Límites
Los límites de frecuencia de solicitudes de la Direct API, los encabezados que los informan y sus límites de tamaño y cantidad.
Frecuencia de solicitudes
| Cupo | Límite | Se cuenta por |
|---|---|---|
| Lecturas de generaciones | 30 por minuto por generación, 1,200 por minuto en total | clave de API |
Llamadas a herramientas gratuitas (listas, catálogo, plan_media y cada URL de contenido multimedia que importa una llamada) | 1,000 por hora | clave de API |
Gestión de webhooks (/webhooks y sus rutas) | 60 por minuto | clave de API |
/usage, /me | 60 por minuto | clave de API |
Solicitudes cuya clave de API no funciona (401) | 60 cada 10 minutos; a partir de ahí, las solicitudes desde esa dirección responden 429 (con Retry-After) hasta que se vacíe la ventana, salvo con una clave que se haya autenticado en los últimos 10 minutos | dirección IP del cliente (una dirección IPv6 por su /64) |
| Llamadas a herramientas de pago | sin límite de frecuencia de solicitudes |
- Las llamadas de pago están acotadas por el dinero, no por la frecuencia: los límites de créditos de su clave y el saldo de su organización.
- Con carga alta, una generación espera en
queueda que haya capacidad del modelo en lugar de rechazarse. Iniciar más trabajo del que un modelo puede ejecutar a la vez hace que las generaciones posteriores tarden más, nunca que fallen. - Una llamada de pago cuyo resultado acabó siendo gratuito, como
video_remove_audiosobre un video sin sonido, cuenta para el cupo de llamadas gratuitas.
Respuestas de límite de frecuencia
Todos los endpoints con límite de frecuencia devuelven estos encabezados:
X-RateLimit-Limit: 1200
X-RateLimit-Remaining: 1187
X-RateLimit-Reset: 1792919760Una solicitud rechazada responde 429 con Retry-After: <seconds> y este cuerpo:
{
"description": "This API key read generations more than 1200 times a minute. Poll less often, or pass ?wait= to be answered when a status changes.",
"code": "rate_limited",
"data": { "retry_after_seconds": 14 }
}Espere Retry-After segundos antes de reintentar. Un 429 nunca cobra.
Límites de tamaño y cantidad
| Límite | Valor |
|---|---|
| Cuerpo de la solicitud | 1 MB |
variations por inicio de imagen | de 1 a 4 |
| Ids por lectura por lotes | 10 |
wait | 45 s |
metadata | 20 claves; clave de hasta 40 caracteres, valor de hasta 500 |
Idempotency-Key | hasta 200 caracteres, se recuerda 24 h |
| Claves de API activas por organización | 10 |
| Endpoints de webhook por organización | 10 |
| Vigencia de los enlaces a recursos | sin caducidad |
| Entradas por modelo (longitud del prompt, imágenes de referencia, duraciones, tamaños de archivo) | según Modelos y el input_schema de cada herramienta |
Si tiene algún problema o alguna pregunta, no dude en ponerse en contacto con nosotros. Estaremos encantados de ayudarle. Escríbanos a support@morphic.com.