Usa GPT-5.2 mediante Rivya Public API v1 con el model id gpt-5-2-chat, entradas compatibles, parámetros, reglas de Files API, créditos y ejemplos de respuesta.

Disponible vía APIEntrada de texto listaChat

ID de modelo de API

gpt-5-2-chat

Entradas

text, file

Files API

No requerido para la solicitud mínima

Créditos base

Capacidad

Chat

Preparación

Chat API: no streaming + SSE streaming

Facturación

TOKEN_BASED

Límite de prompt

20000 caracteres

Contrato de solicitud

Las solicitudes de Chat envían un mensaje por vez. Rivya guarda el historial en la session; no envíes un array raw messages.

Key	Tipo	Obligatorio	Predeterminado	Descripción
model	string	Sí	gpt-5-2-chat	Usa gpt-5-2-chat como ID de modelo de API.
session_id	string	No	-	ID de sesión de chat creado por la API, opcional. Omítelo para iniciar una sesión nueva.
message	string	Sí	-	El siguiente mensaje del usuario. El historial de Chat API viene de la session del servidor, no de un array raw messages.
attachments	array	No	-	Valores file_id de imagen opcionales devueltos por Files API. No se aceptan URLs de adjuntos externos.
enable_web_search	boolean	No	false	Solo se aplica cuando el modelo de Chat seleccionado admite búsqueda web.
reasoning_effort	string	No	default	Esfuerzo de razonamiento opcional: default, minimal, low, medium, high o xhigh cuando el modelo lo admita.
client_request_id	string	No	-	ID opcional del cliente para rastrear solicitudes en tu sistema.

Parámetros del modelo

Este modelo de Chat usa los campos compartidos de Chat API anteriores. La compatibilidad específica con búsqueda web, adjuntos de imagen file, pensamientos y reasoning se refleja en los datos de preparación.

Solicitud mínima

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

Solicitud con archivo de referencia

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

Respuesta de creación

El endpoint de Chat devuelve el mensaje completado del assistant, el uso de tokens y la liquidación final de créditos de este turno.

{
  "id": "chatcmpl_msg_gpt_5_2_chat_example",
  "object": "chat.completion",
  "session_id": "chat_session_gpt_5_2_chat",
  "model": "gpt-5-2-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
  }
}

Errores comunes

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

Chat API admite turnos no streaming y SSE streaming en Public API v1. Los adjuntos de imagen deben usar valores file_id de Files API.

Integración de API de GPT-5.2