<!-- Canonical URL: https://ask.atlascloud.ai/zh-TW/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。

## 步驟 1 — 建立帳號與 API 金鑰

前往 atlascloud.ai 註冊，並從儀表板產生 API 金鑰。請將金鑰視為機密妥善保管。

## 步驟 2 — 將用戶端指向 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-..."
```

## 步驟 3 — 發出第一個請求

```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`）。

## 步驟 4 — 選擇模型

列出目前所有可用模型，並透過更改 `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` 格式。

## 步驟 5 — 使用圖像、影片及其他模態

同一帳號與金鑰也支援圖像模型（如 [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)。