API

Совместимо с OpenAI. Каждая модель.

Направьте свой существующий OpenAI SDK на https://api.yout.chat/v1 с ключом Yout.chat — и все основные модели в вашем распоряжении. Один пул кредитов, один счёт, никаких контрактов на каждую модель.

Базовый URL: https://api.yout.chat/v1 · Авторизация: Authorization: Bearer <your-key>

Замена без переделок

Если ваш код уже работает с OpenAI API, вам нужно поменять всего две вещи.

from openai import OpenAI

client = OpenAI(
    api_key="yout-...",                  # ← from Account → API keys
    base_url="https://api.yout.chat/v1",       # ← that's it
)

resp = client.chat.completions.create(
    model="anthropic-claude-sonnet-46",
    messages=[
        {"role": "user", "content": "Write a haiku about caching."},
    ],
)
print(resp.choices[0].message.content)

Работает без изменений с OpenAI Python SDK, OpenAI Node SDK, LangChain, LlamaIndex, Vercel AI SDK, LiteLLM, и всем остальным, что использует формат OpenAI.

Эндпоинты

Все эндпоинты принимают Authorization: Bearer <key>. Cookie сессии работают для веб-приложения.

POST/v1/chat/completions

Совместимо с OpenAI. Передайте stream: true для SSE. Кредиты списываются атомарно.

Тело запроса
{
  "model": "anthropic-claude-sonnet-46",
  "messages": [
    {"role": "system", "content": "You are helpful."},
    {"role": "user",   "content": "What is 2+2?"}
  ],
  "stream": false,
  "temperature": 0.7,
  "max_tokens": 512
}
Ответ (без потока)
{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "model": "anthropic-claude-sonnet-46",
  "choices": [{"index":0,"message":{"role":"assistant","content":"Four."},"finish_reason":"stop"}],
  "usage": {"prompt_tokens": 15, "completion_tokens": 2, "total_tokens": 17},
  "yout": {"credits_charged": 10, "balance": 14999990}
}
GET/v1/models

Список моделей, совместимый с OpenAI. Каждая активная модель с id, context_window, и стоимостью в кредитах за токен.

POST/api/chat/stream/

Нативный потоковый эндпоинт — формат JSON проще, чем у OpenAI, используется веб-приложением. Предпочитайте /v1/chat/completions для совместимости со сторонними SDK.

GET/api/chat/models/

Расширенный каталог моделей с тегами задач, модальностью, флагом «только для Pro». Используйте его в собственном интерфейсе.

GET/api/chat/limit/

Ваша текущая квота — баланс кредитов + статус плана или дневной лимит для анонимных пользователей.

GET/api/chat/keys/

Список ваших активных API-ключей (замаскированных).

POST/api/chat/keys/

Создать именованный API-ключ. Полный токен возвращается один раз — сохраните его.

Тело запроса
{"name": "production"}
POST/api/chat/keys/<id>/revoke/

Отозвать ключ. Существующие сессии, использующие его, получат 401 при следующем вызове.

POST/api/media/image/

Задача генерации изображения. Возвращает job_uuid; опрашивайте /api/media/jobs/<uuid>/.

POST/api/media/video/

Задача генерации видео. ~1,2 млн кредитов за 5-секундное Veo. Кредиты автоматически возвращаются при сбое.

POST/api/media/speech/

Преобразование текста в речь. Возвращает job_uuid; результатом является подписанный URL аудио после завершения.

GET/api/media/jobs/<uuid>/

Опрос задачи генерации: status, output_url, error, credits_cost.

POST/api/chat/share/

Создать публичный снимок только для чтения. Возвращает /c/<slug> URL.

POST/api/chat/purge/

Стереть ваши беседы, сообщения и журнал использования на стороне сервера.

Оплата

Использование API списывается из того же пула кредитов, что и веб-приложение. Отдельной оплаты за API нет.

Цена за токен

Текстовые модели тарифицируются как credits_per_1k_input × входные токены + credits_per_1k_output × выходные токены. Медиа-модели тарифицируются по фиксированной ставке credits_per_call.

Минимальная плата

Каждый успешный вызов списывает не менее 10 кредитов для покрытия накладных расходов, независимо от количества токенов.

Возврат при сбое

Задачи генерации изображения/видео/речи, завершившиеся сбоем на стороне провайдера, автоматически возвращают кредиты. При сбое текстового потока тарифицируется только то, что было сгенерировано.

Перерасход

Вызовы возвращают 402 insufficient_credits когда вашего баланса не хватает на покрытие расчётной стоимости. Планы не ограничиваются в скорости, пока plan_active имеет значение true и баланс положительный.

Аутентификация & конфиденциальность

  • Bearer-токен — на каждого пользователя, доступен на странице вашего аккаунта. Для ротации удалите и создайте аккаунт заново (полноценный эндпоинт ротации запланирован).
  • Идентификаторы пользователя не передаются — мы проксируем запросы к провайдерам без вашего email, IP, user agent или ID аккаунта. Только обобщённый HTTP-Referer: yout.chat и ничего больше.
  • no-log сигнал — отправляется провайдерам, чтобы их попросили не логировать ваши запросы и не обучаться на них там, где это позволяют их контракты.
  • Содержимое сообщений по умолчанию не сохраняется — мы записываем строку UsageLedger (токены + кредиты + модель), но не сам запрос или ответ.

Дорожная карта

  • Совместимая с OpenAI /v1/chat/completions прослойка, чтобы существующие SDK работали без изменений
  • Webhook-колбэки для долгих медиа-задач (вместо опроса)
  • Ротация токенов + области действия для каждого токена
  • Ключи идемпотентности для /stream/ + создание задач, безопасное при повторах
  • Самостоятельное управление ограничениями скорости

Готовы к запуску?

Бесплатный тариф даёт вам 50 тыс. кредитов для экспериментов. Перейдите на платный, когда понадобится больше.