认证
authorization string 必需
所有 API 均使用 Bearer Token 鉴权
获取 API Key：
访问 API Key 管理页面 获取 API Key
用法：
将以下 Header 添加到请求中：
Authorization: Bearer YOUR_API_KEY参数
model string 必需
请求使用的模型 ID
值: spark_t2i_3_0
prompt string 必需
用于生成图像的提示词, 中英文均可输入
建议长度 ≤ 120 字符, 最长不超过 800 字符, prompt 过长有概率出图异常或不生效
use_pre_llm boolean
开启文本扩写, 会针对输入 prompt 进行扩写优化. 如果输入 prompt 较短建议开启, 如果输入 prompt 较长建议关闭
默认值: true
seed integer
随机种子, 作为确定扩散初始状态的基础. 若随机种子为相同正整数且其他参数均一致, 则生成图片极大概率效果一致
默认值: -1（随机）
width integer
生成图像的宽
支持自定义生成图像宽高, 宽高比在 1:3 到 3:1 之间, 宽高乘积在 [512×512, 2048×2048] 之间
推荐可选的宽高比:
标清 1K:
1328 × 1328（1:1）
1472 × 1104（4:3）
1584 × 1056（3:2）
1664 × 936（16:9）
2016 × 864（21:9）
高清 2K:
2048 × 2048（1:1）
2304 × 1728（4:3）
2496 × 1664（3:2）
2560 × 1440（16:9）
3024 × 1296（21:9）
注意: 需同时传 width 和 height 才会生效
默认值: 1328
height integer
生成图像的高
支持自定义生成图像宽高, 宽高比在 1:3 到 3:1 之间, 宽高乘积在 [512×512, 2048×2048] 之间
注意: 需同时传 width 和 height 才会生效
默认值: 1328
轮询
由于图像生成需要时间, 您需要在创建任务后轮询任务状态
初始响应返回任务 ID 和初始状态. 实际的生成结果必须通过轮询任务状态端点来获取
响应格式
error object
错误信息. 仅在状态为 failed 时出现
code
integer错误码
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折扣金额
input_tokens
integer输入令牌数
output_tokens
integer输出令牌数
total_tokens
integer总令牌数
错误码
| 错误码 | 描述 |
|---|---|
| 003001001 | 缺少提示词 |
| 003001002 | 提示词长度无效（1-800 字符） |
| 003001003 | use_pre_llm 参数无效 |
| 003001004 | 种子参数无效（必须是 -1 或正整数） |
| 003001005 | 尺寸参数无效 |
| 003001006 | 宽高比无效（必须在 1:3 到 3:1 之间） |
| 003001007 | 宽度和高度必须同时提供 |
| 003001008 | 宽度和高度必须是整数 |
| 003001009 | 宽度和高度必须在 512-2048 范围内 |
| 003001095 | 内部生成错误 |
| 003001096 | 结果解析异常 |
| 003001097 | HTTP 错误响应 |
| 003001098 | 状态检查异常 |
| 003001099 | 任务创建异常 |