API Платформы
Шлюз повторяет API OpenAI и Anthropic: берёте их документацию и библиотеки, меняете адрес на
https://api.1bitai.ru/v1 и ключ на свой. Один ключ — все модели.
Подключение
| Адрес | https://api.1bitai.ru/v1 (порт 443, только HTTPS). Для библиотек
Anthropic — https://api.1bitai.ru, без /v1: они добавляют его сами |
|---|---|
| Ключ | Заголовок Authorization: Bearer sk-… (библиотеки Anthropic шлют
x-api-key — тоже принимается). Ключ — в кабинете, раздел «Ключи и API» |
| Модель | Поле model — имя из списка моделей, например
deepseek-v4-flash. Модели вашего ключа — GET /v1/models |
| Документация протокола | OpenAI API Reference, Anthropic Messages API. Всё, что там описано для перечисленных ниже ручек, работает и у нас — с оговорками из разделов «Чего нет» и «Что запаздывает» |
Примеры
curl
curl https://api.1bitai.ru/v1/chat/completions \
-H "Authorization: Bearer $BITAI_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "deepseek-v4-flash",
"messages": [{"role": "user", "content": "Привет!"}]}'
Python, библиотека openai
from openai import OpenAI
client = OpenAI(base_url="https://api.1bitai.ru/v1", api_key="sk-ВАШ_КЛЮЧ")
# Ответ целиком
resp = client.chat.completions.create(
model="deepseek-v4-flash",
messages=[{"role": "user", "content": "Кратко: что такое НДС?"}],
)
print(resp.choices[0].message.content)
# Потоком — для длинных ответов
for chunk in client.chat.completions.create(
model="deepseek-v4-flash",
messages=[{"role": "user", "content": "Напиши план статьи"}],
stream=True,
):
print(chunk.choices[0].delta.content or "", end="")
# Векторы текста
emb = client.embeddings.create(model="bge-m3", input=["первый текст", "второй текст"])
print(len(emb.data[0].embedding))
Python, библиотека anthropic
import anthropic
client = anthropic.Anthropic(base_url="https://api.1bitai.ru", api_key="sk-ВАШ_КЛЮЧ")
msg = client.messages.create(
model="glm-5.2",
max_tokens=1024,
messages=[{"role": "user", "content": "Привет!"}],
)
print(msg.content[0].text)
Картинка в сообщении
Только у моделей со значком 🖼 в списке. Картинку можно передать ссылкой
или прямо в запросе — data:image/png;base64,….
resp = client.chat.completions.create(
model="gemma-4-26b",
messages=[{"role": "user", "content": [
{"type": "text", "text": "Что на картинке?"},
{"type": "image_url", "image_url": {"url": "data:image/png;base64,iVBORw0KGgo…"}},
]}],
)
Программы
| OpenCode | Готовая установка — в кабинете, раздел «Скачать агентов»: одна команда ставит программу и сама подключает её к Платформе с вашим ключом. Настраивать вручную ничего не нужно |
|---|---|
| Cursor | Settings → Models: в поле OpenAI API Key — ваш ключ, включить
Override OpenAI Base URL и вписать https://api.1bitai.ru/v1, затем
Add model — имя из списка, например deepseek-v4-flash |
| Другие | Любая программа или библиотека с настройкой «OpenAI-совместимый провайдер»
(OpenAI compatible, Custom OpenAI): адрес https://api.1bitai.ru/v1, ключ, имя модели.
Программы, которые умеют только Anthropic, — адрес https://api.1bitai.ru |
Что поддерживается
| Запрос | Что делает | Пример модели |
|---|---|---|
POST /v1/chat/completions | Ответ модели на диалог; stream: true,
вызов инструментов (tools), структурированный ответ (response_format),
картинки в сообщении — у моделей с поддержкой изображений | deepseek-v4-flash |
POST /v1/responses | Ответ модели в формате OpenAI Responses API | deepseek-v4-flash |
POST /v1/messages | Ответ модели в формате Anthropic Messages API — для любой модели из списка, не только Claude | glm-5.2 |
POST /v1/completions | Продолжение текста (старый формат OpenAI) | qwen3-14b |
POST /v1/embeddings | Векторы текста | bge-m3 |
POST /v1/rerank | Переранжирование документов по запросу (формат Cohere/Jina:
query, documents, top_n) | bge-reranker-v2-m3 |
POST /v1/images/generations | Картинка по описанию | раздел «Генерация изображений» в списке |
POST /v1/videos, GET /v1/videos/{id},
GET /v1/videos/{id}/content | Видео по описанию и кадру: создать задачу, опрашивать статус
(queued → in_progress → completed), скачать mp4. Оплата списывается при
создании, опрос бесплатный | раздел «Генерация видео» в списке |
POST /v1/systemone | Модели решений: ответы на заданные вопросы о тексте — да/нет, выбор из вариантов | jev-latest |
GET /v1/models | Модели, доступные ключу | — |
GET /key/info | Бюджет, расход и срок действия ключа | — |
Стоимость каждого вызова приходит в заголовке ответа x-litellm-response-cost
(в долларах по прайсу шлюза).
Модели
Цены — в рублях за 1 млн токенов по курсу прайса 80,00 ₽/$. Окно — сколько токенов модель принимает в одном запросе (вместе с историей диалога). 🖼 — принимает изображения на вход. 🌙 — с 20:00 до 08:00 по Москве действует ночная цена, она применяется сама.
Чат
| Модель | Где работает | Окно, токенов | Вход, ₽/1M | Выход, ₽/1M |
|---|---|---|---|---|
claude-fable-5.1 🖼 |
у провайдера | 200 000 | 960,00 ₽ | 4 800,00 ₽ |
claude-haiku-4.5 🖼 |
у провайдера | 200 000 | 105,60 ₽ | 528,00 ₽ |
claude-haiku-5.5 🖼 |
у провайдера | 1 000 000 | 10,56 ₽ | 52,80 ₽ |
claude-opus-5 🖼 |
у провайдера | 1 000 000 | 528,00 ₽ | 2 640,00 ₽ |
claude-opus-5.5 🖼 |
у провайдера | 200 000 | 422,40 ₽ | 2 112,00 ₽ |
claude-sonnet-5 🖼 |
у провайдера | 1 000 000 | 211,20 ₽ | 1 056,00 ₽ |
claude-sonnet-5.5 🖼 |
у провайдера | 1 000 000 | 211,20 ₽ | 1 056,00 ₽ |
deepseek-v4-flash 🌙 |
в контуре БИТ | 393 216 | 32,00 ₽ | 64,00 ₽ |
deepseek-v4-pro |
у провайдера | 1 000 000 | 91,87 ₽ | 183,74 ₽ |
deepseek-v4.1-flash 🖼 |
у провайдера | — | 28,80 ₽ | 115,20 ₽ |
gemini-2.5-flash 🖼 |
у провайдера | — | 33,60 ₽ | 268,80 ₽ |
gemini-2.5-flash-lite 🖼 |
у провайдера | — | 14,40 ₽ | 48,00 ₽ |
gemini-2.5-pro 🖼 |
у провайдера | — | 144,00 ₽ | 960,00 ₽ |
gemini-3.6-flash 🖼 |
у провайдера | — | 79,20 ₽ | 396,00 ₽ |
gemini-3.7-flash 🖼 |
у провайдера | — | 72,00 ₽ | 360,00 ₽ |
gemini-3.8-flash 🖼 |
у провайдера | — | 72,00 ₽ | 360,00 ₽ |
gemini-4-argon 🖼 |
у провайдера | — | 192,00 ₽ | 960,00 ₽ |
gemma-4-26b 🖼 🌙 |
в контуре БИТ | 131 072 | 16,00 ₽ | 64,00 ₽ |
gemma-4-26b-a4b-it |
у провайдера | — | 6,72 ₽ | 32,64 ₽ |
gigachat |
у провайдера | 131 072 | 64,80 ₽ | 64,80 ₽ |
gigachat-2 |
у провайдера | 131 072 | 64,80 ₽ | 64,80 ₽ |
gigachat-2-max |
у провайдера | 131 072 | 648,00 ₽ | 648,00 ₽ |
gigachat-2-pro |
у провайдера | 131 072 | 500,00 ₽ | 500,00 ₽ |
glm-5.2 |
у провайдера | — | 68,45 ₽ | 215,13 ₽ |
glm-5.3 |
у провайдера | — | 151,73 ₽ | 476,86 ₽ |
glm-5.3-flash 🖼 |
у провайдера | — | 15,85 ₽ | 52,84 ₽ |
gpt-4.1 🖼 |
у провайдера | — | 211,20 ₽ | 844,80 ₽ |
gpt-4.1-mini 🖼 |
у провайдера | — | 38,40 ₽ | 220,80 ₽ |
gpt-4o-mini 🖼 |
у провайдера | — | 16,32 ₽ | 62,40 ₽ |
gpt-5.1 🖼 |
у провайдера | — | 132,00 ₽ | 1 056,00 ₽ |
gpt-5.4 🖼 |
у провайдера | — | 286,08 ₽ | 1 714,56 ₽ |
gpt-5.4-mini 🖼 |
у провайдера | 272 000 | 79,68 ₽ | 486,72 ₽ |
gpt-5.4-nano 🖼 |
у провайдера | 272 000 | 21,12 ₽ | 132,00 ₽ |
gpt-5.5 🖼 |
у провайдера | 1 050 000 | 528,00 ₽ | 3 168,00 ₽ |
gpt-5.6-luna 🖼 |
у провайдера | 922 000 | 21,12 ₽ | 126,72 ₽ |
gpt-5.6-terra 🖼 |
у провайдера | 922 000 | 249,60 ₽ | 1 496,00 ₽ |
gpt-6-astra 🖼 |
у провайдера | 922 000 | 960,00 ₽ | 4 800,00 ₽ |
gpt-6-luna 🖼 |
у провайдера | 922 000 | 10,60 ₽ | 53,02 ₽ |
gpt-6.1-sol 🖼 |
у провайдера | 922 000 | 212,85 ₽ | 1 064,24 ₽ |
gpt-6.1-terra 🖼 |
у провайдера | 922 000 | 107,29 ₽ | 536,46 ₽ |
gpt-oss-120b |
у провайдера | — | 2,88 ₽ | 16,32 ₽ |
grok-4.7 🖼 |
у провайдера | — | 211,20 ₽ | 633,60 ₽ |
kimi-k2.7-code 🖼 |
у провайдера | — | 91,20 ₽ | 384,00 ₽ |
kimi-k3 🖼 |
у провайдера | — | 288,00 ₽ | 1 440,00 ₽ |
mimo-v2.6-pro 🖼 |
у провайдера | — | 41,76 ₽ | 83,52 ₽ |
minimax-m3 🖼 |
у провайдера | 1 000 000 | 28,80 ₽ | 115,20 ₽ |
minimax-m3.1-flash 🖼 |
у провайдера | — | 14,40 ₽ | 57,60 ₽ |
mistral-large-4.0 🖼 |
у провайдера | — | 130,56 ₽ | 401,28 ₽ |
qwen3-14b 🌙 |
в контуре БИТ | 40 960 | 40,00 ₽ | 120,00 ₽ |
qwen3-coder |
у провайдера | — | 33,60 ₽ | 144,00 ₽ |
qwen3-coder-next |
у провайдера | — | 17,28 ₽ | 86,40 ₽ |
qwen3.5-35b-a3b |
у провайдера | — | 39,36 ₽ | 156,48 ₽ |
qwen3.6-plus 🖼 |
у провайдера | — | 31,20 ₽ | 187,20 ₽ |
qwen3.7-plus 🖼 |
у провайдера | — | 30,72 ₽ | 122,88 ₽ |
qwen3.8-27b 🖼 |
у провайдера | 262 144 | 40,00 ₽ | 240,00 ₽ |
qwen3.8-max |
у провайдера | — | 192,00 ₽ | 576,00 ₽ |
sonar |
у провайдера | 128 000 | 80,00 ₽ | 80,00 ₽ |
sonar-pro |
у провайдера | 200 000 | 240,00 ₽ | 1 200,00 ₽ |
yandexgpt |
у провайдера | 32 768 | 960,00 ₽ | 960,00 ₽ |
Эмбеддинги
| Модель | Где работает | Окно, токенов | Вход, ₽/1M | Выход, ₽/1M |
|---|---|---|---|---|
bge-m3 |
в контуре БИТ | 8 192 | 2,00 ₽ | — |
qwen3-embedding-4b |
в контуре БИТ | 16 384 | 3,20 ₽ | — |
qwen3-embedding-8b |
у провайдера | — | 4,80 ₽ | — |
text-embedding-3-large |
у провайдера | 8 191 | 12,48 ₽ | — |
Модели решений (/v1/systemone)
| Модель | Где работает | Окно, токенов | Вход, ₽/1M | Выход, ₽/1M |
|---|---|---|---|---|
frida-decisions |
в контуре БИТ | — | 4,03 ₽ | 0,00 ₽ |
jev-1.14 |
у провайдера | 65 536 | 4,03 ₽ | 0,00 ₽ |
jev-latest |
у провайдера | 65 536 | 4,03 ₽ | 0,00 ₽ |
Генерация изображений
| Модель | Где работает | Цена, ₽ за изображение |
|---|---|---|
flux.2-klein-4b |
у провайдера | 5,20 ₽ |
gemini-3-pro-image |
у провайдера | 14,32 ₽ |
gemini-3.1-flash-image |
у провайдера | 7,20 ₽ |
gemini-3.1-flash-lite-image |
у провайдера | 5,20 ₽ |
gpt-image-2 🖼 |
у провайдера | 5,52 ₽ |
gpt-image-2.5-flare 🖼 |
у провайдера | 5,52 ₽ |
qwen-image-2.1-turbo |
у провайдера | 3,76 ₽ |
seedream-5-flash |
у провайдера | 3,68 ₽ |
Распознавание документов
| Модель | Где работает | Окно, токенов | Вход, ₽/1M | Выход, ₽/1M |
|---|---|---|---|---|
lighton-ocr 🖼 |
в контуре БИТ | 16 384 | 20,00 ₽ | 60,00 ₽ |
Реранк
| Модель | Где работает | Окно, токенов | Вход, ₽/1M | Выход, ₽/1M |
|---|---|---|---|---|
bge-reranker-v2-m3 |
в контуре БИТ | 8 192 | 4,00 ₽ | — |
Генерация видео
| Модель | Где работает | Цена, ₽ за секунду ролика |
|---|---|---|
grok-imagine-video-1.5-lite |
у провайдера | 480p — 2,29 ₽ · 720p — 3,33 ₽ · 1080p — 14,77 ₽ |
veo-3.1-fast |
у провайдера | 720p — 10,40 ₽ · 1080p — 12,48 ₽ · 4k — 31,20 ₽ |
«В контуре БИТ» — модель работает на наших серверах, запрос не уходит к внешнему провайдеру. Включить и выключить модели для своего ключа — в кабинете, раздел «Модели».
Чего нет и что делать вместо
| Запрос | Ответ шлюза | Вместо этого |
|---|---|---|
/v1/files | Ошибка: загрузка файлов не настроена | Передавайте содержимое в самом сообщении: текст — строкой, картинку — в image_url
(base64). PDF и сканы — сначала распознать моделью из раздела «Распознавание документов»
через /v1/chat/completions с картинкой страницы |
/v1/batches | Пустой список; без /v1/files задание не создать |
Обычные запросы параллельно, в пределах лимитов |
/v1/assistants, /v1/threads | Ошибка | /v1/chat/completions или /v1/responses; историю диалога храните у себя |
/v1/audio/* | Моделей распознавания и синтеза речи на шлюзе нет | — |
/v1/fine_tuning, /v1/vector_stores | Не настроено | Поиск по своим документам — эмбеддинги и реранк из списка моделей |
Что запаздывает
- Новые ручки и параметры OpenAI и Anthropic появляются у нас не в день выхода: шлюз обновляется после проверки, обычно через несколько недель. Базовое — диалог, поток, инструменты, структурированный ответ, эмбеддинги — работает всегда.
- Параметр, который модель не поддерживает, шлюз молча отбрасывает, а не возвращает ошибку.
Если параметр «не действует» (например,
seed,logprobsили настройка рассуждений у модели без них) — скорее всего, он был отброшен. - Новые модели появляются в списке, когда мы их проверили и назначили цену. Нужна конкретная модель — напишите нам из кабинета («Написать нам»).
Ошибки
Тело ошибки: {"error": {"message": "…", "code": "…"}}. Текст
message — по-русски и говорит, что делать.
| Код | Когда | Что делать |
|---|---|---|
| 401 | Ключ не передан | Добавить заголовок Authorization: Bearer sk-… |
| 401 | «Ключ не принят: такого ключа нет или он отозван» | Скопировать актуальный ключ из кабинета; не помогло — выпустить новый |
| 401 | «Срок действия ключа истёк» | Выпустить новый ключ в кабинете |
| 401 | «Key is blocked» | Ключ отключён; взять в кабинете действующий ключ |
| 403 | «У ключа нет доступа к этой модели, либо в имени модели ошибка» | Выбрать модель из GET /v1/models или включить её в кабинете, раздел «Модели» |
| 400 | «Лимит расходов исчерпан» | Пополнить баланс в кабинете |
| 400 | ContextWindowExceededError — запрос длиннее окна модели | Сократить запрос или взять модель с большим окном (колонка «Окно» в списке) |
| 400 | «Model only supports text input» — картинка модели без поддержки изображений | Взять модель со значком 🖼 |
| 429 | Модель занята или превышен лимит запросов | Повторить через несколько секунд, с нарастающей паузой |
| 408, 500, 502, 503 | Сбой или таймаут на стороне модели | Повторить; длинные ответы запрашивать с stream: true |
Лимиты
| Расходы | Списание с баланса по факту; закончился баланс — ошибка 400. Оповещение при остатке — в кабинете, раздел «Лимиты и оповещения» |
|---|---|
| Длина запроса | Окно модели — колонка «Окно» в списке и
max_input_tokens в GET /v1/models |
| Время ответа | Ответ без потока может оборваться по таймауту (у deepseek-v4-flash — 120 с).
Для длинных ответов — stream: true |
| Одновременные запросы | Ограничены на каждую модель; сверх ограничения — 429 |
Ключ и кабинет
| Начать | Регистрация компании — на platform.1bitai.ru; вход — по коду на почту |
|---|---|
| Ключ | Раздел «Ключи и API». Ключ показывается маской; потеряли — выпустите новый, баланс и настройки сохранятся, старый ключ перестанет работать |
| Баланс | Раздел «Баланс и платежи»: работа с аванса, списание по факту, остаток не сгорает |
| Модели | Раздел «Модели»: все модели доступны сразу; выключенная модель возвращает ошибку и ничего не списывает |
| Сотрудники | Раздел «Команда»: владелец приглашает коллег и заводит ключи, участник видит ключи и расход |
| Расход | Раздел «Аналитика»: траты по дням, моделям, ключам и сотрудникам; почему запросы не прошли |
| Вопрос | «Написать нам» в кабинете |