认证
authorization string 必填
所有 API 都需要通过 Bearer Token 进行身份验证.
获取 API Key：
访问 API Key 管理页面 获取您的 API Key
使用方式：
添加到请求头：
Authorization: Bearer YOUR_API_KEY参数
model string 必填
请求使用的模型 ID
值: viduq2_reference2image
images array
图像引用. 支持输入 0 到 7 张图像.
模型将根据输入图像生成具有一致主体的图像.
格式要求：
支持 Base64 编码或 URL 格式（必须可访问）
支持格式：png, jpeg, jpg, webp
图像分辨率不得低于 128×128, 宽高比不得小于 1:4 或 4:1
图像大小不得超过 50MB
HTTP 请求体不得超过 20MB, 编码必须包含适当的内容类型字符串. 示例：data:image/png;base64{base64_encode}
prompt string 必填
图像生成的文本描述, 最大 2000 个字符
注意： viduq2模型支持文生图，在使用viduq2模型，且没有上传任何images时，模型会使用该参数的文本内容生成图片
resolution string
图像分辨率
可选值: 1080p, 2K, 4K
默认值: 1080p
aspect_ratio string
宽高比
注意： 自动模式将保持生成图像的比例与第一张输入图像一致
可选值: auto, 16:9, 9:16, 1:1, 3:4, 4:3, 21:9, 2:3, 3:2
默认值: 16:9
seed integer
随机种子. 默认值为随机种子数. 手动设置的值将覆盖默认随机种子
payload string
透传参数，不做任何处理, 仅数据传输，最多 1048576 个字符
callback_url string
回调 URL
轮询
由于图像生成需要时间, 您需要在创建任务后轮询任务状态
初始响应返回任务 ID 和初始状态. 实际的生成结果必须通过轮询任务状态端点来获取
响应格式
error object
错误信息. 仅在 status 为 failed 时出现.
code
string错误码
message
string详细错误消息
output array
生成结果. 仅在 status 为 completed 时出现.
content
array生成的内容列表
type
string资源类型
值:
imageurl
string图像 URL
jobId
string远程任务 ID
usage object
使用统计信息. 仅在 status 为 completed 时出现.
cost
string总费用（美元）
discount
number折扣金额
metadata object
元数据信息.
错误码
| 错误码 | 描述 |
|---|---|
| 008023001 | images 或 subjects 参数缺失（至少需要提供一个） |
| 008023002 | images 参数数量错误（必须包含 1-7 张图像） |
| 008023003 | prompt 参数缺失 |
| 008023095 | 内部生成错误 |
| 008023096 | 结果解析错误 |
| 008023097 | HTTP 错误响应 |
| 008023098 | 状态检查错误 |
| 008023099 | 任务创建错误 |