原站参考文档

以下为胜算云公开资料。文中的原站账号、地址、定价和专有服务不属于蓝天；蓝天可用模型以当前 sub2api 配置为准。接入蓝天请先查看快速开始。

GPT Image 2

openai/gpt-image-2
异步任务：POST /v1/tasks/generations 提交 → GET /v1/tasks/generations/{request_id} 轮询结果（POST 发送后 request_id 自动填入 GET）。

BASE URLhttps://router.shengsuanyun.com/api

认证方式Authorization: Bearer YOUR_API_KEY

端点列表

← 上一页

GPT Image 2.5 Sunburst（同步任务）

GPT Image 1.5（异步任务）

接口参考

以下为原文协议定义与示例，原站地址不代表蓝天已开通对应能力。蓝天接入地址和模型以本地配置为准。

蓝天 API 密钥

POST/v1/tasks/generationsOpenAI 图像生成-异步

异步任务：POST 提交后返回 request_id，再用 GET /v1/tasks/generations/{request_id} 轮询结果。

请求体

application/json

object

anyOf · 1

字段	类型	说明
`prompt`必填	stringtextarea
`size`	string	支持满足约束的任意分辨率：最大边 ≤ 3840，两边均为 16 的倍数，长短比 ≤ 3:1，总像素在 655360~8294400 之间可选值："auto" · "1024x1024" · "1536x1024" · "1024x1536" · "2048x2048" · "2048x1152" · "3840x2160" · "2160x3840"
`quality`	string	可选值："auto" · "low" · "medium" · "high"
`n`	integer
`output_format`	string	可选值："png" · "jpeg" · "webp"
`output_compression`	integer	仅 jpeg/webp 有效，0~100
`background`	string	gpt-image-2 不支持 transparent 可选值："auto" · "opaque"
`moderation`	string	可选值："auto" · "low"
`model`必填	string	路由模型，本页固定为 openai/gpt-image-2

anyOf · 2

字段	类型	说明
`prompt`必填	stringtextarea
`image`必填	string
`mask`	string	与输入图片同格式、同尺寸，需含 alpha 通道，标记需要编辑的区域
`size`	string	支持满足约束的任意分辨率：最大边 ≤ 3840，两边均为 16 的倍数，长短比 ≤ 3:1，总像素在 655360~8294400 之间可选值："auto" · "1024x1024" · "1536x1024" · "1024x1536" · "2048x2048" · "2048x1152" · "3840x2160" · "2160x3840"
`quality`	string	可选值："auto" · "low" · "medium" · "high"
`n`	integer
`output_format`	string	可选值："png" · "jpeg" · "webp"
`output_compression`	integer	仅 jpeg/webp 有效，0~100
`background`	string	gpt-image-2 不支持 transparent 可选值："auto" · "opaque"
`moderation`	string	可选值："auto" · "low"
`model`必填	string	路由模型，本页固定为 openai/gpt-image-2

anyOf · 3

字段	类型	说明
`prompt`必填	stringtextarea
`images`必填	array	展开结构 `array` 数组元素 `string`
`size`	string	支持满足约束的任意分辨率：最大边 ≤ 3840，两边均为 16 的倍数，长短比 ≤ 3:1，总像素在 655360~8294400 之间可选值："auto" · "1024x1024" · "1536x1024" · "1024x1536" · "2048x2048" · "2048x1152" · "3840x2160" · "2160x3840"
`quality`	string	可选值："auto" · "low" · "medium" · "high"
`n`	integer
`output_format`	string	可选值："png" · "jpeg" · "webp"
`output_compression`	integer	仅 jpeg/webp 有效，0~100
`background`	string	gpt-image-2 不支持 transparent 可选值："auto" · "opaque"
`moderation`	string	可选值："auto" · "low"
`model`必填	string	路由模型，本页固定为 openai/gpt-image-2

{
  "background": "auto",
  "model": "openai/gpt-image-2",
  "moderation": "auto",
  "n": 1,
  "output_compression": 100,
  "prompt": "帮我生成一张图，整体构图需要具有强烈的收藏版海报气质与高级设计感，大结构稳定，主轮廓强烈明确，内部世界具有纵深、秩序和呼吸感，细节丰富但不拥挤，内容丰满但不杂乱，可以适度加入小比例人物剪影、远处建筑、光柱、门洞、桥、阶梯、回廊、倒影、天光或远景结构来增强尺度感、故事感与史诗感。整体画面要安静、宏大、凝练、富有余味，不要平均铺满，不要廉价热闹，不要无重点堆砌。风格融合收藏版电影海报构图、高级叙事型视觉设计、梦幻水彩质感与纸张印刷品气质，强调纸张颗粒感、边缘飞白、水彩刷痕、轻微晕染、空气透视、柔和雾化、局部体积光、光雾穿透、大面积留白与克制版式，让画面看起来像设计师完成的高端收藏版视觉作品，而不是普通 AI 跑图。整体气质要高级、诗意、宏大、神圣、怀旧、安静、具有传说感和叙事感。色彩由 AI 根据主题自动判断并匹配最合适的高级配色方案，但必须保持统一、克制、耐看、低饱和、高级，不要杂乱高饱和，不要廉价霓虹感，不要塑料数码感。配色可以围绕黑金灰、冷蓝灰、雾白灰、褐红米白、暗铜、旧纸色、深海蓝、暮色紫、银灰等体系自由变化，但必须始终服务主题，并保持海报级审美与整体和谐。最终要求：第一眼有强烈的主题识别度和轮廓记忆点，第二眼有完整丰富的叙事世界，第三眼仍有细节和余味。轮廓选择必须具有创意和主题匹配度，尽量避免重复、保守、常见的容器套路，优先选择更有象征性、更有空间感、更有设计潜力的轮廓形式。不要普通背景拼接，不要生硬裁切，不要模板化奇幻素材，不要游戏宣传图感，不要过度卡通化，不要过度写实导致失去艺术感，不要形式大于内容。如果合适，可以自然加入低调克制的标题、编号、签名或落款，让它更像收藏版海报设计的一部分，但不要喧宾夺主。",
  "quality": "auto",
  "size": "auto"
}

