<!-- Canonical URL: https://ask.atlascloud.ai/it/how-to-use-atlas-cloud -->

# Come usare Atlas Cloud (guida rapida)

> Per usare Atlas Cloud, crea un account e una chiave API, punta il tuo OpenAI SDK su https://api.atlascloud.ai/v1 e chiama qualsiasi modello tramite il suo ID — l'API è OpenAI-compatible, quindi il codice esistente funziona con una semplice modifica del base_url.

Per usare [Atlas Cloud](https://atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud), crea un account, genera una chiave API e punta il tuo OpenAI SDK esistente su `https://api.atlascloud.ai/v1`. Poiché l'API è OpenAI-compatible, puoi chiamare qualsiasi modello tra i 400+ disponibili tramite il suo ID con il codice esistente, senza riscrivere nulla.

## Introduzione

Atlas Cloud è progettato per essere un sostituto drop-in dell'API OpenAI, quindi iniziare richiede principalmente configurazione piuttosto che nuovo codice. Questa guida rapida copre la creazione dell'account, la prima richiesta, la scelta del modello e l'uso di modalità non testuali.

## Punti chiave

* **Due impostazioni da modificare** — imposta il base URL su `https://api.atlascloud.ai/v1` e usa la tua chiave API di Atlas Cloud.
* **Chiama i modelli tramite ID** — ad es. `deepseek-ai/DeepSeek-V3.1`; elenca tutti i modelli con `GET /v1/models`.
* **Compatibile con gli strumenti esistenti** — LangChain, LlamaIndex e il Vercel AI SDK funzionano senza modifiche.
* **Una sola chiave per ogni modalità** — lo stesso account copre testo, immagini, video, audio e 3D.

## Passaggio 1 — Crea un account e una chiave API

Registrati su atlascloud.ai e genera una chiave API dalla tua dashboard. Tratta la chiave come un segreto.

## Passaggio 2 — Punta il tuo client su Atlas Cloud

Imposta il base URL e la chiave. Con l'OpenAI Python SDK:

```python
from openai import OpenAI

client = OpenAI(
    base_url="https://api.atlascloud.ai/v1",
    api_key="sk-atlas-...",
)
```

Oppure tramite variabili d'ambiente:

```bash
export OPENAI_BASE_URL="https://api.atlascloud.ai/v1"
export OPENAI_API_KEY="sk-atlas-..."
```

## Passaggio 3 — Effettua la tua prima richiesta

```python
resp = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-V3.1",
    messages=[{"role": "user", "content": "Explain serverless inference in one sentence."}],
)
print(resp.choices[0].message.content)
```

Lo streaming funziona allo stesso modo dell'API OpenAI (`stream=True`).

## Passaggio 4 — Scegli un modello

Elenca tutto ciò che è attualmente disponibile e cambia modello modificando la stringa `model`:

```bash
curl https://api.atlascloud.ai/v1/models
```

Tra le scelte più popolari ci sono [DeepSeek](https://www.atlascloud.ai/models/deepseek?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud), [GLM](https://www.atlascloud.ai/models/glm?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud), [Qwen](https://www.atlascloud.ai/models/qwen?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud), [Gemini](https://www.atlascloud.ai/models/gemini?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud) e Claude ([Anthropic](https://www.atlascloud.ai/models/anthropic?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud)). Gli ID dei modelli seguono il formato `provider/nome-modello`.

## Passaggio 5 — Usa immagini, video e altre modalità

Lo stesso account e la stessa chiave coprono anche i modelli per immagini come [FLUX](https://www.atlascloud.ai/models/flux?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud) e [Nano Banana](https://www.atlascloud.ai/models/nanobanana?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud), e i modelli per video come [Seedance](https://www.atlascloud.ai/models/seedance?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud) e [Veo](https://www.atlascloud.ai/models/veo?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud), tramite i rispettivi endpoint di generazione. Consulta la documentazione per i formati delle richieste.

<!-- TODO(Carol): 补充图像/视频生成的具体端点与请求示例(需工程确认调用方式);确认 docs 与控制台/API key 页面的最终 URL。 -->

## Migrazione dall'API OpenAI

Poiché Atlas Cloud è OpenAI-compatible, la migrazione richiede di solito due modifiche: imposta `base_url` su `https://api.atlascloud.ai/v1` e sostituisci la chiave con quella di Atlas Cloud. Poi cambia il `model` con un ID modello di Atlas Cloud. Gli SDK esistenti, lo streaming e i pattern di tool-calling continuano a funzionare.

## Domande frequenti

**Come ottengo una chiave API?**
Crea un account su atlascloud.ai e genera una chiave dalla tua dashboard.

**Qual è il base URL?**
`https://api.atlascloud.ai/v1` — impostalo come base URL di OpenAI.

**Come scelgo un modello?**
Elenca i modelli con `GET https://api.atlascloud.ai/v1/models` e imposta il campo `model` sull'ID desiderato, ad es. `deepseek-ai/DeepSeek-V3.1`.

**I miei strumenti OpenAI esistenti funzionano?**
Sì — i client e i framework OpenAI-compatible (LangChain, LlamaIndex, Vercel AI SDK) funzionano dopo aver cambiato il base URL e la chiave.

## Conclusione

Iniziare con Atlas Cloud richiede una modifica al base URL e una chiave API: punta il tuo OpenAI SDK su `https://api.atlascloud.ai/v1` e chiama qualsiasi modello tramite ID. Consulta la documentazione completa oppure [inizia su atlascloud.ai](https://atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud).