> ## 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` 外掛為 Alibaba Model Studio（DashScope 的國際名稱）上的 Wan 模型註冊影片生成供應商。此供應商預設啟用，只需要 API 金鑰。

| 屬性        | 值                                                                       |
| --------- | ----------------------------------------------------------------------- |
| 供應商 ID    | `alibaba`                                                               |
| 外掛        | 內建，`enabledByDefault: true`                                             |
| 驗證環境變數    | `MODELSTUDIO_API_KEY` → `DASHSCOPE_API_KEY` → `QWEN_API_KEY`（採用第一個相符項目） |
| 初始設定旗標    | `--auth-choice alibaba-model-studio-api-key`                            |
| 直接命令列介面旗標 | `--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>
    ```

    或在啟動閘道前匯出任一可接受的環境變數：

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    export MODELSTUDIO_API_KEY=sk-...
    # 或 DASHSCOPE_API_KEY=...
    # 或 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
    ```

    清單包含全部五個內建的 Wan 模型。如果無法解析 `MODELSTUDIO_API_KEY`，`openclaw models status --json` 會在 `auth.unusableProfiles` 下回報缺少的認證資訊。
  </Step>
</Steps>

<Note>
  Alibaba 外掛和 [Qwen 外掛](/zh-TW/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`       | 參照轉影片     |

## 功能與限制

這三種模式的每次請求影片數量與時間長度上限皆相同，只有輸入格式不同。

| 模式    | 最大輸出影片數 | 最大輸入圖片數 | 最大輸入影片數 | 最長時間 | 支援的控制項                                                |
| ----- | ------- | ------- | ------- | ---- | ----------------------------------------------------- |
| 文字轉影片 | 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 秒**。在[影片生成工具](/zh-TW/tools/video-generation)上明確設定 `durationSeconds`，可將時間延長至 10 秒。

<Warning>
  參照圖片和影片輸入必須是遠端 `http(s)` URL；DashScope 的參照模式會拒絕本機檔案路徑。請先上傳至物件儲存空間，或使用已能產生公開 URL 的[媒體工具](/zh-TW/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` 設定）會覆寫環境變數解析。關於設定檔輪替、冷卻和覆寫機制，請參閱[模型常見問題中的驗證設定檔](/zh-TW/help/faq-models#auth-profiles-what-they-are-and-how-to-manage-them)。
  </Accordion>

  <Accordion title="與 Qwen 外掛的關係">
    這兩個內建外掛都會與 DashScope 通訊，並接受部分重疊的 API 金鑰。請使用：

    * `alibaba/wan*.*` ID：用於本頁所述的專用 Wan 影片供應商。
    * `qwen/*` ID：用於 Qwen 聊天、嵌入和媒體理解（請參閱 [Qwen](/zh-TW/providers/qwen)）。

    由於驗證環境變數清單刻意重疊，只要設定一次 `MODELSTUDIO_API_KEY` 即可驗證這兩個外掛；不需要分別對每個外掛執行初始設定。
  </Accordion>
</AccordionGroup>

## 相關內容

<CardGroup cols={2}>
  <Card title="影片生成" href="/zh-TW/tools/video-generation" icon="video">
    共用影片工具參數和供應商選擇。
  </Card>

  <Card title="Qwen" href="/zh-TW/providers/qwen" icon="microchip">
    使用相同 DashScope 驗證的 Qwen 聊天、嵌入和媒體理解設定。
  </Card>

  <Card title="設定參考" href="/zh-TW/gateway/config-agents#agent-defaults" icon="gear">
    代理程式預設值和模型設定。
  </Card>

  <Card title="模型常見問題" href="/zh-TW/help/faq-models" icon="circle-question">
    驗證設定檔、切換模型，以及解決「無設定檔」錯誤。
  </Card>
</CardGroup>