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

# Cách sử dụng Atlas Cloud (hướng dẫn nhanh)

> Để sử dụng Atlas Cloud, hãy tạo tài khoản và API key, trỏ OpenAI SDK của bạn vào https://api.atlascloud.ai/v1, và gọi bất kỳ mô hình nào theo ID của nó — API tương thích OpenAI-compatible, vì vậy code hiện có hoạt động chỉ với một thay đổi base_url.

Để sử dụng [Atlas Cloud](https://atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud), hãy tạo tài khoản, tạo API key, và trỏ OpenAI SDK hiện có của bạn vào `https://api.atlascloud.ai/v1`. Vì API tương thích OpenAI-compatible, bạn có thể gọi bất kỳ mô hình nào trong số hơn 400 mô hình theo ID của nó bằng code hiện có — không cần viết lại.

## Giới thiệu

Atlas Cloud được thiết kế để thay thế trực tiếp cho OpenAI API, vì vậy việc bắt đầu chủ yếu là cấu hình thay vì viết code mới. Hướng dẫn nhanh này bao gồm thiết lập tài khoản, yêu cầu đầu tiên, chọn mô hình và sử dụng các phương thức phi văn bản.

## Điểm chính

* **Hai cài đặt cần thay đổi** — đặt base URL thành `https://api.atlascloud.ai/v1` và sử dụng Atlas Cloud API key của bạn.
* **Gọi mô hình theo ID** — ví dụ: `deepseek-ai/DeepSeek-V3.1`; liệt kê tất cả mô hình qua `GET /v1/models`.
* **Hoạt động với các công cụ hiện có** — LangChain, LlamaIndex, và Vercel AI SDK hoạt động không cần thay đổi.
* **Một key cho mọi phương thức** — cùng một tài khoản hỗ trợ văn bản, hình ảnh, video, âm thanh và 3D.

## Bước 1 — Tạo tài khoản và API key

Đăng ký tại atlascloud.ai và tạo API key từ bảng điều khiển của bạn. Hãy bảo mật key như một thông tin bí mật.

## Bước 2 — Trỏ client của bạn vào Atlas Cloud

Đặt base URL và key. Với OpenAI Python SDK:

```python
from openai import OpenAI

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

Hoặc thông qua biến môi trường:

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

## Bước 3 — Thực hiện yêu cầu đầu tiên

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

Streaming hoạt động theo cách tương tự như OpenAI API (`stream=True`).

## Bước 4 — Chọn mô hình

Liệt kê tất cả những gì hiện có và chuyển đổi bằng cách thay đổi chuỗi `model`:

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

Các lựa chọn phổ biến bao gồm [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), và Claude ([Anthropic](https://www.atlascloud.ai/models/anthropic?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud)). ID mô hình theo định dạng `provider/model-name`.

## Bước 5 — Sử dụng hình ảnh, video và các phương thức khác

Cùng một tài khoản và key cũng hỗ trợ các mô hình hình ảnh như [FLUX](https://www.atlascloud.ai/models/flux?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud) và [Nano Banana](https://www.atlascloud.ai/models/nanobanana?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud), cũng như các mô hình video như [Seedance](https://www.atlascloud.ai/models/seedance?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud) và [Veo](https://www.atlascloud.ai/models/veo?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud), thông qua các endpoint tạo nội dung của chúng. Xem tài liệu để biết định dạng yêu cầu.

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

## Chuyển từ OpenAI API

Vì Atlas Cloud tương thích OpenAI-compatible, việc chuyển đổi thường chỉ cần hai thay đổi: đặt `base_url` thành `https://api.atlascloud.ai/v1` và thay thế bằng Atlas Cloud key của bạn. Sau đó thay đổi `model` thành ID mô hình của Atlas Cloud. Các SDK, streaming và tool-calling pattern hiện có vẫn tiếp tục hoạt động.

## Câu hỏi thường gặp

**Làm cách nào để lấy API key?**
Tạo tài khoản tại atlascloud.ai và tạo key từ bảng điều khiển của bạn.

**Base URL là gì?**
`https://api.atlascloud.ai/v1` — đặt nó làm OpenAI base URL của bạn.

**Làm cách nào để chọn mô hình?**
Liệt kê các mô hình với `GET https://api.atlascloud.ai/v1/models` và đặt trường `model` thành ID bạn muốn, ví dụ: `deepseek-ai/DeepSeek-V3.1`.

**Các công cụ OpenAI hiện có của tôi có hoạt động không?**
Có — các client và framework tương thích OpenAI-compatible (LangChain, LlamaIndex, Vercel AI SDK) hoạt động sau khi thay đổi base URL và key.

## Kết luận

Bắt đầu với Atlas Cloud chỉ là thay đổi base URL cộng với một API key: trỏ OpenAI SDK của bạn vào `https://api.atlascloud.ai/v1` và gọi bất kỳ mô hình nào theo ID. Xem tài liệu đầy đủ, hoặc [bắt đầu tại atlascloud.ai](https://atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud).