> SeedViral for agents: https://seedviral.com/llms.txt lists every public page as Markdown, https://seedviral.com/llms-full.txt has them in one file, and https://seedviral.com/openapi.json describes the API. 1. [Home](https://seedviral.com/) 2. For agents 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 credits Approved Done. Want another one in the same style? ![First frame of a mythology story video made by SeedViral](https://seedviral.com/landing-showcase/v1/mythology.webp) 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 key](https://seedviral.com/developers) [API docs](https://seedviral.com/agent/1.0.0/README.md) [OpenAPI](https://seedviral.com/openapi.json) [llms.txt](https://seedviral.com/llms.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](https://seedviral.com/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](https://seedviral.com/openapi.json) and the [API reference](https://seedviral.com/agent/1.0.0/README.md). ``` 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":""}}' ``` ### MCP connector A local connector for any MCP client that runs commands (stdio, Node 20 or newer). Download [the connector](https://seedviral.com/agent/1.0.0/seedviral-agent-1.0.0.mjs) and check it against [SHA256SUMS](https://seedviral.com/agent/1.0.0/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](https://seedviral.com/agent/1.0.0/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. | Plan | Price | Series videos | Credits | | --- | --- | --- | --- | | Hobby | $29/month | 3 videos a week | 100 credits a month | | Daily | $59/month | 1 video a day | 250 credits a month | | Pro | $97/month | 2 videos a day | 500 credits a month | - One video, 30 to 40 seconds **10 credits** - One video, 60 to 70 seconds **15 credits** Credits renew every month and don't roll over. See [pricing](https://seedviral.com/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":""}' ``` For agents ## Files for agents - [llms.txt](https://seedviral.com/llms.txt) Index of every public page as Markdown, with the agent guide first. - [llms-full.txt](https://seedviral.com/llms-full.txt) The agent guide, the API reference and every page in one file. - [openapi.json](https://seedviral.com/openapi.json) OpenAPI 3.1 description of the API. - [API reference](https://seedviral.com/agent/1.0.0/README.md) Endpoints, errors, limits and idempotency. - [This page as Markdown](https://seedviral.com/agents.md) Add .md to any public page, or send Accept: text/markdown. 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. --- Source: https://seedviral.com/agents