aisplice

Riferimento API

Chat Completions

POST/v1/chat/completions

L'endpoint principale: chat multi-turno, streaming, chiamata di strumenti, visione e modalità JSON per ogni modello di chat del catalogo.

#Parametri della richiesta

  • modelstringobbligatorio

    ID del modello da /v1/models. Il gateway determina il fornitore upstream da questo valore.

  • messagesarrayobbligatorio

    Turni della conversazione: {role: system|user|assistant|tool, content}. content può essere una stringa o un array di parti multimodali.

  • streambooleanfacoltativo

    true trasmette in streaming delta SSE, chiusi da data: [DONE].

  • temperaturenumberfacoltativo

    Da 0 a 2. Lascia vuoto per il valore predefinito del modello.

  • max_tokensintegerfacoltativo

    Limite massimo di token generati; limita anche la stima della quota pre-riservata.

  • toolsarrayfacoltativo

    Dichiarazioni delle funzioni che il modello può chiamare — vedi la guida alla chiamata di strumenti.

  • tool_choicestring | objectfacoltativo

    "auto", "none" oppure fissa una funzione specifica.

  • response_formatobjectfacoltativo

    {"type":"json_object"} o un wrapper json_schema per output strutturati sui modelli che li supportano.

  • top_pnumberfacoltativo

    Nucleus sampling; usa temperature o top_p, non entrambi.

  • stopstring | arrayfacoltativo

    Fino a 4 sequenze di stop che interrompono la generazione.

#Errori correlati

  • 400 invalid_request_errorCorpo malformato o parametro non supportato per questo modello.
  • 401Bearer token non valido o mancante. Su questo percorso non c'è error.code — basati sullo stato.
  • 402 insufficient_user_quotaIl saldo del portafoglio non copre la stima pre-riservata.
  • 429Limitazione per chiave. Corpo vuoto; attendi Retry-After. Un 429 che contiene insufficient_user_quota indica invece un limite di spesa giornaliero.
  • 503 model_not_foundModello sconosciuto, oppure nessun canale funzionante lo serve al momento.

Tabella completa dei codici di errore →

#Esempio di richiesta

curl https://www.aisplice.store/v1/chat/completions \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-luna",
    "messages": [{"role": "user", "content": "Say hello."}]
  }'

#Risposta

response.json
{
  "id": "chatcmpl-…",
  "object": "chat.completion",
  "model": "gpt-5.6-luna",
  "choices": [{
    "index": 0,
    "message": {"role": "assistant", "content": "Hello!"},
    "finish_reason": "stop"
  }],
  "usage": {"prompt_tokens": 9, "completion_tokens": 3, "total_tokens": 12}
}

Non hai ancora risolto?

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