接口提示
输入的图片需要满足以下要求：
图片格式： 仅支持 JPG、JPEG、PNG 格式, 建议使用 JPG 格式
图片文件大小： 最大 5 MB, 图片分辨率：最大 4096 * 4096
主体要求： 为保证处理效果, 输入图须含且仅含 1 人人脸, 人脸最好为正面、无遮挡且人脸面积占比较高. 如不满足条件, 处理效果较差
认证
authorization string 必需
所有 API 均使用 Bearer Token 鉴权
获取 API Key：
访问 API Key 管理页面 获取 API Key
用法：
将以下 Header 添加到请求中：
Authorization: Bearer YOUR_API_KEY参数
model string 必需
请求使用的模型 ID
值: spark_edit_portrait
image_input string 必需
图片 URL
示例: https://example.com/image.png
prompt string
生图提示词
默认值: 演唱会现场的合照，闪光灯拍摄
width integer
生成图像的宽
范围: 512-2048
默认值: 1328
height integer
生成图像的高
范围: 512-2048
默认值: 1328
gpen number
高清处理效果, 越高人脸清晰度越高, 建议使用默认值
可选值: 0, 0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9, 1
默认值: 0.4
skin number
人脸美化效果, 越高美颜效果越明显, 建议使用默认值
可选值: 0, 0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9, 1
默认值: 0.3
skin_unifi number
匀肤效果, 越高均匀肤色去除瑕疵效果越明显, 建议使用默认值
可选值: 0, 0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9, 1
默认值: 0
gen_mode string
参考模式
creative: 提示词模式（有 prompt 时自动切换此模式）, 只参考人物的性别特征
reference: 全参考模式（无 prompt 时自动切换此模式）, 参考人物更多维度特征（性别、服饰、发型等）及背景
reference_char: 人物参考模式, 参考人物更多维度特征（性别、服饰、发型等）, 不参考背景
手动输入优先级大于自动
可选值: creative, reference, reference_char
seed string
随机种子, 作为确定扩散初始状态的基础. 若随机种子为相同正整数且其他参数均一致, 则生成内容极大概率效果一致
默认值: -1（随机）
轮询
由于图像生成需要时间, 您需要在创建任务后轮询任务状态
初始响应返回任务 ID 和初始状态. 实际的生成结果必须通过轮询任务状态端点来获取
响应格式
error object
错误信息. 仅在状态为 failed 时出现
code
string错误码
error_message
string详细错误信息
output array
生成结果. 仅在状态为 completed 时出现
content
array生成内容列表
type
string资源类型
值:
imageurl
string图像 URL（已处理并上传至 CDN）
size
integer图像大小（字节）
jobId
string远程任务 ID
usage object
使用统计. 仅在状态为 completed 时出现
cost
string总费用（美元）
discount
number折扣金额
metadata object
元数据信息
错误码
| 错误码 | 描述 |
|---|---|
| 0 | 无错误 |
| 003010001 | 缺少图像输入 |
| 003010002 | 参数无效 |
| 003010003 | 图像格式无效, 仅支持 JPG/JPEG/PNG |
| 003010095 | 内部生成错误 |
| 003010096 | 结果解析异常 |
| 003010097 | HTTP 错误响应 |
| 003010098 | 状态检查异常 |
| 003010099 | 任务创建异常 |