Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.faces.app/llms.txt

Use this file to discover all available pages before exploring further.

La API de Faces es una REST API que te permite generar y gestionar de forma programática presentaciones interactivas y explorables. Pitches, portafolios, guías y propuestas. Describe lo que quieres en un prompt y Faces lo construye.

​
URL base

https://faces.app/api/v1

​
Autenticación

Incluye tu API key como un Bearer token: 
Authorization: Bearer faces_your_key_here
Consulta Autenticación para aprender cómo crear una key.

​
Formato de las requests

  • Todos los cuerpos de request son JSON (Content-Type: application/json)
  • Todas las responses son JSON

​
Responses de error

Los errores devuelven un cuerpo JSON con un campo error y, opcionalmente, un hint: 
{
  "error": "prompt is required",
  "hint": "POST /api/v1/projects/generate {\"prompt\": \"<text>\"}"
}
StatusSignificado
400Cuerpo o parámetros de request inválidos
401API key ausente o inválida
404Recurso no encontrado
429Rate limit excedido (50 req/min)
500Error interno del servidor

​
Rate limits

Todos los endpoints comparten un límite de 50 requests por minuto por usuario. Cuando se excede:
  • Status de la response: 429
  • Headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

​
Paginación

Los endpoints de listado usan paginación basada en cursores: 
# Primera página
GET /projects?limit=10

# Siguiente página (usa nextCursor de la response anterior)
GET /projects?limit=10&cursor=cm1abc123...