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

1. Создайте API-ключ

В личном кабинете откройте «API-ключи», создайте ключ и сохраните его: полный ключ показывается один раз.

2. Отправьте первый запрос

Укажите свой ключ, базовый адрес https://api.kosareva.cloud/v1 и модель, например 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

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)

Эмбеддинги

Векторы считаются на /v1/embeddings тем же ключом. Поле input принимает строку или список строк — для индексации базы знаний считайте пачками, так быстрее и дешевле по накладным расходам. Подробнее: как собрать RAG-систему.

curl https://api.kosareva.cloud/v1/embeddings \n  -H "Authorization: Bearer ВАШ_API_КЛЮЧ" \n  -H "Content-Type: application/json" \n  -d '{"model":"gemini-embedding-2","input":["Первый фрагмент","Второй фрагмент"]}'

Ответ — массив data, в каждом элементе поле embedding на 3072 числа. Векторы разных моделей несовместимы: сменили модель — переиндексируйте базу целиком.

Генерация изображений

Картинки создаются на /v1/images/generations тем же ключом. Цена фиксирована за изображение и не зависит от разрешения.

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}'

Редактирование изображений

Ручку /v1/images/edits принимают gpt-image-2, seedream-4-5, flux-2-pro, flux-2-flex и nano-banana-pro-gemini-3-pro-image. У Seedream 4.5 правка стоит столько же, сколько генерация. У остальных моделей изображений редактирования нет на стороне провайдера: запрос вернёт ошибку, но списания за него не будет.

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

Какие модели доступны по API

Точный список имён отдаёт сам шлюз — это надёжнее любой страницы:

curl https://api.kosareva.cloud/v1/models \
  -H "Authorization: Bearer ВАШ_API_КЛЮЧ"

Генерация видео и озвучка по API пока не отдаются — они доступны только в личном кабинете.