Integrazioni

Il portale offre Guide e integrazioni, con esempi adattati al catalogo disponibile. Usa i nomi pubblici effettivamente consentiti alla tua chiave.

Parametri comuni

Parametro	Valore
Gateway	https://api.llm.netter.io
Base API compatibile OpenAI	https://api.llm.netter.io/v1
Credenziale	Chiave personale Netter
Modello	Nome esatto del catalogo autorizzato
Protocollo	Quello realmente supportato dal mapping

Un client che aggiunge automaticamente /v1 deve ricevere il base URL coerente, evitando percorsi duplicati come /v1/v1.

Richiesta Python senza SDK

Questo esempio usa la libreria standard per una richiesta Chat Completions:

import json
import os
import urllib.request

payload = {
    "model": "NOME_PUBBLICO",
    "messages": [{"role": "user", "content": "Ciao!"}],
    "max_tokens": 1024,
}
request = urllib.request.Request(
    "https://api.llm.netter.io/v1/chat/completions",
    data=json.dumps(payload).encode("utf-8"),
    headers={
        "Authorization": "Bearer " + os.environ["NETTER_API_KEY"],
        "Content-Type": "application/json",
    },
)
with urllib.request.urlopen(request, timeout=120) as response:
    result = json.load(response)
print(result["choices"][0]["message"]["content"])

Strumenti e SDK

Le guide autenticate coprono Claude Code, Codex CLI, OpenCode, Cline e client compatibili. Seleziona la guida dello strumento, verifica la sua versione e usa il protocollo previsto. Le credenziali upstream rimangono nel proxy; il client riceve soltanto la chiave Netter.

Per un’integrazione aziendale collauda almeno richiesta semplice, streaming, chiamata a uno strumento, limiti di output ed errore di autorizzazione. Se servono immagini o artefatti di reasoning, verifica anche quei casi sul modello effettivo.

Retry e stato

Rispetta Retry-After per gli HTTP 429. Una connessione interrotta dopo l’invio può corrispondere a lavoro già eseguito: non presumere che ripetere la richiesta sia gratuito o idempotente. Conserva gli identificativi operativi disponibili e consulta Streaming.

Separare API di inferenza e portale

Le chiavi API personali autenticano il gateway. Le API del portale usano sessione, workspace e verifiche Origin per le modifiche. Non usare un cookie amministrativo come credenziale condivisa di un’applicazione.

Scarica i contratti in API di inferenza e API del portale.