1. OpenAI 兼容异步生图
星核API国际站
  • 开始
  • 模型API
    • 文本生成
      • OpenAI Chat Completions API
      • OpenAI Responses API
      • Anthropic Messages API
    • 图片生成
      • OpenAI 兼容异步生图
        • 提交图片生成任务
          POST
        • 查询图片生成任务
          GET
        • 提交图片编辑任务
          POST
        • 查询图片编辑任务
          GET
    • 视频生成
      • OpenAI 兼容异步视频
        • 提交视频生成任务
        • 查询视频生成任务
      • Seedance 官方 Ark 视频
        • 提交视频生成任务
        • 查询视频生成任务
  1. OpenAI 兼容异步生图

查询图片生成任务

GET
/v1/images/generations/{taskId}
接入信息值
Base URLhttps://api.starcore.cloud
请求GET /v1/images/generations/{taskId}
鉴权Authorization: Bearer <YOUR_API_KEY>
将路径中的任务 ID 替换为提交返回的 id,使用创建时的 Key。GET 无需请求体。

任务状态#

status含义下一步
queued / in_progress排队或处理中约 5 秒后再查
completed已完成保存结果文件
failed失败或已取消停止查询,查看 error
成功后读取 data[].url 获取图片下载地址,并保存所有生成图片。usage 可选;查询不提供切换为 Base64 的参数。

查询 cURL#

整段复制到 Apipost / Apifox 的 cURL 导入,替换 <YOUR_API_KEY> 后使用。将 <TASK_ID> 替换为任务 ID。

查询说明#

遇到 HTTP 429 请降低查询频率;不存在、无权限或协议不匹配的任务可能返回 404。请以任务最终状态判断是否生成成功;结果文件准备完成后即可获取。

请求参数

Authorization
Bearer Token
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
or
Path 参数

Header 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --request GET --url 'https://api.starcore.cloud/v1/images/generations/<TASK_ID>' --header 'Authorization: Bearer <YOUR_API_KEY>'

返回响应

🟢200
application/json
任务状态;成功、处理中和失败均使用 HTTP 200,请检查 status。
Bodyapplication/json

示例
{
    "id": "task_example_01",
    "status": "queued"
}
🟠400
🟠401
🟠403
🟠404
🟠429
🔴502
🔴503
修改于 2026-10-22 03:43:52
上一页
提交图片生成任务
下一页
提交图片编辑任务
Built with