Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt Anmelden

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

von Roilo-coVersion 1.0.0i★ 0iLäuft in der CloudOffizielle Website ↗
Name in der Registryio.github.roilo-co/ai-product-video-api

So installierst du es

Was es kann

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

Originaltext des Herstellers

  • Verbindung Läuft in der Cloud
  • Konto oder Schlüssel Braucht Authorization
  • Kategorie Design, Bilder & Audio

Zusammen nutzen mit

Skills, die der KI diese Art Arbeit beibringen; sie funktionieren zusammen mit diesem

impeccable

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

von pbakaus★ 113.0421 Skills

Skill · Anleitung

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.

von cathrynlavery★ 68.2961 Skills

Skill · Anleitung

frontend-slides

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

von zarazhangrui★ 32.5791 Skills

Skill · Anleitung

Warum es hier steht

Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert

Beliebtheit0/80GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20
Aktualität12/12Volle Punkte für Release oder Codeänderung in 30 Tagen
Antwortet noch8/8Der Cloud-Endpoint antwortete bei der letzten Prüfung
Nutzungswert20/100

Qualität: 2/5 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Mit einem Satz von deiner KI installieren lassen

Installiere bitte Roilo: UGC Video Ads From a Few Product or Venue Photos. Folge https://mcp.popnx.com/i/roilo-co-ai-product-video-api.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.

Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen

2/5 Prüfungen bestanden · Was du fragst, läuft über den Server des Anbieters (roilo.co) · ✓ Befehle geprüft am 20. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude · etwa 5 Min.

Du brauchst einen Schlüssel von Roilo: UGC Video Ads From a Few Product or Venue Photos (auf der Seite des Anbieters erstellen) · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu

  1. Bei Roilo: UGC Video Ads From a Few Product or Venue Photos registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von Roilo: UGC Video Ads From a Few Product or Venue Photos öffnen ↗

  2. Öffne die Connectors-Seite von Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  3. Klicke „Add“ → „Custom“ → „Web“ und fülle diese 2 Felder aus

    Kopiere jeden Wert in das gleichnamige Feld in Claude und klicke Continue

    Name · NameRoilo: UGC Video Ads From a Few Product or Venue Photos
    Remote MCP server URL · Adressehttps://roilo.co/api/mcp

    Unter Request headers diesen Namen und Wert hinzufügen

    Header-NameAuthorization
    WertBearer <Schlüssel hier einfügen>

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

    Klicke auf der von Claude erkannten Anmelde-Seite auf Continue · wähle bei Authentication, was der Anbieter angibt (Sign in now, Sign in when needed oder No sign in), dann Add

  4. Im Chat einschalten

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

  5. Ausprobieren

    Nutze Roilo: UGC Video Ads From a Few Product or Venue Photos und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es Roilo: UGC Video Ads From a Few Product or Venue Photos nutzt, oder ein Werkzeug von Roilo: UGC Video Ads From a Few Product or Venue Photos in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

ChatGPT kann Roilo: UGC Video Ads From a Few Product or Venue Photos noch nicht verbinden

Roilo: UGC Video Ads From a Few Product or Venue Photos braucht zum Verbinden deinen eigenen Schlüssel, aber die OpenAI-Hilfe beschreibt nur die Anmeldung per OAuth; eine Schlüssel-Option konnten wir nicht bestätigen

Das kannst du stattdessen tun

A · Eine App nutzen, die Roilo: UGC Video Ads From a Few Product or Venue Photos verbinden kann

  • Du brauchst einen Schlüssel von Roilo: UGC Video Ads From a Few Product or Venue Photos (auf der Seite des Anbieters erstellen) · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu
  • Du brauchst einen Schlüssel von Roilo: UGC Video Ads From a Few Product or Venue Photos (auf der Seite des Anbieters erstellen)
  • Du brauchst einen Schlüssel von Roilo: UGC Video Ads From a Few Product or Venue Photos (auf der Seite des Anbieters erstellen)
  • Du brauchst einen Schlüssel von Roilo: UGC Video Ads From a Few Product or Venue Photos (auf der Seite des Anbieters erstellen)

B · Andere in Design, Bilder & Audio, die mit ChatGPT funktionieren

Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden

Klappt mit Claude Code · etwa 5 Min.

Du brauchst einen Schlüssel von Roilo: UGC Video Ads From a Few Product or Venue Photos (auf der Seite des Anbieters erstellen)

  1. Bei Roilo: UGC Video Ads From a Few Product or Venue Photos registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von Roilo: UGC Video Ads From a Few Product or Venue Photos öffnen ↗

  2. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  3. Diesen Befehl einfügen und Enter drücken

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

    Ersetze „your-value“ vor dem Enter durch deinen Schlüssel

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  4. /mcp in Claude Code eingeben

    Roilo: UGC Video Ads From a Few Product or Venue Photos sollte in der Liste als verbunden erscheinen

  5. Ausprobieren

    Nutze Roilo: UGC Video Ads From a Few Product or Venue Photos und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es Roilo: UGC Video Ads From a Few Product or Venue Photos nutzt, oder ein Werkzeug von Roilo: UGC Video Ads From a Few Product or Venue Photos in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor · etwa 5 Min.

Du brauchst einen Schlüssel von Roilo: UGC Video Ads From a Few Product or Venue Photos (auf der Seite des Anbieters erstellen)

  1. Bei Roilo: UGC Video Ads From a Few Product or Venue Photos registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von Roilo: UGC Video Ads From a Few Product or Venue Photos öffnen ↗

  2. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  3. Schlüssel eintragen

    In den Einstellungen von Roilo: UGC Video Ads From a Few Product or Venue Photos ist Authorization leer; trag deinen Schlüssel ein und speichere

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  4. KI-Chat in Cursor im Agent-Modus öffnen

  5. Ausprobieren

    Nutze Roilo: UGC Video Ads From a Few Product or Venue Photos und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es Roilo: UGC Video Ads From a Few Product or Venue Photos nutzt, oder ein Werkzeug von Roilo: UGC Video Ads From a Few Product or Venue Photos in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code · etwa 5 Min.

