视频生成万相
万相2.7-文生视频
POST /api/v1/services/aigc/video-generation/video-synthesis — wan2.7 文生视频
万相 2.7 文生视频模型:基于文本提示词生成一段流畅的视频,支持多镜头叙事(在 prompt 里用时间戳描述分镜即可)。
支持的模型
| 模型 | 说明 |
|---|---|
wan2.7-t2v | 万相 2.7 文生视频 |
创建任务
POST
/api/v1/services/aigc/video-generation/video-synthesiscurl https://api.modelsite.ai/api/v1/services/aigc/video-generation/video-synthesis \
-H "Authorization: Bearer $MODELSITE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "wan2.7-t2v",
"input": {
"prompt": "雨夜的纽约街头,霓虹灯闪烁,一位身穿黑色风衣的侦探快步行走,电影级质感"
},
"parameters": {
"resolution": "720P",
"ratio": "16:9",
"duration": 5
}
}'请求体
| 字段 | 类型 | 说明 |
|---|---|---|
model | string(必填) | wan2.7-t2v |
input.prompt | string(必填) | 提示词,≤5000 字符。多镜头叙事直接在 prompt 里写(如「第1个镜头[0-3秒] 全景:…」) |
input.negative_prompt | string(可选) | 反向提示词,≤500 字符。wan 方言里它在 input 里,不在 parameters 里 |
input.audio_url | string(可选) | 音频文件 URL(wav/mp3,2~30s,≤15MB),模型以该音频为声轨生成视频;音频长度超过 duration 时自动截取前段 |
parameters | object(可选) | 生成参数,见下表 |
parameters 参数
| 参数 | 类型 | 说明 |
|---|---|---|
resolution | string | 720P / 1080P(默认)。可售档位以价格配置为准 |
ratio | string | 16:9(默认)/ 9:16 / 1:1 / 4:3 / 3:4 |
duration | integer | [2, 15] 的整数,默认 5 |
prompt_extend | boolean | prompt 智能改写,默认 true |
watermark | boolean | 水印(右下角 "AI生成" 角标),默认 false |
seed | integer | [0, 2147483647] |
wan2.7 不再支持早期模型的 size 与 shot_type 字段——输出规格由 resolution + ratio 组合表达,镜头类型用 prompt 描述。
轮询与结果
GET
/api/v1/tasks/{task_id}curl "https://api.modelsite.ai/api/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $MODELSITE_API_KEY"响应字段
| 字段 | 说明 |
|---|---|
output.task_id | 任务 ID(与创建时返回的一致) |
output.task_status | PENDING 排队 / RUNNING 处理中 / SUCCEEDED 成功 / FAILED 失败 |
output.video_url | 生成视频的 URL,仅 SUCCEEDED 时返回,尽快下载转存 |
output.code / output.message | 仅失败时返回,失败原因 |
usage | 用量统计(时长、分辨率档位等),仅成功时计数 |
request_id | 请求唯一标识,排查问题时请提供 |
状态流转:PENDING → RUNNING → SUCCEEDED / FAILED。
计费
按实际生成时长(秒)计费,resolution 档位影响单价;任务失败不计费。单价见 模型页。
错误处理
创建阶段错误返回 {"code": "...", "message": "..."};任务内失败看轮询的 output.code / output.message。通用错误码见错误处理。