HappyHorse 1.1 参照から動画 API：料金とコード

Name: HappyHorse 1.1 API
SKU: alibaba/happyhorse-1.1/reference-to-video
Price: 1.05 USD
Availability: InStock

このガイドは今のところ英語のみです。 →

リクエストパラメーター

パラメーター	必須	説明
`aspect_ratio`	いいえ	画面の形：横長、正方形、縦長。 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 4:5 · 5:4 · 9:21 · 21:9 · デフォルト: 16:9
`duration_seconds`	いいえ	動画の長さ。1秒ごとに課金されます。 ≥ 3 · ≤ 15 · デフォルト: 5
`prompt`	はい	Describe the scene, action, camera movement, and timing.
`reference_image_urls`	はい	結果に残したい人物・衣装・場所の参照画像。
`resolution`	いいえ	出力サイズ。大きいほど鮮明で、料金も上がります。 720p · 1080p · デフォルト: 720p
`seed`	いいえ	同じ数字を使えば、同じ結果を再現できます。 ≥ 0 · ≤ 2147483647

料金

料金はクレジットで表示され、サイトで使うクレジットと同じです（1クレジット = $0.01）。タスクの受付時に保留され、完了時に実際の料金で精算されます。失敗したタスクは返金されます。

オプション	クレジット /秒	≈ USD
resolution 720p	21	$0.21
resolution 1080p	27	$0.27

実行前に正確な金額を知りたいときは、同じボディを POST /jobs/quote に送ってください。

API クイックスタート

HappyHorse 1.1 API を 3 ステップで呼び出す

API キーを作成する. PopNow にログインし、API コンソールでキーを作成します。キーは sk-popnow- で始まり、サイトと同じクレジットを使います。
リクエストを送る. POST /jobs/createTask に、model を alibaba/happyhorse-1.1/reference-to-video、input をパラメーター表どおりにして送ります。レスポンスですぐにタスク ID が返ります。
結果を受け取る. タスク ID で GET /jobs/recordInfo をポーリングするか、callBackUrl を渡せば結果がそこへ送られます。タスクが成功したら出力リンクからダウンロードします。

# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "alibaba/happyhorse-1.1/reference-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "reference_image_urls": [
      "https://media.popnow.ai/influencer/examples/ava.webp"
    ],
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration_seconds": 5
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

プロンプトとリンクはご自身のものに置き換えてください。API タブにレスポンス、ポーリング、コールバックのリファレンスがあります。

HappyHorse 1.1 API についての質問

HappyHorse 1.1 API の料金はいくらですか？

HappyHorse 1.1の最安は参照から動画で、105クレジット（$1.05）/ 5秒の動画からです。オプション別の料金：720p 21クレジット/秒、1080p 27クレジット/秒。クレジットはサイトと共通（1クレジット = $0.01）で、新規アカウントには30クレジットが付き、失敗したタスクは返金されます。

API でのHappyHorse 1.1のモデル名は？

POST /jobs/createTask の model フィールドに動画を作成は alibaba/happyhorse-1.1/text-to-video；画像から動画は alibaba/happyhorse-1.1/image-to-video；参照から動画は alibaba/happyhorse-1.1/reference-to-video を指定します。

HappyHorse 1.1 は参照画像を何枚まで受け取れますか？

reference-to-video で 1〜9 枚、そしてそこでは必須のフィールドです。プロンプトが指す順に送り、1 枚につき役割を 1 つにしてください。同じ被写体の重なった 9 アングルは、整合されるのではなく平均されます。

使えるアスペクト比は？

9 種です。16:9、9:16、1:1、4:3、3:4、4:5、5:4、9:21、21:9 で、既定は 16:9 です。text-to-video と reference-to-video で公開されています。image-to-video は開始フレームから形を受け取ります。

HappyHorse 1.1 は音声を生成しますか？

はい。3 つのエンドポイントのどれにも音声フィールドはありませんが、クリップには生成された音声トラックが付いて返るため、オフにする方法はありません。欲しい音はプロンプトで描写し、自前のミックスの下に敷くときは編集でトラックをミュートするか差し替えてください。

クリップの最後のフレームを固定できますか？

できません。image-to-video に終了フレームのフィールドはなく、あるのは image_url だけです。特定の構図に着地させたいなら、その構図を逆方向の動きの開始フレームにするか、編集でそこへカットしてください。

対応している解像度は？

720p と 1080p で、どのエンドポイントでも既定は 720p です。720p で下書きし、採用するテイクを 1080p で回し直してください。回すたびに別のテイクが描かれるので、同じ絵が戻ることは期待せず、文言のほうを固定します。

HappyHorse 1.1 API の制限は？

動画の長さ：3–15 s；解像度：720p · 1080p；アスペクト比：16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 4:5 +3；参照画像：9；プロンプトの長さ（文字）：2,500。この範囲を超えるリクエストは、課金される前に拒否されます。

コードを書かずにHappyHorse 1.1を試せますか？

はい。Playground なら API キーなしで、PopNow のクレジットでHappyHorse 1.1を実行でき、実行ごとに対応するコードが表示されます。

HappyHorse 1.1 についてさらに

試す: HappyHorse 1.1 のAI動画生成をオンラインで PopNow で HappyHorse 1.1 を使って動画を作る
ドキュメント: API ドキュメントの HappyHorse 1.1 モデル ID と入力スキーマ PopNow API クイックスタート：5 分で最初のリクエスト PopNow API 画像から動画ガイド Webhook：ポーリングせずに HappyHorse 1.1 の結果を受け取る