> ## Documentation Index
> Fetch the complete documentation index at: https://mixroute.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Doubao Seedance 2.5 Flash

> MixRoute で Doubao Seedance 2.5 Flash を使用し、480p または 720p の動画を生成・編集・延長します。

Doubao Seedance 2.5 Flash は、ByteDance の Seedance 2.5 の高速版です。テキストからの生成、先頭フレームや先頭・末尾フレームの指定、マルチモーダル参照、動画編集と延長に対応します。

`POST https://api.mixroute.ai/v1/video/generations`

`model`、`prompt`、`asset` は最上位に置き、プロバイダー固有のフィールドは `metadata` にまとめます。テキストのみの場合は `asset: false` を指定し、`metadata.content` に `prompt` と同じテキスト項目を追加します。参照メディアを渡す場合は `asset: true` を指定します。

> [!NOTE]
>
> Flash は Draft に対応していません。`metadata.draft` と `draft_task` のコンテンツ項目は指定しないでください。プレビューが必要な場合は [Doubao Seedance 2.5 の標準ルート](https://mixroute.ai/docs/ja/model-api/bytedance/doubao-seedance-2-5.md)を使用してください。

## パラメーターと制限

| フィールド | 値 |
| - | - |
| `model` | `doubao-seedance-2-5-flash-261115` |
| `metadata.resolution` | `480p` / `720p` (既定) |
| `metadata.duration` | 4–30 秒。`-1`（既定）では長さを自動で選択します。 |
| `metadata.ratio` | `16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、または `adaptive`（既定）。 |
| `metadata.generate_audio` | `true`（既定）で同期音声を生成し、`false` で無音の動画を出力します。 |
| `metadata.output_format` | `mp4`（既定）または `mov`。フレームレートは 24 fps です。 |
| `metadata.omni_reference_task_type` | マルチモーダル入力時に指定可能：`auto`（既定）、`reference`、`edit`、`extend`。 |

## 入力モード

* 先頭フレームには `first_frame`、先頭・末尾フレームには `first_frame` と `last_frame` を指定します。`metadata.ratio` は `adaptive` にします。フレーム用のロールを `reference_*` と併用しないでください。
* マルチモーダル参照では `reference_image`、`reference_video`、`reference_audio` を使います。1 リクエストあたり画像 10 枚、動画 5 本、音声 5 本まで指定でき、音声のみの参照も可能です。参照動画と参照音声の合計時間は、それぞれ 30 秒以内です。
* 動画編集には 4–30 秒の `reference_video` が必要です。`metadata.ratio` は `adaptive`、`metadata.duration` は `-1` にします。延長でも `reference_video` と `adaptive` が必要です。

## リクエスト例

`MIXROUTE_API_KEY` に MixRoute の API キーを設定します。編集例の URL はアクセス可能な元動画の URL に置き換えてください。

### テキストから動画を生成する

```bash theme={null}
curl --request POST "https://api.mixroute.ai/v1/video/generations" \
  --header "Authorization: Bearer $MIXROUTE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "doubao-seedance-2-5-flash-261115",
  "prompt": "A red ceramic mug turns slowly on a white tabletop in soft daylight.",
  "asset": false,
  "metadata": {
    "content": [
      {
        "type": "text",
        "text": "A red ceramic mug turns slowly on a white tabletop in soft daylight."
      }
    ],
    "duration": 4,
    "resolution": "480p",
    "ratio": "16:9",
    "generate_audio": false
  }
}'
```

### 動画を編集する

```bash theme={null}
curl --request POST "https://api.mixroute.ai/v1/video/generations" \
  --header "Authorization: Bearer $MIXROUTE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "doubao-seedance-2-5-flash-261115",
  "prompt": "Replace the white tabletop with a light wood surface. Keep the mug and camera motion unchanged.",
  "asset": true,
  "metadata": {
    "content": [
      {
        "type": "text",
        "text": "Replace the white tabletop with a light wood surface. Keep the mug and camera motion unchanged."
      },
      {
        "type": "video_url",
        "video_url": {
          "url": "https://example.com/source.mp4"
        },
        "role": "reference_video"
      }
    ],
    "omni_reference_task_type": "edit",
    "duration": -1,
    "resolution": "720p",
    "ratio": "adaptive",
    "generate_audio": false
  }
}'
```

## タスクを照会する

`MIXROUTE_TASK_ID` を送信時に返されたタスク ID に置き換え、タスク成功後に動画 URL を取得します。ステータスとレスポンスは[動画タスクの照会](https://mixroute.ai/docs/ja/api-reference/endpoint/query-video-task.md)を参照してください。

```bash theme={null}
curl "https://api.mixroute.ai/v1/video/generations/MIXROUTE_TASK_ID" \
  --header "Authorization: Bearer $MIXROUTE_API_KEY"
```

共通パラメーターは [Doubao API](https://mixroute.ai/docs/ja/api-reference/endpoint/doubao.md)、入力形式とサイズ制限は [Seedance のメディア制限](https://mixroute.ai/docs/ja/api-reference/endpoint/seedance.md)を参照してください。最新の料金は[モデルマーケットプレイス](https://console.mixroute.ai/models)で確認できます。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.