API Pro: límites, códigos de error y buenas prácticas

Límites

Cada clave lleva tres: renders simultáneos (2 por defecto), envíos por minuto (60 por defecto) y, si lo configuras, un límite diario de créditos.

Al superar un límite la respuesta es 429 con una cabecera Retry-After en segundos. Una llamada rechazada no tiene ningún coste. El día utilizado para los límites es el día UTC.

Nuestra propia tarjeta se comparte con los usuarios de la app. Cuando está ocupada, tus renders van a GPUs alquiladas, al mismo precio y a través de la misma API, con unos pocos decenas de segundos más en el arranque.

Códigos de error

Código	error	Qué significa y qué hacer
400	champ prompt requis	Añade un prompt.
400	contenu_interdit	El filtro de contenido rechazó el prompt.
400	image_requise, inpaint_images_requises	El modo necesita image_b64, y mask_b64 para inpaint.
401	cle_requise, cle_invalide	Cabecera ausente o clave desconocida.
402	credits_insuffisants	Saldo insuficiente para este render (se indica el cost). Recarga en el sitio.
403	cle_desactivee, cle_revoquee, cle_expiree	Clave desactivada, revocada o expirada: crea una nueva en la app.
403	licence_revoquee, licence_non_pro	Licencia revocada, o cuenta que no es Pro.
403	portee_manquante	La clave no tiene el permiso solicitado, indicado en portee.
403	lora_inconnu	Un personaje que no pertenece a la cuenta.
404	media_indisponible	El archivo ya no está disponible: vuelve a enviar.
413	image_trop_lourde	La imagen de origen o la máscara supera los 12 MB descodificados.
429	trop_de_rendus_simultanes, cadence_minute, plafond_jour	Se ha alcanzado un límite, consulta Retry-After.
429	plafond_credits_jour	Se ha alcanzado el límite diario de créditos de la clave (plafond, depense, cout).
502	soumission_echouee, statut_echoue	Un incidente en el lado del render: reintenta en unos segundos.
503	licence_inverifiable	La cuenta no se puede verificar ahora mismo: reintenta en un minuto.

Los nombres de error son las cadenas exactas que devuelve la API. Compáralos con ellos en lugar de con el mensaje, que puede cambiar de redacción.

Buenas prácticas

• Consulta cada 3 segundos, no más rápido. La cola es compartida y saturarla no ayuda a nadie.
• Descarga en cuanto el estado sea completed. El archivo no se archiva.
• Escribe los prompts en inglés, y para vídeos describe el movimiento en lugar de la imagen estática.
• Una clave por uso, y un límite diario de créditos en cada clave que viva en un servidor. Una clave filtrada con límite te cuesta un día, no todo el saldo.
• Trata un 429 como algo normal, no como un fallo: espera al Retry-After y continúa.

Los prompts se registran en nuestro lado, igual que en la app, por motivos de seguridad.