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

# Cómo usar Atlas Cloud (inicio rápido)

> Para usar Atlas Cloud, crea una cuenta y una API key, apunta tu OpenAI SDK a https://api.atlascloud.ai/v1 y llama a cualquier modelo por su ID. La API es OpenAI-compatible, por lo que el código existente funciona con solo cambiar la base URL.

Para usar [Atlas Cloud](https://atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud), crea una cuenta, genera una API key y apunta tu OpenAI SDK existente a `https://api.atlascloud.ai/v1`. Como la API es OpenAI-compatible, puedes llamar a cualquiera de los más de 400 modelos por su ID con tu código actual, sin necesidad de reescribirlo.

## Introducción

Atlas Cloud está diseñado para ser un reemplazo directo de la API de OpenAI, por lo que comenzar a usarlo es principalmente una cuestión de configuración, no de código nuevo. Este inicio rápido cubre la configuración de la cuenta, tu primera solicitud, la elección de un modelo y el uso de modalidades no textuales.

## Puntos clave

* **Dos ajustes para cambiar** — establece la base URL en `https://api.atlascloud.ai/v1` y usa tu API key de Atlas Cloud.
* **Llama a los modelos por ID** — por ejemplo, `deepseek-ai/DeepSeek-V3.1`; lista todos los modelos con `GET /v1/models`.
* **Funciona con herramientas existentes** — LangChain, LlamaIndex y el Vercel AI SDK funcionan sin cambios.
* **Una sola key para todas las modalidades** — la misma cuenta cubre texto, imagen, video, audio y 3D.

## Paso 1 — Crea una cuenta y una API key

Regístrate en atlascloud.ai y genera una API key desde tu panel de control. Trata la key como un secreto.

## Paso 2 — Apunta tu cliente a Atlas Cloud

Establece la base URL y la key. Con el OpenAI Python SDK:

```python
from openai import OpenAI

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

O mediante variables de entorno:

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

## Paso 3 — Haz tu primera solicitud

```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)
```

El streaming funciona de la misma manera que en la API de OpenAI (`stream=True`).

## Paso 4 — Elige un modelo

Lista todo lo disponible actualmente y cambia de modelo modificando el string `model`:

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

Las opciones más populares incluyen [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) y Claude ([Anthropic](https://www.atlascloud.ai/models/anthropic?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud)). Los IDs de modelo siguen el formato `proveedor/nombre-de-modelo`.

## Paso 5 — Usa imágenes, video y otras modalidades

La misma cuenta y key también cubren modelos de imagen como [FLUX](https://www.atlascloud.ai/models/flux?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud) y [Nano Banana](https://www.atlascloud.ai/models/nanobanana?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud), y modelos de video como [Seedance](https://www.atlascloud.ai/models/seedance?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud) y [Veo](https://www.atlascloud.ai/models/veo?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud), a través de sus endpoints de generación. Consulta la documentación para conocer los formatos de solicitud.

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

## Migrar desde la API de OpenAI

Como Atlas Cloud es OpenAI-compatible, la migración generalmente implica dos cambios: establecer `base_url` en `https://api.atlascloud.ai/v1` e intercambiar tu API key de Atlas Cloud. Luego cambia el `model` a un ID de modelo de Atlas Cloud. Los SDKs existentes, el streaming y los patrones de llamada a herramientas siguen funcionando.

## Preguntas frecuentes

**¿Cómo obtengo una API key?**
Crea una cuenta en atlascloud.ai y genera una key desde tu panel de control.

**¿Cuál es la base URL?**
`https://api.atlascloud.ai/v1` — establécela como tu base URL de OpenAI.

**¿Cómo elijo un modelo?**
Lista los modelos con `GET https://api.atlascloud.ai/v1/models` y establece el campo `model` con el ID que deseas, por ejemplo `deepseek-ai/DeepSeek-V3.1`.

**¿Funcionan mis herramientas de OpenAI existentes?**
Sí. Los clientes y frameworks OpenAI-compatible (LangChain, LlamaIndex, Vercel AI SDK) funcionan tras cambiar la base URL y la key.

## Conclusión

Comenzar con Atlas Cloud implica cambiar la base URL y agregar una API key: apunta tu OpenAI SDK a `https://api.atlascloud.ai/v1` y llama a cualquier modelo por su ID. Consulta la documentación completa o [comienza en atlascloud.ai](https://atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud).