# Seedance 2.0 Mini — /videos/generations

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

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

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

## リクエストボディ
| パラメータ | 種別 | 必須 | 説明 |
| --- | --- | --- | --- |
| `model` | string | はい | モデル ID。ここでは seedance-2.0-mini です。 |
| `prompt` | string | はい | 動画の内容、カメラ、動きを説明するテキストプロンプト。最大 5000 バイト（UTF-8。漢字 1 文字は 3 バイト）。参照画像を複数渡すときは、プロンプトの中で @Image1 / @Image2 のように指名できます。例:「@Image1 の人物が @Image2 の場面にいる」。指名しない場合はモデルが自分で判断します。 |
| `duration` | integer | いいえ | 長さ（秒）。5〜15 の任意の整数で、既定は 5 です。seconds とも書けます。秒単位で課金します。 |
| `resolution` | string | いいえ | 解像度: 480P / 720P（既定は 720P）。等級ごとに単価が異なるので、モデルページの料金表をご覧ください。 |
| `size` | string | いいえ | 画面比率: 16:9 / 9:16 / 1:1 / 4:3 / 3:4（既定は 16:9）。aspect_ratio とも書けます。 |
| `audio` | boolean | いいえ | 出力される動画には常に音声が付きます（セリフ・効果音・音楽はプロンプトから生成）。オフにはできず、false を指定しても効果はありません。 |
| `image` | string | いいえ | 参照画像 1 枚（公開 URL、data: URI、base64）。人物・物・場面・スタイルの参照としてモデルに渡します。複数なら images を使ってください。このモデルには最初のフレームの指定がないため、画像がクリップの最初に来るとは限りません。参照素材を何も渡さなければテキストから動画です。 |
| `images` | array | いいえ | 複数枚の参照画像。このモデルは最大 9 枚です。各要素は公開 URL、data: URI、base64 のいずれでも構いません。上限を超えた場合は切り詰めずに拒否します。reference_images とも書けます。 1 枚あたり最大 16MB、jpg / png / webp / gif。プロンプトでは順に @Image1、@Image2 … と指名します。 |
| `image_role` | string | いいえ | 省略可。参照画像は常に参照として使われ（人物・場面・スタイル）、プロンプトでは @Image1… と指名します。このモデルには最初・最後のフレームの指定はありません。 |
| `audio_reference` | string / array | いいえ | 参照オーディオの公開 http(s) リンク。最大 3 件で、参照画像または参照動画と一緒に使う必要があります。audio_references とも書けます（両方を同時に送らないでください）。 base64（data:audio/mpeg;base64,...）も使えます。mp3 / wav / m4a。プロンプトでは @Audio1 と指名します。 |
| `video_references` | array | いいえ | 参照動画。最大 3 件。各要素は公開 http(s) リンクのほか、ローカルの動画を base64 で直接渡すこともできます（data:video/mp4;base64,...、mp4 / mov、1 件あたり最大 50MB）。こちらでホスティングしてから上流に渡します。同じリクエストで参照画像と併用できます（例：写真で人物の外見、動画で動きとカメラワーク）。プロンプトでは @Image1 / @Video1 のように指名してください。 各動画は最長 30 秒、合計 15 秒まで。こちらでホスティングした参照素材は 7 日間保存されます。 |

## リクエスト例
```bash
# 1) submit -> 202 {"id":"img_...","status":"queued"}
curl https://kovapi.com/v1/videos/generations -H 'Authorization: Bearer YOUR_API_KEY' -H 'Content-Type: application/json' -d '{"model": "seedance-2.0-mini", "prompt": "a cat surfing a wave at sunset", "duration": 5, "resolution": "720P", "size": "16:9"}'
# with references: add "images": ["https://example.com/a.png"], "video_references": ["https://example.com/move.mp4"], "audio_reference": ["https://example.com/bgm.mp3"] and name them @Image1 / @Video1 / @Audio1 in the prompt
# 2) poll every ~5s until status=succeeded, then read data[0].url
curl https://kovapi.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-mini"
}
```

## コンテンツ要件

Seedance のタスクはすべてコンテンツ審査を通ります。対象はプロンプト、参照素材、生成された動画で、映像も音声も審査されます。審査で不合格になったタスクは `content_policy` で失敗し、課金されません。

### 審査のタイミング

送信時にプロンプトと参照素材が審査され、動画の生成後に映像と音声がもう一度審査されます。そのため不合格の結果は、送信から数秒で返ることもあれば、レンダリングの終了後に返ることもあります（30分以上かかることもあります）。`status` が `failed`、`error.code` が `content_policy` で終わったタスクは審査で不合格です。Webhook では `video.failed` イベントが届きます。

### 課金なし

不合格のタスクは課金されません。送信時に仮押さえした金額はタスク終了時に全額返金され、呼び出しログでも課金なしと表示されます。

### 音声

音声（セリフ、ナレーション、歌、効果音）はプロンプトに沿ってモデルが生成し、映像と一緒に審査されます。プロンプトに書いたセリフ、ナレーション、歌詞は読み上げられたり歌われたりします。人の声が要らない動画なら、プロンプトにセリフや歌詞を書かないでください。このモデルは毎回音声付きで出力され、オフにできません（`audio: false` を指定しても効果はありません）。アップロードした参照音声も審査され、著作権のある音楽を参照音声に使うと弾かれることがあります。音声が不合格の場合、`error.param` は `audio` になり、message に生成された音声か参照音声かが書かれます。

### よく弾かれる内容

- 性的な内容、裸、性的なほのめかし（AI で生成・合成した画像を含む）
- 流血、残虐な描写、自傷、銃撃や出血などの暴力による負傷
- 銃器、爆発物、薬物
- 未成年者を性的に扱う内容は一切不可。未成年者と酒・たばこ・薬物・危険な行為の組み合わせも弾かれます
- 政治家、芸能人、スポーツ選手、経済人など公人の容姿や声（よく似た人物を含む）
- 著作権で保護されたキャラクターや IP（ディズニーやマーベルのキャラクターなど）
- 憎悪や差別的な内容、フェイクニュース

### 長い絵コンテ台本

違反するカットが1つでもあれば動画全体が弾かれます。長い絵コンテ台本で特に起きやすく、アクションシーンの銃撃戦や出血のアップ、未成年者が飲酒や喫煙をする場面があると全体が失敗します。送信前に台本を通して読み、こうしたカットを削除するか書き直してください。

### 実在の人物

実在の人物の写真を参照に使うには、その人物の肖像を使う権利が必要です。

### 弾かれたあと

同じ内容で再送信しても再び弾かれます。問題になりそうな部分を見つけ、プロンプトを書き直すか参照素材を差し替えてから送信し直してください。

エラーコード: `content_policy` · `status: failed`