Referencia · Autenticación
Autenticación de la API de Photta una clave, una cabecera
En una frase
Envía tu clave como `Authorization: Bearer photta_live_xxx` en cada llamada a la API de Photta. Las claves se generan en el panel de control, no tienen scopes por endpoint y comparten un único saldo de credits.
- Autenticación: Bearer key
- Límites: 600 requests/min
- Procesamiento: asíncrono, polling
Cada cifra de esta página proviene de la documentación de la API de Photta · verificado
Qué espera la API
Resumen de autenticación
- Cabecera
- Authorization: Bearer photta_live_xxx
- Prefijo de clave
- photta_live_
- Base URL
- https://api.photta.app/api/v1
- Dónde se generan las claves
- https://ai.photta.app
- Scope
- Una sola clave da acceso a todos los endpoints y a un único saldo de credits
Comprueba una clave con una sola llamada
El endpoint de cuenta es gratuito, por lo que es la vía segura para confirmar que una clave funciona.
curl https://api.photta.app/api/v1/account \
-H "Authorization: Bearer $PHOTTA_API_KEY"const res = await fetch("https://api.photta.app/api/v1/account", {
headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();import os, requests
res = requests.get(
"https://api.photta.app/api/v1/account",
headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]Gestión de claves
Rota ante cualquier sospecha
La documentación es clara: rota una clave de inmediato si sospechas que ha sido comprometida. Genera primero el reemplazo, despliégalo y luego retira la anterior.
Manténla en el servidor
Una clave expuesta en el navegador queda al alcance de cualquiera que cargue la página. Llama a la API desde tu backend y envía los resultados al cliente.
401 señala la clave, no la petición
Una clave ausente, no válida o expirada devuelve `authentication_error`. Revisa la cabecera en busca de erratas y espacios en blanco accidentales antes de investigar otra causa.
Un único saldo para todas las claves
Las claves no están limitadas por capability. Usar varias claves para distintos entornos consume el mismo saldo de credits, el cual devuelve GET `/api/v1/account`.
Preguntas sobre autenticación
¿Cómo autentico una petición?
Envía la clave en la cabecera Authorization como bearer token en cada llamada. No hay ningún paso independiente de inicio de sesión o intercambio de tokens.
¿Dónde creo una clave?
En tu panel de Photta. En ese mismo lugar se emiten los reemplazos, que es a donde te dirige la documentación tras un 401.
¿Puedo llamar a la API desde el navegador?
No con tu clave. Todo lo que se envía a un navegador es legible por sus visitantes, así que coloca la llamada detrás de tu propio servidor y reenvía el resultado.
¿Qué pasa si se filtra una clave?
Rótala de inmediato: genera una clave nueva, despliégala y luego elimina la antigua. Los credits ya gastados no se pueden recuperar, así que rota primero e investiga después.
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
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
Rate limits de la API de Photta
El rate limit de la API de Photta, su ventana, la cabecera Retry-After, el intervalo de polling y los límites de concurrencia por plan, todo extraído directamente de la documentación de la API.
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é.
- Bearer key
- 600 requests/min
- asíncrono, polling