Dola Seedream 5.5 API

POST /v1/images/generations

dola-seedream-5.5 同步文生图:1张1024x1024图片的Base64基础请求、实际响应字段和图片价格档位。

基础文生图

必填参数: model, prompt

可用参数: model, prompt, n, size, response_format

请求参数

参数类型必填说明
modelstring是请求时使用精确可调用型号 dola-seedream-5.5;响应中的model为服务返回的型号标识,以实际返回为准。 可选: dola-seedream-5.5
promptstring是用文字描述要生成的图像。
ninteger否请求生成的图片数量,默认1。本页基础示例为1张,不在此承诺其它数量上限。
sizestring否图像尺寸,使用宽x高字符串。本页基础请求和虚构响应均为1024x1024;实际输出以data[].size及图片为准,不承诺其它尺寸或缺省值。
response_formatstring否图片返回形式。本页使用并已核对b64_json,未在本页承诺其它返回形式。
## 图片价格与规格 按实际返回的图片数量和每张图片的实际像素档位计价。对外价格请查看模型广场。下列档位标签不是 `size` 参数枚举,也不代表每个尺寸都已可请求。 | 计费档位 | 实际输出像素(宽×高) | |---|---| | 1K | ≤2,610,000 | | 2K | >2,610,000且≤4,630,000 | | 4K | >4,630,000 | 本页只说明文生图,不提供参考图或图片编辑请求。不要把1K、2K或4K价格标签当作可用的 `size` 枚举。基础请求使用 `1024x1024`。 ## 读取与保存 - 读取 `data[].b64_json`,使用Base64解码后自行保存文件;文件格式以 `data[].output_format` 和实际图片内容为准。 - `data[].background`、`data[].output_format`、`data[].size` 及 `usage` 子字段可能缺失,按实际返回读取。不要把缺失改写为0,也不要把响应字段当成已开放的请求参数。 - `usage.generated_images` 和 `usage.input_images` 是报告的图片计数;`usage.output_tokens`、`usage.total_tokens` 是服务报告的用量计数,不是图片费用之外的额外收费项,也不承诺固定相加或换算关系。 - 本接口返回同步结果,成功时读取 `data[]`;本页不需要任务轮询。 ## 完整嵌套结构 响应字段均按可能缺失处理;表内的必填标记只对应请求参数。 ### 请求体 | 字段路径 | 类型 | 必填 | 含义 | |---|---|---|---| | `model` | string | 是 | 请求时使用精确可调用型号 dola-seedream-5.5;响应中的model为服务返回的型号标识,以实际返回为准。 | | `prompt` | string | 是 | 用文字描述要生成的图像。 | | `n` | integer | 否 | 请求生成的图片数量,默认1。本页基础示例为1张,不在此承诺其它数量上限。 | | `size` | string | 否 | 图像尺寸,使用宽x高字符串。本页基础请求和虚构响应均为1024x1024;实际输出以data[].size及图片为准,不承诺其它尺寸或缺省值。 | | `response_format` | string | 否 | 图片返回形式。本页使用并已核对b64_json,未在本页承诺其它返回形式。 | ### 成功响应 | 字段路径 | 类型 | 必填 | 含义 | |---|---|---|---| | `created` | integer | 否 | 响应中的创建时间,Unix秒;可能缺失。 | | `data` | array[object] | 否 | 生成图片结果数组;每个元素对应一张返回图片。 | | `data[].b64_json` | string | 否 | Base64编码的图片数据。示例占位文本不是有效图片,不能直接解码使用。 | | `data[].background` | string | 否 | 图片背景标记,按实际返回读取;本页不把它列为可请求参数或统一枚举。 | | `data[].output_format` | string | 否 | 实际返回的图片编码格式,按响应读取;本页示例为png。 | | `data[].size` | string | 否 | 图像尺寸,使用宽x高字符串。本页基础请求和虚构响应均为1024x1024;实际输出以data[].size及图片为准,不承诺其它尺寸或缺省值。 | | `model` | string | 否 | 请求时使用精确可调用型号 dola-seedream-5.5;响应中的model为服务返回的型号标识,以实际返回为准。 | | `usage` | object | 否 | 可选用量对象。缺失字段与明确返回0不同,不要补造数值。 | | `usage.generated_images` | integer | 否 | 本次报告的生成图片数量。 | | `usage.input_images` | integer | 否 | 本次报告的输入图片数量;基础文生图示例为0。本页不据此开放参考图调用说明。 | | `usage.output_tokens` | integer | 否 | 服务返回的输出用量计数;不是在图片费用之外再加收的一项。 | | `usage.total_tokens` | integer | 否 | 服务返回的总用量计数;不承诺与其它用量字段存在固定换算或相加关系。 | ### 错误响应 | 字段路径 | 类型 | 必填 | 含义 | |---|---|---|---| | `error` | object|string | 否 | 错误对象,实际字段可能随错误类型变化。 | | `error.message` | string | 否 | 可读的错误说明。 | | `error.type` | string | 否 | 错误类别。 | | `error.param` | string | 否 | 关联参数名,可能为null或缺失。 | | `error.code` | string | 否 | 错误代码,可能为null或缺失。 | 错误可能返回`error`字符串、`error`对象或`detail`说明。状态块中的错误示例均为虚构,不规定固定错误文字或代码。 ## 参考 [Seedream 5.5 官方介绍](https://docs.byteplus.com/en/docs/modelark/seedream-5-5)仅作模型背景参考;调用使用本页平台地址和精确型号。核对日期:2026-11-13。本页未将官方其它规格或扩展能力视为本站已验证能力。

请求示例

curl --request POST https://api.router.ai/v1/images/generations \
  --header "Authorization: Bearer $API_KEY" \
  --header "Content-Type: application/json" \
  --data-raw '{
  "model": "dola-seedream-5.5",
  "prompt": "A fictional miniature greenhouse made of translucent emerald glass, centered on a pale cream background, soft studio light, no writing.",
  "n": 1,
  "size": "1024x1024",
  "response_format": "b64_json"
}'

接口通用说明: Aliyun Qwen-Image 文生图