认证
authorization string 必填
所有 API 都需要通过 Bearer Token 进行认证.
获取 API Key：
访问 API Key 管理页面 获取您的 API Key
使用方法：
添加到请求头：
Authorization: Bearer YOUR_API_KEY参数
model string 必填
请求使用的模型 ID
值: wan26_t2i
input object 必填
生成请求的输入数据
messages
array必填请求内容数组. 目前仅支持单轮对话, 即传递一组 role 和 content 参数. 不支持多轮对话. 数组长度必须为
1.role
string必填消息的角色
值:
usercontent
array必填消息内容数组. 数组长度必须为
1.text
string必填正向提示词, 用于描述您期望生成的图像内容、风格和构图. 支持中英文. 每个中文字符、字母、数字或符号计为一个字符. 超出限制的内容将被自动截断.
最大长度：
2100个字符示例：
一只坐着的橙色猫, 表情愉快, 活泼可爱, 逼真准确.注意： 仅支持传递一个 text 对象. 不传或传多个将导致错误.
parameters object
生成参数
negative_prompt
string负向提示词, 用于描述您不希望出现在图像中的内容, 以约束输出. 支持中英文. 超出限制的内容将被自动截断.
最大长度：
500个字符示例：
低分辨率, 低质量, 变形的四肢, 变形的手指, 过饱和, 蜡质外观, 无面部细节, 过于光滑, AI 生成的外观, 混乱的构图, 模糊的文字, 扭曲.
size
string输出图像分辨率, 格式为
width*height.总像素必须在
[1280×1280, 1440×1440]之间, 宽高比必须在[1:4, 4:1]范围内. 例如,768×2700符合要求.常见宽高比的推荐分辨率：
1:1：1280×1280
3:4：1104×1472
4:3：1472×1104
9:16：960×1696
16:9：1696×960默认值:
1280*1280
n
integer要生成的图像数量
重要：
n参数直接影响计费成本. 成本 = 单价 × 图像数量. 请在调用前确认模型定价.注意： 按图像计费. 建议在测试时设为
1.范围:
1-4默认值:
4
prompt_extend
boolean是否启用智能提示词改写. 启用时, 使用大模型优化正向提示词. 这对较短的提示词有显著改善效果, 但会增加
3-4秒的处理时间.可选值:
true,false默认值:
true
watermark
boolean是否添加水印标识. 水印位于图像右下角, 固定文字为「AI Generated」.
可选值:
false,true默认值:
false
seed
integer随机种子. 使用相同的种子值可以保持生成内容相对稳定. 如果未提供, 算法将自动使用随机种子.
注意： 模型生成过程是概率性的. 即使使用相同的种子, 也不能保证每次生成的结果完全一致.
范围:
0-2147483647
轮询
由于图像生成需要时间, 创建任务后需要轮询任务状态.
初始响应返回任务 ID 和初始状态. 实际生成结果必须通过轮询任务状态端点获取.
响应格式
error object
错误信息. 仅当状态为 failed 时存在.
code
string错误码
message
string详细错误信息
output array
生成结果. 仅当状态为 completed 时存在.
content
array生成的图像内容列表
type
string资源类型
值:
imageurl
string生成的图像 URL
jobId
string远程任务 ID
usage object
使用统计. 仅当状态为 completed 时存在.
cost
string总费用（美元）
discount
number折扣金额
image_count
integer生成的图像数量
metadata object
元数据信息.
错误码
| 错误码 | 描述 |
|---|---|
| 001015001 | 缺少必填字段 input |
| 001015002 | input.messages 必须包含一条消息 |
| 001015003 | message.role 必须是 user |
| 001015004 | message.content 必须包含一个文本对象 |
| 001015005 | content[0] 必须包含 text 字段 |
| 001015006 | 文本长度必须在 1-2100 字符之间 |
| 001015007 | negative_prompt 不能超过 500 字符 |
| 001015008 | n 必须是 1 到 4 的整数 |
| 001015009 | seed 必须是 0 到 2147483647 的整数 |
| 001015010 | size 格式必须为 ‘width*height’ |
| 001015011 | size 必须在 768*768 到 1440*1440 像素之间 |
| 001015012 | 宽高比必须在 1:4 到 4:1 之间 |
| 001015013 | 无效的 size 格式, 必须为 ‘width*height’ 且为整数 |
| 001015095 | 内部生成错误 |
| 001015096 | 结果解析错误 |
| 001015097 | HTTP 错误响应 |
| 001015098 | 状态检查错误 |
| 001015099 | 任务创建错误 |