ViibeoAgents · OpenClaw · MCP · REST · Webhooks

Faceless shorts for Cursor, Claude, Zapier, and any agent.

One API key unlocks OpenClaw skills, MCP tools, a versioned REST API, and signed webhooks. Create the script, voice, visuals, and captions — then export or publish without babysitting the dashboard. Step-by-step: generate faceless TikToks from Cursor with MCP.

Get an API keyOpenAPIOpen SKILL.md
Same pipeline

The interface changes.Script, voice, captions, export stay the same.

  1. Cursor

    Ask Agent to create a faceless short, then post it to TikTok, IG, or YouTube.

    ChatComposer

      create_short → publish_video

    • Claude

      Get the finished short, then choose where to post — TikTok, IG, or YouTube.

      ClaudeSonnet

        generation.completed → publish

      • MCP

        Export the MP4, then publish the same cut to TikTok, IG, or YouTube.

        MessagesJSON-RPC

          export.ready → publish_video

        • REST

          Post to connected socials, or schedule a series on Starter+.

          RESTHTTPS

          POST /api/v1/publish

          {
  "platforms": ["tiktok", "instagram", "youtube"]
}
          TikTokIGYouTube

          201 queued · 3 platforms

          publish_video · Autopilot

        MCP

        Connect in one config

        Create a vii_ key under Settings → Developers, then add this to Cursor or Claude Desktop.

        {
  "mcpServers": {
    "viibeo": {
      "url": "https://www.viibeo.com/api/mcp",
      "headers": {
        "Authorization": "Bearer vii_YOUR_API_KEY"
      }
    }
  }
}

        MCP tools

        • create_shortCreate and start a faceless/standard AI short. Returns jobId + videoId — poll get_generation_status until COMPLETED.
        • create_storyCreate and start an AI story video. Returns jobId + videoId — poll get_generation_status.
        • get_generation_statusPoll a generation job created by create_short / create_story.
        • list_my_videosList the authenticated user's videos (paginated).
        • get_videoGet video details, scene summary, and beat sheet for agent QA.
        • get_my_creditsGet credit balance and subscription tier.
        • start_exportStart a Remotion Lambda export for a completed video. Poll get_render_status.
        • get_render_statusPoll a Lambda render/export job.
        • list_autopilot_seriesList Autopilot series (scheduled content projects).
        • suggest_ideasSuggest faceless short ideas for a niche (hook + angle). Use before create_short.
        • publish_videoPublish a finished video to connected social platforms (TikTok / Instagram / YouTube).
        • create_autopilot_seriesCreate an Autopilot series that generates + schedules faceless shorts.
        OpenClaw

        How to use Viibeo in OpenClaw

        OpenClaw agents read a SKILL.md that teaches create → poll/webhook → export → publish over the Agent REST API. Same vii_ key as MCP.

        1. Get an API key

          Dashboard → Settings → Developers. Copy a key that starts with vii_. You need credits on the account (Free exports may be watermarked).

          Open API keys

        2. Install the skill

          From ClawHub once published, or load the public skill file. Skill name: viibeo.

          # After the skill is on ClawHub:
openclaw skills install @OWNER/viibeo

# Or load the published SKILL.md locally / from URL:
# https://www.viibeo.com/skills/viibeo/SKILL.md

          Full skill: /skills/viibeo/SKILL.md · endpoint reference: rest-api.md.

        3. Set the env var

          OpenClaw looks for VIIBEO_API_KEY. Always call https://www.viibeo.com (apex redirects can drop Authorization).

          export VIIBEO_API_KEY="vii_YOUR_API_KEY"
# Optional override (default is fine):
# export VIIBEO_BASE_URL="https://www.viibeo.com"

        4. Ask your agent

          Give a concrete niche prompt. The skill will check credits, create the short, wait for completion, then export (and optionally publish if socials are connected).

          Make a 15s faceless scary-facts short about ships that vanished,
then export the MP4 when generation completes.
          • Prefer webhooks (generation.completed, export.ready) over tight polling.
          • First tests: 15s or 30s, AI Images.
          • Never paste the full API key into chat logs.
        REST

        Versioned HTTP for scripts and Zapier

        Same capabilities as MCP. Base URL: https://www.viibeo.com/api/v1. Auth: Authorization: Bearer vii_…. Schema: /api/v1/openapi.json.

        • GET/creditsBalance + plan
        • GET/videosList videos
        • POST/videosCreate short / story
        • GET/videos/{id}Video details
        • GET/jobs/{id}Generation status
        • POST/exportsStart MP4 export
        • GET/exports/{id}Render status
        • POST/publishPost to socials
        • GET/autopilot/seriesList series
        • POST/autopilot/seriesCreate series
        • POST/ideasSuggest niches
        • GET/POST/webhooksManage endpoints

        Check credits

        curl "https://www.viibeo.com/api/v1/credits" \
  -H "Authorization: Bearer vii_YOUR_API_KEY"

        Create a short

        curl "https://www.viibeo.com/api/v1/videos" \
  -H "Authorization: Bearer vii_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "True crime: three facts about the 1890s poison ring",
    "duration": "30s",
    "type": "Faceless"
  }'
        Webhooks

        Signed pushes when jobs finish

        Skip polling. Add an HTTPS endpoint under Settings → Developers (or POST /api/v1/webhooks). Verify X-Viibeo-Signature as HMAC-SHA256(secret, t + "." + rawBody); header format t=…,v1=….

        • generation.completedGeneration completed
        • generation.failedGeneration failed
        • export.readyExport ready
        • export.failedExport failed
        • publish.completedPublish completed

        Example payload

        {
  "id": "evt_…",
  "type": "export.ready",
  "createdAt": "2026-09-03T12:00:00.000Z",
  "data": {
    "renderJobId": "…",
    "videoId": "…",
    "outputUrl": "https://…/out.mp4",
    "status": "COMPLETED"
  }
}
        Recommended loop

        Create → ready → export → publish

        1. Create

          create_short or POST /videos with a niche prompt

        2. Wait for ready

          Prefer generation.completed — or poll job status

        3. Export

          Start export → wait for export.ready

        4. Publish

          publish_video / POST /publish, or Autopilot for daily cadence

        Machine-readable facts: /llms.txt, /llms-full.txt. OpenAPI: /api/v1/openapi.json. Skill: /skills/viibeo/SKILL.md.

        FAQ

        Agent API FAQ

        OpenClaw, MCP, REST, webhooks, keys, and what agents can create.

        Your first video is minutes away.

        First video free and watermarked. Start from a prompt, URL, or Inspiration. Clean exports on Lite from $19/mo. Autopilot on Starter+.

        Start with a free video

        No card to start · Lite from $19/mo · Cancel anytime