Seedance 2.0 API：開発者のための実践ガイド

最終更新日：2026年3月

Seedance 2.0 APIを使用すると、開発者はAI動画生成をアプリケーションに直接統合できます。このガイドでは、APIの実際の機能、代替手段との比較、および開始方法について説明します。

Seedance 2.0 APIの機能

Seedance 2.0 APIは、テキストプロンプトや画像から動画を生成するためのプログラムによるアクセスを提供します。Webインターフェースを使用する代わりに、HTTPリクエストを介して生成ジョブを送信し、完了をポーリングして動画URLを取得します。

コア機能：

• テキストから動画生成（Seedance 2.0モデル）
• 画像から動画生成（参照画像をアニメーション化）
• 非同期ジョブ送信とステータスポーリング
• MP4形式、1080p HDでの出力
• 生成あたり最大約10秒

できないこと：

• リアルタイムストリーミング出力なし（生成に時間がかかる）
• 組み込みの動画編集機能なし
• オーディオ生成なし（Google Veo 3とは異なる）
• 負荷に応じて生成キュー時間が変動

Seedance API vs 競合API

構築する前に、選択肢を正直に比較する価値があります。

Seedance APIが適しているケース：

• Google Cloudの設定複雑さなしに良好な品質を求める場合
• 信頼性のあるクレジットベースの料金を必要とする製品を構築している場合
• 1つのAPIで複数のモデルにアクセスしたい場合（Seedance 1.5は速度、2.0は品質）

代替手段を検討すべきケース：

• 最高の品質が必要 → Google Veo 3（Vertex AI）
• ネイティブオーディオ生成が必要 → Google Veo 3
• 高度なカメラ制御が必要 → Runway API

はじめに

ステップ1：APIキーを取得

seedance.tvにサインアップし、アカウント設定に移動します。APIアクセスは、月額$9.9からの有料プランで利用できます。

APIキーは環境変数として保存し、ソースファイルにハードコードしないでください。

export SEEDANCE_API_KEY="your-api-key-here"

ステップ2：生成ジョブを送信

APIは非同期パターンを使用します。ジョブを送信し、完了をポーリングします。

import requests
import time
import os

API_KEY = os.environ["SEEDANCE_API_KEY"]
BASE_URL = "https://api.seedance.tv/v1"

def generate_video(prompt: str, model: str = "seedance-2.0"):
    """テキストから動画生成ジョブを送信します。"""
    response = requests.post(
        f"{BASE_URL}/videos",
        headers={
            "Authorization": f"Bearer {API_KEY}",
            "Content-Type": "application/json"
        },
        json={
            "prompt": prompt,
            "model": model,
            "aspect_ratio": "16:9",
            "resolution": "1080p"
        }
    )
    response.raise_for_status()
    return response.json()["job_id"]

ステップ3：完了をポーリング

def wait_for_completion(job_id: str, poll_interval: int = 5, timeout: int = 300):
    """動画生成が完了するまでポーリングします。"""
    start_time = time.time()
    
    while time.time() - start_time < timeout:
        response = requests.get(
            f"{BASE_URL}/videos/{job_id}",
            headers={"Authorization": f"Bearer {API_KEY}"}
        )
        response.raise_for_status()
        data = response.json()
        
        status = data["status"]
        
        if status == "completed":
            return data["output_url"]
        elif status == "failed":
            raise Exception(f"生成に失敗しました: {data.get('error', '不明なエラー')}")
        
        # まだ処理中
        print(f"ステータス: {status} ({int(time.time() - start_time)}秒経過)")
        time.sleep(poll_interval)
    
    raise TimeoutError(f"生成が{timeout}秒以内に完了しませんでした")

# 使用例
job_id = generate_video("ネオンに照らされた夜の東京の街をスロードリーで撮影、雨の反射が濡れたアスファルトに映る、シネマティック1080p")
video_url = wait_for_completion(job_id)
print(f"動画準備完了: {video_url}")

ステップ4：画像から動画

参照画像をアニメーション化する場合：

def generate_from_image(image_url: str, prompt: str):
    """参照画像をアニメーション化します。"""
    response = requests.post(
        f"{BASE_URL}/videos",
        headers={
            "Authorization": f"Bearer {API_KEY}",
            "Content-Type": "application/json"
        },
        json={
            "prompt": prompt,
            "model": "seedance-2.0",
            "image_url": image_url,
            "type": "image-to-video",
            "aspect_ratio": "16:9"
        }
    )
    response.raise_for_status()
    return response.json()["job_id"]

APIのためのプロンプトエンジニアリング

出力の品質はプロンプトの構造に大きく依存します。以下は一貫して機能するパターンです。

優れたテキストから動画プロンプトの構造：

[ショットタイプ]、[被写体の説明]、[アクション/動き]、[環境]、[照明]、[スタイル]

例：

クローズアップ追跡ショット、日差しが降り注ぐオリーブ畑を歩く女性、風になびく髪、葉を通した暖かい午後の光、シネマティックな浅い被写界深度

APIクレジットを無駄にするよくある間違い：

曖昧すぎる：

美しい動画

競合する要素が多すぎる：

男性と女性と犬がビーチにいて、夕日と波と山が背景にある

動きの説明がない：

テーブルの上のコーヒーカップ

改善例：木製テーブルの上のコーヒーカップ、ゆっくりと立ち上る湯気、左からの柔らかな自然光、マクロレンズ

適切なモデルの選択：

推奨ワークフロー： seedance-1.5で下書き、プロンプトを洗練し、seedance-2.0で最終生成。これにより反復中のAPIコストを削減できます。

アスペクト比

