Dola Seedream 5.5 API
- 模型名:
dola-seedream-5.5 - 厂商: BytePlus
- 类型: image
POST /v1/images/generations
dola-seedream-5.5 同步文生圖:1張1024x1024圖片的Base64基礎請求、實際響應欄位和圖片價格檔位。
基础文生图
必填参数: model, prompt
可用参数: model, prompt, n, size, response_format
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|
model | string | 是 | 请求时使用精确可调用型号 dola-seedream-5.5;响应中的model为服务返回的型号标识,以实际返回为准。 可选: dola-seedream-5.5 |
prompt | string | 是 | 用文字描述要生成的图像。 |
n | integer | 否 | 请求生成的图片数量,默认1。本页基础示例为1张,不在此承诺其它数量上限。 |
size | string | 否 | 图像尺寸,使用宽x高字符串。本页基础请求和虚构响应均为1024x1024;实际输出以data[].size及图片为准,不承诺其它尺寸或缺省值。 |
response_format | string | 否 | 图片返回形式。本页使用并已核对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 文生圖