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

# Alibaba Model Studio

同梱の `alibaba` Plugin は、Alibaba Model Studio（DashScope の国際向け名称）の Wan モデル向け動画生成プロバイダーを登録します。デフォルトで有効化されており、必要なのは API キーだけです。

| プロパティ        | 値                                                                      |
| ------------ | ---------------------------------------------------------------------- |
| プロバイダー ID    | `alibaba`                                                              |
| Plugin       | 同梱、`enabledByDefault: true`                                            |
| 認証環境変数       | `MODELSTUDIO_API_KEY` → `DASHSCOPE_API_KEY` → `QWEN_API_KEY`（最初の一致が優先） |
| オンボーディングフラグ  | `--auth-choice alibaba-model-studio-api-key`                           |
| 直接 CLI フラグ   | `--alibaba-model-studio-api-key <key>`                                 |
| デフォルトモデル     | `alibaba/wan2.6-t2v`                                                   |
| デフォルトベース URL | `https://dashscope-intl.aliyuncs.com`                                  |

## はじめに

<Steps>
  <Step title="API キーを設定する">
    オンボーディングで `alibaba` プロバイダーに対してキーを保存します。

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw onboard --auth-choice alibaba-model-studio-api-key
    ```

    または、キーを直接渡します。

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw onboard --alibaba-model-studio-api-key <your-key>
    ```

    または、Gateway を起動する前に、受け付けられる環境変数のいずれかをエクスポートします。

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    export MODELSTUDIO_API_KEY=sk-...
    # or DASHSCOPE_API_KEY=...
    # or QWEN_API_KEY=...
    ```
  </Step>

  <Step title="デフォルトの動画モデルを設定する">
    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      agents: {
        defaults: {
          videoGenerationModel: {
            primary: "alibaba/wan2.6-t2v",
          },
        },
      },
    }
    ```
  </Step>

  <Step title="プロバイダーが構成されていることを確認する">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw models list --provider alibaba
    ```

    一覧には、同梱されている 5 つすべての Wan モデルが含まれます。`MODELSTUDIO_API_KEY` を解決できない場合、`openclaw models status --json` は不足している認証情報を `auth.unusableProfiles` の下に報告します。
  </Step>
</Steps>

<Note>
  Alibaba Plugin と [Qwen Plugin](/ja-JP/providers/qwen) はどちらも DashScope に対して認証し、重複する環境変数を受け付けます。専用の Wan 動画サーフェスには `alibaba/...` モデル ID を使用し、Qwen のチャット、埋め込み、またはメディア理解には `qwen/...` ID を使用します。
</Note>

## 組み込み Wan モデル

| モデル参照                      | モード             |
| -------------------------- | --------------- |
| `alibaba/wan2.6-t2v`       | テキストから動画（デフォルト） |
| `alibaba/wan2.6-i2v`       | 画像から動画          |
| `alibaba/wan2.6-r2v`       | 参照から動画          |
| `alibaba/wan2.6-r2v-flash` | 参照から動画（高速）      |
| `alibaba/wan2.7-r2v`       | 参照から動画          |

## 機能と制限

3 つのモードはすべて、リクエストごとの動画数と長さの上限を共有します。異なるのは入力形式だけです。

| モード      | 最大出力動画数 | 最大入力画像数 | 最大入力動画数 | 最大長  | サポートされる制御                                                 |
| -------- | ------- | ------- | ------- | ---- | --------------------------------------------------------- |
| テキストから動画 | 1       | 該当なし    | 該当なし    | 10 秒 | `size`, `aspectRatio`, `resolution`, `audio`, `watermark` |
| 画像から動画   | 1       | 1       | 該当なし    | 10 秒 | `size`, `aspectRatio`, `resolution`, `audio`, `watermark` |
| 参照から動画   | 1       | 該当なし    | 4       | 10 秒 | `size`, `aspectRatio`, `resolution`, `audio`, `watermark` |

`durationSeconds` を省略したリクエストには、DashScope が受け付けるデフォルトの **5 秒** が使われます。最大 10 秒まで延長するには、[動画生成ツール](/ja-JP/tools/video-generation)で `durationSeconds` を明示的に設定します。

<Warning>
  参照画像および動画入力は、リモートの `http(s)` URL である必要があります。DashScope の参照モードはローカルファイルパスを拒否します。先にオブジェクトストレージへアップロードするか、すでに公開 URL を生成する [メディアツール](/ja-JP/tools/media-overview)のフローを使用してください。
</Warning>

## 高度な構成

<AccordionGroup>
  <Accordion title="DashScope ベース URL を上書きする">
    プロバイダーはデフォルトで国際向け DashScope エンドポイントを使用します。中国リージョンのエンドポイントを対象にするには、次のようにします。

    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      models: {
        providers: {
          alibaba: {
            baseUrl: "https://dashscope.aliyuncs.com",
          },
        },
      },
    }
    ```

    プロバイダーは、AIGC タスク URL を構築する前に末尾のスラッシュを削除します。
  </Accordion>

  <Accordion title="認証環境変数の優先順位">
    OpenClaw は、次の順序で環境変数から Alibaba API キーを解決し、最初の空でない値を使用します。

    1. `MODELSTUDIO_API_KEY`
    2. `DASHSCOPE_API_KEY`
    3. `QWEN_API_KEY`

    構成済みの `auth.profiles` エントリ（`openclaw models auth login` で設定）は、環境変数による解決を上書きします。プロファイルのローテーション、クールダウン、上書きの仕組みについては、[モデル FAQ の認証プロファイル](/ja-JP/help/faq-models#auth-profiles-what-they-are-and-how-to-manage-them)を参照してください。
  </Accordion>

  <Accordion title="Qwen Plugin との関係">
    同梱されている両方の Plugin は DashScope と通信し、重複する API キーを受け付けます。用途は次のとおりです。

    * このページで説明している専用の Wan 動画プロバイダーには `alibaba/wan*.*` ID を使用します。
    * Qwen のチャット、埋め込み、メディア理解には `qwen/*` ID を使用します（[Qwen](/ja-JP/providers/qwen) を参照）。

    認証環境変数の一覧は意図的に重複しているため、`MODELSTUDIO_API_KEY` を一度設定すれば両方の Plugin が認証されます。各 Plugin を個別にオンボーディングする必要はありません。
  </Accordion>
</AccordionGroup>

## 関連

<CardGroup cols={2}>
  <Card title="動画生成" href="/ja-JP/tools/video-generation" icon="video">
    共有動画ツールのパラメーターとプロバイダー選択。
  </Card>

  <Card title="Qwen" href="/ja-JP/providers/qwen" icon="microchip">
    同じ DashScope 認証での Qwen チャット、埋め込み、メディア理解のセットアップ。
  </Card>

  <Card title="構成リファレンス" href="/ja-JP/gateway/config-agents#agent-defaults" icon="gear">
    エージェントのデフォルトとモデル構成。
  </Card>

  <Card title="モデル FAQ" href="/ja-JP/help/faq-models" icon="circle-question">
    認証プロファイル、モデルの切り替え、「no profile」エラーの解決。
  </Card>
</CardGroup>