API para desarrolladores

Te damos la bienvenida a la API para desarrolladores de YouThumbAI. Esta API REST te permite integrar la generación de miniaturas con IA directamente en tus aplicaciones, automatizar flujos de trabajo y crear integraciones a medida.

URL base

Todas las solicitudes a la API se hacen a: 
https://youthumb.ai/api

Obtener tu clave API

Para usar la API necesitas una clave API. Así se obtiene:
1

Ve a Claves API

Ve a Cuenta → Claves API
2

Crea una nueva clave

Haz clic en el botón Crear clave API y dale a tu clave un nombre descriptivo.
3

Copia tu clave

Copia tu clave API de inmediato. Por seguridad, solo se muestra una vez.
Advertencia de seguridad: nunca expongas tu clave API en código del lado del cliente, en repositorios públicos ni en JavaScript del navegador. Usa siempre variables de entorno y solicitudes del lado del servidor.

Inicio rápido

Este es un ejemplo mínimo para crear y generar una miniatura:
bash
# 1. Crear un proyecto de miniatura
curl -X POST https://youthumb.ai/api/thumbnails \
  -H "x-api-key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Excited creator with bright yellow background"}'

# Respuesta: { "success": true, "data": { "projectId": "abc-123", ... } }

# 2. Iniciar la generación
curl -X POST https://youthumb.ai/api/thumbnails/abc-123/start \
  -H "x-api-key: your_api_key"

# 3. Consultar hasta que termine
curl https://youthumb.ai/api/thumbnails/abc-123/status \
  -H "x-api-key: your_api_key"

Formato de respuesta

Todas las respuestas de la API siguen un formato coherente: Respuesta correcta:
json
{
  "success": true,
  "data": { ... }
}
Respuesta de error:
json
{
  "success": false,
  "error": "Error message",
  "details": { ... }  // Opcional: errores de validación
}

APIs disponibles

APIDescripción
ThumbnailsCrear y generar miniaturas con IA
PersonsGestionar perfiles de rostro para personalizar
TemplatesExplorar plantillas de referencia de estilo
PresetsAcceder a presets de estilo predefinidos
AssetsSubir y gestionar imágenes (rostros, plantillas, archivos temporales)

Límites de solicitudes

Las solicitudes a la API tienen un límite que depende de tu plan de suscripción. Si superas el límite, recibes una respuesta 429 Too Many Requests.

¿Qué sigue?

1

Autenticación

Conoce los métodos de autenticación y las buenas prácticas.
2

API de miniaturas

Explora la API de miniaturas para empezar a generar miniaturas.
¿Necesitas ayuda? Contacta a nuestro equipo de soporte o consulta la referencia de códigos de error para resolver problemas.