ASPECT_RATIOS = {
    "landscape": "16:9",   # YouTube、デスクトップ、広告
    "portrait": "9:16",    # TikTok、Instagram Reels、Shorts
    "square": "1:1",       # Instagram投稿
    "cinema": "21:9"       # シネマティックワイドスクリーン
}

エラーハンドリング

def safe_generate(prompt: str, max_retries: int = 3):
    """一時的な障害に対してリトライロジックで生成します。"""
    for attempt in range(max_retries):
        try:
            job_id = generate_video(prompt)
            return wait_for_completion(job_id)
        except requests.HTTPError as e:
            if e.response.status_code == 429:
                # レート制限 — バックオフ
                wait = 30 * (attempt + 1)
                print(f"レート制限されました。{wait}秒待機中...")
                time.sleep(wait)
            elif e.response.status_code == 402:
                raise Exception("クレジットが不足しています。seedance.tvでアカウントにチャージしてください")
            else:
                raise
        except TimeoutError:
            if attempt < max_retries - 1:
                print(f"試行{attempt + 1}でタイムアウト、リトライ中...")
            else:
                raise
    raise Exception("最大リトライ回数を超えました")

レート制限とクレジット使用量

• レート制限： プランによって異なります。現在の制限はダッシュボードで確認してください。
• 生成あたりのクレジット： モデル、時間、解像度に依存します。ダッシュボードでライブクレジット残高を確認できます。
• 本番環境でのベストプラクティス： 多数の同時リクエストを送信するのではなく、ジョブキューを実装してください。段階的な送信によりレート制限エラーを回避し、コスト効率も向上します。

このAPIが適しているユースケース

製品動画の自動化： 製品画像から大規模に動画を生成するEコマースプラットフォーム。製品画像とブランドボイスのプロンプトを入力 → 各SKUの自動動画クリップ。

ソーシャルメディアパイプライン： 承認されたプロンプトリストから1週間分の動画コンテンツを生成するスケジュールコンテンツシステム。動画キュー管理ツールと組み合わせてハンズフリー公開。

広告クリエイティブテスト： 同じコンセプトの複数のビジュアル解釈を生成してA/Bテストを行うマーケティングツール。1バッチで広告コンセプトの5つのバリエーションを生成。

プロトタイプ生成： 制作に着手する前にコンセプト動画を生成するデザインおよび製品チーム。初期段階のビジュアライゼーションにおいて従来の制作よりもはるかに低コスト。

シンプルな動画生成パイプラインの構築

import json
from pathlib import Path

def batch_generate(prompts: list[dict], output_dir: str = "./videos"):
    """プロンプト設定のリストから複数の動画を生成します。"""
    Path(output_dir).mkdir(exist_ok=True)
    results = []
    
    for i, config in enumerate(prompts):
        print(f"生成中 {i+1}/{len(prompts)}: {config['name']}")
        
        try:
            # 下書きは高速モデル、最終版はプレミアムモデルを使用
            model = "seedance-2.0" if config.get("final") else "seedance-1.5"
            job_id = generate_video(config["prompt"], model=model)
            url = wait_for_completion(job_id)
            
            results.append({
                "name": config["name"],
                "url": url,
                "status": "success"
            })
            print(f"  ✓ {url}")
            
        except Exception as e:
            results.append({
                "name": config["name"],
                "error": str(e),
                "status": "failed"
            })
            print(f"  ✗ 失敗: {e}")
        
        # 送信間の小さな遅延
        time.sleep(2)
    
    # 結果を保存
    with open(f"{output_dir}/results.json", "w") as f:
        json.dump(results, f, indent=2)
    
    return results

# 使用例
prompts = [
    {"name": "hero-shot", "prompt": "...", "final": True},
    {"name": "product-demo", "prompt": "...", "final": False},
]
results = batch_generate(prompts)

よくある質問

Seedance 2.0には公式の公開APIがありますか？

Seedanceは有料プランの一部としてAPIアクセスを提供しています。現在のアクセス詳細とエンドポイント仕様については、seedance.tvの開発者向けドキュメントを確認してください。

料金はどのように機能しますか？

APIの使用はクレジット残高から引き落とされます。モデルごとに生成あたりのクレジットコストが異なります。現在のモデルごとのクレジットレートはダッシュボードで確認してください。

動画あたりの生成時間はどのくらいですか？

通常30秒から3分で、モデルの複雑さとキューの負荷に依存します。Seedance 1.5はより高速で、Seedance 2.0は時間がかかりますが高品質です。

10秒より長い動画を生成できますか？

現在の単一API呼び出しではできません。より長いコンテンツの場合は、複数のクリップを生成し、moviepyやffmpegなどの動画処理ライブラリを使用してアプリケーション内で結合してください。

出力は商用利用に適していますか？

商用ライセンスの詳細については、seedance.tvの現在の利用規約を確認してください。一般的に、有料プランで生成されたコンテンツは商用利用が許可されています。

Seedance APIはRunwayのAPIとどう比較されますか？

RunwayのAPI（$0.05-0.10/秒）は、より高度なカメラ制御とGen-3 Alphaモデルを提供します。Seedance APIはクレジットベースの料金で、予算計画がより予測しやすいです。Runwayは映画的な仕上がりとカメラ制御で優れ、Seedanceはモデルの多様性と料金の明確さで優れています。ほとんどの開発者にとって、特定のユースケースで両方を試すことをお勧めします。結果はコンテンツタイプによって大きく異なります。

---

構築を始める

AI動画をアプリケーションに統合する準備はできましたか？

Seedanceにサインアップ → — APIをテストするための無料クレジットを入手、有料プランは月額$9.9から。

• テキストから動画プレイグラウンド — 構築前にプロンプトをテスト
• 画像から動画プレイグラウンド — 画像アニメーションをテスト
• Seedance 2.0モデルの詳細 — 品質ベンチマークと仕様