<!-- Canonical URL: https://ask.atlascloud.ai/ja/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 のドロップイン代替として設計されているため、始めるにあたって必要なのは新しいコードではなく、主に設定の変更です。このクイックスタートでは、アカウントのセットアップ、初回リクエスト、モデルの選択、テキスト以外のモダリティの利用方法を説明します。

## 重要なポイント

* **変更箇所は 2 つ** — base URL を `https://api.atlascloud.ai/v1` に設定し、Atlas Cloud の API キーを使用します。
* **モデル ID で呼び出す** — 例: `deepseek-ai/DeepSeek-V3.1`。全モデルは `GET /v1/models` で一覧取得できます。
* **既存のツールで動作** — LangChain、LlamaIndex、Vercel AI SDK はそのまま使用できます。
* **1 つのキーですべてのモダリティに対応** — テキスト、画像、動画、音声、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 なため、移行は通常 2 つの変更だけで完了します。`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)。