认证
authorization string 必需
所有 API 均使用 Bearer Token 鉴权
获取 API Key：
访问 API Key 管理页面 获取 API Key
用法：
将以下 Header 添加到请求中：
Authorization: Bearer YOUR_API_KEY参数
model string 必需
请求使用的模型 ID
值: spark_image_3_1
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输入令牌数（此模型不提供此信息, 固定为 0）
output_tokens
integer输出令牌数（此模型不提供此信息, 固定为 0）
total_tokens
integer总令牌数（使用 comfyui_cost）
generated_images
integer生成的图像数量
错误码
| 错误码 | 描述 |
|---|---|
| 003002001 | 缺少提示词 |
| 003002002 | 无效的提示词长度 |
| 003002003 | 无效的 use_pre_llm 参数 |
| 003002004 | 无效的种子参数 |
| 003002005 | 无效的尺寸参数 |
| 003002006 | 无效的宽高比 |
| 003002007 | 缺少宽度/高度参数 |
| 003002008 | 无效的宽度/高度参数类型 |
| 003002009 | 无效的宽度/高度参数范围 |
| 003002095 | 内部生成错误 |
| 003002096 | 结果解析错误 |
| 003002097 | HTTP 错误响应 |
| 003002098 | 状态检查错误 |
| 003002099 | 服务不可用 |