Rivya AI dokumentáció
Modell API-oldalak

GPT-5 Codex API-integráció

Használd a(z) GPT-5 Codex modellt a Rivya Public API v1-en keresztül a(z) gpt-5-codex-chat modellazonosítóval, támogatott bemenetekkel, paraméterekkel, Files API szabályokkal, kreditekkel és válaszpéldákkal.

Elérhető API-n keresztülSzöveges bemenet készCsevegés
API-modellazonosító

gpt-5-codex-chat

Bemenetek

text, file

Files API

A minimális kéréshez nem szükséges

Alap kreditek

3

Képesség

Csevegés

Készenléti állapot

Chat API: nem streamelt + SSE streaming

Számlázás

TOKEN_BASED

Promptkorlát

20000 karakter

Kérési szerződés

A Chat-kérések egyszerre egy üzenetet küldenek. A munkamenet-előzményeket a Rivya tárolja; ne küldj nyers messages tömböt.

KulcsTípusKötelezőAlapértelmezettLeírás
modelstringIgengpt-5-codex-chatHasználd a(z) gpt-5-codex-chat API-modellazonosítót.
session_idstringNem-Opcionális, API-val létrehozott chat session id. Hagyd ki, ha új sessiont szeretnél indítani.
messagestringIgen-A következő felhasználói üzenet. A Chat API előzménye a szerveroldali sessionből jön, nem nyers messages tömbből.
attachmentsarrayNem-Opcionális image file_id értékek, amelyeket a Files API adott vissza. Külső melléklet-URL-ek nem fogadhatók el.
enable_web_searchbooleanNemfalseCsak akkor érvényes, ha a kiválasztott chatmodell támogatja a webes keresést.
reasoning_effortstringNemdefaultOpcionális reasoning effort: default, minimal, low, medium, high vagy xhigh, ha támogatott.
client_request_idstringNem-Opcionális kliensoldali azonosító a kérések követéséhez a saját rendszeredben.

Modellparaméterek

Ez a chatmodell a fenti közös Chat API mezőket használja. A webes keresés, képfájl-mellékletek, gondolatok és reasoning modellspecifikus támogatása a készenléti adatokban látszik.

Minimális kérés

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

Referenciafájlos kérés

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

Létrehozási válasz

A Chat végpont befejezett asszisztensüzenetet, tokenhasználatot és az adott kör végső kreditelszámolását adja vissza.

{
  "id": "chatcmpl_msg_gpt_5_codex_chat_example",
  "object": "chat.completion",
  "session_id": "chat_session_gpt_5_codex_chat",
  "model": "gpt-5-codex-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": 3,
    "final": 3
  }
}

Gyakori hibák

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

A Chat API a Public API v1-ben támogat nem streamelt és SSE streaminget használó köröket. A képmellékleteknek Files API file_id értékeket kell használniuk.