---
title: "Быстрый старт BroadNet Inference: Python и cURL | BroadRouter"
description: "Отправьте первый запрос к чату и распознаванию речи BroadNet Inference на Python или через cURL, затем пройдите чек-лист миграции для своей модели."
url: https://broadrouter.com/ru/developers/
lang: ru
updated: 2026-11-15
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

# Разработчикам

Обновлено 2026-11-15

BroadNet Inference использует форматы запросов OpenAI по адресу `https://inference.broadnet.ai/v1`. Создайте ключ в консоли, сохраните его в переменной окружения и отправьте запрос на `/chat/completions` или `/audio/transcriptions` с точным ID модели. Прежде чем переносить продакшен-трафик, проверьте для этой модели параметры, стриминг, инструменты, лимиты и ошибки.

-   Быстрый старт: чат
-   Быстрый старт: распознавание речи
-   ID моделей
-   Чек-лист миграции
-   Ошибки и повторы
-   Документация и руководства

## Как отправить первый запрос к чату?

1.  Войдите на [inference.broadnet.ai (на английском)](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ru-developers&utm_content=quickstart-account) и создайте ключ для инференса. Он показывается один раз; консоль хранит только его хеш.
2.  Установите OpenAI SDK и задайте ключ в терминале. Храните ключи на сервере и никогда — в коде, который выполняется в браузере.
3.  Отправьте запрос. Ответ находится в `choices[0].message.content`.

setup

```
python -m pip install openai
export BROADNET_API_KEY='paste-the-key-once'
```

first\_request.py

```
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
)
response = client.chat.completions.create(
    model="broadnet/gemma-4-26b-a4b",
    messages=[{"role": "user", "content": "Reply with one short sentence."}],
)
print(response.choices[0].message.content)
```

request.sh

```
curl https://inference.broadnet.ai/v1/chat/completions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"broadnet/gemma-4-26b-a4b","messages":[{"role":"user","content":"Reply with one short sentence."}]}'
```

В примере используется BroadNet Gemma 4 VL 26B; эту модель покрывает стартовый грант US$5. Для DeepSeek V4.1 Flash, GLM 5.3 и Qwen3.8 27B сначала нужно пополнить баланс. Сохраняйте заголовок ответа `X-Request-ID` для обращений в поддержку.

How a request reaches a model

1.  01**Your app**Key kept in an environment variable
    
2.  02**OpenAI SDK**Two settings change
    
    `base_url` `api_key`
    
3.  03**BroadNet Inference**OpenAI-compatible API`inference.broadnet.ai/v1``POST /chat/completions`
    
4.  04**The model you name**Set in every request
    
    -   `broadnet/deepseek-v4.1-flash`
    -   `broadnet/glm-5.3`
    -   `broadnet/qwen3.8-27b`
    -   `broadnet/gemma-4-26b-a4b`your choice
    
5.  05**Response**From that model
    

You choose the model in each request. There is no automatic routing: the request runs on the model ID you sent.

Your app calls the OpenAI SDK with BroadNet’s base URL and your key. The request goes to BroadNet Inference with the model ID you wrote, and that model answers. Nothing picks or switches the model for you.

### Стриминг

Задайте `stream=true` и читайте Server-Sent Events до `data: [DONE]`. С `stream_options.include_usage` расход токенов приходит в последнем чанке. Если поток оборвался до `[DONE]`, считайте ответ неполным. BroadNet просит проверять стриминг для каждой модели, прежде чем полагаться на него в продакшене.

stream.sh

```
curl -N https://inference.broadnet.ai/v1/chat/completions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"broadnet/gemma-4-26b-a4b","stream":true,"stream_options":{"include_usage":true},"messages":[{"role":"user","content":"Count from one to three."}]}'
```

## Как распознать речь из аудио?

Отправьте WAV или MP3 размером до 26 214 400 байт на `/audio/transcriptions`. Всегда указывайте `language`: без него арабская речь может вернуться латиницей. Для арабского используйте `language=ar`. Файлы `.ogg` и `.m4a` сначала сконвертируйте: `ffmpeg -i voice-note.ogg -ar 16000 -ac 1 voice-note.wav`

