梭子蟹API 文档
用量
立即开始
Base URLhttps://suoxie.codes/v1

API 参考

异步图像任务

提交长耗时图像任务并轮询对象存储结果。

异步任务生命周期 ​

异步接口默认可能关闭；如果对象存储未启用，会返回明确的 404，而不会创建任务。提交和轮询必须使用同一把 API Key。

提交任务 ​

bash
curl https://suoxie.codes/v1/images/generations/async \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"model":"<MODEL>","prompt":"A precise technical cutaway","size":"1536x1024"}'

提交成功返回 202 Accepted，包含 Location 和 Retry-After: 3。

轮询任务 ​

bash
curl https://suoxie.codes/v1/images/tasks/<TASK_ID> \
  -H "Authorization: Bearer <API_KEY>"

状态为 processing、completed 或 failed。完成后返回对象存储 URL，不保留 b64_json。当前合约不提供取消、Webhook 或幂等保证。