认证
authorization string 必填
所有 API 均使用 Bearer Token 鉴权
获取 API Key：
访问 API Key 管理页面 获取 API Key
用法：
将以下 Header 添加到请求中：
Authorization: Bearer YOUR_API_KEY参数
model string 必填
请求使用的模型 ID.
值：kirin_image_omni
prompt string 必填
文本提示词, 可包含正向描述和负向描述. 可将提示词模板化来满足不同的图像生成需求, 不能超过 2500 个字符
可通过 <<<image_N>>> 的格式来指定某个图片, 如：<<<image_1>>>
image_list array
参考图列表
支持传入图片 Base64 编码或图片 URL（确保可访问）
图片要求：
格式：.jpg, .jpeg, .png
文件大小：不超过 10MB
尺寸：宽高不小于 300px
宽高比：介于 1:2.5 ~ 2.5:1 之间
参考主体数量与参考图片数量有关, 参考主体数量和参考图片数量之和不得超过 10. image 参数值不得为空
resolution string
图片分辨率
选项：1k, 2k
默认值：1k
n integer
生成图片数量, 范围 1-9
默认值：1
aspect_ratio string
生成图片的画面纵横比（宽:高）
参考原图横纵比生成新图时, 当前参数无效
选项：16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9, auto
默认值：auto
watermark_info array
是否同时生成含水印的结果
通过 enabled 参数定义, 具体格式如下：
"watermark_info": {
"enabled": boolean // true 为生成，false 为不生成
}暂不支持自定义水印
callback_url string
本次任务结果回调通知地址，如果配置，服务端会在任务状态发生变更时主动通知
external_task_id string
自定义任务 ID
用户自定义任务 ID，传入不会覆盖系统生成的任务 ID，但支持通过该 ID 进行任务查询
请注意，单用户下需要保证唯一性
轮询
由于图像生成需要时间, 您需要在创建任务后轮询任务状态
初始响应返回任务 ID 和初始状态. 实际的生成结果必须通过轮询任务状态端点来获取
响应格式
error object
错误信息.仅在状态为 failed 时出现.
code
string错误码
message
string详细错误信息
output array
生成结果.仅在状态为 completed 时出现.
content
array生成内容列表
type
string资源类型，如
video,imageurl
string生成内容的 URL
duration
number视频时长
jobId
string远程任务 ID
usage object
使用统计.仅在状态为 completed 时出现.
cost
string总费用 (美元)
discount
number折扣金额
metadata object
元数据信息
错误码
| 错误码 | 描述 |
|---|---|
| 002016001 | 提示词缺失 |
| 002016002 | 提示词超过 2500 字符限制 |
| 002016003 | 生成图像数量 n 必须在 1-9 之间 |
| 002016095 | 内部生成错误 |
| 002016096 | 结果解析错误 |
| 002016097 | HTTP 错误响应 |
| 002016098 | 状态检查错误 |
| 002016099 | 任务创建错误 |