Wan 3.0 と HappyHorse の動画 API

HopBase は、Alibaba Cloud Model Studio の動画生成を Alibaba 自身の DashScope 契約のまま、元のパスで提供します(Wan 3.0(万相 3.0)/ HappyHorse(快乐马) 1.1)。Alibaba 公式の SDK や HTTP コードは、base URL とキーだけを変更すれば移行できます。リクエストボディ、レスポンス形式、パスはすべて変わりません。

どちらのモデルファミリーも非同期です。まずタスクを送信し、その後 HopBase のタスク ID をポーリングします。Alibaba プランが有効なキーを使用し、課金対象の処理を送信する前に GET /v1/models で利用可能かどうかを確認してください。

エンドポイント

すべてのリクエストは Authorization: Bearer sk-your-key と Content-Type: application/json を使用します。X-DashScope-Async を送信する必要はありません。

モデル

上記の正確な ID を使用してください。エイリアスは登録されておらず、未知のモデル名は拒否されます。wan3.0-video-prime、happyhorse-1.1-video-edit、および HappyHorse 1.0 系列は提供されていません。

リクエスト契約

{
  "model": "wan3.0-video",
  "input": { "prompt": "...", "media": [{ "type": "first_frame", "url": "..." }] },
  "parameters": { "resolution": "1080P", "duration": 5 }
}

input

prompt が必須かどうかはモデルごとに異なり、Alibaba 自身の契約と一致しています。

長さ:Wan 3.0 は最大 20,000 文字を受け付けます。HappyHorse は非中国語の文字で最大 5,000 文字を受け付けます(中国語のテキストは実質 2,500 文字までに制限されます)。モデルの公式最大値を超えるプロンプトは 400 で拒否されます。

media の各要素は type と url を持ちます。

Wan 3.0 では、先頭/末尾フレーム入力と参照プラン(reference_*、file、link)は 1 つのリクエスト内で互いに排他的であり、さらに file と link も互いに排他的です。参照動画を指定した場合、Alibaba は入力動画の長さ + 出力の長さの合計を 30 秒以内に制限しますが、ゲートウェイは入力クリップの長さを計測できないため、これは Alibaba 側で強制されます。

url には、パブリックな絶対 http(s) URL、または data: URI(base64 埋め込み)を指定できます。oss:// のロケーターは拒否されます。そのオブジェクトはお客様自身の Alibaba Cloud アカウントに属するものであり、ゲートウェイからはアクセスできません。link は実際の Web アドレスである必要があり、data: 埋め込みは使用できません。

parameters

モデルが対応していないパラメータは無視されるのではなく拒否されます。省略したフィールドはまったく送信されないため、モデル自身のデフォルト値が適用されます。

例 — テキストから動画生成

curl https://api.hop-base.com/api/v1/services/aigc/video-generation/video-synthesis \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video",
    "input": { "prompt": "Aerial drone shot over snow mountains above a sea of clouds at sunrise" },
    "parameters": { "resolution": "1080P", "duration": 5, "ratio": "16:9" }
  }'

送信に成功すると 200 が返り、HopBase のタスク ID は Alibaba のレスポンス形式のまま output.task_id(blt… の形式)に入っています。

{ "output": { "task_id": "blt60x4115010d-d361-4bfc-b131-a382f1c400a5", "task_status": "PENDING" }, "request_id": "..." }

例 — 画像から動画生成

{
  "model": "happyhorse-1.1-i2v",
  "input": {
    "prompt": "The camera slowly pushes in, light drifting across the scene",
    "media": [{ "type": "first_frame", "url": "data:image/jpeg;base64,..." }]
  },
  "parameters": { "resolution": "720P", "duration": 5, "watermark": false }
}

タスクのライフサイクル

GET /api/v1/tasks/{task_id} をポーリングしてください。他のページの動画エンドポイントとは異なり、このパスには /api の前に /v1 が付かないことに注意してください。一覧取得のエンドポイントはないため、タスク ID はお客様側で管理してください。output.task_status(大文字)は PENDING → RUNNING → SUCCEEDED | FAILED と遷移し、終了状態はこの最後の 2 つのみです。それ以外の値は実行中として扱ってください。通常、1 本のクリップは 1〜5 分で完成します。長い Wan 3.0 のクリップはより時間がかかります。おおよそ 15 秒間隔でポーリングしてください。

成功した場合、レスポンスには output.video_url に出力 URL が含まれます。

{
  "output": {
    "task_id": "blt60x4115010d-d361-4bfc-b131-a382f1c400a5",
    "task_status": "SUCCEEDED",
    "video_url": "https://api.hop-base.com/...",
    "orig_prompt": "..."
  },
  "usage": { "video_count": 1, "duration": 5, "SR": 1080, "output_video_duration": 5, "input_video_duration": 0, "ratio": "16:9", "billed_seconds": 5, "billing_bucket": "1080p" }
}

output.video_url は api.hop-base.com 上の署名付き URL で、タスク完了時点から 6 時間有効です。再度照会しても同じ URL が返るだけで有効期限は延長されず、期限切れの URL は 410 を返すため、この時間内に結果をダウンロードしてください。usage.ratio は実際に生成されたアスペクト比を返しますが、リクエストの列挙値ではなく生の寸法(例:1632:937)になることがあります。

失敗したタスクは output.message に理由が示され、課金は一切発生しません。

{ "output": { "task_id": "blt60x...", "task_status": "FAILED", "code": "TaskFailed", "message": "..." } }

課金対象

Alibaba はどちらの系列についても、トークンではなく、解像度ティアによって異なる秒単位の単価で動画の長さに応じて課金します。1 リクエストあたりの課金額は usage.billed_seconds に usage.billing_bucket のレートを掛けたものです。usage.SR は生成された動画の解像度ティア(480 / 720 / 1080)を示し、これがレートを決定します。同じティアでも、2 つの系列でレートは異なります。

課金対象となる長さの範囲は両者で異なります。Alibaba は wan3.0-video について、出力だけでなく入力動画にも課金します。課金対象の長さ = 入力動画の長さ + 出力動画の長さとなり、usage.input_video_duration が課金秒数に加算されます。リクエストに動画入力が含まれない場合は 0.0 になります。happyhorse-1.1-* の各モデルは出力のみに課金され、参照から動画を生成する場合、Alibaba のドキュメントでは input_video_duration は固定で 0 と記載されています。

プラン

wan3.0-video と happyhorse-1.1-* の各モデルは、別々の 2 つのモデルファミリーであり、それぞれ別のプラン(万相 3.0 官方直连(Wan 3.0 公式直結)と 快乐马 1.1 官方直连(HappyHorse 1.1 公式直結))から提供されます。そのため、一方に紐づいたキーは他方には到達しません。GET /v1/models で、お使いのキーがどちらのプランに到達するかを確認してください。

料金

公式のリスト価格は料金ページに掲載されています。実際の適用レートはログイン後のモデルカタログに表示され、各リクエストの実際の課金額は利用量レコードで確認できます。