HiAPI
ブログ

使用ガイド

Seedance 2.0@ext ショート動画:ソーシャル向けショート動画のための実用的な API ワークフロー

seedance-2.0@ext の非同期タスク API を使って、詳細なプロンプト1本を縦型・音声付きの完成動画に変える

Aug 10, 2026
Seedance 2.0@ext ショート動画:ソーシャル向けショート動画のための実用的な API ワークフロー

今日、ソーシャルコンテンツの大多数はショート動画で発見されています。そして、きれいな縦型ショート動画は通常、撮影するか、編集するか、あるいはその両方を意味します。hiapi 上の seedance-2.0@ext はこれらの手順を飛ばします。詳細なプロンプトを書き、1つの API エンドポイントを呼び出せば、数分後には完成した 9:16 動画が——音声付きで——返ってきます。

この実践ガイドでは、実際に生成した1本のショート動画を使って、ワークフロー全体を最初から最後まで説明します。プロンプトがどのように構成されているか、非同期タスク API 呼び出しが実際にどう使われるか、いくらかかったか、そして価格設定がどこで期待と合わなくなるかです。

ショート動画に seedance-2.0@ext を選ぶ理由

seedance-2.0@ext は、hiapi 上の seedance-2.0 モデルファミリーの ext ルートです——独自の価格設定とパラメータセットを持つ独立したルートであり、デフォルトの seedance-2.0 ルートとは異なります。縦型のソーシャルネイティブな出力のために作られています:ネイティブな 9:16 構図、スマートフォンの画面で見栄えのするカメラワーク、そして後から付け足すのではなく動画と同じ生成の中で生み出される音声です。

この組み合わせ——縦型構図とネイティブ音声——こそが、汎用の動画モデルを使って後から自分でトリミングや音楽付けをするのではなく、TikTok や Reels 風のショート動画に適している理由です。

プロンプト:このショート動画が実際に使ったもの

本記事のために、端から端まで1本のデモショート動画を生成しました。氷で満たされたグラスにコールドブリューコーヒーを注ぐ縦型の製品クローズアップで、ソーシャルフィード向けのスタイルです。以下が実際の出力と、それを生成した元のプロンプトです。

ソーシャルフィード向けの縦型 9:16 製品クローズアップショーケース:すりガラスのグラスが、日差しの当たる大理石のカウンターの中央に置かれている。カメラは空のグラスの上からゆっくりと見下ろしながら寄っていき、グラスには透明な氷が満たされ、ゴールデンアワーの光を反射している。2秒目に、コールドブリューコーヒーが画面外の上方から注ぎ込まれ、渦を巻いて氷を暗くし、続いてミルクが柔らかな螺旋の筋となって染み込んでいく。水滴がガラスを伝って滑り落ち、冷気が逆光の中で上へと漂う。カメラは見下ろしから低角度の四分の三正面へとゆっくり弧を描いて移動し、やがて鮮明な浅い被写界深度のクローズアップで止まり、背景の窓の外には暖かなボケがにじむ。明るい自然なコマーシャル照明、光沢のある反射、浅い被写界深度、超クリーンな製品動画の美学、滑らかな手持ちの微細な動き、高級感のあるコマーシャル品質。ネイティブ音声:柔らかな注ぎの細い音、氷がガラスに当たる音、かすかなカフェの環境ノイズ、音楽なし。読み取れるテキストなし、ロゴなし、人物なし、手なし、カットなし。

結果:720×1280(9:16)、24fps、約8秒、ファイルにネイティブ AAC ステレオ音声を内蔵——別途のフォーリー工程は不要です。

このプロンプトが効果的な理由

このプロンプトは、より短く曖昧なプロンプトではやらないことをいくつか行っています:

  • カメラに単一の画ではなく経路を与えている。「見下ろしから寄る」→「低角度の四分の三正面へゆっくり弧を描いて移動」→「鮮明なクローズアップ」は、静的な構図ではなくショート動画全体を通した動きを描写しています。
  • 動作にタイミングを与えている。「2秒目に、コールドブリューコーヒーが注ぎ込まれる」は注ぎの動作を具体的な瞬間に固定し、モデルに「面白い部分」がいつ起こるべきかを推測させません。
  • 素材と光の手がかりを重ねている。水滴、冷気、暖かなボケ、光沢のある反射——これらの細部が製品ショットを平凡から高級へと引き上げます。
  • 音声が後付けではなくプロンプトに直接書かれている:注ぎの細い音、氷の当たる音、環境ノイズ、そして音楽は明示的に不要。モデルは音を上記で描写された視覚的動作に同期させます。
  • ネガティブリストで締めくくっている。「読み取れるテキストなし、ロゴなし、人物なし、手なし、カットなし」は、製品系の生成で最もよくある失敗パターンを事前に防ぎます。

プロンプトをキャプションの一文ではなく短いクリエイティブブリーフとして扱う——ここに出力品質の本当の差があります。

/v1/tasks API で再現する

seedance-2.0@ext は hiapi の非同期タスクエンドポイント経由で動作します。タスクを送信し、完了するまでポーリングし、レスポンスから動画を取り出します。

