SuperAPI AI 工具集

image-to-svg

设计与创作

查看项目

更新于 10-16 07:58

技能介绍

用途:把位图(PNG、JPEG、WebP、GIF,也支持本地 SVG)通过 QuiverAI 的 POST /v1/svgs/vectorizations 接口矢量化,并把返回的 SVG 标记写入文件。使用前需先获取当前官方文档,且不要用 head、tail、sed -n、awk、less 等截断命令。

鉴权:API key 存放在 ~/.config/opencode/skills/image-to-svg/.env 的 QUIVERAI_API_KEY,加载时不要打印 key,也不要提交 .env;若值为空则停止并让用户到 https://platform.quiver.ai/api-keys 粘贴 key。

模型与参数:默认模型 arrow-1.1(Logo、图标、多数图片),密集插画或技术图用 arrow-1.1-max。保持 stream 为 false,JSON 体包含完整 SVG,不使用 SSE。尽量自行紧凑裁剪;仅在无法自行裁剪且图中有多余空白时设 auto_crop: true。

调用方式:公网 URL 用 image.url;本地文件发送原始 base64(不是 data URI)。解码后输入需小于 12,582,912 字节、4096x4096 与 16,777,216 像素。输出未指定时保存为与源文件同目录同名 .svg,并确认文件存在且以 <svg 开头。

网站 Logo 后处理:若是 Logo、图标或字标,或用户要求用于网站,需去掉不透明背景(删除整画布白/黑 <rect>、<svg> 上的 fill 及纯背景 path),并把标记的填充和描边(#000、#000000、black 及主色)改为 currentColor,便于用 CSS 适配深浅模式;对颜色即艺术的全彩插画跳过。重写应在保存后再上传前完成。

响应与错误:成功返回非流式 JSON,含 id、created、data[0].svg、mime_type 与 credits,只把 .data[0].svg 写入文件。sk_test_ 开头的 key 返回 mock,若 SVG 含 data-quiver-sandbox="true" 或响应头为 x-quiver-environment: test 则拒绝用于真实工作。HTTP 错误需显示状态、代码、消息与 request_id;429 时等待 Retry-After 秒后重试一次。

保存成功后可用 kimaki upload-to-discord --session <当前会话> "$OUT" 上传 SVG,不要将完整 SVG 标记粘贴到聊天中。