Routescope APIRoutescope API
模型接口API文档图像模型OpenAI 风格图像

异步图片任务

OpenAI 风格异步图片生成和编辑任务 API

异步图片任务接口支持提交图片生成或编辑任务，并通过任务 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

查询任务结果

POST
/v1/aiart/openai/image/query
curl -X POST "https://api.routescope.ai/v1/aiart/openai/image/query" \  -H "Content-Type: application/json" \  -d '{    "job_id": "task_20260529123456_abcd1234"  }'

{
  "status": "WAIT",
  "created": 1779993296
}

{
  "code": "invalid_request",
  "message": "job_id 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

job_id*string

提交接口返回的公开任务 ID。该字段必填。

[key: string]?never

Response Body

application/json

application/json

application/json

application/json

任务参数

字段适用接口类型说明
model提交任务string示例使用 gpt-image-2。
prompt提交任务string生成或编辑提示词。prompt 和 images 至少需要提供一个。
images提交任务array参考图片。prompt 和 images 至少需要提供一个。
job_id查询结果string提交任务时返回的任务 ID。

任务流程

  1. 调用 /v1/aiart/openai/image/submit 提交任务。
  2. 服务端返回 job_id。
  3. 使用 /v1/aiart/openai/image/query 查询任务状态。
  4. 状态为 DONE 时，data 中返回结果图片 URL；状态为 FAIL 时，error_message 通常包含失败原因。

示例代码

提交任务

curl https://api.routescope.ai/v1/aiart/openai/image/submit \
  -H "Authorization: Bearer $ROUTESCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "生成一张现代 API 文档封面"
  }'

查询结果

curl https://api.routescope.ai/v1/aiart/openai/image/query \
  -H "Authorization: Bearer $ROUTESCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "job_id": "your-job-id"
  }'

最后更新于

图片编辑 POST

OpenAI 风格图片编辑 API

视频模型

Doubao Seedance 创建任务、查询任务、素材库和内容获取接口