> ## 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

OpenClaw include un plugin `alibaba` in bundle che registra un provider per la generazione video per i modelli Wan su Alibaba Model Studio (il nome internazionale di DashScope). Il plugin è abilitato per impostazione predefinita; devi solo impostare una chiave API.

| Proprietà            | Valore                                                                                       |
| -------------------- | -------------------------------------------------------------------------------------------- |
| ID provider          | `alibaba`                                                                                    |
| Plugin               | in bundle, `enabledByDefault: true`                                                          |
| Variabili env auth   | `MODELSTUDIO_API_KEY` → `DASHSCOPE_API_KEY` → `QWEN_API_KEY` (vince la prima corrispondenza) |
| Flag onboarding      | `--auth-choice alibaba-model-studio-api-key`                                                 |
| Flag CLI diretto     | `--alibaba-model-studio-api-key <key>`                                                       |
| Modello predefinito  | `alibaba/wan2.6-t2v`                                                                         |
| URL base predefinito | `https://dashscope-intl.aliyuncs.com`                                                        |

## Per iniziare

<Steps>
  <Step title="Imposta una chiave API">
    Usa l'onboarding per archiviare la chiave per il provider `alibaba`:

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

    Oppure passa la chiave direttamente durante l'installazione/onboarding:

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

    Oppure esporta una qualsiasi delle variabili env accettate prima di avviare il 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="Imposta un modello video predefinito">
    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      agents: {
        defaults: {
          videoGenerationModel: {
            primary: "alibaba/wan2.6-t2v",
          },
        },
      },
    }
    ```
  </Step>

  <Step title="Verifica che il provider sia configurato">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw models list --provider alibaba
    ```

    L'elenco dovrebbe includere tutti e cinque i modelli Wan inclusi in bundle. Se `MODELSTUDIO_API_KEY` non viene risolta, `openclaw models status --json` segnala la credenziale mancante in `auth.unusableProfiles`.
  </Step>
</Steps>

<Note>
  Il plugin Alibaba e il [plugin Qwen](/it/providers/qwen) si autenticano entrambi su DashScope e accettano variabili env sovrapposte. Usa gli ID modello `alibaba/...` per utilizzare la superficie video Wan dedicata; usa gli ID `qwen/...` quando vuoi la superficie di chat, embedding o comprensione dei media di Qwen.
</Note>

## Modelli Wan integrati

| Riferimento modello        | Modalità                   |
| -------------------------- | -------------------------- |
| `alibaba/wan2.6-t2v`       | Testo-video (predefinito)  |
| `alibaba/wan2.6-i2v`       | Immagine-video             |
| `alibaba/wan2.6-r2v`       | Riferimento-video          |
| `alibaba/wan2.6-r2v-flash` | Riferimento-video (rapido) |
| `alibaba/wan2.7-r2v`       | Riferimento-video          |

## Capacità e limiti

Il provider incluso in bundle rispecchia i limiti dell'API video Wan di DashScope. Tutte e tre le modalità condividono lo stesso conteggio video per richiesta e lo stesso limite di durata; cambia solo la forma dell'input.

| Modalità          | Video di output max | Immagini di input max | Video di input max | Durata max | Controlli supportati                                      |
| ----------------- | ------------------- | --------------------- | ------------------ | ---------- | --------------------------------------------------------- |
| Testo-video       | 1                   | n/a                   | n/a                | 10 s       | `size`, `aspectRatio`, `resolution`, `audio`, `watermark` |
| Immagine-video    | 1                   | 1                     | n/a                | 10 s       | `size`, `aspectRatio`, `resolution`, `audio`, `watermark` |
| Riferimento-video | 1                   | n/a                   | 4                  | 10 s       | `size`, `aspectRatio`, `resolution`, `audio`, `watermark` |

Quando una richiesta omette `durationSeconds`, il provider invia il valore predefinito accettato da DashScope di **5 secondi**. Imposta esplicitamente `durationSeconds` nello [strumento di generazione video](/it/tools/video-generation) per arrivare fino a 10 s.

<Warning>
  Gli input di immagini e video di riferimento devono essere URL `http(s)` remoti. I percorsi di file locali non sono accettati dalle modalità di riferimento di DashScope; caricali prima su un object storage oppure usa il flusso dello [strumento media](/it/tools/media-overview) che produce già un URL pubblico.
</Warning>

## Configurazione avanzata

<AccordionGroup>
  <Accordion title="Sovrascrivi l'URL base di DashScope">
    Il provider usa per impostazione predefinita l'endpoint internazionale di DashScope. Per indirizzare l'endpoint della regione Cina, imposta:

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

    Il provider rimuove le barre finali prima di costruire gli URL delle attività AIGC.
  </Accordion>

  <Accordion title="Priorità env auth">
    OpenClaw risolve la chiave API Alibaba dalle variabili di ambiente in quest'ordine, prendendo il primo valore non vuoto:

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

    Le voci `auth.profiles` configurate (impostate tramite `openclaw models auth login`) sovrascrivono la risoluzione delle variabili env. Consulta [Profili auth nelle FAQ sui modelli](/it/help/faq-models#what-is-an-auth-profile) per la rotazione dei profili, il cooldown e i meccanismi di sovrascrittura.
  </Accordion>

  <Accordion title="Relazione con il plugin Qwen">
    Entrambi i plugin inclusi in bundle comunicano con DashScope e accettano chiavi API sovrapposte. Usa:

    * gli ID `alibaba/wan*.*` per utilizzare il provider video Wan dedicato documentato in questa pagina.
    * gli ID `qwen/*` per chat, embedding e comprensione dei media Qwen (vedi [Qwen](/it/providers/qwen)).

    Impostare una sola volta `MODELSTUDIO_API_KEY` autentica entrambi i plugin perché l'elenco delle variabili env auth è intenzionalmente sovrapposto; non devi eseguire l'onboarding di ciascun plugin separatamente.
  </Accordion>
</AccordionGroup>

## Correlati

<CardGroup cols={2}>
  <Card title="Generazione video" href="/it/tools/video-generation" icon="video">
    Parametri dello strumento video condiviso e selezione del provider.
  </Card>

  <Card title="Qwen" href="/it/providers/qwen" icon="microchip">
    Configurazione di chat, embedding e comprensione dei media Qwen con la stessa auth DashScope.
  </Card>

  <Card title="Riferimento di configurazione" href="/it/gateway/config-agents#agent-defaults" icon="gear">
    Valori predefiniti agent e configurazione dei modelli.
  </Card>

  <Card title="FAQ modelli" href="/it/help/faq-models" icon="circle-question">
    Profili auth, cambio di modello e risoluzione degli errori "no profile".
  </Card>
</CardGroup>