HappyHorse 1.0 API
HappyHorse 1.0 は OmniaKey 上の第 1 世代 HappyHorse 動画ファミリーで、1 枚のカードに操作ごとのモデル ID を載せています。happyhorse-1.0-t2v(テキストから)、happyhorse-1.0-i2v(最初のフレームから)、happyhorse-1.0-r2v(参照画像から)です。
- 利用可能なモデル ID
- happyhorse-1.0-t2vhappyhorse-1.0-i2vhappyhorse-1.0-r2v
- プロバイダー
- Alibaba
- 種別
- AIビデオ
- 出力 1 秒あたり
- $0.14–$0.24
- 最終確認済み
- 2026-09-14
01
向いている用途
既存の 1.0 ベースのパイプラインを再現したいときに使います。HappyHorse 1.1 は 720P が同額、1080P は安く、さらに 480P が加わります。
02
できること
テキストからビデオへ
happyhorse-1.0-t2v
テキストプロンプトから短い動画クリップを生成します。
画像からビデオへ
happyhorse-1.0-i2v
静止画を短い動画クリップに動かします。
参考動画
happyhorse-1.0-r2v
参照映像で生成クリップを誘導します。
03
呼び出し方
メディアモデルは非同期で動作します。タスクを作成し、完了までポーリングしてから、署名付きアセット URL をダウンロードします。
# 1. Create the job. 202 Accepted; the body carries the task id,
# the pre-charged price, and a poll_url. Reuse one Idempotency-Key
# across retries so a timeout never starts a second paid job.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks \
-H "Authorization: Bearer $OMNIAKEY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: happyhorse-1.0-001" \
-d '{
"model": "happyhorse-1.0-t2v",
"type": "video",
"operation": "text_to_video",
"input": {"prompt": "a paper boat on a quiet lake at sunset"},
"parameters": {"duration": 6, "resolution": "720p"}
}'
# 2. The operation picks the model id on this route:
# happyhorse-1.0-t2v prompt only
# happyhorse-1.0-i2v media[] type "first_frame"
# happyhorse-1.0-r2v media[] type "reference_image"
# 3. Poll GET /v1/media/tasks/{id} until status is
# succeeded | failed | canceled. Progress carries percent and stage.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks/TASK_ID \
-H "Authorization: Bearer $OMNIAKEY_API_KEY"
# 4. Download assets[0].url before expires_at, or poll again for a
# fresh signed URL. Failed and canceled jobs are refunded.
curl -sS -o out.mp4 "$(jq -r '.assets[0].url' result.json)"04
料金
動画ジョブはトークン単位ではなく、生成された出力の秒数に応じて課金されます。失敗またはキャンセルされたジョブは自動的に返金されます。
$0.14–$0.241 秒あたり
- 720P
- $0.141 秒あたり
- 1080P
- $0.241 秒あたり
Alibaba のその他のモデル
よくある質問
OmniaKey で HappyHorse 1.0 を呼び出すには?
モデル ID、type に "video"、operation に "text_to_video" を指定して /v1/media/tasks に POST します。最初のフレームから生成する場合は operation を "image_to_video" にし、input.media[](type を "first_frame" に) に渡します。再試行時は同じ Idempotency-Key を使うと、タイムアウトで二重の課金ジョブが作られません。
HappyHorse 1.0 の料金は?
HappyHorse 1.0 の料金は $0.14–$0.24 1 秒あたり です(生成された動画の長さに応じて課金)。作成時に指定した尺の分が前払い残高から事前に引き落とされ、失敗またはキャンセルされたジョブは自動的に返金されます。
なぜ API は動画ではなくタスク ID を返すのですか?
動画のレンダリングには 1 分から数分かかるため、OmniaKey はすべての動画ルートを 1 つの非同期フローで処理します。GET /v1/media/tasks/{id} を succeeded になるまでポーリングし、署名付きアセット URL を読み取ってください。
