API-ключи

Создание и управление API-ключами для аутентификации Atlas Cloud API

API-ключи используются для аутентификации ваших запросов к API Atlas Cloud. Каждый API-вызов требует действительного API-ключа.

Создание API-ключа

  1. Перейдите в раздел API Keys
  2. Нажмите Создать API-ключ
  3. Скопируйте новый 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())

Интеграция со сторонними инструментами

Вы можете использовать API-ключ Atlas Cloud с любым OpenAI-совместимым инструментом или приложением. Популярные варианты:

ИнструментТипНастройка
ChatboxНастольное приложениеУстановите API Host на https://api.atlascloud.ai/v1
Cherry StudioНастольное приложениеДобавьте как пользовательского провайдера OpenAI
OpenWebUIВеб-интерфейсНастройте OpenAI-совместимый эндпоинт
CursorIDEИспользуйте через MCP-сервер
Claude CodeCLIИспользуйте через MCP-сервер или Skills

При настройке сторонних инструментов:

  • API Host / Base URL: https://api.atlascloud.ai/v1 (суффикс /v1 обязателен)
  • API Key: Ваш API-ключ Atlas Cloud
  • Имя модели: Любая модель из Библиотеки моделей

Лучшие практики безопасности

  • Никогда не делитесь API-ключом и не добавляйте его в систему контроля версий
  • Используйте переменные окружения для хранения API-ключа:
    export ATLASCLOUD_API_KEY="your-api-key"
  • Регулярно обновляйте ключи — удаляйте старые ключи и создавайте новые
  • Используйте отдельные ключи для сред разработки и продакшена
  • Мониторьте использование в Консоли для обнаружения несанкционированного использования

Управление ключами

Вы можете управлять API-ключами в Настройках аккаунта:

  • Создание — Генерируйте новые API-ключи по мере необходимости
  • Удаление — Отзывайте API-ключи, которые больше не нужны или могли быть скомпрометированы
  • Просмотр использования — Мониторьте использование API и затраты, связанные с каждым ключом

Лимиты запросов

Лимиты запросов API зависят от уровня аккаунта и типа модели. Если вы столкнулись с ошибками лимита запросов (429 Too Many Requests), рассмотрите:

  • Добавление небольшой задержки между запросами
  • Использование экспоненциальной задержки для повторных попыток
  • Обращение на [email protected] для увеличения лимитов