跳到主要内容

任务生命周期

生图接口不会长时间保持连接等待结果。提交成功后返回 task_id，调用方自行查询：

curl 'https://api.ch88.cn/v1/open/tasks/<TASK_ID>' \
  -H 'Authorization: Bearer <PUBLIC_API_KEY>'

建议首次间隔不少于 5 秒，持续未完成时逐步退避。终态包括：

  • queued：任务已进入队列
  • processing：任务处理中
  • succeeded：已完成，可下载素材
  • failed：生成失败
  • cancelled：任务已取消

任务查询和素材下载都必须使用创建任务时所属成员的 Public API Key。

下载结果​

任务成功后，从响应中的 asset_id 或素材 URL 下载文件。开放上传和生成素材最长保存 3 天，下载时继续携带同一把 Key：

curl -L \
  -H 'Authorization: Bearer <PUBLIC_API_KEY>' \
  'https://api.ch88.cn/v1/linggan/media/assets/generated%2Fwebhook%2F<TASK_ID>.png' \
  -o result.png