BroadRouter
Начать

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

Обновлено

Отправьте 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 или инструмент.

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

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

export BROADNET_API_KEY='paste-your-key'

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

2. Первый chat completion

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

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:

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, бюджет закончился ещё на рассуждениях. Подробнее — в статье почему модели с рассуждениями возвращают пустые ответы.

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

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

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.

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

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

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. Для арабского используйте broadnet/cohere-transcribe-arabic с language=ar; см. руководство по распознаванию арабской речи. Многоязычная модель стоит $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 Да

Цены за токен и за минуту — на странице цен. У каждой модели есть своя страница, например GLM 5.3.

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

  • 401. Ключ отсутствует, неверен или истёк, либо исчерпан лимит оплаты по факту. Проверьте, нет ли лишних пробелов вокруг ключа.
  • Ошибка в поле model. Скопируйте ID из таблицы: он включает префикс broadnet/. Платные модели не работают на стартовом гранте, пока вы не пополните баланс.
  • 413. Аудиофайл больше 26 214 400 байт. Разделите его на части.
  • 403. Запрос отклонён белым списком IP ключа, политикой модели или маршрута. См. белые списки IP для API-ключей.
  • 429. Ключ с оплатой по факту допускает 30 запросов в минуту, а одновременно — не больше 4. Сделайте паузу и повторите запрос. См. коды ошибок BroadNet и повторные запросы.
  • На безлимитном тарифе. Каждая сессия тарифа обрабатывает один запрос за раз, поэтому параллельные циклы curl запускайте в отдельных сессиях. Ключи тарифов работают только с broadnet/deepseek-v4.1-flash.

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

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

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

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.

Открыть в MarkdownСпросить ChatGPTСпросить ClaudeСпросить Perplexity