# Seedance 2.0 · Clip — /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 つの長さは同額です。失敗時は全額返金します。

**エンドポイント:** `POST https://nezhagate.com/v1/videos/generations`

## 認証
```
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

## リクエストボディ
| パラメータ | 種別 | 必須 | 説明 |
| --- | --- | --- | --- |
| `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 とも書けます。 |

## リクエスト例
```bash
# 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'
```

## レスポンス
```json
{
  "id": "img_3f9a...c2",
  "object": "video.generation.job",
  "status": "queued",
  "model": "seedance-2.0-clip"
}
```