На этой странице вы пройдёте путь от нового ключа до трёх работающих вызовов: 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 ...).
