跳转到主要内容
POST
Seedream 5.5 Pro · 文生图

简介

使用文本提示词生成 1 张图片,不传 image。支持直接生成透明背景图片。需要参考图编辑、多图融合或图层拆分时,请查看 图生图。

接口与认证

使用 Authorization: Bearer sk-xxxxxxxxxx 和 Content-Type: application/json。认证和接口规则见 参数与计费。

请求参数

n 传 1 或不传;需要多张普通生成结果时请分别请求。safety_identifier、完整默认值和参数解释见 通用参数。两版均不支持 quality、组图、流式输出与联网搜索。

size

支持档位 1K、1.5K、2K,默认 2K;可在提示词中描述宽高比。自定义 宽x高 使用小写 x,总像素必须在 [921600, 4624220] 内,宽高比在 [1/16, 16] 内。例如 1024x1024 有效,512x512 无效。完整尺寸表见 尺寸说明。

background

控制输出图片是否带透明通道。
  • 文生图支持 transparent,无需参考图片。
  • 实际是否透明以响应里的 data[].background 为准,可能和请求值不同。
transparent 不能和 output_format: "jpeg" 同时用,否则报错。

调用示例

每个示例提供可直接复制的完整 JSON 请求 body 和对应 cURL。使用 cURL 时,请将 sk-xxxxxxxxxx 替换为自己的 API Key。

文生图

文生透明图

成功返回

普通生成返回 1 张图片。response_format: "url" 时读取 data[].url,24 小时内下载保存;使用 b64_json 时读取 data[].b64_json 并解码。响应示例、完整字段和用量解释见 基础响应。

计费与错误处理

文生图无需参考图费用,输出图按实际像素定档。详细价格和示例见 计费说明;排查参数、图片读取等问题见 错误处理。