CutAI API 允许你通过服务端 API Key 创建图片生成任务，并轮询任务状态。

​
基础地址

https://studio.cutaihub.com
生产环境 API 地址： 
https://studio.cutaihub.com

​
快速开始

先验证 API Key 是否已接入成功： 
curl "$CUTAI_BASE_URL/api/ping" \
  -H "Authorization: Bearer $CUTAI_API_KEY"
再查询当前可用积分： 
curl "$CUTAI_BASE_URL/api/query/credits" \
  -H "Authorization: Bearer $CUTAI_API_KEY"
创建生成任务： 
curl -X POST "$CUTAI_BASE_URL/api/generations" \
  -H "Authorization: Bearer $CUTAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A cinematic product photo",
    "modelId": "gpt-img2",
    "imageCount": 1
  }'
接口返回 batch。其中 batch.request.idempotencyKey 是 task 级别幂等键，batch.results 是每张图对应的 job。

​
任务与 Job

一次 API 调用会创建一个 task。批量生成时，一个 task 下会有多个 job，每张图一个 job。
  • 任意 job 成功，task 状态就是 completed
  • 全部 job 失败，task 状态才是 failed
  • job 失败后对应积分会退回