Routescope APIRoutescope API

提交图片生成或编辑任务

提交异步图片任务。prompt 和 images 至少需要提供一个；服务端会返回公开 job_id，后续使用该 job_id 调用查询接口获取任务状态和结果。

POST
/v1/aiart/openai/image/submit
curl -X POST "https://api.routescope.ai/v1/aiart/openai/image/submit" \  -H "Content-Type: application/json" \  -d '{    "model": "gpt-image-2",    "prompt": "一只橘猫坐在霓虹灯下，电影感，细节丰富",    "size": "1024x1024",    "quality": "high",    "n": 1,    "output_format": "png"  }'
{
  "request_id": "req_8f2b7c1a9d",
  "job_id": "task_20260529123456_abcd1234"
}
{
  "code": "invalid_request",
  "message": "prompt or images is required",
  "data": null
}
{
  "code": "invalid_request",
  "message": "prompt or images is required",
  "data": null
}
{
  "code": "invalid_request",
  "message": "prompt or images is required",
  "data": null
}
{
  "code": "invalid_request",
  "message": "prompt or images is required",
  "data": null
}

Authorization

BearerAuth

AuthorizationBearer <token>

模型 relay 接口鉴权。请求头：Authorization: Bearer 。

In: header

Request Body

application/json

prompt?string

图片生成或编辑提示词。纯文生图时必填；图生图或编辑时可与 images 一起使用。

model?string

模型名称。未传时服务端默认使用 gpt-image-2。

Default"gpt-image-2"
images?array<string>

输入参考图 URL 列表。用于图生图、图片编辑或多图参考；数组中的空字符串会被忽略。

mask?string

蒙版图片 URL。用于限定编辑区域；未传时不使用蒙版。

Formaturi
input_fidelity?string

输入图片保真度控制。用于图片编辑时控制生成结果对输入图的贴近程度，具体可选值由上游通道决定。

size?string

输出图片尺寸。常见格式为 宽x高，例如 1024x1024；具体支持范围由上游模型决定。

quality?string

输出图片质量档位。具体可选值由上游通道决定，例如 low、medium、high。

background?string

背景模式。用于控制是否透明或自动生成背景，具体可选值由上游通道决定。

n?integer

生成图片数量。当前仅支持 1 张。

Range1 <= value <= 1
output_format?string

输出图片格式。常见值包括 png、jpeg、webp，具体支持范围由上游通道决定。

output_compression?integer

输出图片压缩质量。通常用于 jpeg/webp 等格式；该字段支持显式传 0，服务端会保留该值并转发给上游。

Range0 <= value <= 100
response_format?string

结果返回格式。当前接口为异步任务提交，提交响应固定返回 job_id；该字段会作为上游扩展参数转发。

logo_add?integer

是否添加 Logo 的开关。通常 1 表示添加，0 表示不添加；该字段支持显式传 0。

Value in0 | 1
logo_param?

Logo 参数。用于在生成图片中添加指定 Logo。

extra_body?

扩展请求参数。仅当需要兼容上游扩展字段或避免顶层字段冲突时使用。

[key: string]?never

Response Body

application/json

application/json

application/json

application/json

application/json

最后更新于