プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説 ログイン

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

作者:Roilo-coバージョン 1.0.0i★ 0iクラウドで動く公式サイト ↗
レジストリ名io.github.roilo-co/ai-product-video-api

インストール方法

できること

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

作者による原文

  • 接続方法 クラウドで動く
  • アカウントまたはキー Authorization が必要
  • カテゴリ デザイン・画像・音声

一緒に使える

この種の作業を AI に教える Skill。これと一緒に使えます

impeccable

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

作者:pbakaus★ 113,0421 個の skill

Skill · 手順書

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.

作者:cathrynlavery★ 68,2961 個の skill

Skill · 手順書

frontend-slides

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

作者:zarazhangrui★ 32,5791 個の skill

Skill · 手順書

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気0/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中8/8前回の確認でクラウドのエンドポイントが応答
利用スコア20/100

品質: 基本チェック 2/5 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

Roilo: UGC Video Ads From a Few Product or Venue Photos をインストールして。https://mcp.popnx.com/i/roilo-co-ai-product-video-api.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 2/5 合格 · 質問内容は提供元のサーバー(roilo.co)を通ります · ✓ コマンド確認済み 2026年11月20日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげます · 約 5 分

Roilo: UGC Video Ads From a Few Product or Venue Photos のキーが必要です(提供元のサイトで作成) · claude.ai かデスクトップアプリで一度設定すれば、チャットで使えます · 無料アカウントは 1 つまで · Team/Enterprise はオーナー(Owner)が追加

  1. Roilo: UGC Video Ads From a Few Product or Venue Photos に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    Roilo: UGC Video Ads From a Few Product or Venue Photos のサイトを開く ↗

  2. Claude の Connectors ページを開く

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  3. 「Add」→「Custom」→「Web」を押し、この 2 つを入力

    ここからコピーして Claude の同じ名前の欄に貼り付け、Continue を押します

    Name · 名前Roilo: UGC Video Ads From a Few Product or Venue Photos
    Remote MCP server URL · アドレスhttps://roilo.co/api/mcp

    Request headers に、この名前と値を追加

    ヘッダー名Authorization
    値Bearer <ここにキーを貼り付け>

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

    Claude が検出したサインイン設定の画面で Continue を押す · Authentication は作者の説明どおり(Sign in now・Sign in when needed・No sign in)を選び Add を押します

  4. チャットで有効にする

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

  5. 試してみる

    Roilo: UGC Video Ads From a Few Product or Venue Photos を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が Roilo: UGC Video Ads From a Few Product or Venue Photos を使っていると言うか、回答に Roilo: UGC Video Ads From a Few Product or Venue Photos のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ Roilo: UGC Video Ads From a Few Product or Venue Photos につなげません

Roilo: UGC Video Ads From a Few Product or Venue Photos は接続時に自分のキーが必要ですが、OpenAI のヘルプページは OAuth ログインしか説明しておらず、確認できたキー入力方法がありません

代わりにできること

A · Roilo: UGC Video Ads From a Few Product or Venue Photos につなげるアプリを使う

  • Roilo: UGC Video Ads From a Few Product or Venue Photos のキーが必要です(提供元のサイトで作成) · claude.ai かデスクトップアプリで一度設定すれば、チャットで使えます · 無料アカウントは 1 つまで · Team/Enterprise はオーナー(Owner)が追加
  • Roilo: UGC Video Ads From a Few Product or Venue Photos のキーが必要です(提供元のサイトで作成)
  • Roilo: UGC Video Ads From a Few Product or Venue Photos のキーが必要です(提供元のサイトで作成)
  • Roilo: UGC Video Ads From a Few Product or Venue Photos のキーが必要です(提供元のサイトで作成)

B · デザイン・画像・音声 の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげます · 約 5 分

Roilo: UGC Video Ads From a Few Product or Venue Photos のキーが必要です(提供元のサイトで作成)

  1. Roilo: UGC Video Ads From a Few Product or Venue Photos に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    Roilo: UGC Video Ads From a Few Product or Venue Photos のサイトを開く ↗

  2. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  3. このコマンドを貼り付けて Enter

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

    Enter の前に「your-value」を自分のキーに書き換えてください

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  4. Claude Code で /mcp と入力

    Roilo: UGC Video Ads From a Few Product or Venue Photos が一覧にあり、接続済みと表示されれば OK です

  5. 試してみる

    Roilo: UGC Video Ads From a Few Product or Venue Photos を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が Roilo: UGC Video Ads From a Few Product or Venue Photos を使っていると言うか、回答に Roilo: UGC Video Ads From a Few Product or Venue Photos のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげます · 約 5 分

Roilo: UGC Video Ads From a Few Product or Venue Photos のキーが必要です(提供元のサイトで作成)

  1. Roilo: UGC Video Ads From a Few Product or Venue Photos に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    Roilo: UGC Video Ads From a Few Product or Venue Photos のサイトを開く ↗

  2. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  3. キーを入力

    Roilo: UGC Video Ads From a Few Product or Venue Photos の設定で Authorization が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  4. Cursor の AI チャットを Agent モードで開く

  5. 試してみる

    Roilo: UGC Video Ads From a Few Product or Venue Photos を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が Roilo: UGC Video Ads From a Few Product or Venue Photos を使っていると言うか、回答に Roilo: UGC Video Ads From a Few Product or Venue Photos のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげます · 約 5 分

