Endpoints
Consulta de generaciones
Consulta con GET /generation el coste exacto, los tokens, el proveedor y la latencia de una petición pasada a partir de su id de generación.
Consulta los detalles de una petición pasada (su coste exacto, el recuento de tokens, el proveedor, la latencia y el motivo de finalización) a partir de su id de generación. Es útil para conciliar facturas, auditar peticiones en streaming y depurar llamadas lentas.
GET https://api14.com/api/v1/generation?id={generation_id}
Dónde encontrar el id
- El campo
idde un chat completion, completion o response (gen-...). - La cabecera de respuesta
X-Generation-Id, cuando está presente. - El
iddel primer fragmento de un stream. - La página de Uso de tu panel.
Petición
| Parámetro de consulta | Obligatorio | Descripción |
|---|---|---|
id | sí | El id de generación. |
curl "https://api14.com/api/v1/generation?id=gen-1791100000-abc123" \
-H "Authorization: Bearer sk-api14-..."
Solo puedes consultar generaciones hechas por tu propia cuenta. Cualquier otro id (o un id que nunca se registró) devuelve 404 not_found.
Respuesta
El cuerpo es el registro de la generación:
{
"data": {
"id": "gen-1791100000-abc123",
"model": "anthropic/claude-sonnet-4.5",
"created_at": "2026-10-04T09:12:44Z",
"provider_name": "Anthropic",
"streamed": true,
"finish_reason": "stop",
"tokens_prompt": 1250,
"tokens_completion": 340,
"native_tokens_prompt": 1310,
"native_tokens_completion": 352,
"native_tokens_reasoning": 0,
"native_tokens_cached": 1024,
"latency": 412,
"generation_time": 3810,
"total_cost": 0.00918
}
}
| Campo | Descripción |
|---|---|
total_cost | El importe descontado de tu saldo, en USD. |
native_tokens_* | Recuento de tokens según el tokenizador del propio proveedor; es lo que se te factura. |
native_tokens_cached | Tokens del prompt servidos desde la caché. Consulta Caché de prompts. |
latency / generation_time | Tiempo hasta el primer token y tiempo total de generación, en ms. |
Coste
total_cost (y usage.cost en la respuesta original) es lo que se te cobra por la petición, el mismo importe que aparece en la página de Uso. Consulta Precios y facturación.
Tiempos
El registro puede tardar unos segundos en aparecer después de que termine una petición. Si recibes un 404 justo después de una petición, reintenta tras una breve espera.
Errores
| Estado | Código | Cuándo |
|---|---|---|
| 401 | invalid_api_key | Clave ausente o no válida. |
| 404 | not_found | El id es desconocido o pertenece a otra cuenta. |
| 502 | upstream_unavailable | No se pudo obtener el registro; reintenta. |
Consulta Errores.