Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas Iniciar sesión

Roilo: UGC Video Ads From a Few Product or Venue Photos

de Roilo-coversión 1.0.0i★ 0iSe ejecuta en la nubeSitio oficial ↗
Nombre en el registroio.github.roilo-co/ai-product-video-api

Cómo instalar

Qué hace

Turn a few product or venue photos into a usable UGC video ad: script, actor, voiceover, captions.

Texto original del autor

  • Conexión Se ejecuta en la nube
  • Cuenta o clave Necesita Authorization
  • Categoría Diseño, imágenes y audio

Úsalo junto con

Skills que enseñan a la IA este tipo de trabajo; funcionan junto a este

impeccable

The design vocabulary for your coding agent. Steer with polish and bolder, review with critique and audit, catch AI slop before it ships.

de pbakaus★ 113.0421 skills

Skill · Guía de trabajo

diagram-design

Editorial diagram design for Claude Code, Codex, GitHub Copilot, Cursor, Factory Droid, Qoder, and Pi. 45 diagram types. Self-contained HTML + SVG. No shadows. No Mermaid slop.

de cathrynlavery★ 68.2961 skills

Skill · Guía de trabajo

frontend-slides

Create beautiful slides on the web using a coding agent's frontend skills

de zarazhangrui★ 32.5791 skills

Skill · Guía de trabajo

Por qué está en este puesto

Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes

Popularidad0/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad12/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo8/8El endpoint en la nube respondió en la última revisión
Puntuación de uso20/100

Calidad: Pasó 2/5 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)

Instalación

Elige la app de IA que usas y copia la configuración.

Que tu IA lo instale con una frase

Instala Roilo: UGC Video Ads From a Few Product or Venue Photos. Sigue https://mcp.popnx.com/i/roilo-co-ai-product-video-api.md, enséñame los comandos y espera mi OK antes de ejecutarlos.

Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA

Pasó 2/5 revisiones · Lo que preguntas pasa por el servidor del autor (roilo.co) · ✓ Comandos revisados el 20 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude · unos 5 min

Necesitas una clave de Roilo: UGC Video Ads From a Few Product or Venue Photos (créala en el sitio del autor) · Configúralo una vez en claude.ai o en la app de escritorio y úsalo en el chat · las cuentas gratis pueden añadir 1 · en Team/Enterprise lo añade un Owner

  1. Regístrate y crea una clave de Roilo: UGC Video Ads From a Few Product or Venue Photos

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Abrir el sitio de Roilo: UGC Video Ads From a Few Product or Venue Photos ↗

  2. Abre la página Connectors de Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  3. Pulsa “Add” → “Custom” → “Web” y completa estos 2 campos

    Copia cada valor al campo con el mismo nombre en Claude y pulsa Continue

    Name · NombreRoilo: UGC Video Ads From a Few Product or Venue Photos
    Remote MCP server URL · Direcciónhttps://roilo.co/api/mcp

    En Request headers, añade este nombre y valor

    Nombre del headerAuthorization
    ValorBearer <pega tu clave aquí>

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

    Pulsa Continue en la pantalla de inicio de sesión que detectó Claude · en Authentication elige lo que indique el autor (Sign in now, Sign in when needed o No sign in) y pulsa Add

  4. Actívalo en un chat

    +ConnectorsRoilo: UGC Video Ads From a Few Product or Venue Photos

  5. Pruébalo

    Usa Roilo: UGC Video Ads From a Few Product or Venue Photos y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando Roilo: UGC Video Ads From a Few Product or Venue Photos o muestra una herramienta de Roilo: UGC Video Ads From a Few Product or Venue Photos en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

ChatGPT todavía no puede conectar Roilo: UGC Video Ads From a Few Product or Venue Photos

Roilo: UGC Video Ads From a Few Product or Venue Photos necesita tu propia clave para conectarse, pero la ayuda de OpenAI solo describe el inicio de sesión con OAuth; no hay una opción de clave que hayamos podido verificar

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar Roilo: UGC Video Ads From a Few Product or Venue Photos

  • Necesitas una clave de Roilo: UGC Video Ads From a Few Product or Venue Photos (créala en el sitio del autor) · Configúralo una vez en claude.ai o en la app de escritorio y úsalo en el chat · las cuentas gratis pueden añadir 1 · en Team/Enterprise lo añade un Owner
  • Necesitas una clave de Roilo: UGC Video Ads From a Few Product or Venue Photos (créala en el sitio del autor)
  • Necesitas una clave de Roilo: UGC Video Ads From a Few Product or Venue Photos (créala en el sitio del autor)
  • Necesitas una clave de Roilo: UGC Video Ads From a Few Product or Venue Photos (créala en el sitio del autor)

