Vídeos desde tu código

Empezar

Una llamada crea el vídeo y devuelve su id. La generación tarda unos minutos, así que la respuesta llega antes que el vídeo: consulta el estado con ese id.

curl https://autoshort.io/api/v1/videos \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "type": "faceless",
    "script": "Tres cosas que nadie te cuenta sobre dormir bien.",
    "duration": 30
  }'

Autenticación

Cada petición lleva tu clave en la cabecera Authorization. Las claves se crean desde el panel y se muestran una sola vez.

Authorization: Bearer sk_live_8f2c...

Guardamos solo un hash de la clave, así que no podemos enseñártela otra vez. Si la pierdes, revócala y crea otra.

Crea un vídeo. Devuelve 202 con el id: el render sigue en marcha cuando recibes la respuesta.

Respuesta

{
  "id": "9f1c2a6e-...",
  "status": "pending",
  "type": "faceless",
  "title": "Tres cosas que nadie te cuenta...",
  "credits_used": 40,
  "url": null
}

Consulta uno de tus vídeos. Mientras se genera, status es pending o processing; al terminar llega la url del MP4.

{
  "id": "9f1c2a6e-...",
  "status": "completed",
  "url": "https://cdn.autoshort.io/renders/9f1c2a6e.mp4",
  "error": null,
  "created_at": "2026-08-05T18:20:11.000Z"
}

Un vídeo de otra cuenta responde 404, no 403: un 403 confirmaría que ese id existe.

Los últimos vídeos de la cuenta, del más reciente al más antiguo. limit acepta hasta 50.

{ "data": [ { "id": "...", "status": "completed", "url": "..." } ] }

Tu plan, tus créditos, tus límites y lo que llevas gastado. Útil antes de lanzar un lote: te dice cuántos renders tienes ya en marcha.

{
  "email": "[email protected]",
  "plan": "creator",
  "credits": 820,
  "limits": {
    "requests_per_minute": 60,
    "concurrent_renders": 3,
    "credits_per_video": 40,
    "credits_per_extra_minute": 15
  },
  "usage": {
    "requests_last_minute": 2,
    "requests_today": 34,
    "requests_30d": 512,
    "credits_today": 120,
    "credits_30d": 1840,
    "errors_30d": 3,
    "renders_running": 1
  }
}

Errores

Todos los errores llegan con el mismo cuerpo: un objeto error con code y message.

Créditos y límites

Una llamada a la API cuesta exactamente lo mismo que hacer el vídeo desde la app, y sale del mismo saldo.

• 40 créditos por vídeo de hasta 60 segundos, y 15 más por cada minuto extra.
• Hasta cinco claves activas por cuenta, revocables en cualquier momento.
• Los vídeos creados por API aparecen en tu panel como cualquier otro.
• Límite de peticiones por minuto y de vídeos generándose a la vez, según el plan.
• Cada respuesta trae tus créditos y tu cupo restante en las cabeceras.

Cabeceras de cada respuesta

X-Plan: creator
X-Credits-Remaining: 780
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58
X-RateLimit-Reset: 60

Servidor MCP

Si trabajas con un asistente que habla MCP (Claude Desktop, Claude Code, Cursor), el servidor de AutoShort le da estas herramientas directamente. Es la misma API: la misma clave, el mismo plan, los mismos créditos y los mismos límites.

{
  "mcpServers": {
    "autoshort": {
      "command": "node",
      "args": ["/ruta/a/mcp/autoshort-mcp.mjs"],
      "env": { "AUTOSHORT_API_KEY": "sk_live_..." }
    }
  }
}

Herramientas

• create_videocrea un vídeo y devuelve su id.
• get_videoconsulta en qué punto está un vídeo.
• list_videoslista los últimos vídeos de la cuenta.
• get_accountplan, créditos, límites y uso.

El servidor está en el repositorio, en mcp/autoshort-mcp.mjs. No necesita dependencias: solo Node.