送信:

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0@ext",
    "input": {
      "prompt": "<your prompt>",
      "aspect_ratio": "9:16",
      "resolution": "720p",
      "duration": 8,
      "generate_audio": true
    }
  }'

prompt と aspect_ratio は必須です——aspect_ratio を省略すると、呼び出しは生成に到達する前に検証で失敗します。resolution、duration(4〜15秒)、generate_audio は任意です。上記の値は、本記事のショート動画を生成したときの設定に近いものです。

もしあなたが画像から動画への発想から来ているなら、注意すべき点があります。価格ページはこのモデルに画像から動画への料金を記載していますが、実際の入力スキーマはテキストプロンプトのみを受け付け、画像や参照フレームのフィールドは拒否されます。価格ラベルがどう書かれていようと、実際にはテキストから動画へのモデルです。

結果をポーリング:

curl https://api.hiapi.ai/v1/tasks/<task_id> \
  -H "Authorization: Bearer $HIAPI_API_KEY"

status が成功を報告したら、output[0].url が完成した .mp4 を指します。このリンクは一時的です——タスクレスポンスの有効期限ウィンドウに応じておよそ1週間——なので、直接リンクするのではなく、すぐにバイトをダウンロードして自分で保存してください。

価格設定:4K の奇妙な現象

seedance-2.0@ext は出力秒数に基づいて課金され、料率は解像度の階層によって変わります:

解像度 1秒あたりの価格
720p $0.149
1080p $0.373
2K $0.662
4K $0.467

このモデルでは 4K が 2K より安いことに注意してください——$0.467/秒 対 $0.662/秒。これは誤植でも一般的なパターンでもありません。ここのほとんどのモデルは解像度とともに価格が単調に上昇します。他のモデルもそうだと仮定せず、解像度ベースのコストロジックをパイプラインに書き込む前に /api/pricing を再確認してください。この種の階層は実際に調整されるからです。

参考までに、上記の8秒・720p のデモショート動画の生成には $1.19 かかりました——720p 階層での単純な 長さ × 1秒あたりの料率 計算です。

ショート動画が実際に配信される場所に合わせて解像度を選ぶ

わずか 720p → 1080p への切り替えでコストが約2.5倍になるので、何かを一括生成する前に、解像度は最初に検討すべきレバーです:

  • フィードとストーリーズ配信(TikTok、Reels、Shorts)はほぼ常にスマートフォンで視聴され、ピクセル密度は 1080p の実際の密度のはるかに一部にすぎません——720p はそこで通常見分けがつかず、最も安い階層です。
  • 1080p は、ショート動画がランディングページのヒーローに再利用されたり、スマートフォン画面より大きいサイズでレンダリングされる可能性のある有料配信で使われる可能性がある場合に価値があります。
  • 2K と 4K は、後工程で切り抜き、ズーム、手ぶれ補正を計画しているソース素材に適しています——余分な解像度は、目に見える画質劣化なしに再構図する余地を与えます。上記の価格表を踏まえると、この特定のモデルでは 4K が両者の中でよりお得な選択です。

よくある質問

seedance-2.0@ext はテキストから動画だけでなく、画像から動画もサポートしていますか? いいえ——価格ページはこのモデルに画像から動画への料金を記載していますが、ext ルートの実際の /v1/tasks スキーマはテキストプロンプトのみを受け付け、画像 URL、参照フレーム、参照動画のフィールドは拒否されます。プラットフォームのモデル一覧に別段の記載があるまでは、テキストから動画のみとして扱ってください。

生成するショート動画の長さを制御できますか? はい、任意の duration フィールドで、4〜15秒の整数を指定できます。省略するとモデルがデフォルト値を適用します。下流のテンプレートが特定の長さを期待する場合は、明示的に設定する方が安全です。

動画には自動で音声が付きますか? ネイティブ音声生成は任意の generate_audio フィールドで提供されます。希望する音声をプロンプトに直接書けば——上記の「柔らかな注ぎの細い音、氷がガラスに当たる音、かすかなカフェの環境ノイズ」のように——別途の音声工程なしで映像の動作に同期させられます。

4K は本当に 2K より安いのですか、それとも表示バグですか? これは本記事執筆時点(2026年8月)の現在の実際の価格であり、バグではありません——ただし解像度の価格設定は変わりうるので、コストモデルでこれに依存する前に /api/pricing と照らし合わせて確認してください。

返される動画 URL はどのくらい有効ですか? 完了したタスクの output[0].url は一時リンクで、タスクの有効期限メタデータに応じておよそ1週間有効です。長期的にリンクするのではなく、ファイルを自分でダウンロードして保存してください。

次に何をするか

このモデルの完全なパラメータ詳細と現在の価格設定については、seedance-2.0@ext モデルページと hiapi 価格ページをご覧ください。同じモデルをめぐるプロンプトパターンをもっと知りたい場合は、Seedance 2.0@ext プロンプトレシピにさらに実例があり、Seedance 2.0 によるショート動画の製品ショーケースでは、同じ非同期タスクワークフローを異なるクリエイティブブリーフに適用する方法を解説しています。

永続的なAIアーティファクトで開発を始める

APIキーを取得して、タスクベースの1つのAPIで画像・動画・音声モデルを呼び出せます。

APIドキュメントを読む