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

# Dreamina

> Dreaminaの動画生成パラメーター、対応する値、入力制約、およびリクエスト例。

このページでは、`dreamina-seedance-*`の動画ルートについて説明します。Dreaminaはルート／製品のプレフィックスで、Seedanceは動画モデルのファミリーです。プレフィックスを入れ替えるのではなく、完全なモデルIDを使用してください。

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

<Info>
  `model`、`prompt`、`asset`はルートに置いてください。`content`、`duration`、`ratio`、`resolution`、`generate_audio`を含む、すべてのプロバイダーフィールドを単一の`metadata`オブジェクト内に配置してください。
</Info>

## モデルID

| バージョン | MixRouteモデルID |
| - | - |
| Seedance 2.5 | `dreamina-seedance-2-5-260628` |
| Seedance 2.0 | `dreamina-seedance-2-0-260128` |
| Seedance 2.0 Fast | `dreamina-seedance-2-0-fast-260128` |
| Seedance 2.0 Mini | `dreamina-seedance-2-0-mini-260615` |

モデルの利用可否はアカウントによって異なります。[モデルマーケットプレイス](https://console.mixroute.ai/models)に表示される完全なIDを使用してください。

## トップレベルのフィールド

| フィールド | 型 | 必須 | 説明 |
| - | - | - | - |
| `model` | string | はい | モデル表に記載された、完全なMixRouteモデルID。 |
| `prompt` | string | はい | MixRouteの動画プロンプト。`metadata.content`にテキスト項目が含まれる場合は、両方のテキストの整合性を保ってください。 |
| `asset` | boolean | 条件付き | MixRouteのメディア処理の切り替え設定であり、プロバイダーフィールドではありません。ルートに配置してください。テキストのみの例では`false`を使用します。 |
| `metadata` | object | はい | 以下で説明するプロバイダーフィールドを格納するコンテナ。 |

## 生成パラメータ

| フィールド | 型 | 必須 | 説明 |
| - | - | - | - |
| `metadata.content` | object\[] | はい | 動画の入力：テキスト、画像、動画、および対応する音声参照。テキストのみから生成する場合はtext項目が必須です。プロバイダーのメディア入力を組み合わせる場合、テキストは任意です。 |
| `metadata.draft` | boolean | いいえ | デフォルトは`false`です。DraftモードはDreamina Seedance 2.5でサポートされ、`480p`を使用します。Dreamina 2.5の最終化では`1080p`を使用します。パラメータの再利用方法はバージョンによって異なります。これらの規則を2.0に適用しないでください。 |
| `metadata.output_format` | string | いいえ | Seedance 2.5のみ。デフォルトは`mp4`。値: `mp4`、`mov`。MP4は一般的な再生向けです。MOVはポストプロダクション向けに高い色精度を保持し、対応する再生ソフトウェアが必要です。 |
| `metadata.omni_reference_task_type` | string | いいえ | Seedance 2.5のみ。デフォルトは`auto`です。値：`auto`、`reference`、`edit`、`extend`。モードを明示すると、タスク種別を早期に検証できます。宣言されたモードと推定された意図が一致しない場合は、それでも非同期で失敗することがあります。 |
| `metadata.resolution` | string | いいえ | 出力解像度のティアです。対応する値とデフォルトはモデルのバージョンによって異なります。バージョン表を参照してください。値では大文字と小文字が区別されます。 |
| `metadata.ratio` | string | いいえ | デフォルトは`adaptive`。値: `16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`adaptive`。利用場面ごとの制約は以下に記載しています。 |
| `metadata.duration` | integer | いいえ | 2.5：整数の秒数4～30、または`-1`（デフォルト、自動）。編集には`-1`が必要です。2.0：4～15、または`-1`。 |
| `metadata.generate_audio` | boolean | いいえ | デフォルトの`true`では、発話、効果音、音楽などの同期されたモノラル音声を生成します。`false`では無音の動画を生成します。 |
| `metadata.watermark` | boolean | いいえ | デフォルトは`false`です。`true`は右下にAI生成を示す透かしを追加し、`false`は透かしを付けません。 |
| `metadata.return_last_frame` | boolean | いいえ | デフォルトは`false`。`true`を指定すると、生成動画と同じピクセル寸法の、透かしのない最終フレームのPNGがタスク結果に返されます。 |
| `metadata.callback_url` | string | いいえ | タスクステータスのコールバックURL。プロバイダーは、タスク照会レスポンスの構造でPOST通知を送信します。ステータスには`queued`、`running`、`succeeded`、`failed`、`expired`があります。 |
| `metadata.execution_expires_after` | integer | いいえ | 範囲は3600～259200秒、デフォルトは172800（48時間）で、タスクの作成時から計測されます。このしきい値を超えたタスクは、ステータス`expired`で終了します。 |
| `metadata.priority` | integer | いいえ | 2.5および2.0のみ。範囲は0～9、デフォルトは0です。値が大きいタスクは、同じエンドポイントのキューにある優先度の低いタスクより先に処理されます。同じ優先度ではFIFOが維持され、実行中のタスクは中断されません。`flex`との併用はサポートされていません。 |
| `metadata.safety_identifier` | string | いいえ | エンドユーザーを識別する安定した一意の識別子です。英字64文字以内に制限されます。生の個人情報ではなく、ハッシュ化した識別子を使用してください。 |
| `metadata.tools` | object\[] | いいえ | 2.5と2.0のみ。各ツールには`type`が必要で、対応する値は`web_search`です。検索するかどうかはモデルが判断します。照会結果の`usage.tool_usage.web_search`には検索回数が表示されます。 |

## バージョンごとの制限

| バージョン | 解像度 | デフォルトの解像度 | 長さ | 参照の上限（画像 / 動画 / 音声） |
| - | - | - | - | - |
| Seedance 2.5 | `480p` / `720p` / `1080p` | `720p` | 4〜30秒 / -1 | 30 / 10 / 10 |
| Seedance 2.0 | `480p` / `720p` / `1080p` / `4k` | `720p` | 4～15秒 / -1 | 9 / 3 / 3 |
| Seedance 2.0 Fast / Mini | `480p` / `720p` | `720p` | 4～15秒 / -1 | 9 / 3 / 3 |

ネストされたcontentフィールドとメディアのサイズ/形式の制約は、[Seedance](/ja/api-reference/endpoint/seedance)に定義されています。

## Seedance 2.5

編集と延長には`metadata.ratio=adaptive`を使用してください。編集には`metadata.duration=-1`と4～30秒の元動画も必要です。2.5は2.0と異なり、音声のみの参照入力に対応しています。

1080pでは10ビットのH.265/HEVCを使用します。返された動画を再生できない場合は、対応するデコーダーを使用してください。Draftリクエストでは`metadata.draft=true`と`metadata.resolution=480p`を使用します。最終化には、プロバイダーで成功したDraftタスクの`draft_task.id`と1080pを使用します。Draft IDの有効期限は7日間です。

## シナリオ別の制約

* 最初のフレーム、最初と最後のフレーム、マルチモーダル参照の各ワークフローは併用できません。フレーム用のロールと`reference_*`ロールを混在させないでください。
* Seedance 2.0で音声を参照するには、少なくとも1つの画像または動画の参照が必要です。

## 例

APIを呼び出す前に`MIXROUTE_API_KEY`を設定してください。メディアのプレースホルダーは、アクセス可能な入力に置き換えてください。受け付けられたリクエストは課金対象の生成タスクを作成します。送信がタイムアウトしても自動的に再送信しないでください。

```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": "dreamina-seedance-2-5-260628",
  "prompt": "A red cube slowly rotates on a white background. Static camera.",
  "asset": false,
  "metadata": {
    "content": [
      {
        "type": "text",
        "text": "A red cube slowly rotates on a white background. Static camera."
      }
    ],
    "duration": 4,
    "ratio": "9:16",
    "resolution": "480p",
    "generate_audio": false
  }
}'
```

### Python

```python theme={null}
import json
import os
import requests

payload = json.loads(r'''
{
  "model": "dreamina-seedance-2-5-260628",
  "prompt": "A red cube slowly rotates on a white background. Static camera.",
  "asset": false,
  "metadata": {
    "content": [
      {
        "type": "text",
        "text": "A red cube slowly rotates on a white background. Static camera."
      }
    ],
    "duration": 4,
    "ratio": "9:16",
    "resolution": "480p",
    "generate_audio": false
  }
}
''')
response = requests.post(
    "https://api.mixroute.ai/v1/video/generations",
    headers={"Authorization": "Bearer " + os.environ["MIXROUTE_API_KEY"]},
    json=payload,
    timeout=120,
)
response.raise_for_status()
result = response.json()
print(result)
```

## タスクの結果

送信時に返されるMixRouteタスクIDを保存し、[動画タスクの照会](/ja/api-reference/endpoint/query-video-task)をポーリングします。送信が成功するとタスクが作成されます。タスクが成功の終端状態に到達してから結果を読み取ってください。レスポンスエンベロープと結果の格納位置はルートによって異なります。


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