HappyHorse 1.1 API

HappyHorse 1.1 参照から動画 は、1〜9 枚の参照画像から 1 つのショットを組み立てます。画像はプロンプトが言及する順に reference_image_urls で送ります。720p か 1080p、3〜15 秒の整数長で、9 種類のアスペクト比から選べ、生成されたサウンドトラックが付きます。参照は画像のみで、動画や音声の参照は受け付けません。

開始素材に応じてモードを選ぶ

順番付きの 9 つの枠

最大 9 枚の画像があれば、1 回のリクエストでキャラクター、衣装の各パーツ、乗り物、場所、小道具を固定できます。rider-jacket-bike-station の例は 3 枚の静止画で、ライダー、前を開けたジャケット、バイク、給油所をテイク間で同じに保ち、3:4・720p で生成しています。そのためプロンプトは動作と光を書くだけで済みます。

顔・小道具・場所を 1 テイクで

three-plate-corridor の例は、画像ごとに別の役割を与えています。女性、彼女が持つチェリーレッドのギター、ネオンのモーテルの廊下です。プロンプトはどの画像が何かを示したうえで、顔、小道具、場所がすべて同時に保たれなければならない、後退しながら追う 1 テイクを求めています。

このエンドポイントでも 9 種類の画面比率

aspect_ratio は 16:9 を既定とする 9 種類の値を持ち、1:1、4:5、5:4 も含まれます。product-in-place の例は 1080p の正方形で、1 枚目の画像のキャンドルジャーを 2 枚目の大理石の棚に置き、棚に差す窓の光に合わせて照らしています。

製品をその場所に置く

製品と場所を別々の画像として送り、両者の関わりを書きます。product-in-place では、芯に火がつき一筋の煙が立ちのぼるにつれてカメラがゆっくり寄り、炎の暖かな光が大理石とリネンに 2 つ目の光を加えます。

シリーズを通して同じキャストと衣装を保つ

すべてのショットで同じ参照セットを使えば、演者、衣装、乗り物がテイクごとに変わりません。プロンプトで変えるのは動作の行だけにします。画像は毎回同じ順で送り、位置による呼び方が正しい画像を指し続けるようにしてください。

検閲なしの表現や作り込んだキャラクター表現

image-to-video と同じく、この経路は渡された画像に従います。text-to-video では拒否される検閲なしのキャラクター表現も、キャスト、衣装、場所をそれぞれ専用の画像で固定した参照セットから始められます。

# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
  -d '{
  "model": "alibaba/happyhorse-1.1/reference-to-video",
  "input": {
    "aspect_ratio": "16:9",
    "duration_seconds": 5,
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "reference_image_urls": [
      "https://example.com/reference.png"
    ],
    "resolution": "720p"
  }
}'

# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

認証、完全なスキーマ、ポーリング、エラー処理は API リファレンスを参照してください。