Seedance 2.5 を、
あなたのプロダクトに。

数回のリクエストで、最初の動画を。

サーバーの環境変数 SEADANCE_API_KEY にキーを保存してください。この動画専用の一意な値を SEADANCE_REQUEST_KEY に設定し（例：uuidgen で生成）、再試行時もその値を保持してください。アカウントに十分なクレジットがあることを確認します。この例では、5 秒・720p の動画に 350 クレジットを仮引き落としします。返された id を保存して、タスクの状態を照会してください。

export SEADANCE_API_KEY="sd_live_your_key"
# Keep this value for retries; choose a new value for a new video.
export SEADANCE_REQUEST_KEY="${SEADANCE_REQUEST_KEY:-$(uuidgen)}"

curl --fail-with-body "https://seedance3ai.dev/api/v1/videos" \
  -H "Authorization: Bearer $SEADANCE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $SEADANCE_REQUEST_KEY" \
  --data '{
  "model": "seedance-2.5",
  "mode": "text-to-video",
  "prompt": "A paper boat floating through a sunlit stream, gentle camera movement",
  "aspectRatio": "16:9",
  "resolution": "720p",
  "duration": 5
}'

このドキュメントから自動的に生成が実行されることはありません。作成リクエストを送信すると、クレジットが使用されます。

サーバー側で認証する。

すべての API 呼び出しで Authorization: Bearer sd_live_… を使用します。キーをブラウザー、モバイルアプリ、公開リポジトリ、クライアント側のコードに含めないでください。キーの全文は一度だけ表示され、API ダッシュボードからいつでも取り消せます。

既定のキー権限は、アップロードと生成用の videos:write、モデル情報とタスク状態の取得用の videos:read、クレジット照会用の account:read です。アカウントのアクセス設定と上限は、すべてのキーに適用されます。

動画生成タスクを作成する。

Content-Type: application/json を使用し、生成する動画ごとに一意の Idempotency-Key を指定してください。サーバーが上流サービスのタスクを受け付けるまで時間がかかる場合があります。接続がタイムアウトしたら、同じ本文と同じキーで再試行してください。HTTP 202 は受付完了を示し、生成完了ではありません。Idempotency-Key は、空白を含まない 1〜128 文字の印字可能な ASCII 文字を受け付けます。

これらのフィールドを使い、Seedance 2.5 でテキスト、最初と最後のフレーム、複数形式の参照素材、動画の編集と延長を扱えます。現在利用可能な機能と料金は、GET /models の返却値を参照してください。

{
  "model": "seedance-2.5",
  "mode": "image-to-video",
  "prompt": "A paper boat floating through a sunlit stream, gentle camera movement",
  "aspectRatio": "16:9",
  "resolution": "720p",
  "duration": 5,
  "firstFrameUrl": "YOUR_UPLOADED_PUBLIC_OBJECT_URL"
}

{
  "model": "seedance-2.5",
  "mode": "reference-to-video",
  "prompt": "A paper boat floating through a sunlit stream, gentle camera movement",
  "aspectRatio": "16:9",
  "resolution": "720p",
  "duration": 5,
  "referenceImageUrls": [
    "YOUR_UPLOADED_IMAGE_URL"
  ],
  "referenceVideoUrls": [
    "YOUR_UPLOADED_VIDEO_URL"
  ]
}

一度アップロードし、URL で参照する。

POST /uploads に fileName、contentType、size（バイト数）、kind（image、video、audio のいずれか）を送信します。expiresAt までに requiredHeaders を指定して、元のファイルのバイト列を PUT で uploadUrl にアップロードしてください。成功後、生成リクエストで publicObjectUrl を使用します。素材は同じアカウントに属している必要があり、任意の外部 URL や base64 入力は受け付けません。

// Node.js 20+ · upload once, then use publicObjectUrl
import { readFile } from "node:fs/promises";

