Документация API kosareva.cloud
Один ключ открывает все модели каталога через OpenAI-совместимый API: текст и код, эмбеддинги, картинки, видео, озвучку, музыку и распознавание речи. Если код уже написан под OpenAI SDK, меняются две строки: ключ и base_url.
Клиентам в формате Anthropic, например Claude Code, нужен тот же адрес без /v1. Для редакторов и агентов есть пошаговый выбор инструмента.
- Base URL
https://api.kosareva.cloud/v1- Формат Anthropic
https://api.kosareva.cloud, без/v1: путь/v1/messagesSDK допишет сам- Авторизация
Authorization: Bearer ВАШ_API_КЛЮЧ, в формате Anthropic подходит иx-api-key. Ключ видаsk-...- Имя модели
- как в каталоге, латиницей через дефисы:
gpt-5-6,claude-sonnet-5-5 - Оплата
- рубли на балансе, списание по факту: за токены, картинку, минуту записи. Абонентской платы нет
Быстрый старт
Три шага, после которых работает любой код под OpenAI SDK.
/1Зарегистрируйтесь и пополните баланс
Вход в личный кабинет по почте, Яндекс ID или VK ID. Пополнение картой или СБП от 50 ₽, юрлицам по счёту, с договором и актом.
/2Создайте API-ключ
В кабинете откройте «API-ключи» и создайте ключ. Полный ключ потом можно скопировать в том же списке кнопкой «Копировать». Подробнее про лимиты и отдельные ключи на странице Ключи и оплата.
/3Отправьте первый запрос
Подставьте ключ вместо ВАШ_API_КЛЮЧ. Модель любая текстовая из каталога, здесь gpt-5-6.
curl https://api.kosareva.cloud/v1/chat/completions \
-H "Authorization: Bearer ВАШ_API_КЛЮЧ" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5-6","messages":[{"role":"user","content":"Привет!"}]}'
Python, OpenAI SDK
from openai import OpenAI
client = OpenAI(
api_key="ВАШ_API_КЛЮЧ",
base_url="https://api.kosareva.cloud/v1",
)
response = client.chat.completions.create(
model="gpt-5-6",
messages=[{"role": "user", "content": "Привет!"}],
)
print(response.choices[0].message.content)
Node.js, OpenAI SDK
import OpenAI from 'openai';
const client = new OpenAI({
apiKey: 'ВАШ_API_КЛЮЧ',
baseURL: 'https://api.kosareva.cloud/v1',
});
const response = await client.chat.completions.create({
model: 'gpt-5-6',
messages: [{ role: 'user', content: 'Привет!' }],
});
console.log(response.choices[0].message.content);
Ключ лучше держать в переменной окружения, а не в коде: OpenAI SDK сам читает OPENAI_API_KEY и OPENAI_BASE_URL.
Эндпоинты
Пути и форматы как у OpenAI, поэтому подходят официальные SDK и любые клиенты, где можно поменять base URL. Модель выбирается полем model в каждом запросе, к ключу она не привязана.
| Что делает | Метод и путь | Модели |
|---|---|---|
| Чат, код, агенты | POST /v1/chat/completions | все текстовые модели каталога, сейчас их 130 |
| Responses API | POST /v1/responses | модели OpenAI, так работает, например, Codex CLI |
| Формат Anthropic | POST /v1/messages | модели Claude, сейчас их 15; base URL без /v1 |
| Эмбеддинги | POST /v1/embeddings | 6 моделей, таблица |
| Генерация картинок | POST /v1/images/generations | 33 модели, таблица |
| Правки картинок | POST /v1/images/edits | 16 моделей, таблица |
| Озвучка текста | POST /v1/audio/speech | 5 моделей, таблица |
| Видео | POST /v1/videos | Veo, Kling, Seedance и другие видеомодели; задача, статус, mp4 |
| Музыка | POST /v1/music | suno-v6, suno-v6-mini, suno-v6-wild; задача, статус, два mp3 |
| Распознавание речи | POST /v1/audio/transcriptions | whisper-large-v3, gigaasr, gemini-3-5-transcribe |
| Список моделей | GET /v1/models | все, что доступны вашему ключу |
| Баланс, ключи, счета | GET /api/v1/… | на kosareva.cloud, а не на api. |
Видео и музыка работают асинхронно: POST ставит задачу, статус и готовый файл забираются по её id. Запрос, который закончился ошибкой, не списывается ни на одном эндпоинте.
Разделы документации
У каждой темы своя страница.
Текст и код
Чат, форматы OpenAI и Anthropic, потоковая выдача, защита персональных данных.
Видео
Задача, статус, готовый mp4, первый и последний кадр.
Озвучка
Текст в речь: модели, голоса и цена за 1000 символов.
Музыка
Песня или инструментал по описанию, два варианта трека.
Распознавание речи
Аудиофайл в текст или субтитры, таймкоды по словам.
Эмбеддинги
Векторы для поиска по смыслу и RAG, таблица моделей.
Ошибки и лимиты
Что значит код ответа, таймаут и повторы.
API кабинета
Баланс, ключи, счета и пополнения из вашего кода.
Частые вопросы
VPN, один ключ на все модели, лимит расхода, документы.
Инструменты
Шаги для редакторов и агентов собраны на одной странице: выберите инструмент, и она покажет команды и поля.
- Claude Code на Windows, macOS и Linux
- Codex CLI, opencode, Hermes и OpenClaw в терминале
- наше расширение для VS Code, GitHub Copilot, Cline, Kilo Code, Cursor, Zed и Continue
- расширение для Chrome
Подробные настройки каждого инструмента в разделе «Инструменты». Подойдёт и любой другой клиент, где можно указать base URL для OpenAI.