在 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.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis
查詢任務:GET https://token-plan.ap-southeast-1.maas.aliyuncs.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 小時。 - 不同模型支援的輸入類型、解析度、時長和長寬比不同,以對應模型文件為準。
- 影片生成消耗高於圖片和語音合成,以主控台用量統計為準。