Referencia · Rate limits
Rate limits de la API de Photta y cómo hacer polling de forma educada
En una frase
La API de Photta permite 600 peticiones por minuto por API key en una ventana fija. Un 429 incluye Retry-After: 30. Haz polling de un trabajo cada 3 segundos; el trabajo concurrente está limitado por plan.
- Límites: 600 requests/min
- Retry-After: Retry-After: 30s
- Procesamiento: asíncrono, polling
Cada cifra de esta página proviene de la documentación de la API de Photta · verificado
Los límites publicados
Tasa, ventana, reintento, tamaño de imagen y formatos, tal y como los especifica la documentación.
Límites
- 600 solicitudes por minuto por API key (Ventana fija; el límite es el mismo en todos los planes)
- Un 429 incluye Retry-After: 30 segundos
- Hasta 10 MB por imagen
- Formatos: JPEG, PNG, WebP
- Lotes simultáneos por plan: Free 1 · Hobby 2 · Seller 3 · Brand 4 · Studio 6
- Solo polling — la API no envía webhooks.
Trabajo concurrente por plan
Cuántos lotes pueden estar en curso a la vez antes de que un envío devuelva 409.
Lotes en curso por plan
Free
Concurrente: 1
Hobby
Concurrente: 2
Seller
Concurrente: 3
Brand
Concurrente: 4
Studio
Concurrente: 6
Mantenerse dentro de los límites
Una ventana fija
El límite se contabiliza por API key en una ventana fija y es el mismo en todos los planes. Dos claves suponen dos presupuestos.
Haz polling cada 3 segundos
El polling es la única señal de finalización: la API no envía webhooks. Cada 3 segundos es el intervalo documentado; hacerlo más rápido gasta tu presupuesto en respuestas vacías.
Aplica retroceso exponencial
Tras un 429, espera los segundos indicados en Retry-After y luego incrementa el intervalo en cada fallo posterior en lugar de reintentar a un ritmo fijo.
Los lotes tienen límites independientes
El rate limit cuenta peticiones; el límite de concurrencia cuenta trabajos en curso. Un lote que exceda este límite devuelve 409, no 429.
Preguntas sobre rate limits
¿Cuál es el rate limit?
600 peticiones por minuto por API key, en una ventana fija. La documentación muestra la misma cifra en cada endpoint.
¿Con qué frecuencia debo hacer polling de un trabajo?
Cada 3 segundos. No hay webhooks, por lo que el polling es la vía documentada para saber si un trabajo ha finalizado.
¿Cuánto se puede renderizar a la vez?
Los lotes en curso se limitan según el plan: Free 1, Hobby 2, Seller 3, Brand 4 y Studio 6. Si se supera el límite, el envío devuelve 409.
¿Qué debo hacer ante un 429?
Lee la cabecera Retry-After, espera esa cantidad de segundos y luego reintenta con retroceso exponencial. Encola el trabajo en lugar de descartarlo.
Endpoints y referencias
Capacidades
API de virtual try-on para ropa
API REST que viste maniquíes de IA con prendas. Generación asíncrona de 1.5–4 minutos, 5 créditos en 2K, 6 en 4K. Ejemplos en cURL, Node.js y Python.
LeerCapacidades
API de try-on de joyas para collares, anillos, pulseras y pendientes
Coloca collares, anillos, pulseras y pendientes en modelos de IA mediante REST. 5 credits en 2K, maniquíes en primer plano integrados y renderizado optimizado para reflejos según la documentación de Photta.
LeerCapacidades
API de maniquí invisible para fotos de producto con efecto maniquí invisible
Endpoint de maniquí invisible con IA. Elimina el maniquí de una foto de la prenda y preserva el detalle interior. 3D o flat-lay, procesamiento por lotes, 4 credits a 2K.
LeerReferencia
Tu primera imagen de Photta en menos de cinco minutos.
Regístrate, genera una API key, ejecuta tu primera llamada cURL, haz polling hasta que se complete y guarda el resultado. Cinco pasos, documentados de principio a fin.
LeerReferencia
Autenticación de la API de Photta
Cómo autenticarse frente a la API de Photta: la cabecera Authorization, el prefijo de clave, dónde se generan las claves y cómo rotarlas de forma segura.
LeerReferencia
Precios de la API de Photta
Cuánto cuesta en credits cada endpoint de Photta API a 2K y 4K, cómo funcionan los cobros y reembolsos, y qué endpoints son gratuitos. Sin precio monetario por imagen.
LeerReferencia
Errores de Photta API
La lista completa de tipos de error de Photta API con sus status codes, la estructura del cuerpo de error y qué fallos merece la pena reintentar.
LeerReferencia
Endpoints de recursos de la API de Photta
Lista maniquíes, poses, fondos, calzado y etiquetas de marca, sube los tuyos propios y consulta tu saldo de credits. Las búsquedas detrás de cada generación.
Leer
Cada cifra de esta página proviene de la documentación de la API de Photta · verificado
Prueba la API en cinco minutos
Genera una API key de Photta, pega el snippet de cURL de arriba y tendrás tu primera imagen con modelo antes de que termine de prepararse el café.
- 600 requests/min
- Retry-After: 30s
- asíncrono, polling