API Reference
Panoramica
Endpoint e convenzioni dell'API di immagini asincrona.
SeedRouter offre modelli di immagine, video, audio e testo tramite un'unica API e un'unica chiave API. I modelli di immagine, video e audio vengono eseguiti come attività asincrone: invii una richiesta, ricevi un ID attività e interroghi l'attività per ottenere il risultato. I modelli di testo rispondono direttamente, nel formato di richiesta del fornitore del modello.
URL di base
https://api.seedrouter.aiUsa HTTPS e invia corpi di richiesta in JSON. Gli endpoint audio accettano invece il caricamento di un file in multipart/form-data.
Autenticazione
Invia la tua chiave come token Bearer in ogni richiesta, comprese le interrogazioni delle attività:
Authorization: Bearer YOUR_API_KEYL'endpoint Anthropic Messages accetta la chiave anche in x-api-key, insieme all'intestazione anthropic-version. Vedi Autenticazione.
Endpoint delle attività multimediali
| Metodo | Percorso | Scopo |
|---|---|---|
| POST | /v1/images/generations | Invia un'attività di generazione o modifica di immagine: GPT Image, Nano Banana e Midjourney. |
| POST | /v1/videos/generations | Invia un'attività video: Seedance 2.5 e 2.0 (corpo di richiesta ModelArk), Veo 3.1, Kling 3.0, MiniMax H3 e SD Video. |
| POST | /v1/audio/transcriptions | Invia un file audio da trascrivere con Whisper-1. |
| POST | /v1/audio/translations | Invia un file audio da tradurre in inglese con Whisper-1. |
| GET | /v1/tasks/{id} | Legge lo stato e il risultato di un'attività di immagine, video o audio. |
Immagini, video e audio di riferimento si passano come URL nel corpo della richiesta. Una richiesta di immagine diventa una modifica quando include immagini di input. Il riferimento di ciascun modello elenca i suoi parametri.
Endpoint di testo
| Metodo | Percorso | Formato di richiesta |
|---|---|---|
| POST | /v1/chat/completions | OpenAI Chat Completions |
| POST | /v1/responses | OpenAI Responses |
| POST | /v1/messages | Anthropic Messages |
| POST | /v1beta/models/{model}:generateContent | Google Gemini |
| POST | /v1beta/models/{model}:streamGenerateContent | Google Gemini, in streaming |
| GET | /v1/models | Elenca i modelli disponibili |
Non tutti i modelli di testo supportano tutti i formati. Il riferimento API del modello indica quelli che accetta; ad esempio Claude Opus 5.5 accetta Chat Completions, Responses e Messages, mentre i modelli di testo Gemini usano i percorsi /v1beta.
Ciclo di vita di una richiesta
Attività multimediali
- Invia la richiesta. La risposta è un'attività, non il file finito: conserva il suo
id. - Interroga l'attività finché non raggiunge uno stato finale. Le attività su
/v1/tasks/{id}indicanoprocessing, poicompletedofailed. - Leggi il risultato. Le immagini sono in
output.data[].url, i video inoutput.video_urle l'output di Whisper inoutput.url. Ogni link ai risultati punta allo storage di SeedRouter.
In caso di errore, esamina error.code e error.message. Le attività fallite non vengono addebitate. Non esiste un webhook di completamento; interroga invece l'attività, come descritto in Webhooks.
Richieste di testo
Una richiesta di testo restituisce la risposta del modello nella stessa risposta, con la struttura ufficiale del fornitore. Imposta stream su true, oppure usa :streamGenerateContent per Gemini, per ricevere eventi inviati dal server (SSE). I modelli di testo vengono addebitati per token.