Skip to main content

HappyHorse テキスト動画生成 API リファレンス

HappyHorse モデルを使用して、テキストプロンプトから物理的にリアルで動きの滑らかな動画を生成します。

可用性

モデル、エンドポイント URL、API キーは同じリージョンに属している必要があります。リージョンをまたいだ呼び出しは失敗します。
このトピックのサンプルコードは、シンガポールリージョンに適用されます。
Alibaba Cloud Model Studio は、中国 (北京) およびシンガポールリージョン向けにワークスペース固有のドメインをリリースしました。新しい専用ドメインは、推論リクエストに対して優れたパフォーマンスと高い安定性を提供します。新しいドメインへの移行を推奨します:
  • 中国 (北京):https://dashscope.aliyuncs.com から https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com
  • シンガポール:https://dashscope-intl.aliyuncs.com から https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com
{WorkspaceId} は、Alibaba Cloud Model Studio コンソールの [ワークスペース詳細] ページで確認できるワークスペース ID です。既存のドメインも引き続き完全に機能します。

HTTP リクエスト

テキスト動画生成タスクは通常 1~5 分かかります。API は、「タスクの作成 → 結果のポーリング」という 2 つのステップからなる非同期呼び出しを使用します。

ステップ 1:タスクを作成し、タスク ID を取得

  • シンガポール
  • 米国 (バージニア)
  • 中国 (北京)
  • ドイツ (フランクフルト)
  • 日本 (東京)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis
{WorkspaceId} を実際の ワークスペース ID に置き換えてください。
  • タスクが作成された後、返された task_id を使用して結果をクエリします。task_id は 24 時間有効です。重複したタスクを作成しないでください。代わりに、ポーリングを使用して結果を取得してください。
  • 初心者向けのガイダンスについては、「Postman または cURL を使用した API 呼び出し」をご参照ください。

リクエストパラメーター

Content-Type string (必須)リクエストのコンテンツタイプ。application/json である必要があります。Authorization string (必須)Model Studio API キーでリクエストを認証します。例:Bearer sk-xxxx。X-DashScope-Async string (必須)非同期処理を有効にします。HTTP リクエストは非同期呼び出しのみをサポートします。enable である必要があります。
このリクエストヘッダーがない場合、「current user api does not support synchronous calls」というエラーが返されます。
リクエストボディ
model string (必須)モデル名。利用可能なモデルについては、Model Studio コンソールをご参照ください。例:happyhorse-1.1-t2v。input object (必須)モデルの入力。

プロパティ

prompt string (必須)生成する動画のテキスト説明。任意の言語をサポートします。最大 5,000 文字 (中国語以外) または 2,500 文字 (中国語)。超過分は切り捨てられます。
parameters object (任意)動画出力設定 (解像度、縦横比、持続時間)。

プロパティ

resolution string (任意)出力動画の解像度。有効値:
  • 480P
  • 720P
  • 1080P (デフォルト)
ratio string (任意)出力動画の縦横比。有効値:
  • 16:9 (デフォルト)
  • 9:16
  • 1:1
  • 4:3
  • 3:4
  • 4:5
  • 5:4
  • 9:21
  • 21:9
duration integer (任意)出力動画の持続時間 (秒)。
  • happyhorse-1.0-t2v:3~15。デフォルト:5。
watermark boolean (任意)ウォーターマークを追加するかどうか。右下に「HappyHorse」と表示されます。
  • true (デフォルト)
  • false
seed integer (任意)乱数シードは [0, 2147483647] の範囲の整数である必要があります。指定しない場合、ランダムなシードが生成されます。シードを固定すると、再現性が向上します。モデルの生成は確率的であるため、同じシードでも同一の結果が保証されるわけではありません。
  • テキスト動画生成
# 以下の URL はシンガポールリージョン用です。呼び出しの際は、{WorkspaceId} を実際のワークスペース ID に置き換えてください。URL はリージョンによって異なります。
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
    -H 'X-DashScope-Async: enable' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "model": "happyhorse-1.1-t2v",
    "input": {
        "prompt": "A miniature city built from cardboard and bottle caps comes to life at night. A cardboard train slowly passes through, with small lights dotting the scene and illuminating the way ahead."
    },
    "parameters": {
        "resolution": "720P",
        "ratio": "16:9",
        "duration": 5
    }
}'

レスポンスパラメーター

output objectタスクの出力情報。

プロパティ

task_id stringタスク ID。24 時間クエリに有効です。task_status stringタスクのステータス。

列挙値

  • PENDING
  • RUNNING
  • SUCCEEDED
  • FAILED
  • CANCELED
  • UNKNOWN:タスクが存在しないか、ステータスが不明です。
