Riferimento API

API precedenti e compatibilità

#Compatibilità con OpenAI

Ogni percorso accetta il corpo di richiesta OpenAI — i parametri specifici del fornitore (anthropic tool_use, gemini thinking_config) vengono inoltrati invariati.

Stessa struttura di risposta di OpenAI

Il corpo della risposta corrisponde esattamente a quello di OpenAI, quindi parser, logica di retry e wrapper di osservabilità scritti per OpenAI continuano a funzionare.

Gli endpoint di questa pagina sono attivi e fatturati come tutti gli altri, ma non sono il modo consigliato di integrarsi. Usali quando un SDK esistente di un fornitore deve continuare a funzionare senza modifiche, o quando hai ereditato una chiamata che non sei pronto a migrare.

#Quale interfaccia usare?

Nuova integrazione

Usa gli endpoint /v1 in formato OpenAI del riferimento API. Un unico vocabolario per ogni funzionalità, ed è l'unica interfaccia che riceve nuovi parametri.

SDK di un fornitore già in uso

Usa il passthrough corrispondente qui sotto. Cambi l'URL di base e la chiave e mantieni il corpo di richiesta del fornitore.

Chiamata legacy ereditata

Continua a funzionare. Migrala la prossima volta che metti mano a quel percorso di codice — queste route sono congelate, non mantenute.

#Passthrough nativo del fornitore

Accettano il corpo di richiesta del fornitore e restituiscono la sua forma di risposta. L'autenticazione resta un unico header Authorization: Bearer con una chiave di questa piattaforma — lo schema di autenticazione del fornitore non viene usato.

Gemini nativo

passthrough

Punta il Google GenAI SDK a questo gateway senza modificare il codice. La forma del percorso generateContent e il corpo della richiesta sono quelli di Gemini.

GET	/v1beta/models	Elenca i modelli nel formato del catalogo Gemini.
POST	/v1beta/models/*	Forma del percorso Gemini: /v1beta/models/{model}:{action}, per esempio :generateContent o :streamGenerateContent.
POST	/v1/models/*	La stessa forma di richiesta Gemini sotto /v1, per i client che non possono cambiare il prefisso di versione dell'API.
POST	/v1/engines/:model/embeddings	Embedding Gemini tramite il percorso legacy engines.

Kling nativo

passthrough

Accetta il corpo di richiesta ufficiale di Kling (model_name + prompt e i campi propri del fornitore) e restituisce la sua struttura di task.

POST	/kling/v1/videos/text2video	Invia un task Kling da testo a video con il corpo nel formato del fornitore.
POST	/kling/v1/videos/image2video	Invia un task Kling da immagine a video.
GET	/kling/v1/videos/text2video/:task_id	Interroga un task Kling da testo a video.
GET	/kling/v1/videos/image2video/:task_id	Interroga un task Kling da immagine a video.

Jimeng nativo

passthrough

L'API ufficiale Action-query di Jimeng. Invio e risultato condividono un unico percorso e sono selezionati dal parametro Action.

POST	/jimeng/?Action=CVSync2AsyncSubmitTask&Version=2022-08-31	Invia un task con req_key e prompt nel corpo del fornitore. La barra finale è obbligatoria — /jimeng reindirizza, e con un 301 la maggior parte dei client HTTP perde il corpo.
POST	/jimeng/?Action=CVSync2AsyncGetResult&Version=2022-08-31	Recupera il risultato di un task inviato.

Suno nativo

passthrough

Invio e recupero musicale in formato Suno. Per i nuovi progetti preferisci /v1/music/generations — restituisce la struttura di task della piattaforma usata ovunque.

POST	/suno/submit/:action	action è music o lyrics.
POST	/suno/fetch	Recupero in batch tramite elenco di id.
GET	/suno/fetch/:id	Recupera un task.

gemini-native.sh

# Google GenAI SDK: set the API endpoint, keep everything else.
curl "https://www.aisplice.store/v1beta/models/gemini-3.5-flash:generateContent" \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "Say hello."}]}]
  }'

Le risposte passthrough sono del fornitore, non nostre

Codici di stato, corpi di errore e nomi dei campi su queste route seguono il fornitore upstream. La struttura di errore della piattaforma e i codici di errore documentati si applicano solo ai rifiuti lato gateway, come autenticazione, quota e routing.

#Route legacy congelate

Instradate e fatturate, ma chiuse alle modifiche: nessun nuovo parametro, nessun nuovo modello garantito e nessuna promessa di compatibilità oltre a ciò che funziona oggi.

Alias legacy

congelato

Ancora instradati, ancora fatturati, ma congelati: nessun nuovo parametro e nessuna garanzia di compatibilità. Migra quando metti mano al codice chiamante.

POST	/v1/completions	Completamento di prompt legacy di OpenAI. Usa /v1/chat/completions.
POST	/v1/edits	Nonostante il nome, instrada al formato di modifica immagini. Usa /v1/images/edits.
POST	/v1/video/generations	Invio video precedente al formato OpenAI. Usa POST /v1/videos.
GET	/v1/video/generations/:task_id	Polling video precedente al formato OpenAI. Usa GET /v1/videos/{task_id}.

Archivio Midjourney

congelato

Sola lettura. L'invio a pagamento a Midjourney è stato dismesso; resta solo la consultazione dei task storici e delle relative immagini archiviate.

GET	/mj/task/:id/fetch	Consulta un task archiviato.
GET	/mj/task/:id/image-seed	Leggi il seed di un'immagine archiviata.
GET	/mj/image/:id	Restituisce un'immagine archiviata.

#Cosa restituisce 404

Le interfacce OpenAI non supportate non sono proprio registrate. Un 404 su un percorso OpenAI significa che la funzionalità qui davvero non è servita — non è una lacuna temporanea, e non esiste una route che risponda 501 per far finta del contrario.

Scoprire cosa può raggiungere davvero una chiave

GET /v1/models elenca tutti i modelli che questa chiave può chiamare. Combinandolo con un 404 sul percorso stesso puoi distinguere "modello non consentito" da "endpoint non servito".

Non hai ancora risolto?

Inviaci l'ID richiesta o il messaggio di errore e verificheremo.

PrecedenteFatturazione e saldo SuccessivoPrima di andare in produzione