NezhaGateNezhaGate
简体中文EnglishEspañol한국어日本語 ✓Русский
ログイン API Key を取得
seedance-2.0-clip

Seedance 2.0 · Clip · API

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

Seedance 2.0 · Clip の動画生成（非同期、特価の 1 本ごとの課金）: duration は 5 / 10 / 15 秒のいずれか（既定は 15。縦 9:16 は 15 秒のみ）、720P、size=16:9 / 9:16。参照画像は最大 9 枚（images。人物・場面・スタイルを決め、プロンプトでは @Image1… と指名）で、実在の人物の写真も参照に使えます。参照動画と参照音声は受け付けません。ジョブ ID を返し（HTTP 202）、GET /v1/videos/jobs/{id} を status=succeeded になるまでポーリングすると、結果が data[0].url に入ります。1 本 $1.00、3 つの長さは同額です。失敗時は全額返金します。

Playground で試す →

認証

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

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

リクエストボディ

パラメータ種別必須説明
model string はい モデル ID。ここでは seedance-2.0-clip です。
prompt string はい 動画の内容、カメラ、動きを説明するテキストプロンプト。最大 5000 バイト（UTF-8。漢字 1 文字は 3 バイト）。
duration integer いいえ 長さは 5 / 10 / 15 秒のいずれかのみ（既定は最長の 15 秒）。縦 9:16 は現在 15 秒のみです。それ以外の値は拒否されます。seconds とも書けます。特価の 1 本ごとの課金で、3 つの長さは同額です。
resolution string いいえ 解像度は 720P のみ（既定も 720P）。長さに関係なく 1 本 $1.00 です。
size string いいえ 画面比率: 16:9（横、既定。5 / 10 / 15 秒）または 9:16（縦。15 秒）。aspect_ratio とも書けます。
image string いいえ 画像から動画：参照画像を渡してください（公開 URL、data: URI、base64）。省略するとテキストから動画になります。
images array いいえ 複数枚の参照画像。最大 9 枚です。上限を超えた場合は切り詰めずに拒否します。reference_images とも書けます。

リクエスト例

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-clip", "prompt": "a paper crane unfolding over a misty lake", "duration": 15, "resolution": "720P", "size": "16:9"}'
# image-to-video: also pass  "image": "https://example.com/ref.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-clip"
}

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

送信すると即座に HTTP 202 とジョブ ID が返ります。status=succeeded になるまでポーリングし、data[0].url（mp4 のリンク）を読んでください。指定できる長さ・解像度・画面比率は上のパラメータ表にあります。image パラメータを付けると画像から動画になります。

curl · 送信（テキストから動画）
curl https://nezhagate.com/v1/videos/generations -H 'Authorization: Bearer YOUR_API_KEY' -H 'Content-Type: application/json' -d '{"model": "seedance-2.0-clip", "prompt": "夕暮れにサーフィンをする猫", "size": "16:9"}'
参照画像：images（最大 9 枚。公開 URL、data: URI、base64）も渡し、プロンプトでは @Image1… と指名します。被写体・場面・スタイルを決めるもので、最初のフレームにはなりません。この等級は参照動画と参照音声を受け付けません。
実在の人物の顔もそのまま参照画像に使えます（隠す必要はありません）。写っている人物の肖像を使用する権利があることを必ずご確認ください。
レスポンス例
{ "id": "img_3f9a...c2", "object": "video.generation.job", "status": "queued", "model": "seedance-2.0-clip" }
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-clip",
  "data": [{ "url": "https://img.nezhagate.com/i/9f86d081a8....mp4" }]
}

🕑 data[0].url は当方の画像ホストのリンクで、60 日間保存された後に自動的に削除されます。継続して使う場合は、ダウンロードしてご自身のストレージや CDN に保存してください。

1 本ごとの課金で、失敗時は全額返金します。生成が失敗またはタイムアウトした場合、確保したクレジットは自動的に戻ります。

エラーコード

エラー本文には常に error.message / error.type / error.code / error.param が含まれます。分岐は code で行ってください。一覧は接続ガイドにあります。

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