エージェントツールから Token Plan の動画生成モデルを呼び出し、非同期タスクを送信して、生成が完了したら動画をダウンロードします。
サポートされているモデル
| モデル | 入力 | 説明 |
|---|---|---|
happyhorse-1.1-t2v | テキスト | テキストから動画生成 |
happyhorse-1.1-i2v | 先頭フレーム画像、テキスト | 画像から動画生成 |
happyhorse-1.1-r2v | 参照画像、テキスト | 参照から動画生成 |
wan3.0-video | テキスト、画像、または参照資料 | オールインワン動画生成 |
前提条件
- Token Plan サブスクリプションと、
sk-sp-で始まる API キー。詳細については、統合の概要 をご覧ください。 - Python 3.9 以降。
- お使いの AI コーディングツールが Slash Commands をサポートしていること。他のツールの設定パスについては、その他のツール をご覧ください。
インターフェース
タスクの送信: 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 を追加します。
ステップ1:スラッシュコマンドの作成
Token Plan APIキーを環境変数 $ANTHROPIC_AUTH_TOKEN に設定します。
プロジェクトルートに .claude/commands/text-to-video.md を作成し、以下の内容を追加します:
ステップ2: 動画を生成する
Claude Code で、/text-to-video a white cat sitting on a balcony in the sun と入力します。再生時間、解像度、またはアスペクト比を調整するには、コマンドで指定します。例: /text-to-video generate a 10-second, 1080P, 9:16 city night scene。
リクエストパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
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 時間有効です。 - サポートされる入力タイプ、解像度、長さ、アスペクト比はモデルによって異なります。各モデルのドキュメントを参照してください。
- 動画生成は、画像生成や音声合成よりも多く消費します。実際の Credits 消費量は、コンソールの Usage に表示されます。