使用ガイド
Seedance 2.5 テキストから動画：hiapi API でショート動画クリップを構築する
実際のプロンプト、実際のクリップ、そしてそれを再現可能なショート動画パイプラインに変える非同期ワークフロー。
ショート動画は数の勝負です。TikTok、Reels、Shorts はいずれも投稿頻度を評価しますが、投稿ごとに B-roll 素材を手作業で撮影するのはスケールしません。Seedance 2.5 のテキストから動画エンドポイントなら、たった 1 回の API 呼び出しで、1 つのプロンプトが同期済み音声付きの完成した縦型クリップに変わります。カメラも、編集タイムラインも、別途のナレーション収録も不要です。
このガイドでは、私たちが hiapi API を通じてエンドツーエンドで生成した実際のクリップを一通り紹介します。正確なプロンプト、それを生み出した非同期ワークフロー、確認済みの料金、そして単発のクリップではなくショート動画のセットを制作するためのバッチ生産にそのまま使えるパターンです。3 つすべての seedance-2.5 エンドポイントの完全なパラメータリファレンスについては、完全な API ガイドをご覧ください。
ショート動画コンテンツがテキストから動画に適している理由
ショート動画プラットフォームが必要とするのは映画級の長さではなく、シームレスにループし、1 秒で視聴者を引きつける 6〜15 秒のクリップを安定して供給することです。seedance-2.5/text-to-video はまさにこのニーズに合致します：
- 1 本あたり最大 30 秒で、TikTok/Reels/Shorts 向けの 9:16 を含む 7 種類のアスペクト比に対応。
- ネイティブ音声同期——モデルはプロンプト内の動作に基づいて環境音や音声の手がかりを生成します。無音のクリップを生成して後から音声を当てるのではありません。
- プロンプトは 11 言語に対応しており、ショート動画キャンペーンをローカライズする場合に便利です。
- 2 段階の解像度（480p と 720p）があるため、低コストで下書きを生成し、実際に公開するクリップにだけ 720p の料金を支払えます。
実際のクリップを最初から最後まで
これはこのガイド用に私たちが生成したクリップです。カフェのショート動画向けに縦型で撮影した、ラテアートを注ぐ様子のクローズアップです。
私たちが送信した正確なプロンプト（未編集）：
バリスタの安定した手が、ステンレス製のミルクピッチャーから白い陶器のエスプレッソカップに蒸しミルクを注ぎ、ミルクの流れがリアルタイムで形成されるロゼッタのラテアートの渦に折り重なる。温かいゴールデンアワーの光がカウンターを斜めに横切り、背景のクロワッサンやペストリーは柔らかくぼけている。クローズアップの縦型構図、かすかな湯気、カフェの環境音。
パラメータ：aspect_ratio: "9:16"、resolution: "720p"、duration: 8。上記の出力は実際の未編集のタスク結果です——8.06 秒で、注ぐ音とカフェの環境のハミングはモデルが直接生成したもので、後から追加したものではありません。
API ワークフロー
seedance-2.5/text-to-video は hiapi の非同期タスク API で動作します——送信、ポーリング、ダウンロード。同期型の動画エンドポイントはなく、各クリップはバックグラウンドタスクです。
import time
import requests
API_KEY = "YOUR_HIAPI_KEY"
BASE = "https://api.hiapi.ai/v1"
def generate_clip(prompt: str, aspect_ratio: str = "9:16",
resolution: str = "720p", duration: int = 8) -> str:
submit = requests.post(
f"{BASE}/tasks",
headers={"Authorization": f"Bearer {API_KEY}"},
json={
"model": "seedance-2.5/text-to-video",
"input": {
"prompt": prompt,
"aspect_ratio": aspect_ratio,
"resolution": resolution,
"duration": duration,
},
},
timeout=30,
)
task_id = submit.json()["data"]["taskId"]
while True:
poll = requests.get(
f"{BASE}/tasks/{task_id}",
headers={"Authorization": f"Bearer {API_KEY}"},
timeout=30,
).json()["data"]
if poll["status"] == "success":
return poll["output"][0]["url"] # 一時リンク——すぐにダウンロード
if poll["status"] == "fail":
raise RuntimeError(poll)
time.sleep(5)
clip_url = generate_clip(
"バリスタの安定した手が、ステンレス製のミルクピッチャーから白い陶器のエスプレッソカップに蒸しミルクを注ぎ、"
"ミルクの流れがリアルタイムで形成されるロゼッタのラテアートの渦に折り重なる。温かいゴールデンアワーの光が"
"カウンターを斜めに横切り、背景のクロワッサンやペストリーは柔らかくぼけている。"
"クローズアップの縦型構図、かすかな湯気、カフェの環境音。"
)
# 出力 URL は期限切れになります（expireAt タイムスタンプ付き）——すぐにダウンロードし、
# 自分のストレージに永続化してください。ホットリンクとして保持しないでください
video_bytes = requests.get(clip_url, timeout=60).content
open("clip.mp4", "wb").write(video_bytes)
タスクのレスポンスには元のプロンプトがエコーされません——返るのは model、status、output、タイムスタンプのみです。そのため、後でクリップを再現したりバリエーションを作ったりする必要がある場合は、送信した内容を自分で記録しておいてください。
料金：2 段階、1080p はなし
hiapi の料金エンドポイントでリアルタイムに確認済み——seedance-2.5/text-to-video は出力秒数で課金され、解像度は 2 段階で、1080p の選択肢はありません：
| 解像度 | 1 秒あたりの価格 | 8 秒クリップ |
|---|---|---|
| 480p | $0.1395 | 約 $1.12 |
| 720p | $0.3019 | 約 $2.42 |
720p の 1 秒あたりの価格は 480p の約 2.2 倍です——まず 480p で下書きを生成し、プロンプトを練り上げてから 720p の料金だけを支払う価値があります。完全なパラメータと料金の詳細は seedance-2.5/text-to-video モデルページにあります。料金は 2026-08 時点で有効であり、変更される可能性があるため、大量生産の予算を立てる前にそのページを確認してください。
1 本だけでなく、ショート動画のセットを制作する
単一のクリップはデモにすぎませんが、コンテンツカレンダーにはバッチ生産が必要です。各クリップをプロンプトをキーとする冪等なタスクとして扱えば、クラッシュ後に再実行しても二重課金されません：
import hashlib
PROMPTS = [
"バリスタが蒸しミルクをエスプレッソカップに注ぎ、ロゼッタのラテアートが形成される。ゴールデンアワーの光、クローズアップの縦型構図。",
"新鮮なハンドドリップコーヒーがフィルターを通して滴り落ちるときに立ち上る湯気、カフェの窓から差し込む朝の光、縦型構図。",
"片手がコーヒー豆の袋を木製のスケールに軽く置き、豆が落ち着く。柔らかなカフェの雰囲気、クローズアップの縦型構図。",
]
def job_key(prompt: str) -> str:
return hashlib.sha1(prompt.encode()).hexdigest()[:12]
results = {}
for prompt in PROMPTS:
key = job_key(prompt)
if key in results: # このラウンドで既に生成済み
continue
results[key] = generate_clip(prompt, resolution="480p", duration=6)
# 各結果をすぐに永続化——上記のダウンロード手順を参照
まずセット全体を 480p で生成し、どのクリップが実際にキャンペーンに適しているか評価してから、勝ち残ったクリップだけを 720p で再実行します。単発制作ではなくバッチ生産が必要な場合、この 2 ラウンドの習慣がコスト面で最大のレバーになります。
Seedance 2.0 との比較
Seedance 2.0 を使ったことがあるなら、2.5 のテキストから動画の階層は同じ送信-ポーリング-ダウンロードのタスク形態を保っています——統合側の変更はありません。パイプラインを移行する前に知っておくべき実際の違いは次のとおりです：2.5 はデフォルトで各クリップにネイティブ音声同期を追加し、解像度の段階がよりシンプルです（480p/720p のみで、2.0 には追加の段階がありました）。ワークフローが 2.5 では提供されない解像度に依存している場合は、同等と仮定する前にそのモデル自身のページで現在の仕様を確認してください。
よくある質問
seedance-2.5/text-to-video は 1080p に対応していますか？ いいえ——2026-08 時点で、このモデルは 480p と 720p のみを提供しています。1080p の出力が必要な場合は、このエンドポイントを中心にパイプラインを構築する前にモデルカタログで対応モデルを探してください。
音声は本物ですか、それとも別途追加する必要がありますか？ モデルがタスクの一部として生成します——上記のデモクリップの注ぐ音とカフェの環境のハミングは後から追加したものではありません。ブランド固有の音楽やナレーションが必要な場合は、後から自分の音声を重ねることもできます。
1 本のクリップの生成にはどのくらい時間がかかりますか？ タスクの完了時間は長さと解像度によって変わります。おおよそ 1 本あたり数分程度で、固定の待機時間を仮定せず必ずポーリングしてください。
同じプロンプトを異なるプラットフォームでアスペクト比を変えて再利用できますか？
はい——aspect_ratio はプロンプトとは別のパラメータなので、同じプロンプトをシーン記述を書き直すことなく、TikTok/Reels 向けに 9:16 で、YouTube 向けに 16:9 で再送信できます。
ダウンロードする前に出力 URL が期限切れになった場合はどうなりますか？
タスクを再送信する必要があります——output[0].url は expireAt タイムスタンプに紐づく一時リンクであり、永久ストレージではありません。タスクが success を報告したらすぐに各クリップをダウンロードして永続化してください。
要点
seedance-2.5/text-to-videoはショート動画コンテンツ向けのプロンプト入力・クリップ出力エンドポイントです——下書きやソーシャル向けのつなぎコンテンツには 480p、クリップが最終アセットになる場合は 720p を選びましょう。- 予算はクリップ単位ではなく秒数単位で立てましょう：720p は 1 秒あたりのコストが 480p の約 2.2 倍なので、8 秒の 720p クリップはすでに約 $2.42 かかります。
- タスクの出力 URL は期限切れになります——ポーリングが成功したらすぐにダウンロードし、永久ストレージに永続化してください。
- ネイティブ音声同期により、ショート動画のつなぎコンテンツでは通常、別途のナレーションや効果音処理は不要です。
- このモデルには現在 1080p の段階がありません——1080p があると仮定してパイプラインを構築する前にモデルページを確認してください。
試す準備はできましたか？ seedance-2.5/text-to-video モデルページで完全なパラメータリファレンスを確認するか、hiapi の完全な動画モデルカタログを見て、Kling 3.0 Turbo などの画像から動画の選択肢と比較し、次のショート動画バッチに備えましょう。
