Providers
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 |
시작하기
API 키 설정
온보딩을 통해 alibaba 제공자에 키를 저장합니다.
openclaw onboard --auth-choice alibaba-model-studio-api-key또는 키를 직접 전달합니다.
openclaw onboard --alibaba-model-studio-api-key <your-key>또는 Gateway를 시작하기 전에 허용되는 환경 변수 중 하나를 내보냅니다.
export MODELSTUDIO_API_KEY=sk-...# 또는 DASHSCOPE_API_KEY=...# 또는 QWEN_API_KEY=...기본 동영상 모델 설정
{ agents: { defaults: { videoGenerationModel: { primary: "alibaba/wan2.6-t2v", }, }, },}제공자 구성 확인
openclaw models list --provider alibaba목록에는 번들 Wan 모델 5개가 모두 포함됩니다. MODELSTUDIO_API_KEY를 확인할 수 없으면 openclaw 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초 | 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 엔드포인트를 사용합니다. 중국 리전 엔드포인트를 대상으로 지정하려면 다음과 같이 설정합니다.
{ models: { providers: { alibaba: { baseUrl: "https://dashscope.aliyuncs.com", }, }, },}제공자는 AIGC 작업 URL을 구성하기 전에 후행 슬래시를 제거합니다.
인증 환경 변수 우선순위
OpenClaw는 다음 순서로 환경 변수에서 Alibaba API 키를 확인하며, 비어 있지 않은 첫 번째 값을 사용합니다.
MODELSTUDIO_API_KEYDASHSCOPE_API_KEYQWEN_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을 별도로 온보딩할 필요가 없습니다.