# Seedance 2.0 Mini API

ByteDance の Seedance 2.0 Mini 動画生成モデルに関する完全な API リファレンス。

## モデルの種類

この API は 3 種類のモデルに対応しています。

| モデル | ID | 説明 |
|-------|-----|-------------|
| **Seedance 2.0 Mini Text to Video** | `seedance-v2.0-mini-text-to-video` | コスト効率の高いテキストからの動画生成 |
| **Seedance 2.0 Mini Image to Video** | `seedance-v2.0-mini-image-to-video` | 動きを制御できるコスト効率の高い画像アニメーション生成 |
| **Seedance 2.0 Mini Reference to Video** | `seedance-v2.0-mini-reference-to-video` | 参照画像・動画・音声を使用したコスト効率の高い動画生成 |

## 機能の概要

| 機能 | 値 |
|---------|-------|
| 再生時間の範囲 | 4～15 秒 |
| 解像度の選択肢 | 480p, 720p |
| アスペクト比の選択肢 | 21:9, 16:9, 9:16, 1:1, 4:3, 3:4 |
| 音声対応 | あり（デフォルト：有効） |
| 参照メディア | 参照からの動画生成で使用する画像・動画・音声 |
| シードの制御 | すべての Seedance 2.0 Mini モデルで非対応 |

### 対応するアスペクト比

`21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4`

### 解像度の選択肢

| 解像度 | 説明 |
|------------|-------------|
| `480p` | 標準画質、処理が高速 |
| `720p` | 高画質 |

## Seedance 2.0 Mini Text to Video

### エンドポイント

```
POST /api/v1/video/task
```

### リクエストパラメータ

#### 必須

| パラメータ | 型 | 説明 |
|-----------|------|-------------|
| `model_name` | string | `"seedance-v2.0-mini-text-to-video"` を指定する必要があります |
| `prompt` | string | 動画生成用のプロンプト |
| `duration` | integer | 動画の再生時間。整数秒（4～15）、1 秒刻み |
| `resolution` | string | 出力解像度：`"480p"` または `"720p"` |
| `aspect_ratio` | string | 動画のアスペクト比：`"21:9"`、`"16:9"`、`"9:16"`、`"1:1"`、`"4:3"`、`"3:4"` |

#### 任意

| パラメータ | 型 | 説明 |
|-----------|------|-------------|
| `sound` | boolean | 環境音を生成するかどうか（デフォルト：`true`） |

### リクエスト例

```javascript
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'seedance-v2.0-mini-text-to-video',
    prompt: 'A golden retriever running through a sunlit meadow',
    duration: 6,
    resolution: '720p',
    aspect_ratio: '16:9',
    sound: true
  })
});

const { data } = await response.json();
const taskId = data.task_id;
```

## Seedance 2.0 Mini Image to Video

### リクエストパラメータ

#### 必須

| パラメータ | 型 | 説明 |
|-----------|------|-------------|
| `model_name` | string | `"seedance-v2.0-mini-image-to-video"` を指定する必要があります |
| `prompt` | string | 動画生成用のプロンプト |
| `duration` | integer | 動画の再生時間。整数秒（4～15）、1 秒刻み |
| `resolution` | string | 出力解像度：`"480p"` または `"720p"` |
| `aspect_ratio` | string | 動画のアスペクト比：`"21:9"`、`"16:9"`、`"9:16"`、`"1:1"`、`"4:3"`、`"3:4"` |
| `image_url` | string | 動画の最初のフレーム |

#### 任意

| パラメータ | 型 | 説明 |
|-----------|------|-------------|
| `image_end_url` | string | 任意の最終フレーム画像 URL |
| `sound` | boolean | 環境音を生成するかどうか（デフォルト：`true`） |

### リクエスト例

```javascript
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'seedance-v2.0-mini-image-to-video',
    image_url: 'https://example.com/image.jpg',
    image_end_url: 'https://example.com/end-frame.jpg',
    prompt: 'Camera slowly pulls back to reveal the full landscape',
    duration: 6,
    resolution: '720p',
    aspect_ratio: '16:9',
    sound: true
  })
});

const { data } = await response.json();
const taskId = data.task_id;
```

## Seedance 2.0 Mini Reference to Video

### リクエストパラメータ

#### 必須

| パラメータ | 型 | 説明 |
|-----------|------|-------------|
| `model_name` | string | `"seedance-v2.0-mini-reference-to-video"` を指定する必要があります |
| `prompt` | string | 動画生成用のプロンプト。プレースホルダーなしの通常のプロンプトを記述できます。または、@ (AT) 参照機能で `<<<image_N>>>`、`<<<video_N>>>`、`<<<audio_N>>>` を使用し、対応するメディア配列の要素を明示的に参照できます |
| `duration` | integer | 動画の再生時間。整数秒（4～15）、1 秒刻み |
| `resolution` | string | 出力解像度：`"480p"` または `"720p"` |
| `aspect_ratio` | string | 動画のアスペクト比：`"21:9"`、`"16:9"`、`"9:16"`、`"1:1"`、`"4:3"`、`"3:4"` |

#### 参照メディア

各リクエストには、画像または動画を少なくとも 1 つ含める必要があります。画像を参照する場合は 1～9 枚を送信してください。`images` 配列を省略または空にできるのは、`videos` 配列に参照動画が少なくとも 1 本含まれる場合だけです。音声のみのリクエストには対応していません。

