---
title: "API LLM con curl: guida rapida a chat, streaming e audio"
description: "Le prime chiamate a BroadNet Inference con curl: una chat completion, una risposta in streaming e una trascrizione audio, più come leggere risposta, usage ed errori."
url: https://broadrouter.com/it/guides/curl-quickstart/
lang: it
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Tradotto dall’inglese con l’aiuto dell’IA. [Leggi l’originale in inglese](https://broadrouter.com/guides/curl-quickstart/) (aggiornato il 2026-11-16).

# Prima richiesta a BroadNet Inference con curl

Aggiornato 2026-11-16

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](https://broadrouter.com/it/guides/openai-python-sdk/) o strumento.

## 1\. Imposta la chiave

Crea una chiave nella console di BroadNet. I nuovi account ricevono un credito iniziale di $5.

```bash
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ì:

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

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`:

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

Se `content` è vuoto e `finish_reason` è `length`, il budget si è esaurito durante il ragionamento. Vedi [perché i modelli di ragionamento restituiscono risposte vuote](https://broadrouter.com/it/guides/reasoning-tokens-empty-response/).

## 4\. Ricevi la risposta in streaming

Aggiungi `"stream": true` e disattiva il buffering di curl con `-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."}]}'
```

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](https://broadrouter.com/it/guides/streaming-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`:

```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
```

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](https://broadrouter.com/it/guides/transcribe-whatsapp-voice-notes/). Per l’arabo usa `broadnet/cohere-transcribe-arabic` con `language=ar`; vedi la [guida allo speech-to-text in arabo](https://broadrouter.com/it/guides/arabic-speech-to-text-api/). 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](https://broadrouter.com/it/pricing/). Ogni modello ha la sua pagina, per esempio [GLM 5.3](https://broadrouter.com/it/models/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](https://broadrouter.com/it/guides/api-keys-ip-allow-lists/).
-   **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](https://broadrouter.com/it/guides/errors-and-retries/).
-   **Con un piano illimitato.** Ogni [sessione di un piano](https://broadrouter.com/it/guides/unlimited-llm-api-sessions/) 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 ...`).

## Termini in questa guida

[Streaming](https://broadrouter.com/it/glossary/streaming/)

Lo streaming è un modo di restituire la risposta di un modello linguistico in piccoli pezzi mentre viene ancora generata, invece che in un’unica risposta alla fine. Le API compatibili con OpenAI trasmettono in streaming tramite server-sent event quando la richiesta imposta stream a true.

[Token](https://broadrouter.com/it/glossary/token/)

Un token è l’unità di testo che un modello linguistico legge e scrive: una parola, una parte di parola, un segno di punteggiatura o una sequenza di byte prodotta dal tokenizer del modello. Le API LLM contano, limitano e di solito fatturano l’uso in token.

[Pagamento a consumo (pay-as-you-go)](https://broadrouter.com/it/glossary/pay-as-you-go/)

Il pagamento a consumo è un modello di prezzo in cui paghi solo ciò che usi, misurato per unità come token, richieste o minuti di audio, senza abbonamento né impegno minimo. La maggior parte delle API LLM fattura così, da un saldo prepagato o con una fattura periodica.

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

La Chat Completions API è l’endpoint HTTP di OpenAI, POST /v1/chat/completions, che riceve il nome di un modello e una lista di messaggi con un ruolo e restituisce il messaggio successivo del modello. La forma della sua richiesta e risposta è diventata il formato comune che riusano provider e SDK compatibili con OpenAI.

[Concorrenza (concurrency)](https://broadrouter.com/it/glossary/concurrency/)

La concorrenza è il numero di richieste che un client ha in corso nello stesso momento. Le API LLM spesso la limitano per chiave o per piano, separatamente dalle richieste al minuto, perché ogni richiesta aperta occupa capacità GPU finché la sua risposta non è terminata.

[Rate limit (limite di frequenza)](https://broadrouter.com/it/glossary/rate-limit/)

Un rate limit è un tetto che un’API pone a quanto un client può usarla in un intervallo di tempo, per esempio richieste al minuto o token al minuto. Le richieste oltre il limite vengono rifiutate, di solito con HTTP 429 Too Many Requests, finché l’uso non torna sotto la soglia.

[Speech-to-text (riconoscimento vocale)](https://broadrouter.com/it/glossary/speech-to-text/)

Lo speech-to-text, detto anche riconoscimento automatico del parlato (ASR), è la tecnologia che converte l’audio parlato in testo scritto. Un’API speech-to-text riceve un file o uno stream audio e restituisce una trascrizione, di solito a prezzo per minuto di audio. L’accuratezza si misura con il word error rate e varia con accento, dialetto e qualità della registrazione.

[Credito prepagato (prepaid credit)](https://broadrouter.com/it/glossary/prepaid-credit/)

Il credito prepagato è denaro aggiunto a un account API prima dell’uso. Ogni richiesta scala il proprio costo dal saldo e, quando il saldo si esaurisce, le richieste a consumo si fermano finché non ricarichi. Limita la spesa a quanto hai versato.

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

## Guide correlate

-   [Usare l’SDK Python di OpenAI con BroadNet Inference](https://broadrouter.com/it/guides/openai-python-sdk/)
-   [Streaming delle chat completions e connessioni interrotte](https://broadrouter.com/it/guides/streaming-chat-completions/)
-   [API speech-to-text in arabo, passo dopo passo](https://broadrouter.com/it/guides/arabic-speech-to-text-api/)
-   [Codici di errore di BroadNet Inference e quando ritentare](https://broadrouter.com/it/guides/errors-and-retries/)

Provalo sul tuo carico di lavoro reale. I nuovi account partono con USD 5 di credito per Gemma e trascrizione. DeepSeek, GLM e Qwen3.8 richiedono una ricarica.

[Inizia](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-guides-curl-quickstart&utm_content=page-cta) ·

**Fonti**

-   [Riferimento API di BroadNet Inference (in inglese)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-guides-curl-quickstart&utm_content=sources)
-   [Elenco dei modelli e prezzi in formato leggibile dalle macchine (pricing.json) (in inglese)](https://inference.broadnet.ai/pricing.json?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-guides-curl-quickstart&utm_content=sources)
