ビデオ生成 API

テキスト、画像、ビデオ参照、オーディオ入力から AI ビデオを生成します。すべて単一の統合エンドポイントで利用できます。生成モードは、指定するパラメータの組み合わせによって自動的に決定されます。

エンドポイント

POST https://api.evolink.ai/v1/videos/generations

リクエストパラメータ

生成モード

API は、指定された入力パラメータに基づいて生成モードを自動検出します。

入力ファイル要件

画像

ビデオ

オーディオ

ファイル合計制限: 1 リクエストあたり全モダリティ合わせて最大 12 ファイルです。

顔の制限: リアルな人間の顔のアップロードはサポートされておらず、自動的に拒否されます。

すべてのファイル URL は、サーバーから直接アクセス可能である必要があります。

使用例

テキストからビデオ

import requests

response = requests.post(
    "https://api.evolink.ai/v1/videos/generations",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={
        "model": "seedance-2.0",
        "prompt": "A luxury watch rotating slowly on a marble surface, soft studio lighting, product showcase, cinematic 4K",
        "duration": 8,
        "quality": "1080p",
        "aspect_ratio": "16:9",
        "generate_audio": False
    }
)

print(response.json())

画像からビデオ

response = requests.post(
    "https://api.evolink.ai/v1/videos/generations",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={
        "model": "seedance-2.0",
        "prompt": "The woman turns her head slowly and smiles, hair gently flowing in the wind",
        "image_urls": ["https://example.com/portrait.jpg"],
        "duration": 5,
        "quality": "1080p"
    }
)

先頭-末尾フレーム

response = requests.post(
    "https://api.evolink.ai/v1/videos/generations",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={
        "model": "seedance-2.0",
        "prompt": "Smooth camera pan revealing the landscape, golden hour lighting",
        "image_urls": [
            "https://example.com/frame-start.jpg",
            "https://example.com/frame-end.jpg"
        ],
        "duration": 8,
        "quality": "1080p"
    }
)

@タグを使ったマルチモーダル

response = requests.post(
    "https://api.evolink.ai/v1/videos/generations",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={
        "model": "seedance-2.0",
        "prompt": "@Image1 as first frame, replicate @Video1 camera movement, @Audio1 for BGM rhythm",
        "image_urls": ["https://example.com/scene.jpg"],
        "video_urls": ["https://example.com/reference-camera.mp4"],
        "audio_urls": ["https://example.com/bgm.mp3"],
        "duration": 10,
        "quality": "1080p"
    }
)

完全な @ タグ構文と役割の割り当てについては、マルチモーダルリファレンスを参照してください。

レスポンス

{
    "id": "task-unified-1761313744-vux2jw0k",
    "object": "video.generation.task",
    "created": 1761313744,
    "model": "seedance-2.0",
    "status": "pending",
    "progress": 0,
    "type": "video",
    "task_info": {
        "can_cancel": true,
        "estimated_time": 165,
        "video_duration": 8
    },
    "usage": {
        "billing_rule": "per_call",
        "credits_reserved": 12,
        "user_group": "default"
    }
}

レスポンスフィールド

オーディオ生成

Seedance 2.0 は、テキストプロンプトとビジュアルコンテンツに基づいて、音声、効果音、BGM を含む同期オーディオを自動生成できます。

• generate_audio を true（デフォルト）に設定するとオーディオが有効になります
• より良い音声生成のために、プロンプト内のセリフをダブルクォーテーションで囲んでください
• 例: The man stopped the woman and said: "Remember, you must never point at the moon with your finger."
• 無音ビデオを出力するには generate_audio を false に設定してください

プロンプトのコツ

• カメラアングル、ライティング、モーションを具体的に指定してください
• スタイルキーワードを含めてください: "cinematic"、"slow motion"、"aerial shot"
• 被写体、動作、雰囲気を説明してください
• プロンプトの最大長は 2000 トークンです
• 詳細なプロンプトエンジニアリング戦略については、Seedance 2.0 プロンプトガイドをご覧ください

関連ドキュメント

• マルチモーダルリファレンス — 画像、ビデオ、オーディオの @タグ参照で生成を制御する
• 非同期タスク — タスクステータスのポーリングと結果の取得
• Webhooks — callback_url によるリアルタイム完了通知
• SDK とコード例 — Python、Node.js、Go、cURL の統合コード