SeedViral

Works with your agent

Make videos from your own agent.

Connect SeedViral once. Then ask your agent for a video, a series draft or a batch of topics, and get the finished video back.

Make a 30 second video on why Orpheus looked back.

SeedViral · checked the price: 10 creditsApproved

Done. Want another one in the same style?

First frame of a mythology story video made by SeedViral

Why Orpheus looked back

30 s · 9:16 · captions on

Example. The picture is from our own renderer, not a customer video.

Your own agent

Any MCP client, or our API and CLI.

https://seedviral.com/api/v1
Get an API keyAPI docsOpenAPIllms.txt

Videos use your plan's credits, and you see the price before anything is made. Nothing is posted to your accounts unless you ask.

What it covers

What your agent can do

An API key belongs to one workspace. Read only keys can look around; Create and manage keys can also make videos, which spends credits.

Your agent can

  • Read the catalog: formats, niches, voices, art and caption styles, languages and lengths
  • Create and edit series drafts
  • Feed a series topics from an RSS feed, a YouTube channel, a CSV list or typed topics
  • Quote and make one-off videos from a prompt, a script, a link or a remix
  • Follow progress, download finished videos and saved versions
  • Ask for square and landscape copies of a finished video

Your agent cannot

  • Change billing or your plan
  • Connect or post to your social accounts
  • Manage your account or team
  • Use a real person's face or voice

Connect

Connect in three steps

  1. Create a key

    Sign in and open Developers. Create a key, choose Read only or Create and manage, and copy it. It is shown once.

  2. Pick how your agent connects

    All four use the same API and the same key. Give the key to your agent through its settings or the environment, never in a URL or a prompt you share.

  3. Check the price, then confirm

    Your agent asks for a quote, shows you the credits and accepts only when you say yes.

API

JSON over HTTPS at https://seedviral.com/api/v1. Described in OpenAPI 3.1 and the API reference.

curl https://seedviral.com/api/v1/videos/quotes \
  -H "Authorization: Bearer $SEEDVIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mode":"prompt","text":"Why Orpheus looked back","duration":"30–40",
       "style":{"from":"series","seriesId":"<your series id>"}}'

MCP connector

A local connector for any MCP client that runs commands (stdio, Node 20 or newer). Download the connector and check it against SHA256SUMS.

{
  "mcpServers": {
    "seedviral": {
      "command": "node",
      "args": ["/absolute/path/seedviral-agent-1.0.0.mjs", "mcp"],
      "env": { "SEEDVIRAL_API_KEY": "svk_..." }
    }
  }
}

Command line

The same file is a command line tool. Output is JSON.

export SEEDVIRAL_API_KEY=svk_...
node seedviral-agent-1.0.0.mjs whoami
node seedviral-agent-1.0.0.mjs help

Agent skill

SKILL.md teaches an agent the workflows: set up a series, feed it topics, make one video, collect the files. Add it to agents that support skills.

Credits

Credits on every paid plan

Videos your agent makes are paid for with your plan's monthly credits, the same as in the studio. Series videos use the series plan, not credits.

PlanPriceSeries videosCredits
Hobby$29/month3 videos a week100 credits a month
Daily$59/month1 video a day250 credits a month
Pro$97/month2 videos a day500 credits a month
  • One video, 30 to 40 seconds10 credits
  • One video, 60 to 70 seconds15 credits

Credits renew every month and don't roll over. See pricing for yearly plans and credit packs.

Spending

Check the price, then confirm

A quote is free and lasts 15 minutes. It returns the exact credits, your balance and the settings the video will use. Accepting it with an Idempotency-Key spends the credits once, even if your agent retries.

curl https://seedviral.com/api/v1/videos \
  -H "Authorization: Bearer $SEEDVIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: orpheus-video-1" \
  -d '{"quoteId":"<quote id>"}'

For agents

Files for agents

FAQ

Questions about agents

Do I need a paid plan?
Any account can create a key, read the catalog and set up series drafts. Making a video spends credits, and every paid plan includes monthly credits. Credit packs top up any time.
Can my agent spend credits without asking?
Only with a key that has the Create and manage permission. Each video starts with a free quote that shows the exact credits, and nothing is spent until the quote is accepted. The SeedViral skill tells your agent to show you the price and wait for a yes.
Will my agent post to my accounts?
No. API keys cannot connect or post to social accounts. You download the finished video, or post it from the studio.
What happens if I revoke a key?
It stops working on its next request. A video that was already accepted still finishes.
Where is the full reference?
The API reference, the OpenAPI file and the agent skill are linked on this page. Every public page is also available as Markdown for agents.