图片生成

LoopToken 提供两个同步图片接口。请求会等待生成完成后返回；无需创建任务或轮询。不同模型使用不同请求协议与响应结构，请按模型解析，不能假设所有图片接口都返回同一种响应体。

模型	用途	请求提示词与图片	生成参数	成功响应中的图片
`qwen-image-2.0-pro`	文生图	`input.messages` 中的用户文本	`parameters.n`（1-6）、`parameters.size`	`output.choices[].message.content[].image`
`Doubao-seedream-4.0`	文生图、参考图生成	顶层 `prompt`；参考图使用顶层 `image`	顶层图片参数	`data[].url` 或 `data[].b64_json`
`Doubao-seedream-4.5`	文生图、参考图生成	顶层 `prompt`；参考图使用顶层 `image`	顶层图片参数	`data[].url` 或 `data[].b64_json`
`Doubao-Seedream-5.0-lite`	文生图、参考图生成	顶层 `prompt`；参考图使用顶层 `image`	顶层图片参数	`data[].url` 或 `data[].b64_json`
`doubao-seedream-5.0-pro`	文生图、参考图生成	顶层 `prompt`；参考图使用 `image_urls`	`size`、`resolution`	`data[].url` 或 `data[].b64_json`
`wan2.6-image`	参考图编辑	最后一条用户消息的文本和 1-4 张图片，位于 `input.messages`	`parameters.n`、`parameters.size`	`output.choices[].message.content[].image`
`wan2.7-image`	文生图、编辑、序列生成	顶层 `prompt`；参考图使用 `image_urls`	`n`、`size`、`resolution`	`data[].url` 或 `data[].b64_json`
`wan2.7-image-pro`	文生图、编辑、序列生成	顶层 `prompt`；参考图使用 `image_urls`	`n`、`size`、`resolution`	`data[].url` 或 `data[].b64_json`
`gpt-image-2-ext`	文生图	顶层 `prompt`	`n=1`、`size`、`quality`	`data[].url` 或 `data[].b64_json`
`gpt-image-2-official`	文生图、图生图、局部重绘	顶层 `prompt`；参考图使用 `image_urls`，遮罩使用 `mask_url`	`n`（1-4）、`size`、`resolution`、`quality`、`background`、`output_format`	`data[].url`

模型	参考图	输出数量	尺寸	成功响应中的图片
`qwen-image-edit`	1-3 张	固定 1 张	不支持自定义尺寸	`output.choices[].message.content[].image`
`qwen-image-edit-plus`	1-3 张	`parameters.n`，1-6 张	宽高 512-2048，结果对齐到 16 的倍数	`output.choices[].message.content[].image`
`qwen-image-edit-max`	1-3 张	`parameters.n`，1-6 张	宽高 512-2048，结果对齐到 16 的倍数	`output.choices[].message.content[].image`
`gpt-image-2-ext`	1 张，单数 `image` 字段	固定 1 张	支持比例 + 分辨率档位并转换为明确宽高；必须读取实际返回尺寸	`data[].url` 或 `data[].b64_json`

两种请求结构

Seedream 使用顶层字段：model 与 prompt 是主要输入，参考图和生成选项也位于请求体顶层。

Qwen Image 与 Wan 使用多模态结构：文本和图片位于 input.messages，数量、尺寸等选项位于 parameters。这类请求没有顶层 prompt。不要同时混用两套字段位置。

GPT Image、Nano Banana、Grok Imagine 和其他 OpenAI Images 扩展模型也通过这两个同步端点调用。具体请求和响应以 GPT Image、Nano Banana、Grok Imagine 和其他图片模型页面为准。

图片保存

响应中的图片 URL 是临时地址。收到成功响应后应尽快下载并保存到自己的持久存储；当前公开契约不承诺精确有效时长。data[].b64_json 则由调用方解码并保存。

计费

图片按平台识别到的输出张数计费，不同模型单价见模型列表。请求前会按模型、数量和尺寸预扣；成功后按可识别的实际图片数结算。若 2xx 响应结构无法识别图片数，则按本地解析的提交数量结算；模型服务非 2xx、没有可处理资源或重试耗尽会全额退款。响应中的 usage 是模型服务用量，不是 credit 金额。失败与退款规则以错误码为准。

错误响应

接口错误使用统一信封，不应依赖具体 message 文案编写分支：

{
  "error": {
    "type": "invalid_request",
    "code": "invalid_request",
    "message": "request is invalid",
    "request_id": "req_..."
  }
}

常见状态包括 400 invalid_request、401 invalid_api_key、402 insufficient_credits、403 model_not_allowed、404 model_not_found、502 upstream_error 和 503 no_available_channel。保留 request_id 便于排查，完整说明见错误码。

图片生成

鉴权与请求头

端点与协议

`POST /v1/images/generations`

`POST /v1/images/edits`

两种请求结构

图片保存

计费

错误响应

本页内容