const bytes = await readFile("./first-frame.jpg");
const signed = await fetch("https://seedance3ai.dev/api/v1/uploads", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SEADANCE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    fileName: "first-frame.jpg", contentType: "image/jpeg",
    size: bytes.length, kind: "image",
  }),
});
const upload = await signed.json();
if (!signed.ok) throw new Error(JSON.stringify(upload));
const stored = await fetch(upload.uploadUrl, {
  method: "PUT", headers: upload.requiredHeaders, body: bytes,
});
if (!stored.ok) throw new Error("Upload failed");
console.log(upload.publicObjectUrl);
// Use this URL as firstFrameUrl in an image-to-video request.

申告したファイルサイズとコンテンツタイプは、実際にアップロードするファイルと一致する必要があります。アップロード URL には有効期限があるため、必要に応じて再取得してください。生成前に素材の長さ、サイズ、形式を検証します。

完了までタスクを確認する。

GET /videos/:id で現在のタスク状態を取得します。5〜10 秒ごとにポーリングし、succeeded または failed で停止してください。Retry-After がある場合は指定の時間だけ待機します。照会できるのは、ご自身のアカウントで API を通じて作成したタスクのみです。現在の連携方式はポーリングです。

curl --fail-with-body "https://seedance3ai.dev/api/v1/videos/TASK_ID" \
  -H "Authorization: Bearer $SEADANCE_API_KEY"

{
  "id": "a1b2c3d4-1234-4567-8901-abcdef123456",
  "status": "succeeded",
  "credits_reserved": 350,
  "created_at": "2026-10-27T00:00:00.000Z",
  "output": {
    "url": "https://your-result-host.example/video.mp4"
  },
  "error": null,
  "refund_status": "not_applicable"
}

動画が利用可能になるまで output は null です。失敗したタスクには error が含まれ、refund_status でクレジットの返還状況を確認できます。成功した動画は早めにダウンロードしてください。動画を削除してもリクエストはリセットされません。同じ Idempotency-Key で再送すると 410 video_deleted が返り、再生成はできません。

開発前にクレジット費用を確認する。

API での生成には、ウェブサイトと同じアカウントのクレジットと Seedance 2.5 の単価が適用されます。リクエスト受付時にクレジットを仮引き落としし、生成に失敗した場合は買い切りクレジット残高に返還します。タスク作成前の検証で失敗した場合、課金対象の動画は作成されません。

費用 = 出力時間 × 出力単価 + 参照動画の時間 × 参照単価。参照動画の時間はサーバーで計測し、合計を秒単位で切り捨てて課金します。音声生成は料金に含まれます。例えば、5 秒・720p の動画は 350 クレジット、さらに 5 秒の参照動画を使用する場合は 600 クレジットです。

curl --fail-with-body "https://seedance3ai.dev/api/v1/models" \
  -H "Authorization: Bearer $SEADANCE_API_KEY"

curl --fail-with-body "https://seedance3ai.dev/api/v1/credits" \
  -H "Authorization: Bearer $SEADANCE_API_KEY"

API ダッシュボードで、利用可能なクレジット、リクエスト履歴、アカウントの上限を確認できます。同じアカウントでウェブサイトの料金ページからクレジットを追加してください。API 専用の残高やチャージ用エンドポイントはありません。利用可能なクレジットが十分にあれば、有効なサブスクリプションは不要です。サブスクリプションの期限切れや買い切りクレジットの規則は、ウェブサイト利用時と同じです。

クレジットを追加しても、API の頻度、同時実行数、1 日の上限は増えず、無効なアカウントも再有効化されません。1 日の上限には、失敗して返還された分も含むすべての仮引き落としクレジットが計上され、UTC 00:00 にリセットされます。上限の引き上げが必要な場合は、サポートにお問い合わせください。

安全に再試行し、重複課金を防ぐ。

生成する動画ごとに 1 つの Idempotency-Key を使用し、結果が確定するまで正確なリクエスト本文とともに保持してください。新しいキーは新しい生成を意味します。エラーレスポンスには error.code、error.message、request_id が含まれます。サポートへのお問い合わせにはリクエスト ID を添えてください。