Документация

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

API совместим с OpenAI: подойдёт официальный SDK или любой клиент, где можно указать свой base URL. Нужны две вещи — ключ из раздела API-ключи и base URL эндпоинта.

# pip install openai
from openai import OpenAI

client = OpenAI(
    api_key="ВАШ_КЛЮЧ",
    base_url="https://gateway.mediaburo.tech/v1",
)

resp = client.chat.completions.create(
    model="qwen/qwen3-8b",
    messages=[{"role": "user", "content": "Привет!"}],
)
print(resp.choices[0].message.content)

// npm install openai
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "ВАШ_КЛЮЧ",
  baseURL: "https://gateway.mediaburo.tech/v1",
});

const resp = await client.chat.completions.create({
  model: "qwen/qwen3-8b",
  messages: [{ role: "user", content: "Привет!" }],
});
console.log(resp.choices[0].message.content);

curl https://gateway.mediaburo.tech/v1/chat/completions \
  -H "Authorization: Bearer ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen/qwen3-8b",
    "messages": [{"role": "user", "content": "Привет!"}]
  }'

Эндпоинты

Base URL, по которым доступен API. Ключ и баланс общие для всех эндпоинтов.

Эндпоинт	Регион	Base URL
EU-1	Германия	https://gateway.mediaburo.tech/v1

Авторизация

Передавайте ключ в заголовке каждого запроса:

Authorization: Bearer ВАШ_КЛЮЧ

Ключ показывается один раз при создании. Если он утёк — удалите его в кабинете и выпустите новый.

Методы API

POST /chat/completions: Ответ модели на диалог. Формат запроса и ответа — как у OpenAI Chat Completions: model, messages, max_tokens, temperature, tools, response_format, stream. Параметры, которые модель не поддерживает, отбрасываются.
GET /models: Список моделей, доступных вашему ключу. ID из этого списка передаётся в поле model.
POST /messages: Тот же ответ модели в формате Anthropic Messages API — для Claude Code и клиентов, которые говорят на нём. Стриминг и /messages/count_tokens поддерживаются. Подробнее ниже.

ID моделей и цены — в каталоге.

Стриминг

С "stream": true ответ приходит частями по Server-Sent Events. Чтобы получить число токенов в последнем событии, добавьте "stream_options": {"include_usage": true}.

Anthropic API и Claude Code

Кроме OpenAI-формата, эндпоинт принимает запросы в формате Anthropic Messages: POST https://gateway.mediaburo.tech/v1/messages с заголовком x-api-key или Authorization: Bearer. Работает с любой моделью из каталога, не только с Claude.

Claude Code настраивается переменными окружения. Модель задаётся явно — ID из каталога:

export ANTHROPIC_BASE_URL="https://gateway.mediaburo.tech"
export ANTHROPIC_AUTH_TOKEN="ВАШ_КЛЮЧ"
export ANTHROPIC_MODEL="anthropic/claude-opus-5.5"
claude

Проверено на обычных запросах и стриминге. Вызовы инструментов и кэширование промпта зависят от модели и провайдера — если что-то не работает с одной моделью, попробуйте другую.

Оплата и лимиты

Запросы оплачиваются с баланса в рублях по ценам из каталога: входные и выходные токены считаются отдельно. Если баланс закончился, API отвечает ошибкой 429 с типом budget_exceeded.

Резервирование. Перед отправкой запроса резервируется его максимальная стоимость: входные токены плюс max_tokens по цене модели. Если резерв больше остатка, запрос отклоняется с 429 и текстом «Estimated request cost», а деньги не списываются. После ответа резерв заменяется фактической стоимостью. Так параллельные запросы не могут увести баланс в минус. Без max_tokens резервируется до 16 тысяч токенов ответа — для дорогих моделей указывайте max_tokens явно.

У ключа можно задать свой лимит в рублях — на день, неделю, месяц или без сброса — и список разрешённых моделей. Баланс аккаунта действует поверх лимита ключа.

Сетевые модели

Часть моделей (в каталоге отмечены тегом «сеть») работает не у облачного провайдера, а на видеокартах независимых провайдеров, подключённых к Gateway. Для вас это тот же API и тот же ключ, но есть отличия:

Цена плавает. У каждого провайдера своя цена; запрос уходит самому дешёвому из тех, кто сейчас онлайн, и вы платите его цену с наценкой платформы. В каталоге показана цена самого дешёвого провайдера онлайн («от»), фактическая стоимость запроса — в ответе, поле usage.cost (в рублях), и в истории запросов.
Доступность. Если ни одна нода модели не онлайн, API ответит 503 без списания. Страница модели показывает провайдеров и их статус.
Данные. Запрос и ответ проходят через оборудование провайдера, он их видит. Не отправляйте в сетевые модели то, что нельзя показывать третьим лицам. Платформа тексты не хранит.
Резервирование делается по справочной цене модели, списание — по фактической; при отмене запроса посреди стриминга списывается оценка по справочной цене.

Хотите отдавать свою видеокарту в сеть — раздел Провайдер в кабинете.

Ошибки

401: Ключ не передан, удалён или отключён.
400: Неверный запрос: неизвестная модель или ошибка в параметрах.
429: Закончился баланс или лимит ключа (budget_exceeded), либо модель перегружена — повторите позже.
503: У сетевой модели сейчас нет провайдеров онлайн или все заняты. Деньги не списываются.
5xx: Модель или провайдер временно недоступны. Повторите запрос или выберите другую модель.