接口提示
图片要求
图片格式： 仅支持 JPG、JPEG、PNG 格式, 建议使用 JPG 格式
图片文件大小： 最大 5 MB
图片分辨率： 最小 600 * 800, 最大 4096 * 4096
认证
authorization string 必需
所有 API 均使用 Bearer Token 鉴权
获取 API Key：
访问 API Key 管理页面 获取 API Key
用法：
将以下 Header 添加到请求中：
Authorization: Bearer YOUR_API_KEY参数
model string 必需
请求使用的模型 ID
值: spark_style_template
req_key string 必需
图像风格化风格列表, 不同风格传入不同 req_key
可选值:
img2img_ghibli_style_usage: 网红日漫风
img2img_real_mix_style_usage: 写实风
img2img_makoto_style_usage: 天使风
img2img_cartoon_style_usage: 动漫风
img2img_rev_animated_style_usage: 公主风
img2img_blueline_style_usage: 梦幻风
img2img_water_ink_style_usage: 水墨风
i2i_ai_create_monet_usage: 新莫奈花园
img2img_water_paint_style_usage: 水彩风
img2img_comic_style_usage: 莫奈花园 / 精致美漫 / 赛博机械（需配合 sub_req_key）
img2img_exquisite_style_usage: 精致韩漫
img2img_pretty_style_usage: 国风-水墨 / 浪漫光影（需配合 sub_req_key）
img2img_ceramics_style_usage: 陶瓷娃娃
img2img_chinese_style_usage: 中国红
img2img_clay_style_usage: 丑萌粘土 / 可爱玩偶（需配合 sub_req_key）
img2img_3d_style_usage: 3D-游戏_Z时代 / 动画电影 / 玩偶（需配合 sub_req_key）
sub_req_key string
图像风格化子风格列表, 需要与 req_key 风格选择一致. 某些风格需要传入, 某些风格不需要
可选值:
img2img_comic_style_monet: 莫奈花园
img2img_comic_style_marvel: 精致美漫
img2img_comic_style_future: 赛博机械
img2img_pretty_style_ink: 国风-水墨
img2img_pretty_style_light: 浪漫光影
img2img_clay_style_3d: 丑萌粘土
img2img_clay_style_bubble: 可爱玩偶
img2img_3d_style_era: 3D-游戏_Z时代
img2img_3d_style_movie: 动画电影
img2img_3d_style_doll: 玩偶
image_urls array 必需（二选一）
输入图片 URL 数组. 仅支持 1 张图
image_urls 和 binary_data_base64 二选一, 必须提供其中一个
binary_data_base64 array 必需（二选一）
输入图片 Base64 数组. 仅支持 1 张图
image_urls 和 binary_data_base64 二选一, 必须提供其中一个
return_url boolean
输出是否返回图片链接（链接有效期为 24 小时）
logo_info object
水印信息
add_logo
boolean是否添加水印.
true为添加,false不添加默认值:
false
position
integer水印的位置
0: 右下角
1: 左下角
2: 左上角
3: 右上角可选值:
0,1,2,3默认值:
0
language
integer水印的语言
0: 中文（AI生成）
1: 英文（Generated by AI）可选值:
0,1默认值:
0
opacity
number水印的不透明度.
1表示完全不透明范围:
0-1默认值:
1
logo_text_content
string明水印自定义内容
轮询
由于图像生成需要时间, 您需要在创建任务后轮询任务状态
初始响应返回任务 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
元数据信息
错误码
| 错误码 | 描述 |
|---|---|
| 003008001 | 缺少 req_key |
| 003008002 | req_key 无效 |
| 003008003 | sub_req_key 无效 |
| 003008004 | 缺少图像 |
| 003008005 | 图像数量无效 |
| 003008095 | 内部生成错误 |
| 003008096 | 结果解析异常 |
| 003008097 | HTTP 错误响应 |
| 003008098 | 状态检查异常 |
| 003008099 | 任务创建异常 / 服务不可用 |