API 金鑰

API 金鑰用於驗證您對 Atlas Cloud API 的請求。每次 API 呼叫都需要有效的 API 金鑰。

建立 API 金鑰

前往 API Keys
點選 Create API Key
複製並安全保存您的新 API 金鑰

建立 API 金鑰

API 金鑰僅在建立時顯示一次。如果遺失，您需要建立新的金鑰。

使用 API 金鑰

在每次 API 請求的 Authorization 標頭中包含您的 API 金鑰：

Authorization: Bearer your-api-key

LLM / 對話補全（OpenAI 相容）

Base 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!"}]
)

圖片 / 影片生成

Base 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 / Base URL：https://api.atlascloud.ai/v1（需包含 /v1 後綴）
API Key：您的 Atlas Cloud API 金鑰
模型名稱：模型庫中的任意模型

安全最佳實踐

切勿分享 API 金鑰或將其提交到版本控制系統
使用環境變數儲存您的 API 金鑰：
```
export ATLASCLOUD_API_KEY="your-api-key"
```
定期輪換金鑰——刪除舊金鑰並建立新的
分別使用不同金鑰用於開發和生產環境
監控使用情況——在控制台中偵測未經授權的使用

金鑰管理

您可以在帳戶設定中管理 API 金鑰：

建立——根據需要生成新的 API 金鑰
刪除——撤銷不再需要或可能已洩露的 API 金鑰
查看使用情況——監控每個金鑰的 API 使用量和費用

速率限制

API 速率限制因帳戶層級和模型類型而異。如果遇到速率限制錯誤（429 Too Many Requests），請考慮：

在請求之間新增少量延遲
使用指數退避策略進行重試
聯繫 [email protected] 申請更高的限額

本頁目錄