跳转到内容
HiAPI Docs
HiAPI
中文
English 中文

Wan 2.7 文生视频

概览

Section titled “概览”
提供商阿里巴巴
模型名称wan2.7-t2v
主要端点/v1/videos
返回形式先返回 id，再轮询结果
典型能力文生视频、横竖屏短片、叙事镜头、通用宣传视频

Wan 2.7 T2V 是比较通用的文生视频模型，适合直接从文本脚本生成成片，兼顾横屏和竖屏内容。

适用场景

Section titled “适用场景”
  • 竖屏短视频、活动开场片、产品故事片
  • 横版宣传片或介绍视频
  • 先写脚本，再快速验证镜头效果的内容团队
  • 需要统一文生视频接口的产品流程

端点

Section titled “端点”
  • POST /v1/videos
  • GET /v1/videos/{id}

关键参数

Section titled “关键参数”
参数类型说明
modelstring固定为 wan2.7-t2v
promptstring描述主体动作、环境、镜头和节奏
secondsstring可选 "3"、"5"、"8"、"10"、"15"
sizestring例如 1920*1080、1080*1920、1280*720

请求示例

Section titled “请求示例”
Terminal window
curl -X POST https://api.hiapi.ai/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-t2v",
    "prompt": "A Shiba Inu chasing butterflies under cherry blossoms, handheld camera, soft spring light, lively motion",
    "size": "1920*1080",
    "seconds": "5"
  }'

响应示例

Section titled “响应示例”
{
  "id": "video_task_401",
  "object": "video",
  "status": "processing"
}

异步与轮询

Section titled “异步与轮询”

使用 GET /v1/videos/{id} 轮询结果。拿到最终 URL 前，建议前端展示排队或处理中状态。

常见错误

Section titled “常见错误”
  • 400 Bad Request：prompt 为空，或 size、seconds 不受支持。
  • 401 Unauthorized：鉴权失败。
  • 429 Too Many Requests：队列繁忙。
  • 500 或任务失败：镜头描述过长或矛盾时可能失败，建议先精简提示词。

定价说明

Section titled “定价说明”

Wan 2.7 T2V 的实时价格请查看实时定价页。部分规格会按分辨率或时长倍率计费。

下一步

Section titled “下一步”