はじめに
HunyuanVideo 1.5 Text to video は、文章のプロンプトから短いクリップを生成します。HunyuanVideo 1.5 は Tencent が公開しているオープンな 8.3B パラメータの動画モデルで、このエンドポイントは 480p / 720p・横長 / 縦長の 5 秒または 8 秒を返し、アーティファクト対策のネガティブプロンプトも使えます。プラットフォームがプロンプトやクリップにコンテンツフィルターを加えることはありません。
手元の素材に合わせてモードを選ぶ
| 手元にあるもの | モード |
|---|---|
| 文章による説明 | HunyuanVideo 1.5 Text to video |
| 動かしたい写真 | HunyuanVideo 1.5 Image to video |
主な機能とハイライト
小さなモデルで自然な人物
パラメータ数は 8.3B ですが、私たちのテストでは顔、肌、髪、布が写真のように見え、崩れずに動きました。
4 種類のフレームサイズ
aspect_ratio と resolution の組み合わせで 832 x 480、480 x 832、1280 x 720、720 x 1280 になり、縦型のクリップも切り抜きではなく、画面に合わせた構図で作られます。
ネガティブプロンプト
絶対に見たくないものを並べます。余計な文字、歪んだ手、ブレをすばやく抑えるのに最適です。
検閲なし
プロンプトにも結果にもフィルターはありません。私たちのテストでは、コンテンツのプローブの大半は書いたとおりに描画され、最も強いものはシーンの一部が控えめになりました。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 画面に誰がいて、何を着て何をするか、カメラがどう動くかを書きます。1 本のクリップに 1 つの明確な動作を入れるのがいちばん効果的です。 1 文字以上 |
negative_prompt | いいえ | 任意です。"blurry, distorted hands, extra limbs, text, watermark" のように、映したくないものを並べます。 |
aspect_ratio | いいえ | 横長は 16:9(既定)、縦長は 9:16 です。画面の形で料金は変わりません。 |
resolution | いいえ | 480p(832 x 480)か 720p(1280 x 720、既定)です。720p は 1 秒あたり 2 倍の料金なので、下書きは 480p で行ってください。 |
duration_seconds | いいえ | 5 秒または 8 秒で、1 秒単位で課金されます。 |
seed | いいえ | 1 つずつ条件を変えながら、実行結果を比べやすくします。フレームまで同一のクリップになることは保証しません。 |
料金
選んだ解像度での出力 1 秒単位で課金されます。アスペクト比によって料金は変わりません。
| 仕様 | 料金 |
|---|---|
| $0.024 / 秒 |
| $0.048 / 秒 |
ユースケース
縦型のソーシャルクリップ
フィードやストーリーズ向けの 720 x 1280、9:16 です。
プロンプトの試行錯誤
480p なら 5 秒の下書きが安く済むので、アイデアを大きくする前に多くのプロンプトを試せます。
自社プラットフォーム向けの無フィルターのクリップ
プロンプトにもクリップにもコンテンツフィルターはなく、画面に登場するのは成人のみです。
プロンプトガイドと実践のヒント
ショットを書く
被写体、衣装、動作、光、カメラの順に、2〜4 文で書きます。
1 本のクリップに動作は 1 つ
5 秒で収まるのは 1 つの仕草か 1 つの動きです。動作を連ねると、ぼやけてしまいます。
接触のあるシーンはシンプルに
2 人が触れ合うと手足が絡みやすくなります。動きをゆっくりにし、引きのショットにすると改善します。
小さく下書きする
アイデアを 480p で seed を固定して試し、良かったものを 720p で回し直します。
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/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"aspect_ratio": "16:9",
"duration_seconds": 5
}
}'
# 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 リファレンスを参照してください。








