Un'unica API compatibile OpenAI. Ogni modello frontier. Più economica.

Updated 2026-07-15

APIsRouter espone un singolo endpoint /v1 che parla fluentemente l'OpenAI SDK — stesso corpo della richiesta, stessa forma della risposta, stesso formato tool-call — per Claude, GPT, Gemini, DeepSeek e oltre 20 altri.

"Compatibile OpenAI" significa cose diverse da vendor a vendor.

Probabilmente hai già provato qualche API "compatibile OpenAI" e hai scoperto che sono compatibili solo nel nome. Alcune accettano il formato ma restituiscono un solo modello. Alcune non supportano le tool call. Alcune vanno in crash con lo streaming quando il contesto supera i 100k token. Alcune richiedono un prefisso specifico nel nome del modello che rompe la tua configurazione SDK esistente. APIsRouter è costruito per essere un vero drop-in. L'OpenAI Python SDK funziona senza modifiche. L'Anthropic SDK funziona contro /v1/messages. Streaming, tool call, vision, JSON mode, output strutturati — tutto funziona in modo identico al diretto. Cambi esattamente una riga — il base_url — e pubblichi.

Stesso SDK, stesso codice, host diverso.

OpenAI Python (percorso più comune):

from openai import OpenAI

client = OpenAI(
    api_key="sk-APIsRouter-...",
    base_url="https://api.apisrouter.com/v1",  # <-- solo questa modifica
)

response = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role": "user", "content": "Hello"}],
    tools=[...],  # il formato tool standard funziona
)

Cosa è supportato (e cosa non ancora).

Usa l'SDK ufficiale di Anthropic con il nostro base_url e i modelli Claude funzionano nativamente. Usa l'SDK ufficiale di OpenAI e i modelli GPT funzionano nativamente. Mescolali nello stesso progetto — stessa chiave, entrambi gli SDK, nessun cambio di contesto.

  • Funziona in modo identico: /v1/chat/completions (formato OpenAI), /v1/messages (formato Anthropic), /v1/images/generations, /v1/embeddings.
  • Tool / function calling — sia in formato OpenAI che Anthropic.
  • Streaming (SSE), Vision / multimodale, JSON mode + output strutturati.
  • Prompt caching di Anthropic (header cache_control).
  • Roadmap (Q3 2026): /v1/audio/* (TTS / Whisper). Non ancora: API di fine-tuning, Assistants API.

Quando "un'unica chiave compatibile OpenAI" conta davvero.

  • Catene di agenti multi-modello — GPT per la pianificazione, Claude Opus per il ragionamento, Gemini per la vision. Una chiave, tre modelli, una sola fattura.
  • Codebase agnostiche al provider — Sviluppa contro OpenAI SDK, cambia modello modificando la stringa `model`.
  • Migrazione drop-in — Hai scritto contro OpenAI mesi fa? Non fare refactoring. Punta base_url su APIsRouter, usa `claude-sonnet-4-6` come nome del modello.
  • Fallback consapevole dei costi — Task premium → Claude Opus. Basso rischio → Haiku o DeepSeek V4. Tutto dallo stesso client.
  • Agenti locali + cloud condividono una sola superficie di fatturazione — Codex CLI, Hermes, OpenClaw — tutti tramite un'unica chiave.

Domande frequenti

Qual è la differenza tra APIsRouter e OpenRouter?

OpenRouter è pass-through — aggiunge ~5% di margine sui prezzi upstream. Entrambi espongono API compatibili OpenAI. Modelli di prezzo diversi. I modelli globali costano il 20% in meno rispetto ai prezzi ufficiali, i modelli cinesi sono sotto il prezzo ufficiale. Nessun abbonamento: paghi solo quello che usi. La prima ricarica aggiunge il +50% di saldo.

La forma della risposta è esattamente identica a OpenAI?

Sì — id, array choices, oggetto usage, tutti i campi presenti e correttamente tipizzati. Implementiamo rigorosamente le specifiche OpenAI. Lo stesso vale per /v1/messages che rispetta le specifiche di Anthropic.

Come gestite la sovrapposizione dei nomi dei modelli (es. gpt-5.5 vs claude-sonnet)?

Convenzione standard — ogni modello ha un unico ID canonico. Vedi la nostra pagina /models per la mappatura completa. Non creiamo alias o rinominazioni — quello che passi è quello che instradiamo.

Il mio middleware SDK personalizzato si romperà?

Non dovrebbe — il middleware opera sulla semantica richiesta/risposta, che preserviamo esattamente. Se vedi una differenza di comportamento, apri un issue e adegueremo all'upstream.

Quanto è veloce l'overhead del proxy?

APIsRouter aggiunge tipicamente ~30-80ms di latenza di routing per richiesta (a seconda della tua regione rispetto al nostro edge). Per lo streaming, il time-to-first-token segue da vicino l'upstream. Non bufferiamo né trasformiamo mid-stream.

Posso fare self-host o eseguire un'istanza privata?

Attualmente no — APIsRouter è un aggregatore hosted. Per il self-hosting, guarda LiteLLM o one-api (open source). Non hanno i canali scontati ma sono gratuiti da eseguire.