Providers

阿里雲百煉模型服務平台

內建的 alibaba 外掛為 Alibaba Model Studio(DashScope 的國際名稱)上的 Wan 模型註冊影片生成供應商。此供應商預設啟用,只需要 API 金鑰。

屬性
供應商 ID alibaba
外掛 內建,enabledByDefault: true
驗證環境變數 MODELSTUDIO_API_KEYDASHSCOPE_API_KEYQWEN_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

開始使用

  • 設定 API 金鑰

    透過初始設定將金鑰儲存至 alibaba 供應商:

    bash
    openclaw onboard --auth-choice alibaba-model-studio-api-key

    或直接傳入金鑰:

    bash
    openclaw onboard --alibaba-model-studio-api-key <your-key>

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

    bash
    export MODELSTUDIO_API_KEY=sk-...# 或 DASHSCOPE_API_KEY=...# 或 QWEN_API_KEY=...
  • 設定預設影片模型

    json5
    {  agents: {    defaults: {      videoGenerationModel: {        primary: "alibaba/wan2.6-t2v",      },    },  },}
  • 確認供應商已設定

    bash
    openclaw models list --provider alibaba

    清單包含全部五個內建的 Wan 模型。如果無法解析 MODELSTUDIO_API_KEYopenclaw models status --json 會在 auth.unusableProfiles 下回報缺少的認證資訊。

  • 內建 Wan 模型

    模型參照 模式
    alibaba/wan2.6-t2v 文字轉影片(預設)
    alibaba/wan2.6-i2v 圖片轉影片
    alibaba/wan2.6-r2v 參照轉影片
    alibaba/wan2.6-r2v-flash 參照轉影片(快速)
    alibaba/wan2.7-r2v 參照轉影片

    功能與限制

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

    模式 最大輸出影片數 最大輸入圖片數 最大輸入影片數 最長時間 支援的控制項
    文字轉影片 1 不適用 不適用 10 秒 sizeaspectRatioresolutionaudiowatermark
    圖片轉影片 1 1 不適用 10 秒 sizeaspectRatioresolutionaudiowatermark
    參照轉影片 1 不適用 4 10 秒 sizeaspectRatioresolutionaudiowatermark

    省略 durationSeconds 的請求會採用 DashScope 接受的預設值 5 秒。在影片生成工具上明確設定 durationSeconds,可將時間延長至 10 秒。

    進階設定

    覆寫 DashScope 基礎 URL

    供應商預設使用 DashScope 國際端點。若要指定中國地區端點:

    json5
    {  models: {    providers: {      alibaba: {        baseUrl: "https://dashscope.aliyuncs.com",      },    },  },}

    供應商會先移除結尾斜線,再建構 AIGC 工作 URL。

    驗證環境變數優先順序

    OpenClaw 會依下列順序從環境變數解析 Alibaba API 金鑰,並採用第一個非空值:

    1. MODELSTUDIO_API_KEY
    2. DASHSCOPE_API_KEY
    3. QWEN_API_KEY

    已設定的 auth.profiles 項目(透過 openclaw models auth login 設定)會覆寫環境變數解析。關於設定檔輪替、冷卻和覆寫機制,請參閱模型常見問題中的驗證設定檔

    與 Qwen 外掛的關係

    這兩個內建外掛都會與 DashScope 通訊,並接受部分重疊的 API 金鑰。請使用:

    • alibaba/wan*.* ID:用於本頁所述的專用 Wan 影片供應商。
    • qwen/* ID:用於 Qwen 聊天、嵌入和媒體理解(請參閱 Qwen)。

    由於驗證環境變數清單刻意重疊,只要設定一次 MODELSTUDIO_API_KEY 即可驗證這兩個外掛;不需要分別對每個外掛執行初始設定。

    相關內容

    Was this useful?
    On this page

    On this page