Questa pagina ti porta da una chiave appena creata a tre chiamate funzionanti: una chat completion, una risposta in streaming e una trascrizione. Ti serve solo curl. BroadNet Inference usa il formato di richiesta di OpenAI, quindi una volta che queste funzionano, funzionerà anche qualsiasi SDK compatibile con OpenAI o strumento.
1. Imposta la chiave
Crea una chiave nella console di BroadNet. I nuovi account ricevono un credito iniziale di $5.
export BROADNET_API_KEY='paste-your-key'
Invia la chiave solo nell’header Authorization: Bearer.
2. La tua prima chat completion
BroadNet Gemma 4 VL 26B è l’unico modello di chat che funziona con il credito iniziale, quindi parti da lì:
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."}]
}'
La risposta è il normale JSON delle chat completions. Il testo generato è in choices[0].message.content, mentre usage contiene i conteggi dei token che paghi.
3. Prova un modello di ragionamento
Dopo una ricarica, cambia modello. GLM 5.3, Qwen3.8 27B e DeepSeek V4.1 Flash ragionano prima di rispondere, e quel ragionamento conta in 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."}]
}'
Se content è vuoto e finish_reason è length, il budget si è esaurito durante il ragionamento. Vedi perché i modelli di ragionamento restituiscono risposte vuote.
4. Ricevi la risposta in streaming
Aggiungi "stream": true e disattiva il buffering di curl con -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."}]}'
Ricevi dei Server-Sent Events. Lo stream termina con la riga letterale data: [DONE], e con include_usage l’ultimo chunk porta i conteggi dei token. Approfondisci in streaming delle chat completions.
5. Trascrivi un audio
La trascrizione accetta un form multipart. Invia WAV o MP3, fino a 26.214.400 byte, e invia sempre 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
La risposta è un JSON con la trascrizione in text. I vocali WhatsApp in .ogg e le registrazioni .m4a vanno prima convertiti; vedi come trascrivere i vocali di WhatsApp. Per l’arabo usa broadnet/cohere-transcribe-arabic con language=ar; vedi la guida allo speech-to-text in arabo. Il modello multilingue costa $0.002 per minuto di audio e quello arabo $0.0042.
Quale modello scegliere
| Modello | ID | Endpoint | Credito gratuito |
|---|---|---|---|
| BroadNet Gemma 4 VL 26B | broadnet/gemma-4-26b-a4b |
/v1/chat/completions |
Sì |
| GLM 5.3 | broadnet/glm-5.3 |
/v1/chat/completions |
No |
| Qwen3.8 27B | broadnet/qwen3.8-27b |
/v1/chat/completions |
No |
| DeepSeek V4.1 Flash | broadnet/deepseek-v4.1-flash |
/v1/chat/completions |
No |
| BroadNet Transcribe | broadnet/cohere-transcribe |
/v1/audio/transcriptions |
Sì |
| BroadNet Transcribe Arabic | broadnet/cohere-transcribe-arabic |
/v1/audio/transcriptions |
Sì |
I prezzi per token e al minuto sono nella pagina dei prezzi. Ogni modello ha la sua pagina, per esempio GLM 5.3.
Risoluzione dei problemi
- 401. La chiave manca, non è valida o è scaduta, oppure la quota a consumo è esaurita. Controlla che non ci siano spazi in più attorno alla chiave.
- Errore sul campo model. Copia l’ID dalla tabella: include il prefisso
broadnet/. I modelli a pagamento falliscono con il credito iniziale finché non ricarichi. - 413. Il file audio supera i 26.214.400 byte. Dividilo.
- 403. La richiesta è stata rifiutata dalla allowlist di IP della chiave, dal modello o dalla policy di instradamento. Vedi allowlist di IP per le chiavi API.
- 429. Una chiave a consumo consente 30 richieste al minuto e 4 contemporanee. Attendi con backoff e ritenta. Vedi codici di errore e retry di BroadNet.
- Con un piano illimitato. Ogni sessione di un piano esegue una richiesta alla volta, quindi esegui i loop curl paralleli su sessioni separate. Le chiavi dei piani funzionano solo con
broadnet/deepseek-v4.1-flash.
Quando segnali un problema, salva l’header di risposta X-Request-ID (curl -D headers.txt ...).