Roilo: UGC Video Ads From a Few Product or Venue Photos のキーが必要です(提供元のサイトで作成)

  1. Roilo: UGC Video Ads From a Few Product or Venue Photos に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    Roilo: UGC Video Ads From a Few Product or Venue Photos のサイトを開く ↗

  2. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  3. キーを入力

    Roilo: UGC Video Ads From a Few Product or Venue Photos の設定で Authorization が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  4. VS Code の AI チャットを Agent モードで開く

  5. 試してみる

    Roilo: UGC Video Ads From a Few Product or Venue Photos を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が Roilo: UGC Video Ads From a Few Product or Venue Photos を使っていると言うか、回答に Roilo: UGC Video Ads From a Few Product or Venue Photos のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

Web 経由でつなぐアプリ用のアドレス

アドレスhttps://roilo.co/api/mcp

JSON 設定は下の「開発者向け」にあります

つまずいたら?Roilo: UGC Video Ads From a Few Product or Venue Photos を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

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}"
      }
    }
  }
}

自分で入力する値

  • Authorization 秘密 必須 HTTP header
    Roilo API キーを bearer トークンとして指定します。roilo.co/developers でキーを作成してください。
    英語の原文を見るYour Roilo API key as a bearer token. Create a key at roilo.co/developers.

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
npm/PyPIにない
ライセンスi
ライセンスの記載なし
接続方法
クラウドで動く
トランスポート
streamable-http
最新バージョンi
1.0.0
レジストリ公開日i
2026年11月12日
コードの最終更新i
2026年11月13日
最終確認
2026年11月18日
作者
Roilo-co
ウェブサイト
roilo.co
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

インターネット経由でつなげるアプリ

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

すべてのアプリと長所・短所 →

できること

このサーバーは、ツール一覧を表示する前にサインインを求めます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月20日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント roilo-co で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:7 日前

  • ✕ 不合格

    ライセンスがある

    リポジトリにライセンスファイルが見つかりません

  • ! 注意

    エンドポイントが応答する

    アクセスを拒否(HTTP 401)し、OAuth ログインもありません。キーが必要か、ボット対策の可能性があり、未確認です。

  • ! 注意

    OAuthでサインイン

    キーやトークンを自分でコピーして貼り付ける必要があります

  • … 未チェック

    ツールの説明に隠れた指示がない

    まだチェックしていません。エンドポイントをチェックするときにツール一覧を読み取ります

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

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

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

デザイン・画像・音声のほかのサーバーとの比較i

  • このカテゴリのほかの3322件のうち0%よりスターが多い
  • このカテゴリのほかの3322件のうち81%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの3322件のうち8%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Roilo: UGC Video Ads From a Few Product or Venue Photosは安全ですか?

当てはまる基本チェック5項目のうち2項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

入力が必要なもの:Authorization

パソコンで動きますか、それともクラウドですか?

作者のクラウドで動きます。インストール不要でインターネット経由でつながりますが、送った内容は作者のサーバーを通ります。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は7 日前、最新バージョン(1.0.0)がレジストリに届いたのは8 日前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URL で接続するので、リモート MCP を受け付けるアプリでも使えます。例:Web 版 ChatGPT(Business 以上はフル MCP、Pro は読み取りのみ)。

代わりに使えるものは?

同じカテゴリには:HyperFrames by HeyGen, Pascal 3D Editor, draw.io, Figma MCP Server, Remocn: Remotion MCP server

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

HyperFrames by HeyGen

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

作者:heygen-com広く使われている★ 8.7万 リポジトリ全体のスター一昨日更新

クラウドで動く✓ heygen.com

Pascal 3D Editor

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

作者:pascalorg広く使われている↓ 1037/週★ 2.6万 リポジトリ全体のスター一昨日更新

パソコンでもクラウドでも✓ 提供元 · pascal.app

draw.io

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

作者:jgraph広く使われている★ 58603 日前更新

クラウドで動く✓ 提供元 · draw.ioPopNx チームが実際に試用

Figma MCP Server

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

作者:figma広く使われている★ 221313 か月前更新

クラウドで動く✓ 提供元 · mcp.figma.com
似たものと比べる
これ
Roilo: UGC Video Ads From a Few Product or Venue Photos
HyperFrames by HeyGenPascal 3D Editordraw.ioFigma MCP ServerRemocn: Remotion MCP server
動く場所クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドでもパソコンにインストールでも使えるクラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要はいいいえいいえいいえいいえいいえ
Claude で + から追加いいえはいいいえいいえはいいいえ
基本チェック2/54/45/54/44/44/4
ライセンス–Apache-2.0MITApache-2.0–MIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

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

冒頭だけを表示しています。続きはリポジトリで読めます