Prima richiesta API

Usa una chiave personale creata in Chiavi API. Il gateway pubblico è https://api.llm.netter.io; i protocolli di inferenza sono sotto /v1.

Preparare il client

Conserva la chiave nella variabile d’ambiente NETTER_API_KEY usando il tuo secret manager o il meccanismo sicuro previsto per lo strumento. Gli esempi la leggono dall’ambiente e non contengono credenziali reali.

curl --fail-with-body https://api.llm.netter.io/v1/models \
  -H "Authorization: Bearer $NETTER_API_KEY"

Scegli un nome restituito dal catalogo autorizzato. Nei comandi seguenti sostituisci NOME_PUBBLICO con il nome esatto del modello; switchyard è utilizzabile quando autorizzato e configurato.

Chat Completions

curl --fail-with-body https://api.llm.netter.io/v1/chat/completions \
  -H "Authorization: Bearer $NETTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "NOME_PUBBLICO",
    "messages": [{"role": "user", "content": "Scrivi un saluto in italiano."}],
    "max_tokens": 1024
  }'

La disponibilità di un modello non implica un mapping per ogni protocollo. Usa la superficie compatibile e controlla i limiti di output: una richiesta con un massimo elevato può richiedere una prenotazione maggiore del credito disponibile.

Messages

curl --fail-with-body https://api.llm.netter.io/v1/messages \
  -H "x-api-key: $NETTER_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "NOME_PUBBLICO",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Ciao!"}]
  }'

Non usare credenziali del portale o del provider upstream. Per un errore verifica prima autenticazione, modello consentito, protocollo e disponibilità del wallet.

Cosa viene contabilizzato

Ogni chiamata autorizzata prenota credito prima dell’invio upstream. Il consumo finale usa i contatori del provider e i prezzi applicabili. Anche un errore di trasporto può lasciare una riserva da verificare. Per i dettagli vedi Plafond.

Prosegui con Protocolli, Streaming e il riferimento degli endpoint.