Panoramica dell'API
Tutti gli endpoint esposti dal gateway, il formato che utilizzano e ciò che restituiscono.
Tre endpoint. Due formati di richiesta. Una chiave.
| Metodo | Percorso | Formato | Scopo |
|---|---|---|---|
| POST | /v1/messages | Anthropic Messages | Completamento chat, struttura Anthropic |
| POST | /v1/chat/completions | OpenAI Chat Completions | Completamento della chat, struttura OpenAI |
| GET | /v1/models | Elenco in stile OpenAI | ID dei modelli che la tua chiave può chiamare |
Una descrizione leggibile dalle macchine è pubblicata all'indirizzo /openapi.json, e un riepilogo in testo semplice dell'intero sito all'indirizzo /llms.txt e /llms-full.txt.
Scelta di un endpoint
Danno accesso agli stessi modelli allo stesso prezzo. Scegli in base al formato che il tuo client emette già: non convertire i formati autonomamente.
| Endpoint | Header di autenticazione | Struttura della risposta | Streaming |
|---|---|---|---|
/v1/messages | x-api-key o Bearer | content[] array + usage | SSE, content_block_delta eventi |
/v1/chat/completions | Bearer | choices[].message.content | SSE, choices[].delta.content frammenti |
Le strutture degli stream differiscono e non sono intercambiabili. Un client scritto per
choices[].delta.content non leggerà nulla da uno stream Messages. Vedi Streaming.Header comuni
| Header | Si applica a | Note |
|---|---|---|
content-type: application/json | entrambe le richieste POST | Obbligatorio |
x-api-key | Messages | Stile Anthropic |
Authorization: Bearer | entrambi | Stile OpenAI; accettato anche da Messages |
anthropic-version: 2023-06-01 | Messages | Impostato automaticamente dagli SDK Anthropic |
accept: text/event-stream | entrambi | Impostato dagli SDK quando stream è true |