kosareva.cloud
RU
РусскийEnglish

Документация 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/messages SDK допишет сам
Авторизация
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 APIPOST /v1/responsesмодели OpenAI, так работает, например, Codex CLI
Формат AnthropicPOST /v1/messagesмодели Claude, сейчас их 15; base URL без /v1
ЭмбеддингиPOST /v1/embeddings6 моделей, таблица
Генерация картинокPOST /v1/images/generations33 модели, таблица
Правки картинокPOST /v1/images/edits16 моделей, таблица
Озвучка текстаPOST /v1/audio/speech5 моделей, таблица
ВидеоPOST /v1/videosVeo, Kling, Seedance и другие видеомодели; задача, статус, mp4
МузыкаPOST /v1/musicsuno-v6, suno-v6-mini, suno-v6-wild; задача, статус, два mp3
Распознавание речиPOST /v1/audio/transcriptionswhisper-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, один ключ на все модели, лимит расхода, документы.

Инструменты

Шаги для редакторов и агентов собраны на одной странице: выберите инструмент, и она покажет команды и поля.

Подробные настройки каждого инструмента в разделе «Инструменты». Подойдёт и любой другой клиент, где можно указать base URL для OpenAI.