Du brauchst einen Schlüssel von Roilo: UGC Video Ads From a Few Product or Venue Photos (auf der Seite des Anbieters erstellen)

  1. Bei Roilo: UGC Video Ads From a Few Product or Venue Photos registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von Roilo: UGC Video Ads From a Few Product or Venue Photos öffnen ↗

  2. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  3. Schlüssel eintragen

    In den Einstellungen von Roilo: UGC Video Ads From a Few Product or Venue Photos ist Authorization leer; trag deinen Schlüssel ein und speichere

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  4. KI-Chat in VS Code im Agent-Modus öffnen

  5. Ausprobieren

    Nutze Roilo: UGC Video Ads From a Few Product or Venue Photos und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es Roilo: UGC Video Ads From a Few Product or Venue Photos nutzt, oder ein Werkzeug von Roilo: UGC Video Ads From a Few Product or Venue Photos in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

Adresse für Apps, die über das Web verbinden

Adressehttps://roilo.co/api/mcp

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die Roilo: UGC Video Ads From a Few Product or Venue Photos nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Über das 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}"
      }
    }
  }
}

Werte, die du selbst einträgst

  • Authorization geheim erforderlich HTTP header
    Ihr Roilo-API-Schlüssel als Bearer-Token. Erstellen Sie einen Schlüssel unter roilo.co/developers.
    Englisches Original anzeigenYour Roilo API key as a bearer token. Create a key at roilo.co/developers.

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

Downloads pro Wochei
Nicht auf npm/PyPI
Lizenzi
Keine Lizenz angegeben
Verbindung
Läuft in der Cloud
Transport
streamable-http
Neueste Versioni
1.0.0
In der Registry veröffentlichti
12. Nov. 2026
Code zuletzt geänderti
13. Nov. 2026
Zuletzt geprüft
18. Nov. 2026
Entwickler
Roilo-co
Website
roilo.co
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Verbinden sich über das Internet in

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

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Der Server verlangt eine Anmeldung, bevor er seine Tools auflistet.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 20. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde mit dem GitHub-Konto roilo-co bestätigt, dem das Repo gehört

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: vor 7 Tagen

  • ✕ Nicht bestanden

    Hat eine Lizenz

    Keine Lizenzdatei im Repo gefunden

  • ! Vorsicht

    Endpunkt antwortet

    Zugriff verweigert (HTTP 401) ohne OAuth-Anmeldung. Braucht vielleicht einen Schlüssel oder blockiert Bots; nicht bestätigt.

  • ! Vorsicht

    Anmeldung mit OAuth

    Braucht einen Schlüssel oder Token, den du selbst kopierst und einfügst

  • … Noch nicht geprüft

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Noch nicht geprüft; wir lesen die Tool-Liste, wenn wir den Endpunkt prüfen

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

[![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)

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Design, Bilder & Audioi

  • Mehr Sterne als 0 % der anderen 3322 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 81 % der anderen 3322 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 8 % der anderen 3322 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

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

Er hat 2 von 5 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: Authorization

Läuft er auf meinem Computer oder in der Cloud?

Er läuft in der Cloud des Entwicklers. Du verbindest dich übers Internet, ohne etwas zu installieren, aber was du sendest, läuft über die Server des Entwicklers.

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt vor 7 Tagen geändert, und die neueste Version (1.0.0) kam vor 8 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL und funktioniert daher auch in Apps mit Remote-MCP, etwa ChatGPT im Web (volles MCP ab Business; Pro nur lesend).

Was kann ich stattdessen nutzen?

In derselben Kategorie: HyperFrames by HeyGen, Pascal 3D Editor, draw.io, Figma MCP Server, Remocn: Remotion MCP server

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

HyperFrames by HeyGen

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

von heygen-comWeit verbreitet★ 86.798 Sterne des ganzen ReposAktualisiert vorgestern

Läuft in der Cloud✓ heygen.com

Pascal 3D Editor

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

von pascalorgWeit verbreitet↓ 1037/Wo.★ 25.617 Sterne des ganzen ReposAktualisiert vorgestern

Computer oder Cloud✓ vom Dienst · pascal.app

draw.io

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

von jgraphWeit verbreitet★ 5860Aktualisiert vor 3 Tagen

Läuft in der Cloud✓ vom Dienst · draw.ioVom PopNx-Team ausprobiert

Figma MCP Server

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

von figmaWeit verbreitet★ 2213Aktualisiert vor 13 Monaten

Läuft in der Cloud✓ vom Dienst · mcp.figma.com

Remocn: Remotion MCP server

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

von RemocnWachsend★ 1804Aktualisiert vor 10 Tagen

Läuft in der Cloud✓ vom Dienst · remocn.dev
Im Vergleich mit ähnlichen
Dieser
Roilo: UGC Video Ads From a Few Product or Venue Photos
HyperFrames by HeyGenPascal 3D Editordraw.ioFigma MCP ServerRemocn: Remotion MCP server
Läuft woLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationIn der Cloud oder auf deinem RechnerLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine Installation
Braucht SchlüsselJaNeinNeinNeinNeinNein
Mit + in Claude hinzufügenNeinJaNeinNeinJaNein
Basisprüfungen2/54/45/54/44/44/4
Lizenz–Apache-2.0MITApache-2.0–MIT
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

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

Nur der Anfang wird gezeigt; den Rest findest du im Repo