芯剪开放平台

快速开始

五分钟跑通第一次生成:拿 Key、提交任务、轮询结果。

准备

  • 基址https://api.gomiservice.com(旧形式 https://app.gomiservice.com/api/v1/open 仍可用,指向同一服务)
  • 鉴权:所有请求带请求头 Authorization: Bearer sk-gomi-…
  • Key 从哪来:登录芯剪 → 侧边栏「API 密钥」→ 开通团队 API → 新建 Key(需要团队拥有者/管理员身份)。完整 Key 只在创建时展示一次,请立即保存。
  • 计费:扣团队点数,1 点 = 1 分钱。任务到终态按实际消耗结算,失败自动退款。

第一次生成

1. 提交生图任务

curl -X POST https://api.gomiservice.com/v1/images/generations \
  -H "Authorization: Bearer sk-gomi-你的Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "image2",
    "prompt": "一只坐在窗台上的橘猫,水彩风",
    "count": 1,
    "request_id": "demo-0001"
  }'

响应里拿到任务编号:

{
  "tasks": [
    { "task_id": "GMI-XXXXXXXXXXXXX", "status": "pending", "cost_points": 20, "urls": [] }
  ]
}

request_id 是幂等键,必填。超时重试务必复用同一个值——换新值重试会真的再生成一轮、再扣一次费。

2. 轮询到终态

curl https://api.gomiservice.com/v1/tasks/GMI-XXXXXXXXXXXXX \
  -H "Authorization: Bearer sk-gomi-你的Key"

status 变成 succeeded 后,urls 就是产物地址:

{
  "task": {
    "task_id": "GMI-XXXXXXXXXXXXX",
    "status": "succeeded",
    "urls": ["https://…签名地址…"],
    "cost_points": 20
  }
}

建议轮询间隔 5–10 秒。生图通常几十秒,生视频几分钟。

下一步

本页目录