Saltar al contenido principal
GET
Consultar el coste de una solicitud
Este endpoint consulta el coste de llamadas síncronas a la API, principalmente a modelos de texto mediante interfaces como Chat Completions, Messages y Responses.Utilice como Request ID el valor del encabezado X-Request-Id de la respuesta original. Espere un momento después de que finalice la solicitud antes de consultar. Para tareas asíncronas, utilice Consultar el estado de una tarea.

Autorizaciones

Authorization
string
header
requerido

Todos los endpoints requieren autenticación mediante Bearer Token.

Obtener una API Key:

Visite la página de gestión de API Keys para obtener su API Key.

Incluya el siguiente encabezado en la solicitud:

Parámetros de ruta

request_id
string
requerido

Request ID obtenido del encabezado X-Request-Id de la respuesta original. Omita las llaves ({}) y añada el ID directamente al final de la ruta.

Maximum string length: 64

Respuesta

Consulta realizada correctamente

id
string
requerido

Request ID

Ejemplo:

"20261117223155519063884QnAx70lK"

object
enum<string>
requerido

Tipo de objeto; siempre request

Opciones disponibles:
request
Ejemplo:

"request"

model
string
requerido

Modelo utilizado en la solicitud

Ejemplo:

"claude-haiku-5-5"

status
enum<string>
requerido

Estado de la solicitud:

  • completed: La solicitud se completó correctamente.
  • failed: La solicitud falló. Si se produjo uso antes del fallo, por ejemplo, si se interrumpió una respuesta en streaming, usage refleja los cargos realmente descontados.
  • blocked: La solicitud se rechazó antes de su procesamiento, por ejemplo, por saldo insuficiente, cuota de la API Key agotada, API Key desactivada o caducada, o un modelo no permitido. No se generan cargos.
Opciones disponibles:
completed,
failed,
blocked
Ejemplo:

"completed"

finished_at
integer
requerido

Momento de finalización de la solicitud (marca de tiempo Unix en segundos)

Ejemplo:

1794925917

usage
object
requerido

Uso y coste. Siempre se devuelve; si no se han generado cargos, todos los valores son 0.

error
object

Motivo del fallo; solo se devuelve cuando status es failed o blocked. Solo contiene una descripción, sin código de error. Para gestionar errores por código, utilice el error devuelto por la solicitud original.