BroadRouter
Inizia

Prima richiesta a BroadNet Inference con curl

Aggiornato

Invia una POST a https://inference.broadnet.ai/v1/chat/completions con l’header Authorization Bearer e la tua chiave, e un corpo JSON con model, per esempio broadnet/gemma-4-26b-a4b, e messages. Per lo streaming aggiungi stream true. Per l’audio, invia a /v1/audio/transcriptions un form multipart con model, language e file.

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 ...).

Domande frequenti

Quale modello posso usare con il credito iniziale gratuito?

BroadNet Gemma 4 VL 26B, ID del modello broadnet/gemma-4-26b-a4b, ed entrambi i modelli di trascrizione. GLM 5.3, Qwen3.8 27B e DeepSeek V4.1 Flash richiedono una ricarica.

Perché il content del messaggio è vuoto nella risposta di curl?

I modelli di ragionamento spendono prima max_tokens nel ragionamento. Se finish_reason è length, alza max_tokens a 1.000 o più.

Perché la mia trascrizione in arabo esce in lettere latine?

Nella richiesta mancava il campo language. Invia language=ar per l’arabo e il codice ISO 639-1 corrispondente per le altre lingue.

GET /v1/models elenca tutti i modelli che posso chiamare?

La documentazione di BroadNet dice che GET /v1/models "supplies public catalogue metadata for external monitors" (traduzione: fornisce metadati pubblici del catalogo per i sistemi di monitoraggio esterni). Per le richieste usa gli ID dei modelli presi dal riferimento API o da pricing.json.

Leggi in MarkdownChiedi a ChatGPTChiedi a ClaudeChiedi a Perplexity