B · Otros en Diseño, imágenes y audio que funcionan con ChatGPT

Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave

Funciona con Claude Code · unos 5 min

Necesitas una clave de Roilo: UGC Video Ads From a Few Product or Venue Photos (créala en el sitio del autor)

  1. Regístrate y crea una clave de Roilo: UGC Video Ads From a Few Product or Venue Photos

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Abrir el sitio de Roilo: UGC Video Ads From a Few Product or Venue Photos ↗

  2. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  3. Pega este comando y pulsa Enter

    claude mcp add --transport http --scope user ai-product-video-api https://roilo.co/api/mcp --header 'Authorization: Bearer {api_key}'

    Cambia “your-value” por tu clave antes de pulsar Enter

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  4. Escribe /mcp en Claude Code

    Deberías ver Roilo: UGC Video Ads From a Few Product or Venue Photos en la lista como conectado

  5. Pruébalo

    Usa Roilo: UGC Video Ads From a Few Product or Venue Photos y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando Roilo: UGC Video Ads From a Few Product or Venue Photos o muestra una herramienta de Roilo: UGC Video Ads From a Few Product or Venue Photos en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor · unos 5 min

Necesitas una clave de Roilo: UGC Video Ads From a Few Product or Venue Photos (créala en el sitio del autor)

  1. Regístrate y crea una clave de Roilo: UGC Video Ads From a Few Product or Venue Photos

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Abrir el sitio de Roilo: UGC Video Ads From a Few Product or Venue Photos ↗

  2. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  3. Escribe tu clave

    En la configuración de Roilo: UGC Video Ads From a Few Product or Venue Photos, Authorization está vacío; añade tu clave y guarda

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  4. Abre el chat de IA de Cursor en modo Agent

  5. Pruébalo

    Usa Roilo: UGC Video Ads From a Few Product or Venue Photos y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando Roilo: UGC Video Ads From a Few Product or Venue Photos o muestra una herramienta de Roilo: UGC Video Ads From a Few Product or Venue Photos en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code · unos 5 min

Necesitas una clave de Roilo: UGC Video Ads From a Few Product or Venue Photos (créala en el sitio del autor)

  1. Regístrate y crea una clave de Roilo: UGC Video Ads From a Few Product or Venue Photos

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Abrir el sitio de Roilo: UGC Video Ads From a Few Product or Venue Photos ↗

  2. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  3. Escribe tu clave

    En la configuración de Roilo: UGC Video Ads From a Few Product or Venue Photos, Authorization está vacío; añade tu clave y guarda

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  4. Abre el chat de IA de VS Code en modo Agent

  5. Pruébalo

    Usa Roilo: UGC Video Ads From a Few Product or Venue Photos y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando Roilo: UGC Video Ads From a Few Product or Venue Photos o muestra una herramienta de Roilo: UGC Video Ads From a Few Product or Venue Photos en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

Dirección para apps que se conectan por la web

Direcciónhttps://roilo.co/api/mcp

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa Roilo: UGC Video Ads From a Few Product or Venue Photos💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Por la web

Claude Code

claude mcp add --transport http --scope user ai-product-video-api https://roilo.co/api/mcp --header 'Authorization: Bearer {api_key}'

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "ai-product-video-api": {
      "url": "https://roilo.co/api/mcp",
      "headers": {
        "Authorization": "Bearer {api_key}"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "ai-product-video-api": {
      "type": "http",
      "url": "https://roilo.co/api/mcp",
      "headers": {
        "Authorization": "Bearer {api_key}"
      }
    }
  }
}

Valores que debes completar

  • Authorization secreto obligatorio HTTP header
    Tu clave de API de Roilo como token bearer. Crea una clave en roilo.co/developers.
    Ver original en inglésYour Roilo API key as a bearer token. Create a key at roilo.co/developers.

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
No está en npm/PyPI
Licenciai
Sin licencia indicada
Conexión
Se ejecuta en la nube
Transporte
streamable-http
Última versióni
1.0.0
Publicado en el registroi
12 nov 2026
Último cambio de códigoi
13 nov 2026
Última revisión
18 nov 2026
Creador
Roilo-co
Sitio web
roilo.co
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se conectan por internet en

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