request_id stringトレースとトラブルシューティングのためのユニークなリクエスト識別子。code stringエラーコード。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。message string詳細なエラーメッセージ。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。
  • 成功レスポンス
  • エラーレスポンス
task_id を保存して、タスクのステータスと結果をクエリします。
{
    "output": {
        "task_status": "PENDING",
        "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
    },
    "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}

ステップ 2:タスク ID で結果をクエリ

  • シンガポール
  • 米国 (バージニア)
  • 中国 (北京)
  • ドイツ (フランクフルト)
  • 日本 (東京)
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}
  • ポーリングの推奨事項:動画生成には数分かかります。15 秒などの適切な間隔でポーリングメカニズムを使用してください。
  • タスク状態の遷移:PENDING → RUNNING → SUCCEEDED または FAILED。
  • 結果リンク:タスクが成功すると、24 時間有効な動画 URL が返されます。動画をダウンロードし、OSS などの永続ストレージに保存してください。
  • task_idの有効期間:24 時間。この期間を過ぎると、クエリはタスクのステータスを UNKNOWN として返します。

リクエストパラメーター

ヘッダー
Authorization string (必須)Model Studio API キーでリクエストを認証します。例:Bearer sk-xxxx。
パスパラメーター
task_id string (必須)タスクの ID。
  • クエリタスクの結果
{task_id} を前の API 呼び出しで返された task_id の値に置き換えてください。task_id は 24 時間クエリに有効です。{WorkspaceId} を実際の ワークスペース ID に置き換えてください。
curl -X GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

レスポンスパラメーター

outputobjectタスクの出力情報。

プロパティ

task_id stringタスク ID。24 時間クエリに有効です。task_status stringタスクのステータス。

列挙値

  • PENDING
  • RUNNING
  • SUCCEEDED
  • FAILED
  • CANCELED
  • UNKNOWN:タスクが存在しないか、ステータスが不明です。
ポーリング中の状態遷移:
  • PENDING → RUNNING → SUCCEEDED または FAILED。
  • 最初のクエリステータスは通常 PENDING または RUNNING です。
  • ステータスが SUCCEEDED に変わると、レスポンスには生成された動画の URL が含まれます。
  • ステータスが FAILED の場合は、エラーメッセージを確認してタスクをリトライしてください。
submit_time stringタスクが送信された時刻。時刻は UTC + 08:00 で、フォーマットは YYYY-MM-DD HH:mm:ss.SSS です。scheduled_time stringタスクが実行された時刻。時刻は UTC + 08:00 で、フォーマットは YYYY-MM-DD HH:mm:ss.SSS です。end_time stringタスクが完了した時刻。時刻は UTC + 08:00 で、フォーマットは YYYY-MM-DD HH:mm:ss.SSS です。video_url string生成された動画の URL。task_status が SUCCEEDED の場合にのみ返されます。24 時間有効です。動画は MP4 フォーマットで、H.264 エンコーディングです。orig_prompt string元の入力プロンプト。リクエストパラメーターの prompt に対応します。code stringエラーコード。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。message string詳細なエラーメッセージ。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。
usage object出力統計。成功したタスクのみがカウントされます。

プロパティ

input_video_duration integer入力動画の持続時間 (秒)。output_video_duration integer出力動画の持続時間 (秒)。duration integer課金対象の合計動画持続時間。SR integer出力動画の解像度。ratio string出力動画の縦横比。video_count integer出力動画の数。常に 1 です。
request_id stringトレースとトラブルシューティングのためのユニークなリクエスト識別子。
  • タスク成功
  • タスク失敗
  • タスククエリの期限切れ
動画 URL は 24 時間のみ有効で、その後自動的にパージされます。生成された動画は速やかに保存してください。
{
    "request_id": "99243b47-ec5f-9413-9993-xxxxxx",
    "output": {
        "task_id": "4673458e-28be-4a05-bf2a-xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2026-04-20 17:55:17.075",
        "scheduled_time": "2026-04-20 17:55:17.129",
        "end_time": "2026-04-20 17:56:36.658",
        "orig_prompt": "A miniature city built from cardboard and bottle caps comes to life at night. A cardboard train slowly passes through, with small lights dotting the scene and illuminating the way ahead.",
        "video_url": "https://dashscope-result.oss-cn-beijing.aliyuncs.com/xxx.mp4?Expires=xxx"
    },
    "usage": {
        "duration": 5,
        "input_video_duration": 0,
        "output_video_duration": 5,
        "video_count": 1,
        "SR": 720,
        "ratio": "16:9"
    }
}

エラーコード

API 呼び出しが失敗した場合に返されるエラーコードについては、「エラーメッセージ」をご参照ください。