Documentazione API

Costruisci su ogni modello AI attraverso un'unica API.

All Model ti offre un gateway compatibile OpenAI per instradare le richieste tra i provider upstream, gestire le chiavi API, applicare le quote e monitorare i consumi da un'unica console operativa.

Compatibile OpenAI

Punta gli SDK esistenti a un unico URL base e cambia modello con il parametro model.

Routing multi-provider

Aggrega OpenAI, Claude, Gemini, DeepSeek e altri dietro un'unica superficie API.

Quote e fatturazione

Monitora i consumi per chiave, modello, gruppo, canale e cliente in un'unica dashboard.

Avvio rapido

Crea una chiave API

Apri la console, crea una chiave API e delimitala ai modelli o gruppi a cui la tua applicazione deve accedere.

Imposta l'URL base

Usa https://api.allmodel.co/v1 come URL base nei client compatibili OpenAI.

Invia una richiesta

Chiama gli endpoint di chat completions, responses, embeddings o models usando lo stesso token Bearer.

bash

curl https://api.allmodel.co/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "user", "content": "Spiega il routing dei modelli in una frase."}
    ],
    "stream": false
  }'

Autenticazione

Ogni richiesta deve includere una chiave API nell'header Authorization. Conserva le chiavi sul tuo server e ruotale se vengono esposte.

http

Authorization: Bearer YOUR_API_KEY

Consiglio di sicurezza: Non inserire le chiavi API in app browser, bundle mobile, repository pubblici o log visibili ai clienti.

Endpoint principali

POST/v1/chat/completionsChat completions per client compatibili OpenAI.

POST/v1/responsesFlussi di lavoro in stile Responses per modelli compatibili.

GET/v1/modelsElenca i modelli disponibili per la chiave API corrente.

POST/v1/embeddingsGenera embedding attraverso i provider upstream supportati.

Esempio SDK

Le integrazioni SDK OpenAI esistenti di solito necessitano solo di un nuovo URL base e chiave API.

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.ALLMODEL_API_KEY,
  baseURL: "https://api.allmodel.co/v1"
});

const completion = await client.chat.completions.create({
  model: "gpt-4o",
  messages: [{ role: "user", content: "Ciao da All Model" }]
});

console.log(completion.choices[0].message.content);

Provider di modelli

OpenAI

gpt-4o, o3, o4-mini

Chat, visione, ragionamento

Anthropic

claude-3.5-sonnet, claude-3-haiku

Chat, contesto lungo

Google

gemini-2.0-flash, gemini-1.5-pro

Multimodale, contesto lungo

DeepSeek

deepseek-chat, deepseek-reasoner

Chat, codice, ragionamento

Open source

llama, qwen, mistral families

Alternative economiche

La disponibilità dei modelli dipende dai canali upstream abilitati, gruppo utente, quota account e politica della piattaforma.

Quote e limiti di velocità

Per chiave

Limita il traffico per chiave API e revoca le chiavi senza influenzare altre integrazioni.

Per gruppo

Applica permessi di modello e politiche di quota diversi ai gruppi di clienti.

Per modello

Controlla i modelli costosi o sensibili separatamente da quelli predefiniti a basso costo.

FAQ

Posso usare l'SDK ufficiale OpenAI?

Sì. Configura il baseURL dell'SDK sul tuo endpoint All Model e usa la tua chiave API All Model.

Come scelgo un modello?

Imposta il campo model in ogni richiesta. La disponibilità dipende dalla tua chiave, gruppo, piano e canali upstream abilitati.

Come vengono calcolati i costi?

I consumi sono calcolati in base ai prezzi dei modelli, consumo di token, quote e eventuali regole di fatturazione configurate per il tuo account o piano.

Cosa succede se un provider upstream fallisce?

Il comportamento di routing e fallback dipende dai canali configurati e dalla politica della piattaforma. Le richieste fallite restituiscono errori strutturati per una facile gestione.

Vuoi dettagli sui prezzi? Visita la pagina prezzi.