快速开始
五分钟跑通第一次生成:拿 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 秒。生图通常几十秒,生视频几分钟。