API キー

API キーは、Atlas Cloud API へのリクエストを認証するために使用されます。すべての API コールに有効な API キーが必要です。

API キーの作成

API Keys を開く
API キーを作成 をクリック
新しい API キーをコピーして安全に保管

API キーの作成

API キーは作成時に一度だけ表示されます。紛失した場合は、新しいキーを作成する必要があります。

API キーの使用方法

すべての API リクエストの Authorization ヘッダーに API キーを含めてください:

Authorization: Bearer your-api-key

LLM / チャット補完（OpenAI 互換）

ベース URL: https://api.atlascloud.ai/v1

from openai import OpenAI

client = OpenAI(
    api_key="your-api-key",
    base_url="https://api.atlascloud.ai/v1"
)

response = client.chat.completions.create(
    model="deepseek-v3",
    messages=[{"role": "user", "content": "Hello!"}]
)

画像 / 動画生成

ベース URL: https://api.atlascloud.ai/api/v1

import requests

response = requests.post(
    "https://api.atlascloud.ai/api/v1/model/generateImage",
    headers={"Authorization": "Bearer your-api-key"},
    json={
        "model": "seedream-3.0",
        "prompt": "A cat sitting on a rainbow"
    }
)

メディアアップロード

import requests

response = requests.post(
    "https://api.atlascloud.ai/api/v1/model/uploadMedia",
    headers={"Authorization": "Bearer your-api-key"},
    files={"file": open("photo.jpg", "rb")}
)

# 生成タスクで使用する一時 URL を返します
print(response.json())

サードパーティツールとの統合

Atlas Cloud API キーは、OpenAI 互換のツールやアプリケーションで使用できます。主なオプション:

ツール	タイプ	設定方法
Chatbox	デスクトップアプリ	API Host を `https://api.atlascloud.ai/v1` に設定
Cherry Studio	デスクトップアプリ	カスタム OpenAI プロバイダーとして追加
OpenWebUI	Web UI	OpenAI 互換エンドポイントを設定
Cursor	IDE	MCP Server 経由で使用
Claude Code	CLI	MCP Server または Skills 経由で使用

サードパーティツールの設定時:

API Host / ベース URL: https://api.atlascloud.ai/v1（/v1 サフィックスが必要）
API キー: Atlas Cloud の API キー
モデル名: モデルライブラリから任意のモデル

セキュリティのベストプラクティス

API キーを共有しない — バージョン管理にコミットしないでください
環境変数を使用 して API キーを保管:
```
export ATLASCLOUD_API_KEY="your-api-key"
```
定期的にキーをローテーション — 古いキーを削除し、新しいキーを作成
開発と本番で別々のキーを使用
コンソールで 使用状況を監視 し、不正利用を検出

キー管理

アカウント設定で API キーを管理できます:

作成 — 必要に応じて新しい API キーを生成
削除 — 不要になったキーや漏洩の可能性があるキーを無効化
使用状況の確認 — 各キーに関連する API 使用状況とコストを監視

レート制限

API のレート制限はアカウントティアとモデルタイプによって異なります。レート制限エラー（429 Too Many Requests）が発生した場合は、以下を検討してください:

リクエスト間に短い遅延を追加
エクスポネンシャルバックオフによるリトライ
より高い制限については [email protected] にお問い合わせ

目次