接口提示
输入的图片需要满足以下要求：
图片格式： 仅支持 JPEG、PNG 格式, 建议使用 JPEG 格式
图片文件大小： 最大 4.7 MB, 图片分辨率：最大 4096 * 4096
图片比例： 推荐范围为 16:9 到 9:16（极端比例效果欠佳, 有概率报错）
主体要求： 强烈建议上传单主体（支持类型包括写实真人、卡通动漫、动物及其他物体）, 多主体效果显著下降且易引起异常
认证
authorization string 必需
所有 API 均使用 Bearer Token 鉴权
获取 API Key：
访问 API Key 管理页面 获取 API Key
用法：
将以下 Header 添加到请求中：
Authorization: Bearer YOUR_API_KEY参数
model string 必需
请求使用的模型 ID
值: spark_dreamo
prompt string 必需
用于编辑图像的提示词, 支持中英双语
长度建议控制在 300 字符左右, 过长会不生效且易引起异常
image_urls array 必需（二选一）
图片文件 URL（必须公网可正常访问）. 需要并且仅需要输入 1 张图片
image_urls 和 binary_data_base64 二选一, 必须提供其中一个
binary_data_base64 array 必需（二选一）
图片文件, Base64 编码. 需要并且仅需要输入 1 张图片
image_urls 和 binary_data_base64 二选一, 必须提供其中一个
seed integer
随机种子, 作为确定扩散初始状态的基础. 若随机种子为相同正整数且其他参数均一致, 则生成内容极大概率效果一致
默认值: -1（随机）
use_rephraser boolean
是否对输入文本提示词进行改写, 以优化效果, 正常状态建议保持开启
如果输入文本特别长、强诉求不能改变输入提示词内容、强诉求缩短耗时, 可关闭此参数
默认值: true
width integer
生成图像的宽
突破宽高上限, 需要保证宽 * 高乘积小于 2048 * 2048, 且易造成效果异常、超时等问题
建议比例及对应宽高（width * height）:
1:1: 1328 * 1328
4:3: 1472 * 1104
3:2: 1584 * 1056
16:9: 1664 * 936
21:9: 2016 * 864
范围: 512-2048
默认值: 1328
height integer
生成图像的高
突破宽高上限, 需要保证宽 * 高乘积小于 2048 * 2048, 且易造成效果异常、超时等问题
范围: 512-2048
默认值: 1328
轮询
由于图像生成需要时间, 您需要在创建任务后轮询任务状态
初始响应返回任务 ID 和初始状态. 实际的生成结果必须通过轮询任务状态端点来获取
响应格式
error object
错误信息. 仅在状态为 failed 时出现
code
string错误码
error_message
string详细错误信息
output array
生成结果. 仅在状态为 completed 时出现
content
array生成内容列表
type
string资源类型
值:
imageurl
string内容 URL
size
integer图像大小（字节）
jobId
string作业 ID
usage object
使用统计. 仅在状态为 completed 时出现
cost
string总费用（美元）
discount
number折扣金额
metadata object
元数据信息
错误码
| 错误码 | 描述 |
|---|---|
| 003011001 | 缺少提示词 |
| 003011002 | 缺少图像 |
| 003011003 | 提示词长度无效 |
| 003011004 | 参数无效 |
| 003011095 | 内部生成错误 |
| 003011096 | 结果解析异常 |
| 003011097 | HTTP 错误响应 |
| 003011098 | 状态检查异常 |
| 003011099 | 任务创建异常 |