NezhaGate
简体中文EnglishEspañol한국어日本語 ✓
ログイン API Key を取得
seedance-2.0

Seedance 2.0 · API

⧉Markdown としてコピー 📄Markdown として表示AI 用のプレーンテキスト ✦Open in ChatGPT ✶Open in Claude
POST https://nezhagate.com/v1/videos/generations

Seedance 2.0 による動画生成（非同期）。長さは 5〜15 秒の任意の整数、解像度は 480P / 720P / 1080P（既定は 720P。等級ごとに単価が異なります）、画面比率は 5 種類、audio で音声の有無を切り替えます（既定は true）。image を渡すと画像から動画になります。ジョブ ID が返るので（HTTP 202）、GET /v1/videos/jobs/{id} をポーリングしてください。秒単位の課金で、失敗時は全額返金します。

Playground で試す →

認証

Header
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

コンソールで API Key を作成すると利用を開始できます。

リクエストボディ

パラメータ種別必須説明
model string はい モデル ID。ここでは seedance-2.0 です。
prompt string はい 動画の内容、カメラ、動きを説明するテキストプロンプト。最大 5000 バイト（UTF-8。漢字 1 文字は 3 バイト）。参照画像を複数渡すときは、プロンプトの中で @Image1 / @Image2 のように指名できます。例:「@Image1 の人物が @Image2 の場面にいる」。指名しない場合はモデルが自分で判断します。
duration integer いいえ 長さ（秒）。5〜15 の任意の整数で、既定は 5 です。seconds とも書けます。秒単位で課金します。
resolution string いいえ 解像度: 480P / 720P / 1080P（既定は 720P）。等級ごとに単価が異なるので、モデルページの料金表をご覧ください。
size string いいえ 画面比率: 16:9 / 9:16 / 1:1 / 4:3 / 3:4（既定は 16:9）。aspect_ratio とも書けます。
audio boolean いいえ 音声トラックを生成するかどうか。既定は true です。
image string いいえ 画像から動画：参照画像（既定で最初のフレームになります）を公開 URL、data: URI、base64 のいずれかで渡してください。省略するとテキストから動画になります。
images array いいえ 複数枚の参照画像。このモデルは最大 4 枚です。各要素は公開 URL、data: URI、base64 のいずれでも構いません。上限を超えた場合は切り詰めずに拒否します。reference_images とも書けます。
image_role string いいえ 参照画像の使い方：first_frame（既定。2 枚目は最後のフレームになります）または reference（被写体やスタイルの参照。複数枚を使うときはこちら）。reference_images で渡した場合は reference が既定です。
audio_reference string / array いいえ 参照オーディオの公開 http(s) リンク。最大 1 件で、参照画像または参照動画と一緒に使う必要があります。audio_references とも書けます（両方を同時に送らないでください）。
video_references array いいえ 元動画の公開 http(s) リンク。最大 3 件で、公開リンクのみ受け付けます（data: URI は上流で失敗します）。参照画像や最初・最後のフレームとは併用できません。

リクエスト例

cURL
# 1) submit -> 202 {"id":"img_...","status":"queued"}
curl https://nezhagate.com/v1/videos/generations -H 'Authorization: Bearer YOUR_API_KEY' -H 'Content-Type: application/json' -d '{"model": "seedance-2.0", "prompt": "a cat surfing a wave at sunset", "duration": 5, "resolution": "720P", "size": "16:9"}'
# image-to-video: also pass  "image": "https://example.com/first-frame.png"
# 2) poll every ~5s until status=succeeded, then read data[0].url
curl https://nezhagate.com/v1/videos/jobs/img_3f9a...c2 -H 'Authorization: Bearer YOUR_API_KEY'

レスポンス

200 · JSON
{
  "id": "img_3f9a...c2",
  "object": "video.generation.job",
  "status": "queued",
  "model": "seedance-2.0"
}

非同期の動画ジョブ（送信 → ポーリング）

モデルは 1 つで、種類はパラメータで選びます。tier=lite/fast/quality、resolution=720p/1080p/4k（1080p と 4k は quality が必要）、size=16:9/9:16、duration=4s/6s/8s。image パラメータを加えると画像から動画（最初のフレーム）になります。HTTP 202 とジョブ ID が返るので、status=succeeded になるまでポーリングし、結果を data[0].url から取得してください（再ホストした mp4。1〜2 分ほど）。

curl · 送信（テキストから動画）
curl https://nezhagate.com/v1/videos/generations -H 'Authorization: Bearer YOUR_API_KEY' -H 'Content-Type: application/json' -d '{"model": "seedance-2.0", "prompt": "夕暮れにサーフィンをする猫", "tier": "quality", "resolution": "1080p", "size": "16:9", "duration": "8s"}'
画像から動画：image パラメータも渡してください（最初のフレームとして使う参照画像。公開 URL、data: URI、base64 のいずれか）。
レスポンス例
{ "id": "img_3f9a...c2", "object": "video.generation.job", "status": "queued", "model": "seedance-2.0" }
curl · ポーリング
curl https://nezhagate.com/v1/videos/jobs/img_3f9a...c2 -H 'Authorization: Bearer YOUR_API_KEY'
レスポンス例
{
  "id": "img_3f9a...c2",
  "object": "video.generation.job",
  "status": "succeeded",
  "model": "seedance-2.0",
  "data": [{ "url": "https://img.nezhagate.com/i/9f86d081a8....mp4" }]
}

秒単位で課金（$0.15/秒 x 長さ）。確保額と請求額は完全に一致し、生成が失敗またはタイムアウトした場合は自動的に全額返金します。

エラーコード

Code説明
401API Key が欠落または無効
402残高不足または Key が上限超過
400モデルまたはパラメータが非対応
429上流のレート制限
502すべての上流回線が失敗