接口提示
kirin_v2_1_reference2image 通过 subject_image_list 支持 1 到 4 张主体参考图，并可选支持 scene_image 和 style_image
认证
authorization string 必填
所有 API 均使用 Bearer Token 鉴权
获取 API Key：
访问 API Key 管理页面 获取 API Key
用法：
将以下 Header 添加到请求中：
Authorization: Bearer YOUR_API_KEY参数
model string 必填
请求使用的模型 ID。
值: kirin_v2_1_reference2image
prompt string
正向文本提示词。
不能超过 2500 个字符。
subject_image_list array 必填
主体参考图片列表。最少支持 1 张，最多支持 4 张，每张通过 key:value 对象传入，如下所示：
"subject_image_list": [
{ "subject_image": "image_url_or_base64" },
{ "subject_image": "image_url_or_base64" },
{ "subject_image": "image_url_or_base64" },
{ "subject_image": "image_url_or_base64" }
]API 端无裁剪逻辑，请直接上传已选好主体后的图片
支持传入图片 Base64 编码或图片 URL（确保可访问）
注意：若使用 Base64 方式，请不要在 Base64 编码字符串前添加任何前缀（如 data:image/png;base64,），直接传递 Base64 编码后的字符串即可
正确的 Base64 编码参数：
iVBORw0KGgoAAAANSUhEUgAAAAUA...
错误的 Base64 编码参数（包含 data: 前缀）：
data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUA...
图片格式支持 .jpg / .jpeg / .png
图片文件大小不能超过 10MB，图片宽高尺寸不小于 300px，图片宽高比要在 1:2.5 和 2.5:1 之间
subject_image
string必填主体图片 URL 或 Base64 字符串
scene_image string
场景参考图。
支持传入图片 Base64 编码或图片 URL（确保可访问）
注意：若使用 Base64 方式，请不要在 Base64 编码字符串前添加任何前缀（如 data:image/png;base64,），直接传递 Base64 编码后的字符串即可
正确的 Base64 编码参数：
iVBORw0KGgoAAAANSUhEUgAAAAUA...
错误的 Base64 编码参数（包含 data: 前缀）：
data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUA...
图片格式支持 .jpg / .jpeg / .png
图片文件大小不能超过 10MB，图片宽高尺寸不小于 300px，图片宽高比要在 1:2.5 和 2.5:1 之间
style_image string
风格参考图。
支持传入图片 Base64 编码或图片 URL（确保可访问）
注意：若使用 Base64 方式，请不要在 Base64 编码字符串前添加任何前缀（如 data:image/png;base64,），直接传递 Base64 编码后的字符串即可
正确的 Base64 编码参数：
iVBORw0KGgoAAAANSUhEUgAAAAUA...
错误的 Base64 编码参数（包含 data: 前缀）：
data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUA...
图片格式支持 .jpg / .jpeg / .png
图片文件大小不能超过 10MB，图片宽高尺寸不小于 300px，图片宽高比要在 1:2.5 和 2.5:1 之间
n integer
生成图片数量。
默认值: 1
范围: 1 - 9
aspect_ratio string
生成图片的画面纵横比（宽:高）。
默认值: 16:9
可选值: 16:9、9:16、1:1、4:3、3:4、3:2、2:3、21:9
watermark_info object
是否同时生成含水印的结果，暂不支持自定义水印。
enabled
boolean
true：生成含水印的结果
false：不生成
callback_url string
本次任务结果回调通知地址。如果配置，服务端会在任务状态发生变更时主动通知。
具体通知消息的 schema 见回调协议。
external_task_id string
自定义任务 ID。
用户自定义任务 ID，传入不会覆盖系统生成的任务 ID，但支持通过该 ID 进行任务查询。
注意：单用户下需要保证唯一性。
轮询
由于结果生成需要时间，您需要在创建任务后轮询任务状态
初始响应只返回任务 ID 和初始状态等信息，最终生成结果需通过使用该任务 ID 轮询任务状态接口获取
轮询请求与响应示例见右侧
响应格式
error object
错误信息。仅在任务状态为 failed 时返回。
code
string错误码。建议按该字段进行程序化失败处理。
error_message
string详细错误信息，用于说明任务失败原因。
output array
生成结果。仅在任务状态为 completed 时返回。
content
array生成内容列表。
type
string资源类型，例如
image或video。url
string生成资源 URL。
usage object
用量信息。仅在任务状态为 completed 时返回。
cost
string总费用，单位为美元。
discount
number折扣金额。