| パラメータ | 型 | 説明 |
|-----------|------|-------------|
| `images` | string[] | 1～9 個の参照画像 URL。`videos` が空でない場合は空配列も可 |
| `videos` | string[] | 最大 3 個の参照動画 URL。各動画は 2～15 秒、合計再生時間は最大 15 秒 |
| `audios` | string[] | 最大 3 個の参照音声 URL。各クリップは 2～15 秒、合計再生時間は最大 15 秒。WAV または MP3、各クリップ最大 15 MB。画像または動画が少なくとも 1 つ必要 |

#### @ (AT) 参照プレースホルダー

@ (AT) 参照機能は、番号付きの `<<<...>>>` プレースホルダーで参照メディアとプロンプトを関連付けます。番号はメディアの種類ごとに独立して `1` から始まり、対応する配列の順序に従います。

| プレースホルダー | 参照先の値 |
|-------------|------------------|
| `<<<image_1>>>` | `images[0]` |
| `<<<image_2>>>` | `images[1]` |
| `<<<video_1>>>` | `videos[0]` |
| `<<<audio_1>>>` | `audios[0]` |

各プレースホルダーは、対応する配列に存在する要素を指す必要があります。

#### 任意

| パラメータ | 型 | 説明 |
|-----------|------|-------------|
| `sound` | boolean | 同期した音声を生成するかどうか。デフォルトは `true` |

### 参照動画の料金

Seedance V2.0 Mini Reference-to-Video は、他の Seedance 2.0 参照モデルと同じ、解像度に基づく秒単位の料金体系を採用しています。`videos` 配列に参照動画が少なくとも 1 本含まれる場合、生成料金の総額は 2 倍になります。この倍率は、アップロードした参照動画の本数や長さに関係なく 1 回だけ適用されます。

### リクエスト例

```javascript
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'seedance-v2.0-mini-reference-to-video',
    prompt: 'Place the explorer from <<<image_1>>> in the environment from <<<image_2>>>, following the camera movement in <<<video_1>>> and speaking with the reference voice from <<<audio_1>>>',
    duration: 8,
    resolution: '720p',
    aspect_ratio: '16:9',
    sound: true,
    images: [
      'https://example.com/explorer-reference.jpg',
      'https://example.com/environment-reference.jpg'
    ],
    videos: ['https://example.com/camera-movement-reference.mp4'],
    audios: ['https://example.com/voice-reference.mp3']
  })
});

const { data } = await response.json();
const taskId = data.task_id;
```

## メディアの制限

これらの制限は、このページのモデルで使用する最初のフレーム画像、最終フレーム画像、および参照メディアに適用されます。

| メディア | 形式 | 制限 |
|-------|---------|--------|
| 画像 | JPEG, PNG, WEBP, BMP, TIFF, GIF, HEIC, HEIF | 1 枚あたり 30 MB 未満。幅と高さはそれぞれ 300～6000 px。幅と高さの比率は 0.4～2.5 |
| 動画 | MP4, MOV | 1 本あたり最大 200 MB。幅と高さはそれぞれ 300～6000 px。幅と高さの比率は 0.4～2.5。フレームレートは 24～60 FPS |
| 音声 | WAV, MP3 | 1 つあたり最大 15 MB |
| リクエスト本文 | — | 最大 64 MB |

参照音声と参照動画には、それぞれ独立した合計 15 秒の再生時間上限があります。個数の上限も独立しており、画像は最大 9 枚、動画は最大 3 本、音声は最大 3 クリップです。動画を追加しても画像の上限は減りません。

すべてのモデルのデフォルトは `720p` ですが、`resolution` の指定は必須です。音声スイッチのデフォルトは `true` で、このスイッチと参照音声はいずれも料金に影響しません。参照からの動画生成には画像または動画が少なくとも 1 つ必要で、音声のみのリクエストには対応していません。参照動画をアップロードすると、本数や長さに関係なく生成料金が 2 倍になります。

## レスポンス形式

### 初期レスポンス

すべてのモデルは、ポーリング用の `task_id` を返します。

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}
```

### ポーリングのレスポンス

`GET /api/v1/video/{taskId}` をポーリングしてステータスを確認します。

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "task_result": {
      "credit": 0.2,
      "videos": [
        {
          "url": "https://example.com/generated-video.mp4"
        }
      ]
    }
  }
}
```

### ステータス値

- `submitted`: タスクを受け付け、処理待ち
- `processing`: 動画を生成中
- `succeed`: 動画の生成が完了
- `failed`: 動画の生成に失敗

## 処理時間

通常の処理時間は 2～6 分で、再生時間と解像度によって異なります。

5～10 秒ごとにポーリングしてステータスを確認してください。

## ベストプラクティス

1. **動きを明確に記述する**：プロンプトに具体的な動きの説明を含めてください
2. **解像度を選ぶ**：高速な処理には `480p`、高画質には `720p` を使用してください
3. **音声を活用する**：臨場感のある動画にするため、`sound` を有効にしてください
4. **画像から動画を生成する**：`image_url` で鮮明な最初のフレームを指定してください。開始と終了のフレームを制御する場合は `image_end_url` を使用します
5. **参照メディア**：対応する画像・動画・音声を参照に使用し、画像または動画を少なくとも 1 つ含めてください
6. **参照動画の料金**：参照動画を少なくとも 1 本含む参照からの動画生成リクエストは、アップロードした動画の本数や長さに関係なく 2 倍の料金になります
7. **シードパラメータ**：`seed` は送信しないでください。Seedance 2.0 Mini モデルは対応していません