happyhorse-1.1-i2v API

正確なモデル ID happyhorse-1.1-i2v を使用します。モデル フィールドはこのページと正確に一致する必要があります。

サンプル出力happyhorse-1.1-i2vPOST /v1/videos5.2s

パラメータ: duration=5resolution=1080pratio=16:9入力画像

プロンプト： One continuous take, no cuts. The braided steam keeps thickening until the ribbons lock into one coral and ultraviolet serpent that uncoils along the ceiling, drops down past the stools and pours out through the open door into the rain, the cook in the orange jacket stepping back to let it pass. The camera holds at counter height, then tracks with the serpent to the doorway and tilts to watch it leave. One hard tungsten bulb overhead stays the only warm source. Real weight and inertia, visible density in the steam, no text.

入力メディア URL が置き換えられた、このサンプルを生成したリクエスト

{
  "model": "happyhorse-1.1-i2v",
  "prompt": "One continuous take, no cuts. The braided steam keeps thickening until the ribbons lock into one coral and ultraviolet serpent that uncoils along the ceiling, drops down past the stools and pours out through the open door into the rain, the cook in the orange jacket stepping back to let it pass. The camera holds at counter height, then tracks with the serpent to the doorway and tilts to watch it leave. One hard tungsten bulb overhead stays the only warm source. Real weight and inertia, visible density in the steam, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "1080p",
  "ratio": "16:9",
  "aspect_ratio": "16:9",
  "image": "https://example.com/input-image.png"
}

認証とエンドポイント

https://modelflare.dev/v1 で Modelflare API キーを使用します。ゲートウェイのエントリ ポイントは POST /v1/videos です。

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

タスクの作成

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.1-i2v",
    "input": {"prompt": "The cat runs across the grass as the camera follows smoothly.", "media": [{"type": "first_frame", "url": "https://example.com/cat.png"}]},
    "parameters": {"resolution": "1080P", "duration": 5, "watermark": false}
  }'

ポーリングとダウンロード

タスクIDを保存します。 GET /v1/videos/{task_id} をポーリングし、GET /v1/videos/{task_id}/content でダウンロードします。結果 URL は有効期限が切れている可能性があるため、速やかにファイルを転送してください。

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

リクエストメモ

HappyHorse は input.prompt を使用します。 t2v、i2v、または r2v モデル ID に一致する input.media シェイプを選択します。

リクエストパラメータ

HappyHorse I2V は input.media に first_frame 画像を 1 つ配置します。

フィールド	必須	注意事項
model	はい	happyhorse-1.1-i2v
input.prompt	いいえ	オプションのモーションとカメラの説明、最大 5,000 文字（中国語以外）または 2,500 文字
input.media[]	はい	1 つだけ first_frame。パブリック URL または Base64 データ URL、20 MB 未満、最小 300 ピクセルの辺、1:2.5 ～ 2.5:1 のアスペクト比
parameters.resolution	いいえ	720P / 1080P、デフォルトは1080P
parameters.ratio	いいえ	サポートされていません。出力は最初のフレームの画像比率に従います
parameters.duration	いいえ	3 ～ 15 秒、デフォルトは 5
parameters.watermark	いいえ	HappyHorseウォーターマークを追加するかどうか
parameters.seed	いいえ	0 ～ 2,147,483,647 のオプションのシード

入出力制限

I2V は 1 つの first_frame イメージを使用します。最小辺 300 ピクセル、アスペクト比 1:2.5 ～ 2.5:1 の 20 MB 未満のパブリック URL または Base64 データ URL を受け入れ、入力比をほぼ維持します。

エラーと失敗したタスク

無効なモデル パラメーターは、リクエスト ID を含む 4xx を返します。非同期タスクは、作成が成功した後に失敗することもあります。ポーリング応答からの error_code と error_message を最終タスク理由として使用します。異なる JSON 形式で同じリクエストを再試行しないでください。

サポート範囲

このページでは、Modelflare モデルの生成と編集呼び出しについて説明します。検索またはマップのエンリッチメント、音声管理、および要素ライブラリ管理は、このパブリック モデル呼び出しサーフェスの外部にあるリソース API であり、必須のリクエスト フィールドではありません。

価格設定と請求

動画秒単位課金モデルです。現在の顧客価格、参考定価、完全な仕様については、モデル価格ページを参照してください。

ノート

このページでは、Modelflare のパブリック インターフェイスについて説明します。ここに示されているフィールドと制限は現在の契約です。