---
title: "LLM API через curl: чат, стриминг и транскрибация | BroadRouter"
description: "Первые запросы к BroadNet Inference через curl: chat completion, стриминг ответа и транскрибация аудио. Как читать ответ, usage и ошибки."
url: https://broadrouter.com/ru/guides/curl-quickstart/
lang: ru
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Переведено с английского с помощью ИИ. [Читать оригинал на английском](https://broadrouter.com/guides/curl-quickstart/) (обновлён 2026-11-16).

# Первый запрос к BroadNet Inference через curl

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

Отправьте POST на https://inference.broadnet.ai/v1/chat/completions с заголовком Authorization: Bearer и вашим ключом, а в JSON-теле укажите model, например broadnet/gemma-4-26b-a4b, и messages. Для стриминга добавьте stream: true. Для аудио отправьте multipart-форму с полями model, language и file на /v1/audio/transcriptions.

На этой странице вы пройдёте путь от нового ключа до трёх работающих вызовов: chat completion, стриминг ответа и транскрибация. Нужен только curl. BroadNet Inference принимает запросы в формате OpenAI, поэтому, как только эти примеры заработают, заработает и любой [OpenAI-совместимый SDK](https://broadrouter.com/ru/guides/openai-python-sdk/) или инструмент.

## 1\. Задайте ключ

Создайте ключ в консоли BroadNet. Новые аккаунты получают стартовый грант $5.

```bash
export BROADNET_API_KEY='paste-your-key'
```

Передавайте ключ только в заголовке `Authorization: Bearer`.

## 2\. Первый chat completion

BroadNet Gemma 4 VL 26B — единственная чат-модель, которая работает на стартовом гранте, поэтому начните с неё:

```bash
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": "Say hello in English and Arabic."}]
  }'
```

Ответ приходит в стандартном JSON формата chat completions. Текст ответа лежит в `choices[0].message.content`, а `usage` содержит число токенов, за которые вы платите.

## 3\. Попробуйте модель с рассуждениями

После пополнения баланса смените модель. GLM 5.3, Qwen3.8 27B и DeepSeek V4.1 Flash рассуждают перед ответом, и рассуждения расходуют `max_tokens`:

```bash
curl https://inference.broadnet.ai/v1/chat/completions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "broadnet/glm-5.3",
    "max_tokens": 2000,
    "reasoning_effort": "low",
    "messages": [{"role": "user", "content": "Give me a regex for a UK postcode."}]
  }'
```

Если `content` пустой, а `finish_reason` равен `length`, бюджет закончился ещё на рассуждениях. Подробнее — в статье [почему модели с рассуждениями возвращают пустые ответы](https://broadrouter.com/ru/guides/reasoning-tokens-empty-response/).

## 4\. Стриминг ответа

Добавьте `"stream": true` и отключите буферизацию curl флагом `-N`:

```bash
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 to five."}]}'
```

Ответ приходит как Server-Sent Events. Поток заканчивается строкой `data: [DONE]`, а с `include_usage` последний чанк несёт число токенов. Подробнее — в руководстве [стриминг chat completions](https://broadrouter.com/ru/guides/streaming-chat-completions/).

## 5\. Транскрибация аудио

Транскрибация принимает multipart-форму. Отправляйте WAV или MP3 размером до 26 214 400 байт и всегда указывайте `language`:

```bash
curl https://inference.broadnet.ai/v1/audio/transcriptions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -F model=broadnet/cohere-transcribe \
  -F language=en \
  -F file=@meeting.mp3
```

В ответе JSON, текст расшифровки — в поле `text`. Голосовые сообщения WhatsApp в формате `.ogg` и записи `.m4a` сначала нужно конвертировать; см. [как транскрибировать голосовые сообщения WhatsApp](https://broadrouter.com/ru/guides/transcribe-whatsapp-voice-notes/). Для арабского используйте `broadnet/cohere-transcribe-arabic` с `language=ar`; см. [руководство по распознаванию арабской речи](https://broadrouter.com/ru/guides/arabic-speech-to-text-api/). Многоязычная модель стоит $0.002 за минуту аудио, арабская — $0.0042.

## Какую модель выбрать

| Модель | ID | Эндпоинт | Стартовый грант |
| --- | --- | --- | --- |
| BroadNet Gemma 4 VL 26B | `broadnet/gemma-4-26b-a4b` | `/v1/chat/completions` | Да |
| GLM 5.3 | `broadnet/glm-5.3` | `/v1/chat/completions` | Нет |
| Qwen3.8 27B | `broadnet/qwen3.8-27b` | `/v1/chat/completions` | Нет |
| DeepSeek V4.1 Flash | `broadnet/deepseek-v4.1-flash` | `/v1/chat/completions` | Нет |
| BroadNet Transcribe | `broadnet/cohere-transcribe` | `/v1/audio/transcriptions` | Да |
| BroadNet Transcribe Arabic | `broadnet/cohere-transcribe-arabic` | `/v1/audio/transcriptions` | Да |

Цены за токен и за минуту — на [странице цен](https://broadrouter.com/ru/pricing/). У каждой модели есть своя страница, например [GLM 5.3](https://broadrouter.com/ru/models/glm-5.3/).

## Решение проблем

-   **401.** Ключ отсутствует, неверен или истёк, либо исчерпан лимит оплаты по факту. Проверьте, нет ли лишних пробелов вокруг ключа.
-   **Ошибка в поле model.** Скопируйте ID из таблицы: он включает префикс `broadnet/`. Платные модели не работают на стартовом гранте, пока вы не пополните баланс.
-   **413.** Аудиофайл больше 26 214 400 байт. Разделите его на части.
-   **403.** Запрос отклонён белым списком IP ключа, политикой модели или маршрута. См. [белые списки IP для API-ключей](https://broadrouter.com/ru/guides/api-keys-ip-allow-lists/).
-   **429.** Ключ с оплатой по факту допускает 30 запросов в минуту, а одновременно — не больше 4. Сделайте паузу и повторите запрос. См. [коды ошибок BroadNet и повторные запросы](https://broadrouter.com/ru/guides/errors-and-retries/).
-   **На безлимитном тарифе.** Каждая [сессия тарифа](https://broadrouter.com/ru/guides/unlimited-llm-api-sessions/) обрабатывает один запрос за раз, поэтому параллельные циклы curl запускайте в отдельных сессиях. Ключи тарифов работают только с `broadnet/deepseek-v4.1-flash`.

Когда сообщаете о проблеме, сохраните заголовок ответа `X-Request-ID` (`curl -D headers.txt ...`).

## Термины в этом руководстве

[Распознавание речи (speech-to-text)](https://broadrouter.com/ru/glossary/speech-to-text/)

Распознавание речи (speech-to-text, автоматическое распознавание речи, ASR) — это технология, которая превращает устную речь в письменный текст. API распознавания речи принимает аудиофайл или поток и возвращает расшифровку, обычно с оплатой за минуту аудио. Точность измеряют долей ошибок в словах (WER), и она зависит от акцента, диалекта и качества записи.

[Лимит запросов (rate limit)](https://broadrouter.com/ru/glossary/rate-limit/)

Лимит запросов (rate limit) — это ограничение, которое API накладывает на объём использования клиентом за отрезок времени, например число запросов или токенов в минуту. Запросы сверх лимита отклоняются, обычно с HTTP 429 Too Many Requests, пока использование снова не опустится ниже порога.

[Оплата по факту (pay-as-you-go)](https://broadrouter.com/ru/glossary/pay-as-you-go/)

Оплата по факту (pay-as-you-go) — это модель ценообразования, при которой вы платите только за то, что использовали, по счётчику в единицах вроде токенов, запросов или минут аудио, без подписки и минимальных обязательств. Так тарифицирует большинство LLM API — с предоплаченного баланса или по периодическому счёту.

[Параллельность (concurrency)](https://broadrouter.com/ru/glossary/concurrency/)

Параллельность (concurrency) — это число запросов, которые клиент одновременно держит в работе. LLM API часто ограничивают её на ключ или тариф отдельно от лимита запросов в минуту, потому что каждый открытый запрос занимает мощности GPU, пока ответ не будет готов.

[Chat Completions API](https://broadrouter.com/ru/glossary/chat-completions-api/)

Chat Completions API — это HTTP-эндпоинт OpenAI, POST /v1/chat/completions, который принимает имя модели и список сообщений с ролями и возвращает следующее сообщение модели. Формат его запроса и ответа стал общим стандартом, который повторяют OpenAI-совместимые провайдеры и SDK.

[Server-sent events (SSE)](https://broadrouter.com/ru/glossary/sse/)

Server-sent events (SSE) — это веб-стандарт, по которому сервер передаёт клиенту поток текстовых событий в одном долгоживущем HTTP-ответе с типом содержимого text/event-stream. Каждое событие — одна или несколько строк-полей, например data:, и завершается пустой строкой.

[WAV](https://broadrouter.com/ru/glossary/wav/)

WAV (Waveform Audio File Format, или WAVE) — это аудиоконтейнер на основе формата RIFF от Microsoft и IBM. Обычно он содержит несжатые отсчёты линейного PCM, поэтому его размер предсказуем: частота дискретизации × байт на отсчёт × число каналов за каждую секунду.

## Вопросы и ответы

### Какую модель можно вызывать на бесплатном стартовом гранте?

BroadNet Gemma 4 VL 26B с ID broadnet/gemma-4-26b-a4b и обе модели транскрибации. Для GLM 5.3, Qwen3.8 27B и DeepSeek V4.1 Flash нужно пополнить баланс.

### Почему в ответе curl пустой content?

Модели с рассуждениями сначала тратят max\_tokens на рассуждения. Если finish\_reason равен length, поднимите max\_tokens до 1000 или больше.

### Почему арабская расшифровка пришла латиницей?

В запросе не было поля language. Для арабского передавайте language=ar, для других языков — соответствующий код ISO 639-1.

### Показывает ли GET /v1/models все модели, которые я могу вызвать?

В документации BroadNet сказано, что GET /v1/models "supplies public catalogue metadata for external monitors" (перевод: «отдаёт публичные метаданные каталога для внешних мониторов»). Для запросов берите ID моделей из справочника API или из pricing.json.

## Похожие руководства

-   [OpenAI Python SDK и BroadNet Inference](https://broadrouter.com/ru/guides/openai-python-sdk/)
-   [Стриминг chat completions и обрыв соединения](https://broadrouter.com/ru/guides/streaming-chat-completions/)
-   [API распознавания арабской речи: пошаговое руководство](https://broadrouter.com/ru/guides/arabic-speech-to-text-api/)
-   [Коды ошибок BroadNet Inference и когда повторять запрос](https://broadrouter.com/ru/guides/errors-and-retries/)

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

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

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

-   [Справочник API BroadNet Inference (на английском)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ru-guides-curl-quickstart&utm_content=sources)
-   [Машиночитаемый список моделей и цены (pricing.json) (на английском)](https://inference.broadnet.ai/pricing.json?utm_source=broadrouter&utm_medium=referral&utm_campaign=ru-guides-curl-quickstart&utm_content=sources)