请求示例

参考地址：https://router.shengsuanyun.com/api。路径参数与凭据需替换；非 JSON 请求体需按对应格式准备。

curl -X POST 'https://router.shengsuanyun.com/api/v1/tasks/generations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  --data '{
  "background": "auto",
  "model": "openai/gpt-image-2",
  "moderation": "auto",
  "n": 1,
  "output_compression": 100,
  "prompt": "帮我生成一张图，整体构图需要具有强烈的收藏版海报气质与高级设计感，大结构稳定，主轮廓强烈明确，内部世界具有纵深、秩序和呼吸感，细节丰富但不拥挤，内容丰满但不杂乱，可以适度加入小比例人物剪影、远处建筑、光柱、门洞、桥、阶梯、回廊、倒影、天光或远景结构来增强尺度感、故事感与史诗感。整体画面要安静、宏大、凝练、富有余味，不要平均铺满，不要廉价热闹，不要无重点堆砌。风格融合收藏版电影海报构图、高级叙事型视觉设计、梦幻水彩质感与纸张印刷品气质，强调纸张颗粒感、边缘飞白、水彩刷痕、轻微晕染、空气透视、柔和雾化、局部体积光、光雾穿透、大面积留白与克制版式，让画面看起来像设计师完成的高端收藏版视觉作品，而不是普通 AI 跑图。整体气质要高级、诗意、宏大、神圣、怀旧、安静、具有传说感和叙事感。色彩由 AI 根据主题自动判断并匹配最合适的高级配色方案，但必须保持统一、克制、耐看、低饱和、高级，不要杂乱高饱和，不要廉价霓虹感，不要塑料数码感。配色可以围绕黑金灰、冷蓝灰、雾白灰、褐红米白、暗铜、旧纸色、深海蓝、暮色紫、银灰等体系自由变化，但必须始终服务主题，并保持海报级审美与整体和谐。最终要求：第一眼有强烈的主题识别度和轮廓记忆点，第二眼有完整丰富的叙事世界，第三眼仍有细节和余味。轮廓选择必须具有创意和主题匹配度，尽量避免重复、保守、常见的容器套路，优先选择更有象征性、更有空间感、更有设计潜力的轮廓形式。不要普通背景拼接，不要生硬裁切，不要模板化奇幻素材，不要游戏宣传图感，不要过度卡通化，不要过度写实导致失去艺术感，不要形式大于内容。如果合适，可以自然加入低调克制的标题、编号、签名或落款，让它更像收藏版海报设计的一部分，但不要喧宾夺主。",
  "quality": "auto",
  "size": "auto"
}'

响应

200 提交成功，返回 request_id / task_id

application/json

未提供结构定义。

{
  "code": "success",
  "message": "",
  "data": {
    "request_id": "REQ_xxx",
    "task_id": "TASK_xxx",
    "action": "GENERATION",
    "status": "PENDING",
    "progress": "0%"
  }
}

400 请求参数错误

401 未授权（API Key 无效）

429 请求过于频繁

500 服务器内部错误

GET/v1/tasks/generations/{request_id}查询异步任务状态与产物

通过 POST /v1/tasks/generations 返回的 request_id 轮询任务状态、进度与产物 URL（image_urls / video_urls / audio_urls / file_urls / text）。下方「在线测试」填入 request_id 即可发送查询；若上方 POST 已发送成功，request_id 会自动填入。

请求参数

参数	位置 / 类型	说明
`request_id`必填	path / string	POST /v1/tasks/generations 返回的请求 ID

请求示例

参考地址：https://router.shengsuanyun.com/api。路径参数与凭据需替换；非 JSON 请求体需按对应格式准备。

curl -X GET 'https://router.shengsuanyun.com/api/v1/tasks/generations/{request_id}' \
  -H 'Authorization: Bearer YOUR_API_KEY'

响应

200 任务状态与产物

application/json

未提供结构定义。

{
  "code": "success",
  "message": "",
  "data": {
    "request_id": "REQ_xxx",
    "task_id": "TASK_xxx",
    "action": "GENERATION",
    "status": "COMPLETED",
    "progress": "100%",
    "data": {
      "url": [
        "https://oss.shengsuanyun.com/example/output.mp4"
      ]
    }
  }
}

400 请求参数错误

401 未授权（API Key 无效）

429 请求过于频繁

500 服务器内部错误