Providers

Alibaba Model Studio

번들 alibaba Plugin은 Alibaba Model Studio(DashScope의 국제 서비스명)의 Wan 모델용 동영상 생성 제공자를 등록합니다. 기본적으로 활성화되어 있으며 API 키만 있으면 됩니다.

속성
제공자 ID alibaba
Plugin 번들, enabledByDefault: true
인증 환경 변수 MODELSTUDIO_API_KEYDASHSCOPE_API_KEYQWEN_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

시작하기

  • API 키 설정

    온보딩을 통해 alibaba 제공자에 키를 저장합니다.

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

    또는 키를 직접 전달합니다.

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

    또는 Gateway를 시작하기 전에 허용되는 환경 변수 중 하나를 내보냅니다.

    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 모델 5개가 모두 포함됩니다. MODELSTUDIO_API_KEY를 확인할 수 없으면 openclaw models status --jsonauth.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초 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초까지 늘리려면 동영상 생성 도구에서 durationSeconds를 명시적으로 설정하세요.

    고급 구성

    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으로 설정)은 환경 변수 확인보다 우선합니다. 프로필 순환, 쿨다운 및 재정의 방식은 모델 FAQ의 인증 프로필을 참조하세요.

    Qwen Plugin과의 관계

    두 번들 Plugin 모두 DashScope와 통신하며 일부 동일한 API 키를 허용합니다. 다음과 같이 사용하세요.

    • 이 페이지에 설명된 전용 Wan 동영상 제공자에는 alibaba/wan*.* ID를 사용합니다.
    • Qwen 채팅, 임베딩 및 미디어 이해에는 qwen/* ID를 사용합니다(Qwen 참조).

    인증 환경 변수 목록이 의도적으로 겹치므로 MODELSTUDIO_API_KEY를 한 번 설정하면 두 Plugin 모두 인증됩니다. 각 Plugin을 별도로 온보딩할 필요가 없습니다.

    관련 문서

    Was this useful?
    On this page

    On this page