Документация

Добро пожаловать в CloudAPI

CloudAPI — единый API gateway, предоставляющий доступ к 100+ AI моделям от OpenAI, Anthropic, Google, Meta и других через один endpoint. Создан специально для разработчиков Центральной Азии с локальными способами оплаты и биллингом в сумах.

Почему CloudAPI?

bolt

Совместим с OpenAI

Прямая замена для OpenAI SDK. Достаточно изменить base URL.

payments

Локальные платежи

Оплата в сумах через Payme, Click или банковский перевод.

memory

100+ моделей

Доступ к GPT, Claude, Gemini, Llama и многим другим.

trending_up

Прозрачные цены

Платите только за использованное. Без скрытых платежей.

Следующие шаги

Сделайте первый запрос

arrow_forward

Быстрый старт

Запустите всё за 3 минуты

1. Получите API ключ

Войдите в панель и создайте новый API ключ.

2. Установите SDK

Используйте официальный OpenAI SDK с нашим base URL.

bash

# Python
pip install openai

# Node.js
npm install openai

3. Сделайте первый запрос

Отправьте chat completion запрос любой модели.

python

from openai import OpenAI

client = OpenAI(
    api_key="cap-...",
    base_url="https://api.cloudapi.uz/v1"
)

response = client.chat.completions.create(
    model="anthropic/claude-3.5-sonnet",
    messages=[{"role": "user", "content": "Salom!"}]
)

print(response.choices[0].message.content)

check_circle

Попробовать в Playground

Попробовать в Playground →

Аутентификация

Все API запросы требуют аутентификации через API ключ в Authorization header.

Формат заголовка

http

Authorization: Bearer cap-abc123xyz...

warning

Храните ключи в безопасности

Никогда не показывайте API ключи в client-side коде. Храните их как environment variables на сервере.

Chat Completions

Генерируйте текстовые ответы от любой поддерживаемой модели.

Endpoint

endpoint

POST https://api.cloudapi.uz/v1/chat/completions

Параметры

Имя	Type	Описание
`model`	string	ID модели (например, openai/gpt-4o)
`messages`	array	Массив объектов сообщений
`temperature`	number	Температура сэмплинга (0-2)
`max_tokens`	integer	Максимум токенов для генерации
`stream`	boolean	Стримить ответ

Пример запроса

curl

curl https://api.cloudapi.uz/v1/chat/completions \
  -H "Authorization: Bearer cap-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-3.5-sonnet",
    "messages": [{"role": "user", "content": "Salom!"}],
    "temperature": 0.7,
    "max_tokens": 1000
  }'

Цены и биллинг

CloudAPI использует pay-as-you-go ценообразование. Вы платите только за использованные токены.

Как работает биллинг

У каждой модели есть цены на ввод и вывод за миллион токенов
Мы добавляем 30% маржу к базовой цене провайдера
Стоимость списывается с баланса кошелька в реальном времени
Подробная статистика использования и расходов в дашборде

free_breakfast

Бесплатные модели

Некоторые модели доступны бесплатно. Ищите бейдж "Free".

Rate-лимиты

API запросы ограничены по каждому ключу для обеспечения справедливого использования.

speed

Лимит по умолчанию: 60 запросов в минуту

Заголовки rate limit

`X-RateLimit-Limit`	Всего разрешённых запросов
`X-RateLimit-Remaining`	Оставшиеся запросы
`X-RateLimit-Reset`	Время до сброса (секунды)

Обработка ошибок

CloudAPI возвращает стандартные HTTP статус коды и совместимые с OpenAI ответы об ошибках.

Частые коды ошибок

Code	Описание
`400`	Неверный запрос — некорректные параметры
`401`	Не авторизован — неверный API ключ
`402`	Требуется оплата — недостаточно средств
`429`	Слишком много запросов — превышен rate limit
`500`	Внутренняя ошибка сервера

Частые вопросы

Как начать? expand_more

Создайте бесплатный аккаунт, сгенерируйте API ключ, пополните баланс и начинайте делать запросы.

Какие способы оплаты принимаются? expand_more

Сейчас принимаем ручной банковский перевод (Uzcard/Humo). Payme и Click скоро.

Нужна ли международная карта? expand_more

Нет! Вы можете оплачивать полностью в сумах через локальные платёжные системы.

Можно ли использовать бесплатные модели? expand_more

Да, несколько моделей полностью бесплатные. Ищите бейдж "Free" в списке моделей.

Как рассчитывается цена? expand_more

По токенам ввода и вывода, с маржой 30% сверх базовой цены модели.

Безопасны ли мои данные? expand_more

Да. API ключи шифруются, везде HTTPS, мы не храним содержимое разговоров.

Можно отменить в любой момент? expand_more

Подписки нет. Платите только за то, что используете.

Есть ли поддержка? expand_more

Да, свяжитесь через Telegram или email. Отвечаем на узбекском, русском и английском.

Свяжитесь с нами

Нужна помощь? Напишите нашей команде.

email

Email

support@cloudapi.uz

send

Telegram

@coder_nurmatov

Обычно отвечаем в течение 24 часов