はじめに
HunyuanVideo 1.5 Image to video は、写真 1 枚を 480p / 720p の 5 秒または 8 秒のクリップに動かします。HunyuanVideo 1.5 は Tencent が公開しているオープンな 8.3B パラメータの動画モデルです。クリップは写真の形を保ち、プロンプトは任意で、プラットフォームがコンテンツフィルターを加えることはありません。
手元の素材に合わせてモードを選ぶ
| 手元にあるもの | モード |
|---|---|
| 文章による説明 | HunyuanVideo 1.5 Text to video |
| 動かしたい写真 | HunyuanVideo 1.5 Image to video |
主な機能とハイライト
動いても崩れない顔
私たちのテストでは、写真の人物はクリップを通して顔、髪、衣装を保ちました。
どんな形でも
アスペクト比のフィールドはなく、縦長、正方形、横長のどの写真も、それぞれの形のまま返ってきます。
プロンプトは任意
写真だけを送ればモデルが動きを決めます。次の瞬間を自分で書いて指定することもできます。
検閲なし
写真にもプロンプトにもクリップにもフィルターはありません。私たちのテストでは、コンテンツのプローブの大半は書いたとおりに描画され、最も強いものはシーンの一部が控えめになりました。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | いいえ | 任意です。その人が次に何をするか、カメラがどう動くかを書きます。 1 文字以上 |
image_url | はい | 開始フレームです。クリップはこの写真から始まり、アスペクト比も引き継ぎます。 |
resolution | いいえ | 480p か 720p(既定)です。720p は 1 秒あたり 2 倍の料金で、形は写真に従います。 |
duration_seconds | いいえ | 5 秒または 8 秒で、1 秒単位で課金されます。 |
seed | いいえ | プロンプトを変えながら、実行結果を比べやすくします。フレームまで同一のクリップになることは保証しません。 |
料金
選んだ解像度での出力 1 秒単位で課金されます。写真の形によって料金は変わりません。
| 仕様 | 料金 |
|---|---|
| $0.024 / 秒 |
| $0.048 / 秒 |
ユースケース
動くポートレート
ヘッドショットが微笑んだり、歌ったり、カメラに振り向いたりします。
商品・ファッションのスチル
カタログ写真に、布の動き、カメラのドリフト、振り向きを加えます。
フィルターなしで、ユーザーの画像を動かす
ユーザー自身の画像を、コンテンツフィルターなしで動かします。成人のみが対象です。
プロンプトガイドと実践のヒント
次の瞬間を書く
写真に写っているものではなく、撮影のあとにその人が何をするかを書きます。
変えたくないものを伝える
衣装や小物を変えたくない場合は、プロンプトでそう明記します。
1 人のほうが扱いやすい
2 人が触れ合うと絡みやすくなります。動きをゆっくりにしてください。
きれいな公開リンクを使う
画像は直接ダウンロードできる必要があります。ログインが必要なリンクは失敗しますが、課金はされません。
API クイックスタート
# 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": "tencent/hunyuan-video-1.5/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"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 リファレンスを参照してください。








