# Staglight API

> API REST y servidor MCP con créditos prepago para anuncios de tiendas online (imágenes, video, voz, música, subtítulos) en español, inglés, alemán y portugués. Sin suscripción.

URL base https://staglight.ai/api/v1. Autenticación: `Authorization: Bearer <clave>` (las claves empiezan por sl_live_). Los POST de pago aceptan el encabezado `Idempotency-Key` y `max_credits`. Los trabajos responden 202 con un id: consulta GET /api/v1/jobs/<id>?wait=30. Sin créditos es 402 con needed y balance; los trabajos fallidos se reembolsan. Servidor MCP: https://staglight.ai/mcp.

## Documentación
- [Primeros pasos](https://staglight.ai/es/docs.md): claves, créditos, precio, crear, consultar, descargar, idempotencia, errores y límites
- [Referencia de la API](https://staglight.ai/es/docs/api.md): cada endpoint con parámetros, respuestas y curl
- [Configurar el MCP](https://staglight.ai/es/docs/mcp.md): Claude Code, Codex, Cursor, herramientas y reglas de gasto
- [Kit para agentes](https://staglight.ai/es/docs/agente.md): prompt para el agente, skill y recetas de FFmpeg
- [OpenAPI](https://staglight.ai/api/v1/openapi.json): documento OpenAPI 3.1

## Archivos para agentes
- [SKILL.md](https://staglight.ai/agent/staglight-ads/SKILL.md): Agent Skill para Claude Code, Codex y Cursor (en inglés)
- [ffmpeg.md](https://staglight.ai/agent/staglight-ads/references/ffmpeg.md): recetas de FFmpeg para terminar anuncios (en inglés)
- [MCP](https://staglight.ai/mcp): servidor MCP remoto (Streamable HTTP, clave Bearer)

## Optional
- [Toda la documentación en un archivo](https://staglight.ai/es/llms-full.txt): todas las páginas anteriores en un solo archivo Markdown
- [English documentation](https://staglight.ai/llms.txt): versión en inglés