Documentazione Rivya AI
Pagine API per modello

Integrazione API di GPT-5.4

Usa GPT-5.4 tramite Rivya Public API v1 con model id gpt-5-4-chat, input supportati, parametri, regole Files API, crediti ed esempi di risposta.

Disponibile via APIInput testuale prontoChat
ID modello API

gpt-5-4-chat

Input

text, file

Files API

Non richiesto per la richiesta minima

Crediti base

4

Capacità

Chat

Stato di disponibilità

Chat API: non streaming + streaming SSE

Fatturazione

TOKEN_BASED

Limite prompt

20000 caratteri

Contratto della richiesta

Le richieste Chat inviano un message alla volta. La cronologia della session è salvata da Rivya; non inviare un array raw messages.

KeyTipoObbligatorioPredefinitoDescrizione
modelstringgpt-5-4-chatUsa gpt-5-4-chat come ID modello API.
session_idstringNo-ID sessione chat creato dall'API, facoltativo. Omettilo per avviare una nuova session.
messagestring-Il prossimo messaggio utente. La cronologia di Chat API arriva dalla session lato server, non da un array raw messages.
attachmentsarrayNo-Valori file_id immagine facoltativi restituiti da Files API. Gli URL di allegati esterni non sono accettati.
enable_web_searchbooleanNofalseSi applica solo quando il modello Chat selezionato supporta la ricerca web.
reasoning_effortstringNodefaultReasoning effort facoltativo: default, minimal, low, medium, high o xhigh quando supportato.
client_request_idstringNo-ID client facoltativo per tracciare le richieste nel tuo sistema.

Parametri del modello

Questo modello Chat usa i campi condivisi di Chat API sopra. Il supporto specifico del modello per ricerca web, allegati immagine file, pensieri e reasoning è indicato nei dati di disponibilità.

Richiesta minima

{
  "model": "gpt-5-4-chat",
  "message": "Write a concise launch plan for a new product image campaign"
}

Richiesta con file di riferimento

{
  "model": "gpt-5-4-chat",
  "message": "Write a concise launch plan for a new product image campaign",
  "attachments": [
    {
      "file_id": "file_uploaded_image_id"
    }
  ]
}

Risposta di creazione

L'endpoint Chat restituisce il messaggio assistant completato, l'uso dei token e il saldo finale dei crediti per questo turno.

{
  "id": "chatcmpl_msg_gpt_5_4_chat_example",
  "object": "chat.completion",
  "session_id": "chat_session_gpt_5_4_chat",
  "model": "gpt-5-4-chat",
  "created_at": "2026-05-11T00:00:00.000Z",
  "message": {
    "id": "assistant_message_id",
    "role": "assistant",
    "content": "A concise launch plan with clear next steps."
  },
  "usage": {
    "input_tokens": 1200,
    "output_tokens": 320,
    "total_tokens": 1520
  },
  "credits": {
    "reserved": 4,
    "final": 4
  }
}

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported

Chat API supporta turni non streaming e SSE streaming in Public API v1. Gli allegati immagine devono usare valori file_id di Files API.