El servidor pide iniciar sesión antes de mostrar sus herramientas.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 20 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub roilo-co, dueña del repo

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: hace 7 días

  • ✕ No superada

    Tiene licencia

    No se encontró ningún archivo de licencia en el repo

  • ! Precaución

    El endpoint responde

    Rechazó el acceso (HTTP 401) sin ofrecer inicio de sesión OAuth. Puede necesitar una clave o bloquear bots; sin confirmar.

  • ! Precaución

    Inicio de sesión con OAuth

    Necesita una clave o un token que debes copiar y pegar a mano

  • … Aún sin revisar

    Sin instrucciones ocultas en las descripciones de herramientas

    Aún sin revisar; leemos la lista de herramientas cuando revisamos el endpoint

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/roilo-co-ai-product-video-api.svg)](https://mcp.popnx.com/en/servers/roilo-co-ai-product-video-api)

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Diseño, imágenes y audioi

  • Más estrellas que el 0% de los otros 3322 servidores de esta categoría
  • Publicado en el registro más recientemente que el 81% de los otros 3322 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 8% de los otros 3322 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Roilo: UGC Video Ads From a Few Product or Venue Photos?

Superó 2 de 5 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: Authorization

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en la nube del creador. Te conectas por internet sin instalar nada, pero lo que envías pasa por los servidores del creador.

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hace 7 días, y la última versión (1.0.0) llegó al registro hace 8 días.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. Se conecta por URL, así que también sirve en apps que aceptan MCP remoto, como ChatGPT en la web (MCP completo en Business y superiores; Pro solo lectura).

¿Qué puedo usar en su lugar?

En la misma categoría: HyperFrames by HeyGen, Pascal 3D Editor, draw.io, Figma MCP Server, Remocn: Remotion MCP server

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

HyperFrames by HeyGen

Official HyperFrames by HeyGen: the best AI video editor in chat. Captions, motion graphics, MP4.

de heygen-comMuy usado★ 86,8 mil Estrellas de todo el repositorioActualizado anteayer

Se ejecuta en la nube✓ heygen.com

Pascal 3D Editor

Create, inspect, validate, and save editable 3D building scenes with Pascal's MCP server.

de pascalorgMuy usado↓ 1 mil/sem★ 25,6 mil Estrellas de todo el repositorioActualizado anteayer

Computadora o nube✓ del servicio · pascal.app

draw.io

Create draw.io diagrams in chat from Mermaid or XML, shown live and interactive. 10,000+ shapes.

de jgraphMuy usado★ 5,9 milActualizado hace 3 días

Se ejecuta en la nube✓ del servicio · draw.ioProbado por el equipo de PopNx

Figma MCP Server

The Figma MCP server brings Figma design context directly into your AI workflow.

de figmaMuy usado★ 2,2 milActualizado hace 13 meses

Se ejecuta en la nube✓ del servicio · mcp.figma.com

Remocn: Remotion MCP server

Hosted MCP for Remotion videos: search Remocn components, read docs, plan a video, preview it.

de RemocnEn crecimiento★ 1,8 milActualizado hace 10 días

Se ejecuta en la nube✓ del servicio · remocn.dev
Comparado con otros parecidos
Este
Roilo: UGC Video Ads From a Few Product or Venue Photos
HyperFrames by HeyGenPascal 3D Editordraw.ioFigma MCP ServerRemocn: Remotion MCP server
Dónde se ejecutaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaEn la nube o instalado en tu equipoFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nada
Necesita claveSíNoNoNoNoNo
Se añade con + en ClaudeNoSíNoNoSíNo
Revisiones básicas2/54/45/54/44/44/4
Licencia–Apache-2.0MITApache-2.0–MIT
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

Roilo API: AI UGC Video Ads From a Few Product or Venue Photos

Send a few product or venue photos. Get back a usable UGC video ad.

Roilo makes AI UGC video ads. It writes the script and generates the scenes with your product and presenter. It records the voiceover, burns in captions and makes the cuts.

The video comes in 9:16, 1:1 or 16:9. Make videos from your own app with the API, or by chat in Claude through the Roilo MCP server.

Website · Developer reference · Use Roilo in Claude · How it works · Pricing

This repo is the quickstart. It holds no code.

The full, current API reference is at [roilo.co/developers](https://roilo.co/developers). If this README and that page ever differ, the page is right.

Contents

  • What Roilo makes: AI UGC video ads
  • How a video gets made
  • Quickstart: REST API
  • Endpoints
  • Video statuses and fields
  • Webhooks
  • Use Roilo as a video creator in Claude (MCP)
  • Errors, retries and limits
  • Use cases
  • FAQ

What Roilo makes: AI UGC video ads

Roilo turns a product or a service into a video ad that is ready to post. You upload photos of your product and a presenter. The presenter can be you, or someone from Roilo's library. Roilo does the rest.

  • It works out what to say first. Before anything renders, Roilo reads your product. It finds the target buyer, the problem they want solved, what makes the product different, the dream outcome and the time to result.
  • Your product. Your presenter. Your place. Scenes stay true to the photos you sent. For service businesses, that includes your real venue. Every scene is checked against your photos. A scene that doesn't match is rejected and made again.
  • It arrives finished. The voiceover is recorded, captions are burned in and the cuts are made. Nothing is left to edit.
  • The shape your platform wants. You get 9:16 vertical (the default), 1:1 square or 16:9 widescreen. Quality is 480p, 720p or 1080p.
  • You pay only for delivered videos. Credits are held when a video starts. They are charged when the video is delivered and refunded if it fails.

The API makes the same videos as the website. You don't book a creator, rerun scenes one by one or fight with prompts.

How a video gets made

POST /v1/videos

│ ▼ queued ──(review: true)──► awaiting_review ──► approve, or it continues at review_expires_at │ │ ▼ │ processing ◄──────────────────────────────────────┘ │ ├──► completed output.video_url is ready to download └──► failed error.code says why; held credits are refunded

Generation runs in the background. The create call returns 202 straight away. Then you wait for a webhook, or you poll the video.

Quickstart: REST API

Base URL: https://roilo.co/api/v1. Requests and responses are JSON over HTTPS. Uploads are multipart. Timestamps are ISO 8601 in UTC.

1. Create an API key

Sign up for free. You need a verified email. Then open the account menu, choose API keys (/settings/api-keys) and click Create key. Keys start with rk_live_ and are shown only once. You can give each key a monthly credit limit.

export ROILO_API_KEY="rk_live_..."
2. Check the key
curl https://roilo.co/api/v1/me \

-H "Authorization: Bearer $ROILO_API_KEY"

This returns your available credits and how much this key has spent this month. A missing, malformed or revoked key returns 401 invalid_api_key.

3. Pick a mode and a presenter
# Video modes: credit cost, photo limits, aspect ratios, qualities

curl -s https://roilo.co/api/v1/modes \ -H "Authorization: Bearer $ROILO_API_KEY" | jq '.data[] | {id, name, credit_cost}'

Your own presenters plus stock presenters

curl -s https://roilo.co/api/v1/actors \ -H "Authorization: Bearer $ROILO_API_KEY" | jq '.data[] | {id, name, is_stock}'

/v1/voices and /v1/caption-styles work the same way.

4. Upload photos (optional)

You can skip this step and send public https links to your photos instead.

curl https://roilo.co/api/v1/files \

-H "Authorization: Bearer $ROILO_API_KEY" \ -F "file=@tumbler-front.jpg"

→ { "id": "file_...", "expires_at": "..." }

Uploads can be JPEG, PNG or WebP. You can reuse a file ID across videos until it expires.

5. Create the video
IDEMPOTENCY_KEY=$(uuidgen)   # reuse this same value if you retry

curl https://roilo.co/api/v1/videos \ -H "Authorization: Bearer $ROILO_API_KEY" \ -H "Idempotency-Key: $IDEMPOTENCY_KEY" \ -H "Content-Type: application/json" \ -d '{ "mode": "MODE_ID", "actor_id": "ACTOR_ID", "product_images": [ "file_...", "https://cdn.example.com/tumbler-side.jpg" ], "aspect_ratio": "9:16", "product": { "name": "Insulated tumbler", "category": "home" }, "webhook_url": "https://example.com/webhooks/roilo", "metadata": { "sku": "TMB-001" } }'

Replace MODE_ID and ACTOR_ID with IDs from step 3. A few notes:

  • Choose a presenter. Send actor_id, or send your own presenter photos in actor_images. Without actor_id, a product video needs at least the number of presenter photos its mode sets.
  • Photo counts vary by mode. Each mode sets its own minimum and maximum number of photos.
  • You can say more about the product. Add target_audience, pain_point, dream_outcome, competitive_advantage, social_proof and result to the product object.
  • Other settings. voice_id, caption_style_id and quality are also available.
  • `metadata` comes back unchanged on the video object.
  • `"review": true` pauses the video so you can check the brief first. See Review before generation.

The call returns 202 with the video object, in status queued.

6. Get the finished video

The recommended way is to listen for the video.completed webhook. You can also poll:

// Node 18+

const BASE = "https://roilo.co/api/v1"; const headers = { Authorization: Bearer ${process.env.ROILO_API_KEY} };

export async function waitForVideo(id, everyMs = 15_000) { for (;;) { const res = await fetch(${BASE}/videos/${id}, { headers }); if (!res.ok) throw new Error(Roilo responded ${res.status}); const video = await res.json(); if (video.status === "completed") return video.output; // video_url, thumbnail_url, ... if (video.status === "failed") throw new Error(video.error.code); await new Promise((r) => setTimeout(r, everyMs)); } }

Download links are signed and expire after one hour (see output.url_expires_at). To get fresh links, fetch the video again.

Endpoints

MethodPathWhat it does
GET/v1/meCheck the key; read credits and this key's spend
GET/v1/modesVideo modes, credit cost, photo limits, aspect ratios, qualities
GET/v1/actorsYour presenters and stock presenters
GET/v1/voicesYour voices and stock voices
GET/v1/caption-stylesCaption styles
POST/v1/filesUpload one image (201)
POST/v1/videosStart a video (202)
GET/v1/videosList videos, newest first (limit, cursor)
GET/v1/videos/:idRead one video
POST/v1/videos/:id/approveRelease a video held for review
DELETE/v1/videos/:idDelete a video (204)

For every field, limit and example, see roilo.co/developers.

Video statuses and fields

statusMeaning
queuedAccepted. Inputs are being prepared.
awaiting_reviewPaused for you (review: true). Approve it, or it continues on its own when review_expires_at passes.
processingThe video is being generated.
completedoutput is set.
failederror says why. Held credits are refunded.

Write your code against status and error.code.

The fields you will use most:

FieldWhat it holds
idThe video ID, starting with vid_
outputnull until the video is completed. Then it holds video_url, thumbnail_url, duration_sec, aspect_ratio, quality and url_expires_at
errorcode, message and, sometimes, param (the field at fault)
briefThe drafted brief, while the video is awaiting review
credits_held, credits_chargedCredits held for the video, and credits charged on delivery
metadataYour own object, returned unchanged
Review before generation

If you send "review": true, Roilo first analyzes your photos, then stops at awaiting_review. Fetch the video to read the drafted brief. Then approve it:

curl -X POST https://roilo.co/api/v1/videos/vid_.../approve \

-H "Authorization: Bearer $ROILO_API_KEY"

The request body is optional. To change the brief, send a brief that holds only the fields you want to change. If the video isn't waiting for review, approving it returns 409 not_awaiting_review.

Webhooks

Set webhook_url on a video. Roilo then POSTs JSON to that URL for three events:

EventWhen it fires
video.awaiting_reviewThe brief is ready for you to check
video.completedThe video is ready
video.failedThe video failed, and its credits were refunded

The body holds the event id, type and created_at, plus the full video object under data.

  • Reply fast. Return any 2xx within 10 seconds. Redirects are not followed.
  • Failed deliveries are retried. The gaps grow longer between tries, up to six attempts in total.
  • Expect duplicates. An event can arrive more than once. De-duplicate on the Roilo-Event-Id header, or on the body id.
  • Links can go stale. The links in a webhook may expire before a retry arrives. Fetch the video for fresh ones.
Verify the signature

Each webhook carries this header: Roilo-Signature: t= ,v1=

  • What is signed: the HMAC covers ${t}.${rawBody}.
  • The secret: your key's webhook secret. It starts with whsec_, is shown once, and can be rotated on the API keys page.
  • Freshness: reject any t more than 300 seconds from now.
  • Comparison: compare signatures in constant time.
  • Raw body: always verify against the raw request body, before you parse the JSON.

Sample code: Node.js and Python

Node.js (Express)

import express from "express";

import { createHmac, timingSafeEqual } from "node:crypto";

export function verifyRoiloSignature(secret, rawBody, header = "", toleranceSec = 300) { const { t = "", v1 = "" } = Object.fromEntries( header.split(",").map((part) => part.trim().split("=")) ); if (!/^\d+$/.test(t) || Math.abs(Date.now() / 1000 - Number(t)) > toleranceSec) return false; const expected = createHmac("sha256", secret).update(${t}.).update(rawBody).digest(); const given = Buffer.from(v1, "hex"); return given.length === expected.length && timingSafeEqual(given, expected); }

const app = express(); const seen = new Set(); // use a shared store in production

app.post("/webhooks/roilo", express.raw({ type: "*/*" }), (req, res) => { const ok = ve

Solo se muestra el principio; lee el resto en el repo