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

# Como usar o Atlas Cloud (início rápido)

> Para usar o Atlas Cloud, crie uma conta e uma chave de API, aponte seu OpenAI SDK para https://api.atlascloud.ai/v1 e chame qualquer modelo pelo seu ID — a API é OpenAI-compatible, então o código existente funciona com uma simples mudança de base_url.

Para usar o [Atlas Cloud](https://atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud), crie uma conta, gere uma chave de API e aponte seu OpenAI SDK existente para `https://api.atlascloud.ai/v1`. Como a API é OpenAI-compatible, você pode chamar qualquer um dos 400+ modelos pelo seu ID com o código que já possui — sem necessidade de reescrita.

## Introdução

O Atlas Cloud foi projetado para ser um substituto direto da API da OpenAI, então começar a usá-lo é basicamente uma questão de configuração, não de código novo. Este início rápido abrange a criação de conta, sua primeira requisição, a escolha de um modelo e o uso de modalidades além de texto.

## Principais Pontos

* **Duas configurações a alterar** — defina a URL base como `https://api.atlascloud.ai/v1` e use sua chave de API do Atlas Cloud.
* **Chame modelos pelo ID** — por exemplo, `deepseek-ai/DeepSeek-V3.1`; liste todos os modelos via `GET /v1/models`.
* **Funciona com as ferramentas existentes** — LangChain, LlamaIndex e o Vercel AI SDK funcionam sem alterações.
* **Uma chave para todas as modalidades** — a mesma conta cobre texto, imagem, vídeo, áudio e 3D.

## Passo 1 — Crie uma conta e uma chave de API

Cadastre-se em atlascloud.ai e gere uma chave de API no seu painel. Trate a chave como um segredo.

## Passo 2 — Aponte seu cliente para o Atlas Cloud

Defina a URL base e a chave. Com o OpenAI Python SDK:

```python
from openai import OpenAI

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

Ou via variáveis de ambiente:

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

## Passo 3 — Faça sua primeira requisição

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

O streaming funciona da mesma forma que na API da OpenAI (`stream=True`).

## Passo 4 — Escolha um modelo

Liste tudo que está disponível atualmente e troque o modelo alterando a string `model`:

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

Escolhas populares incluem [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)). Os IDs de modelos seguem o formato `provedor/nome-do-modelo`.

## Passo 5 — Use imagem, vídeo e outras modalidades

A mesma conta e chave também cobrem modelos de imagem como [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 modelos de vídeo como [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), por meio de seus endpoints de geração. Consulte a documentação para os formatos de requisição.

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

## Migrando da API da OpenAI

Como o Atlas Cloud é OpenAI-compatible, a migração geralmente envolve duas mudanças: defina `base_url` como `https://api.atlascloud.ai/v1` e substitua pela sua chave do Atlas Cloud. Em seguida, altere o `model` para um ID de modelo do Atlas Cloud. Os SDKs existentes, streaming e padrões de chamada de ferramentas continuam funcionando.

## Perguntas Frequentes

**Como obtenho uma chave de API?**
Crie uma conta em atlascloud.ai e gere uma chave no seu painel.

**Qual é a URL base?**
`https://api.atlascloud.ai/v1` — defina-a como sua URL base da OpenAI.

**Como escolho um modelo?**
Liste os modelos com `GET https://api.atlascloud.ai/v1/models` e defina o campo `model` com o ID desejado, por exemplo `deepseek-ai/DeepSeek-V3.1`.

**Minhas ferramentas OpenAI existentes funcionam?**
Sim — clientes e frameworks OpenAI-compatible (LangChain, LlamaIndex, Vercel AI SDK) funcionam após a mudança da URL base e da chave.

## Conclusão

Começar a usar o Atlas Cloud é uma questão de alterar a URL base e obter uma chave de API: aponte seu OpenAI SDK para `https://api.atlascloud.ai/v1` e chame qualquer modelo pelo ID. Consulte a documentação completa ou [comece em atlascloud.ai](https://atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud).