Документация API kosareva.cloud

/1Зарегистрируйтесь и пополните баланс

Вход в личный кабинет — по почте, Яндекс ID или VK ID. Пополнение картой или СБП — от 50 ₽, юрлицам — по счёту от 1 000 ₽, с договором и актом.

/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.

Потоковая выдача

С stream: true ответ приходит по кусочкам, как у OpenAI. Для длинных ответов это ещё и защита от таймаута: без потока ответ приходит целиком в конце, и клиент с коротким таймаутом может не дождаться.

stream = client.chat.completions.create(
    model="gpt-5-6",
    messages=[{"role": "user", "content": "Объясни, что такое RAG, в трёх абзацах"}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Формат Anthropic: Messages API

Для Anthropic SDK и инструментов на нём адрес — https://api.kosareva.cloud без /v1: путь /v1/messages SDK допишет сам. Через этот формат работают модели Claude из каталога, остальные модели подключайте через OpenAI-совместимый адрес.

from anthropic import Anthropic

client = Anthropic(
    api_key="ВАШ_API_КЛЮЧ",
    base_url="https://api.kosareva.cloud",
)

message = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Привет!"}],
)
print(message.content[0].text)

Claude Code настраивается переменными окружения ANTHROPIC_BASE_URL и ANTHROPIC_AUTH_TOKEN — пошагово на странице Claude Code.

Responses API

Клиенты на Responses API — например, Codex CLI — работают по тому же адресу https://api.kosareva.cloud/v1, путь /v1/responses. Подходят модели OpenAI из каталога.

Защита персональных данных

Если в запросах бывают ФИО, телефоны, ИНН или реквизиты, поменяйте адрес на https://api.kosareva.cloud/guard/v1: такие данные заменяются заглушками до отправки в модель, а в ответе возвращаются на место. Подробнее — на странице API Guard.

Генерация

curl https://api.kosareva.cloud/v1/images/generations \
  -H "Authorization: Bearer ВАШ_API_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-image-2","prompt":"Белые кроссовки на светлом фоне","n":1}'

Правка по исходнику

Файл уходит в multipart/form-data, поле image. У апскейла и удаления фона prompt не нужен.

curl https://api.kosareva.cloud/v1/images/edits \
  -H "Authorization: Bearer ВАШ_API_КЛЮЧ" \
  -F model="gpt-image-2" \
  -F image="@photo.png" \
  -F prompt="Замени фон на белый"