Integración de API de Claude Sonnet 4.5
Usa Claude Sonnet 4.5 mediante Rivya Public API v1 con el model id claude-sonnet-4-5-chat, entradas compatibles, parámetros, reglas de Files API, créditos y ejemplos de respuesta.
claude-sonnet-4-5-chat
text
No requerido para la solicitud mínima
Créditos base / 1 M de tokens: entrada 170, salida 855 El coste final de la tarea se redondea hacia arriba a créditos enteros.
Chat
Chat API: no streaming + SSE streaming
TOKEN_BASED
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í | claude-sonnet-4-5-chat | Usa claude-sonnet-4-5-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. |
| thought_mode | string | No | default | thought_mode es opcional: default, on u off. En los modelos compatibles con la función de pensamiento, on la activa, off la desactiva y default usa el comportamiento predeterminado del modelo. Los demás modelos ignoran este campo. |
| tool_slug | string | No | - | Slug opcional de una herramienta de chat existente en Rivya. Rivya añade las instrucciones de la herramienta a este turno. Si la sesión ya tiene una herramienta, omite este campo o usa el mismo slug. |
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": "claude-sonnet-4-5-chat",
"message": "Describe tres pasos para lanzar una campaña de imágenes de producto."
}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_assistant_message_id",
"object": "chat.completion",
"session_id": "chat_session_claude_sonnet_4_5_chat",
"model": "claude-sonnet-4-5-chat",
"created_at": "2026-05-11T00:00:00.000Z",
"message": {
"id": "assistant_message_id",
"role": "assistant",
"content": "1. Elige las imágenes del producto. 2. Escribe las publicaciones de lanzamiento. 3. Programa la publicación y revisa los resultados.",
"created_at": "2026-05-11T00:00:00.000Z"
},
"usage": {
"input_tokens": 1200,
"output_tokens": 320,
"total_tokens": 1520
},
"credits": {
"reserved": 0,
"final": 0,
"settlement_status": "PENDING"
}
}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. Este modelo de Chat no admite adjuntos de imagen.
