SeedanceLink
チャージログイン

開発者向けドキュメント

プロンプトから動画へ、直接接続。

これらの例は SeedanceLink を呼び出します。自分の API キーを使用してください。Google のログインセッションはウェブコンソール用です。

このページの目次

始める前に

ログインして見積額に十分な残高を追加し、Seedance が有効なグループでキーを作成してください。以下の最小例は 4 秒、480p をリクエストします。

自分の API キーを作成 モデルと料金

認証

作成・状態確認・コンテンツの各リクエストで Authorization: Bearer YOUR_API_KEY を送信してください。タスクを作成した同じキーを使用します。キーを URL に含めないでください。

Authorization: Bearer YOUR_API_KEY
API オリジンhttps://seedancelink.io

省略時は長さが 5 秒、解像度が 720p になります。これらの例では 4 秒、480p を明示しています。application/json を送信し、モデルページに表示された 2 つのモデル ID のいずれかを使用してください。

同じ macOS/Linux ターミナル、または Windows WSL で curl の例を実行してください。最初の例でキーと本サイトの API アドレスを設定します。キーを他人に公開しないでください。

タスクを作成

この例では 4 秒の動画を要求します。API が返す id を保存してください。Seedance 2.0 は 4〜15 秒、Seedance 2.5 は 4〜30 秒に対応し、どちらも 480p・720p・1080p を利用できます。

POST /api/v3/contents/generations/tasks
API_KEY='YOUR_API_KEY'
API_BASE='https://seedancelink.io'

curl --fail-with-body --request POST "$API_BASE/api/v3/contents/generations/tasks" \
  --header "Authorization: Bearer $API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "seedance-2.0-933",
  "content": [
    {
      "type": "text",
      "text": "日の出の穏やかな湖を渡る小舟、映画のような照明。"
    }
  ],
  "duration": 4,
  "resolution": "480p",
  "ratio": "16:9"
}'

レスポンス例

{
  "id": "YOUR_TASK_ID",
  "status": "queued"
}

レスポンスのタスク ID を保存し、次の 2 つの手順で使用してください。

状態を確認

REPLACE_WITH_RESPONSE_ID を保存した id に置き換えてください。待機中・実行中は 15 秒ごとに確認し、succeeded になったらダウンロードします。failed または needs_reconcile では確認を停止し、needs_reconcile の場合はサポートに連絡してください。自動再送はしないでください。

レスポンス例

{
  "id": "YOUR_TASK_ID",
  "status": "succeeded"
}

約 15 秒ごとに確認してください。succeeded になってからダウンロードしてください。

動画をダウンロード

作成時と同じキーを使ってください。この保護されたエンドポイントには Bearer キーが必要で、ブラウザーで URL を開くだけでは利用できません。curl は他のホストにキーを渡さず HTTPS リダイレクトに従います。

タスクの状態と課金

queued
受付済み、待機中です。
running
生成中です。
succeeded
完了。認証が必要なコンテンツエンドポイントを利用できます。
failed
生成失敗。確保した金額は返還されました。
needs_reconcile
送信結果が不明なため、確認のために金額を確保しています。

生成前に見積額を確認。

リクエスト秒数 × 解像度別の単価 × 適用倍率。送信時に見積額を確保し、生成成功時に請求、失敗時に返還します。

同じキーでダウンロード

succeeded になったら、API キーを付けて content.video_url または以下のコンテンツエンドポイントを使用してください。残高がゼロでも、支払い済みのタスクはダウンロードできます。

送信結果が不明な場合

needs_reconcile を含む 202 の受付結果にも、ローカルのタスク ID が含まれます。その ID を保存し、状態を確認してください。元の金額は確保されたままなので、別のタスクを自動で作成しないでください。