impeccable
impeccable เป็นชุดคำสั่งด้านการออกแบบสำหรับ coding agent ใช้กำกับงานให้ดูประณีตหรือโดดเด่นขึ้น ตรวจทานและวิจารณ์งานออกแบบ และช่วยจับงานที่ดูเป็น AI ชั้นต่ำก่อนนำไปใช้จริง
เข้าสู่ระบบเพื่อกดถูกใจ0 คนถูกใจ
ยังไม่มีคำอธิบายภาษาไทย ดูข้อเท็จจริงด้านล่าง หรือเปิดคำอธิบายต้นฉบับจากผู้ทำ
Turn a few product or venue photos into a usable UGC video ad: script, actor, voiceover, captions.Skill ที่สอน AI ทำงานแบบนี้ ใช้ร่วมกับตัวนี้ได้
impeccable เป็นชุดคำสั่งด้านการออกแบบสำหรับ coding agent ใช้กำกับงานให้ดูประณีตหรือโดดเด่นขึ้น ตรวจทานและวิจารณ์งานออกแบบ และช่วยจับงานที่ดูเป็น AI ชั้นต่ำก่อนนำไปใช้จริง
เครื่องมือสำหรับออกแบบไดอะแกรมแบบ editorial ใช้กับ Claude Code, Codex, GitHub Copilot, Cursor, Factory Droid, Qoder และ Pi มี 45 ประเภทไดอะแกรม สร้างผลลัพธ์เป็น HTML กับ SVG ที่ใช้งานได้ในไฟล์เดียว
เครื่องมือเสริมชื่อ frontend-slides ใช้สร้างสไลด์สวยงามบนเว็บ โดยอาศัยทักษะด้าน frontend ของ coding agent
หน้ารายการเรียงด้วยคะแนนการใช้งาน (เต็ม 100) จากส่วนเหล่านี้
| ความนิยม | 0/80 | ดาว GitHub หรือยอดดาวน์โหลดต่อสัปดาห์ ค่ามากนับ 60 ค่าน้อยนับ 20 |
|---|---|---|
| ความสด | 12/12 | ออกรุ่นหรือแก้โค้ดใน 30 วัน ได้เต็ม |
| ระบบยังตอบ | 8/8 | endpoint บนคลาวด์ตอบตอนตรวจล่าสุด |
| คะแนนการใช้งาน | 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 แสดงคำสั่งให้ฉันดูและรอฉันตกลงก่อนรันคัดลอกไปวางในแชตของ AI ที่ทำงานในเครื่องคุณได้ (เช่น Claude Code, Cursor) · AI จะอ่านขั้นตอนจากเรา แสดงคำสั่งให้ดู และรอคุณตกลงก่อน · ไม่ต้องใช้คีย์ ไม่ต้องสมัคร · ดูข้อความเต็มที่ AI จะอ่าน
ผลตรวจผ่าน 2/5 · สิ่งที่คุณถามผ่านเซิร์ฟเวอร์ของผู้ทำ (roilo.co) · ✓ ตรวจคำสั่งแล้ว 20 พ.ย. 2569
ขั้นแรก: คุณใช้ AI ตัวไหน
เลือกแอปที่คุณใช้ ขั้นตอนจะขึ้นด้านล่าง
ต่อกับ Claude ได้ · ประมาณ 5 นาที
ต้องมีคีย์ของ Roilo: UGC Video Ads From a Few Product or Venue Photos (สร้างที่เว็บของผู้ทำ) · ตั้งครั้งเดียวที่ claude.ai หรือแอปบนคอม แล้วใช้ในแชตได้ · บัญชีฟรีเพิ่มได้ 1 ตัว · แผน Team/Enterprise ให้เจ้าของ (Owner) เป็นคนเพิ่ม
เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป ราคาและแผนฟรีดูที่เว็บของผู้ทำ
เปิดเว็บของ Roilo: UGC Video Ads From a Few Product or Venue Photos ↗
CustomizeConnectors
คัดลอกจากที่นี่ไปวางในช่องชื่อเดียวกันบนหน้าจอของ Claude แล้วกด Continue
Roilo: UGC Video Ads From a Few Product or Venue Photoshttps://roilo.co/api/mcpที่หัวข้อ Request headers เพิ่มชื่อและค่านี้
AuthorizationBearer <วางคีย์ของคุณตรงนี้>วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร
กด Continue ผ่านหน้าตรวจการล็อกอินที่ Claude ตรวจเจอ · หัวข้อ Authentication เลือกตามที่ผู้ทำบอก (Sign in now, Sign in when needed หรือ No sign in) แล้วกด Add
+ConnectorsRoilo: UGC Video Ads From a Few Product or Venue Photos
ใช้ Roilo: UGC Video Ads From a Few Product or Venue Photos บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า Claude บอกว่ากำลังใช้ Roilo: UGC Video Ads From a Few Product or Venue Photos หรือมีชื่อเครื่องมือของ Roilo: UGC Video Ads From a Few Product or Venue Photos ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
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 ยังไม่มีวิธีใส่คีย์ที่เราตรวจได้
ก · ใช้แอปที่ต่อ Roilo: UGC Video Ads From a Few Product or Venue Photos ได้
ข · ตัวอื่นในหมวด ออกแบบ ภาพ และเสียง ที่ต่อกับ ChatGPT ได้
เลือกจากตัวที่ใช้มากในหมวดเดียวกัน เฉพาะตัวที่ต่อด้วยที่อยู่ได้โดยไม่ต้องใส่คีย์
ต่อกับ Claude Code ได้ · ประมาณ 5 นาที
ต้องมีคีย์ของ Roilo: UGC Video Ads From a Few Product or Venue Photos (สร้างที่เว็บของผู้ทำ)
เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป ราคาและแผนฟรีดูที่เว็บของผู้ทำ
เปิดเว็บของ Roilo: UGC Video Ads From a Few Product or Venue Photos ↗
Mac: กด Command+Space พิมพ์ Terminal · Windows: เปิด PowerShell
claude mcp add --transport http --scope user ai-product-video-api https://roilo.co/api/mcp --header 'Authorization: Bearer {api_key}'แก้ “ใส่ค่าของคุณ” เป็นคีย์ของคุณก่อนกด Enter
วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร
ต้องเห็น Roilo: UGC Video Ads From a Few Product or Venue Photos ในรายการและขึ้นว่าเชื่อมต่อแล้ว
ใช้ Roilo: UGC Video Ads From a Few Product or Venue Photos บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า Claude Code บอกว่ากำลังใช้ Roilo: UGC Video Ads From a Few Product or Venue Photos หรือมีชื่อเครื่องมือของ Roilo: UGC Video Ads From a Few Product or Venue Photos ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ต่อกับ Cursor ได้ · ประมาณ 5 นาที
ต้องมีคีย์ของ Roilo: UGC Video Ads From a Few Product or Venue Photos (สร้างที่เว็บของผู้ทำ)
เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป ราคาและแผนฟรีดูที่เว็บของผู้ทำ
เปิดเว็บของ Roilo: UGC Video Ads From a Few Product or Venue Photos ↗
ในค่าตั้งของ Roilo: UGC Video Ads From a Few Product or Venue Photos ช่อง Authorization ยังว่าง ใส่คีย์ของคุณแล้วบันทึก
วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร
ใช้ Roilo: UGC Video Ads From a Few Product or Venue Photos บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า Cursor บอกว่ากำลังใช้ Roilo: UGC Video Ads From a Few Product or Venue Photos หรือมีชื่อเครื่องมือของ Roilo: UGC Video Ads From a Few Product or Venue Photos ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Cursor เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ต่อกับ VS Code ได้ · ประมาณ 5 นาที
ต้องมีคีย์ของ Roilo: UGC Video Ads From a Few Product or Venue Photos (สร้างที่เว็บของผู้ทำ)
เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป ราคาและแผนฟรีดูที่เว็บของผู้ทำ
เปิดเว็บของ Roilo: UGC Video Ads From a Few Product or Venue Photos ↗
ในค่าตั้งของ Roilo: UGC Video Ads From a Few Product or Venue Photos ช่อง Authorization ยังว่าง ใส่คีย์ของคุณแล้วบันทึก
วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร
ใช้ Roilo: UGC Video Ads From a Few Product or Venue Photos บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า VS Code บอกว่ากำลังใช้ Roilo: UGC Video Ads From a Few Product or Venue Photos หรือมีชื่อเครื่องมือของ Roilo: UGC Video Ads From a Few Product or Venue Photos ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ VS Code เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
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}"
}
}
}
}คำอธิบายแปลอัตโนมัติ ชื่อตัวแปรคงตามต้นฉบับ ถ้าไม่แน่ใจให้ดูต้นฉบับ
ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README
ดูจากแบบการต่อของ server ตัวนี้ และเอกสารของผู้ทำโปรแกรมแต่ละตัว ตรวจเมื่อ 10 พ.ย. 2569
ต่อผ่านคลาวด์ได้ใน
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast
server ให้ล็อกอินก่อนจึงจะแสดงรายการเครื่องมือ
เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 20 พ.ย. 2569
ชื่อใน registry ยืนยันด้วยบัญชี GitHub roilo-co ซึ่งเป็นเจ้าของ repo
มีการแก้โค้ดล่าสุด 7 วันที่ผ่านมา
ไม่พบไฟล์ license ใน repo
ตอบว่าไม่ให้เข้า (HTTP 401) และไม่มีวิธีล็อกอินแบบ OAuth อาจต้องใช้คีย์ หรือเป็นด่านกันบอท ยังยืนยันไม่ได้
ต้องใช้กุญแจหรือ token ที่คัดลอกมาวางเอง
ยังไม่ได้ตรวจ เราอ่านรายการเครื่องมือตอนตรวจ endpoint
ถ้าคุณเป็นผู้ทำตัวนี้ คัดลอกโค้ดนี้ไปวางใน README ได้เลย ป้ายลิงก์กลับมาที่หน้านี้
[](https://mcp.popnx.com/th/servers/roilo-co-ai-product-video-api)ถาม แชร์เคล็ดลับ หรือแจ้งว่าใช้ไม่ได้ เรียงตามที่คนกดว่ามีประโยชน์
ยังไม่มีใครโพสต์ ถามหรือแชร์เป็นคนแรกได้เลย
ข้อความในส่วนนี้เขียนโดยผู้ใช้ ไม่ใช่ทีม PopNx
ยังไม่มีรีวิว
เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo
จากการตรวจเบื้องต้นของเรา ผ่าน 2 จาก 5 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น
ต้องใส่ค่าเหล่านี้: Authorization
รันบนคลาวด์ของผู้ทำ ต่อผ่านอินเทอร์เน็ตได้เลย ไม่ต้องลงโปรแกรม แต่ข้อมูลที่ส่งให้จะผ่านเซิร์ฟเวอร์ของผู้ทำ
repo บน GitHub มีการแก้โค้ดล่าสุด 7 วันที่ผ่านมา และส่งรุ่นล่าสุด (1.0.0) เข้า registry 8 วันที่ผ่านมา
โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต่อผ่าน URL จึงใช้กับโปรแกรมที่รับ remote MCP ได้ เช่น ChatGPT บนเว็บ (แบบเต็มในแผน Business ขึ้นไป · Pro แบบอ่านอย่างเดียว)
ในหมวดเดียวกันมี HyperFrames by HeyGen, Pascal 3D Editor, draw.io, Figma MCP Server, Remocn: Remotion MCP server
หมวดเดียวกันจากผู้ทำคนอื่น ผ่านตัวตรวจคำสั่งแล้ว ตัวทางการขึ้นก่อน แล้วเรียงตามดาว
อ่านการ์ด:↓ ดาวน์โหลดต่อสัปดาห์i★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi
Official HyperFrames by HeyGen: the best AI video editor in chat. Captions, motion graphics, MP4.
สร้าง ตรวจ และบันทึกฉากอาคาร 3 มิติที่แก้ไขได้ ด้วย Pascal
Create draw.io diagrams in chat from Mermaid or XML, shown live and interactive. 10,000+ shapes.
server ทางการของ Figma ส่งข้อมูลงานออกแบบให้ AI อ่าน เพื่อเปลี่ยนแบบเป็นโค้ดหรืออธิบายแบบได้ตรงขึ้น ต่อผ่านคลาวด์ของ Figma
Hosted MCP for Remotion videos: search Remocn components, read docs, plan a video, preview it.
| ตัวนี้ Roilo: UGC Video Ads From a Few Product or Venue Photos | HyperFrames by HeyGen | Pascal 3D Editor | draw.io | Figma MCP Server | Remocn: Remotion MCP server | |
|---|---|---|---|---|---|---|
| ทำงานที่ไหน | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | มีทั้งบนคลาวด์และแบบลงเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง |
| ต้องใส่คีย์ | ใช่ | ไม่ | ไม่ | ไม่ | ไม่ | ไม่ |
| กด + ใน Claude ได้ | ไม่ | ใช่ | ไม่ | ไม่ | ใช่ | ไม่ |
| ผลตรวจเบื้องต้น | 2/5 | 4/4 | 5/5 | 4/4 | 4/4 | 4/4 |
| สัญญาอนุญาต | – | Apache-2.0 | MIT | Apache-2.0 | – | MIT |
| ราคา | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน |
ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ
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.
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.
The API makes the same videos as the website. You don't book a creator, rerun scenes one by one or fight with prompts.
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.
Base URL: https://roilo.co/api/v1. Requests and responses are JSON over HTTPS. Uploads are multipart. Timestamps are ISO 8601 in UTC.
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_..."
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.
# 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}'
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.
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"
Uploads can be JPEG, PNG or WebP. You can reuse a file ID across videos until it expires.
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:
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.target_audience, pain_point, dream_outcome, competitive_advantage, social_proof and result to the product object.voice_id, caption_style_id and quality are also available.The call returns 202 with the video object, in status queued.
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.
| Method | Path | What it does |
|---|---|---|
GET | /v1/me | Check the key; read credits and this key's spend |
GET | /v1/modes | Video modes, credit cost, photo limits, aspect ratios, qualities |
GET | /v1/actors | Your presenters and stock presenters |
GET | /v1/voices | Your voices and stock voices |
GET | /v1/caption-styles | Caption styles |
POST | /v1/files | Upload one image (201) |
POST | /v1/videos | Start a video (202) |
GET | /v1/videos | List videos, newest first (limit, cursor) |
GET | /v1/videos/:id | Read one video |
POST | /v1/videos/:id/approve | Release a video held for review |
DELETE | /v1/videos/:id | Delete a video (204) |
For every field, limit and example, see roilo.co/developers.
status | Meaning |
|---|---|
queued | Accepted. Inputs are being prepared. |
awaiting_review | Paused for you (review: true). Approve it, or it continues on its own when review_expires_at passes. |
processing | The video is being generated. |
completed | output is set. |
failed | error says why. Held credits are refunded. |
Write your code against status and error.code.
The fields you will use most:
| Field | What it holds |
|---|---|
id | The video ID, starting with vid_ |
output | null until the video is completed. Then it holds video_url, thumbnail_url, duration_sec, aspect_ratio, quality and url_expires_at |
error | code, message and, sometimes, param (the field at fault) |
brief | The drafted brief, while the video is awaiting review |
credits_held, credits_charged | Credits held for the video, and credits charged on delivery |
metadata | Your own object, returned unchanged |
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.
Set webhook_url on a video. Roilo then POSTs JSON to that URL for three events:
| Event | When it fires |
|---|---|
video.awaiting_review | The brief is ready for you to check |
video.completed | The video is ready |
video.failed | The video failed, and its credits were refunded |
The body holds the event id, type and created_at, plus the full video object under data.
2xx within 10 seconds. Redirects are not followed.Roilo-Event-Id header, or on the body id.Each webhook carries this header: Roilo-Signature: t= ,v1=
${t}.${rawBody}.whsec_, is shown once, and can be rotated on the API keys page.t more than 300 seconds from now.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