在 Agent 工具中调用 Token Plan 视频生成模型,提交异步任务并在生成完成后下载视频。
支持的模型
| 模型 | 输入 | 说明 |
|---|---|---|
happyhorse-1.1-t2v | 文本 | 文生视频 |
happyhorse-1.1-i2v | 首帧图片、文本 | 图生视频 |
happyhorse-1.1-r2v | 参考图片、文本 | 参考生视频 |
wan3.0-video | 文本、图片或参考素材 | 全能视频生成 |
前提
- 已订阅 Token Plan,并获取以
sk-sp-开头的 API Key。获取方式见接入概览。 - 本地已安装 Python 3.9 及以上版本。
- 使用的 AI 编程工具支持 Slash Command。其他工具的配置路径见其他工具。
接口
提交任务:POST https://token-plan.maas.qianwenaiapi.com/api/v1/services/aigc/video-generation/video-synthesis
查询任务:GET https://token-plan.maas.qianwenaiapi.com/api/v1/tasks/{task_id}
请求头使用 Authorization: Bearer $ANTHROPIC_AUTH_TOKEN。提交任务时还需要 X-DashScope-Async: enable。
步骤一:创建 Slash Command
将套餐 API Key 配置为环境变量 $ANTHROPIC_AUTH_TOKEN。
在项目根目录创建 .claude/commands/text-to-video.md,写入以下内容:
步骤二:生成视频
在 Claude Code 中输入 /text-to-video 一只白色的猫在阳台上晒太阳。如需调整时长、分辨率或宽高比,在指令中写明即可,例如 /text-to-video 生成 10 秒、1080P、9:16 的城市夜景。
请求参数
| 参数 | 必选 | 说明 |
|---|---|---|
model | 是 | 视频生成模型 ID。 |
input.prompt | 是 | 视频描述。 |
parameters.resolution | 否 | 分辨率,支持 480P、720P、1080P,默认 1080P。 |
parameters.ratio | 否 | 宽高比,支持 16:9、9:16、1:1 等,默认 16:9。 |
parameters.duration | 否 | 时长,取值范围 3 到 15 秒,默认 5 秒。 |
返回结果
- 提交任务后返回
output.task_id和output.task_status。 - 轮询
GET /api/v1/tasks/{task_id},状态为SUCCEEDED时返回output.video_url。 - 任务状态包括
PENDING、RUNNING、SUCCEEDED、FAILED、CANCELED和UNKNOWN。 - 视频 URL 有时效,生成后及时下载。
限制
- 视频生成是异步任务,提交后需要轮询结果。
task_id有效期为 24 小时。 - 不同模型支持的输入类型、分辨率、时长和宽高比不同,以对应模型文档为准。
- 视频生成消耗高于图像和语音合成,具体以控制台用量统计为准。