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

# 如何使用 Atlas Cloud（快速入门）

> 要使用 Atlas Cloud，请创建账户和 API 密钥，将 OpenAI SDK 指向 https://api.atlascloud.ai/v1，然后通过模型 ID 调用任意模型。该 API 与 OpenAI 兼容，因此只需修改 base_url，现有代码即可直接使用。

要使用 [Atlas Cloud](https://atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud)，请创建账户、生成 API 密钥，并将现有 OpenAI SDK 指向 `https://api.atlascloud.ai/v1`。由于该 API 与 OpenAI 兼容，你可以用现有代码通过模型 ID 调用 400+ 个模型，无需重写。

## 简介

Atlas Cloud 被设计为 OpenAI API 的直接替代品，因此上手主要是配置工作，而非编写新代码。本快速入门涵盖账户设置、第一个请求、选择模型以及使用非文本模态。

## 关键要点

* **只需修改两处配置** — 将 base URL 设置为 `https://api.atlascloud.ai/v1`，并使用你的 Atlas Cloud API 密钥。
* **通过 ID 调用模型** — 例如 `deepseek-ai/DeepSeek-V3.1`；通过 `GET /v1/models` 列出所有模型。
* **与现有工具兼容** — LangChain、LlamaIndex 和 Vercel AI SDK 无需修改即可使用。
* **一个密钥覆盖所有模态** — 同一账户支持文本、图像、视频、音频和 3D。

## 第一步 — 创建账户和 API 密钥

在 atlascloud.ai 注册并从控制台生成 API 密钥。请将密钥视为机密信息妥善保管。

## 第二步 — 将客户端指向 Atlas Cloud

设置 base URL 和密钥。使用 OpenAI Python SDK：

```python
from openai import OpenAI

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

或通过环境变量设置：

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

## 第三步 — 发起第一个请求

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

流式传输的使用方式与 OpenAI API 相同（`stream=True`）。

## 第四步 — 选择模型

列出当前可用的所有模型，并通过修改 `model` 字符串来切换模型：

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

热门选择包括 [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) 以及 Claude（[Anthropic](https://www.atlascloud.ai/models/anthropic?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud)）。模型 ID 采用 `provider/model-name` 格式。

## 第五步 — 使用图像、视频等模态

同一账户和密钥还支持图像模型，如 [FLUX](https://www.atlascloud.ai/models/flux?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud) 和 [Nano Banana](https://www.atlascloud.ai/models/nanobanana?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud)，以及视频模型，如 [Seedance](https://www.atlascloud.ai/models/seedance?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud) 和 [Veo](https://www.atlascloud.ai/models/veo?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud)，通过各自的生成端点调用。请参阅文档了解请求格式。

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

## 从 OpenAI API 迁移

由于 Atlas Cloud 与 OpenAI 兼容，迁移通常只需两处修改：将 `base_url` 设置为 `https://api.atlascloud.ai/v1`，并替换为你的 Atlas Cloud 密钥。然后将 `model` 修改为 Atlas Cloud 的模型 ID。现有的 SDK、流式传输和工具调用模式均可继续使用。

## 常见问题

**如何获取 API 密钥？**
在 atlascloud.ai 创建账户，并从控制台生成密钥。

**base URL 是什么？**
`https://api.atlascloud.ai/v1` — 将其设置为你的 OpenAI base URL。

**如何选择模型？**
使用 `GET https://api.atlascloud.ai/v1/models` 列出模型，并将 `model` 字段设置为你想要的 ID，例如 `deepseek-ai/DeepSeek-V3.1`。

**我现有的 OpenAI 工具还能用吗？**
可以。与 OpenAI 兼容的客户端和框架（LangChain、LlamaIndex、Vercel AI SDK）在修改 base URL 和密钥后即可正常使用。

## 总结

开始使用 Atlas Cloud 只需修改 base URL 并提供 API 密钥：将 OpenAI SDK 指向 `https://api.atlascloud.ai/v1`，然后通过 ID 调用任意模型。请参阅完整文档，或[前往 atlascloud.ai 开始使用](https://atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud)。