transcribe.py

```
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
)
with open("recording.wav", "rb") as audio:
    result = client.audio.transcriptions.create(
        model="broadnet/cohere-transcribe-arabic",
        file=audio,
        language="ar",
    )
print(result.text)
```

transcribe.sh

```
curl https://inference.broadnet.ai/v1/audio/transcriptions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -F model=broadnet/cohere-transcribe-arabic \
  -F language=ar \
  -F file=@voice-note.wav
```

Ответ — JSON, текст расшифровки в поле `text`. [Арабская или многоязычная модель и стоимость аудио](https://broadrouter.com/ru/arabic-transcription/).

## Какие ID моделей можно использовать?

Передавайте точный ID в `model`. Не полагайтесь на `/v1/models` для поиска чат-моделей; используйте этот список или [справочник (на английском)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ru-developers&utm_content=models-docs#models).

| Модель | ID | Эндпоинт | Вход | Документировано | Доступ |
| --- | --- | --- | --- | --- | --- |
| [DeepSeek V4.1 Flash](https://broadrouter.com/ru/models/deepseek-v4.1-flash/) | `broadnet/deepseek-v4.1-flash` | `/chat/completions` | Текст + Изображение | Рассуждения | Нужно пополнение |
| [GLM 5.3](https://broadrouter.com/ru/models/glm-5.3/) | `broadnet/glm-5.3` | `/chat/completions` | Текст | Инструменты, Структурированный вывод, Рассуждения | Нужно пополнение |
| [Qwen3.8 27B](https://broadrouter.com/ru/models/qwen3.8-27b/) | `broadnet/qwen3.8-27b` | `/chat/completions` | Текст + Изображение | Инструменты, Структурированный вывод, Рассуждения | Нужно пополнение |
| [BroadNet Gemma 4 VL 26B](https://broadrouter.com/ru/models/gemma-4-vl-26b/) | `broadnet/gemma-4-26b-a4b` | `/chat/completions` | Текст + Изображение | — | Стартовый грант |
| [BroadNet Transcribe Arabic](https://broadrouter.com/ru/models/cohere-transcribe-arabic/) | `broadnet/cohere-transcribe-arabic` | `/audio/transcriptions` | Арабское аудио | — | Стартовый грант |
| [BroadNet Transcribe](https://broadrouter.com/ru/models/cohere-transcribe/) | `broadnet/cohere-transcribe` | `/audio/transcriptions` | Аудио, 14 языков | — | Стартовый грант |

«Документировано» — это инструменты, структурированный вывод и рассуждения, которые справочник BroadNet называет для каждой модели (проверено 2026-11-15). Прочерк значит, что справочник их не называет, а не что их нет.

## Переход с другого OpenAI-совместимого API: чек-лист

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

1.  **Эндпоинт.** Укажите базовый URL `https://inference.broadnet.ai/v1`.
2.  **Ключ.** Используйте ключ BroadNet для инференса из переменной окружения. Ключи тарифов и ключи с оплатой по факту — разные ключи.
3.  **ID модели.** Используйте точный ID, например `broadnet/gemma-4-26b-a4b`.
4.  **Параметры.** Проверьте, что каждый отправляемый параметр документирован для этой модели. Уберите те, которых нет в списке.
5.  **Стриминг.** Убедитесь, что клиент читает SSE до `[DONE]` и корректно обрабатывает поток, который оборвался раньше.
6.  **Инструменты и структурированный вывод.** Справочник документирует их для GLM 5.3 и Qwen3.8 27B. Любую другую модель протестируйте, прежде чем на них полагаться.
7.  **Рассуждения.** Рассуждения могут занимать часть бюджета вывода. Оставляйте запас в `max_tokens`; см. [пустые ответы рассуждающих моделей](https://broadrouter.com/ru/guides/reasoning-tokens-empty-response/).
8.  **Лимиты.** Ключ с оплатой по факту допускает 30 запросов в минуту и 4 одновременно. Сессия тарифа обрабатывает один запрос за раз. Почасовой ключ Gemma допускает один поток, 120 запросов в минуту и 300 000 токенов в минуту.
9.  **Контекст.** Контекст включает вход и ответ. Лимит модели смотрите на её [странице модели](https://broadrouter.com/ru/models/).
10.  **Ошибки.** Сопоставьте коды статуса ниже с действием (повтор или исправление) и логируйте `X-Request-ID`.
11.  **Расходы.** Оцените их с помощью [калькуляторов цен](https://broadrouter.com/ru/pricing/). При оплате по факту изображения считаются входными токенами.

## Какие ошибки стоит повторять?

| Статус | Значение | Действие |
| --- | --- | --- |
| 400 / 422 | Неверный запрос или поле | Исправьте запрос; не повторяйте его как есть |
| 401 | Ключ отсутствует, неверен или истёк, либо лимит исчерпан | Проверьте ключ и аккаунт |
| 402 | `insufficient_balance` | Пополните баланс и повторите |
| 413 | Запрос превышает лимит по байтам или тексту | Отправьте меньше, например аудиофайл меньшего размера |
| 429 | Лимит частоты, параллельности, токенов в минуту или расходов | Сделайте паузу (с ограничением числа попыток) и повторите |
| 500–504 | Проблема на стороне сервера | Повторите с ограниченной экспоненциальной задержкой |

Кратко по [таблице ошибок справочника (на английском)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ru-developers&utm_content=errors-docs#errors), проверено 2026-11-15. [Примеры кода для повторов](https://broadrouter.com/ru/guides/errors-and-retries/).

## Где полная документация и руководства?

-   [**Справочник для разработчиков (на английском)**Форматы запросов, лимиты, ошибки и фид цен. Первоисточник.](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ru-developers&utm_content=docs)
-   [**Интеграции (на английском)**Настройки для Aider, Cline, LangChain, n8n, LiteLLM и других OpenAI-совместимых инструментов.](https://broadrouter.com/integrations/)
-   [**Руководства**SDK, стриминг, повторы, белые списки IP и арабская речь.](https://broadrouter.com/ru/guides/)
-   [**Руководство по Python SDK**Установка, первый запрос и стриминг с OpenAI Python SDK.](https://broadrouter.com/ru/guides/openai-python-sdk/)
-   [**Руководство по Node SDK**То же на JavaScript и TypeScript, с ID запросов.](https://broadrouter.com/ru/guides/openai-node-sdk/)
-   [**Быстрый старт с cURL**Все запросы из терминала.](https://broadrouter.com/ru/guides/curl-quickstart/)
-   [**Ключи и белые списки IP**Привяжите ключи к своим серверам.](https://broadrouter.com/ru/guides/api-keys-ip-allow-lists/)
-   [**Конструктор API-запросов (на английском)**Соберите запрос в браузере и скопируйте его.](https://broadrouter.com/tools/api-request-builder/)

Нужен приватный эндпоинт или модель, которой нет в списке? [Свяжитесь с BroadNet](https://broadrouter.com/ru/contact/#private).

Проверьте на своей реальной нагрузке. Новые аккаунты получают стартовый грант US$5 на Gemma и распознавание речи. Для DeepSeek, GLM и Qwen3.8 нужно пополнить баланс.

[Начать](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ru-developers&utm_content=page-cta) ·

**Источники**

-   [Справочник для разработчиков BroadNet Inference (проверено 2026-11-15) (на английском)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ru-developers&utm_content=sources)
-   [Цены BroadNet Inference (на английском)](https://inference.broadnet.ai/pricing?utm_source=broadrouter&utm_medium=referral&utm_campaign=ru-developers&utm_content=sources)
-   [pricing.json, опубликованный прайс-лист (на английском)](https://inference.broadnet.ai/pricing.json?utm_source=broadrouter&utm_medium=referral&utm_campaign=ru-developers&utm_content=sources)
