# Errores (/es/docs/concepts/errors)

Códigos de estado HTTP, el cuerpo del error y qué errores conviene reintentar.



Los errores llegan con un estado distinto de 2xx y un cuerpo JSON en el formato de OpenAI:

```json
{
  "error": {
    "message": "Invalid token (request id: 2026100912391754811973...)",
    "type": "new_api_error",
    "code": ""
  }
}
```

Basa tu lógica en el estado HTTP (y en `error.code` cuando no esté vacío). El `message` está pensado para personas y puede cambiar.

Los errores que genera el proveedor del modelo después de aceptar tu solicitud pueden llegar con el formato propio de ese proveedor; en `/v1/messages` es el formato de Anthropic, `{ "type": "error", "error": { "type": "...", "message": "..." } }`. Ambos formatos incluyen `error.message`.

## Códigos de estado [#status-codes]

| Estado                                                 | Significado                                                                                                                                                                                                                     | Qué hacer                                                                                                                                            |
| ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| `400`                                                  | La solicitud está mal formada.                                                                                                                                                                                                  | Corrige el cuerpo de la solicitud.                                                                                                                   |
| `400` con `code: invalid_parameter_error` en `kimi-k3` | El modelo solo acepta valores de muestreo fijos y tu cliente envió otro, a menudo uno predeterminado como temperature 0.7 o top\_p 0.9. El mensaje lo indica: `Parameter 'temperature'=0.7 is not supported for kimi-k3 model.` | No envíes `temperature` ni `top_p`, o usa temperature `1` y top\_p `0.95`. Consulta [Límites de muestreo](/es/docs/concepts/models#sampling-limits). |
| `401`                                                  | Falta la clave, no es válida, ya venció o agotó su presupuesto.                                                                                                                                                                 | Revisa la clave en la consola.                                                                                                                       |
| `403`                                                  | La clave no tiene permiso para esta llamada (lista de modelos o de IP permitidas), o tu saldo es insuficiente.                                                                                                                  | Ajusta las opciones de la clave o recarga saldo.                                                                                                     |
| `429`                                                  | Demasiadas solicitudes.                                                                                                                                                                                                         | Reintenta con retroceso exponencial. Consulta [Límites de solicitudes](/es/docs/concepts/rate-limits).                                               |
| `503` con `code: model_not_found`                      | Ningún proveedor ofrece este ID de modelo.                                                                                                                                                                                      | Revisa el ID de modelo en el [catálogo](/es/models).                                                                                                 |
| `500`, `502`, `503`, `504`                             | Falló el gateway o el proveedor del modelo.                                                                                                                                                                                     | Reintenta con retroceso.                                                                                                                             |

Las solicitudes rechazadas con `4xx` antes de llegar a un modelo no se cobran.

## ID de solicitud [#request-ids]

Cada respuesta incluye un encabezado `X-Oneapi-Request-Id`, y los mensajes de error repiten ese ID. Inclúyelo cuando contactes a [soporte](/es/docs/support).