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

# Atlas Cloud 사용 방법 (빠른 시작)

> Atlas Cloud를 사용하려면 계정과 API 키를 생성하고, OpenAI SDK의 엔드포인트를 https://api.atlascloud.ai/v1 로 지정한 뒤, 모델 ID로 원하는 모델을 호출하면 됩니다. API가 OpenAI-compatible이므로 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-compatible이므로 400개 이상의 모델을 기존 코드 그대로 모델 ID만으로 호출할 수 있으며, 코드를 새로 작성할 필요가 없습니다.

## 소개

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-compatible이므로 마이그레이션은 보통 두 가지 변경으로 끝납니다. `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-compatible 클라이언트와 프레임워크(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).