How do I install Seedance 2 in Hermes Agent?

Seedance 2 team · Updated

Hermes Agent can use Seedance 2 as a remote MCP server: add https://www.seedance2.net/mcp under mcp_servers in ~/.hermes/config.yaml with auth: oauth, run hermes mcp login seedance2 to sign in, and Hermes can make Seedance 2.5 and Seedance 2.0 videos and AI images on your Seedance 2 account. There is no API key to store.

Install from the config file

  1. Open ~/.hermes/config.yaml and add an entry under mcp_servers: seedance2 with url: "https://www.seedance2.net/mcp" and auth: oauth.
  2. Run hermes mcp login seedance2. Your browser opens the Seedance 2 sign-in; sign in, approve access and return to the terminal.
  3. Run hermes mcp list to check that seedance2 is enabled, then start a new session with hermes chat.

Or let Hermes add it

https://www.seedance2.net/plugin has a ready prompt for Hermes: paste it into a Hermes chat and it creates the connector named Seedance 2 with the URL https://www.seedance2.net/mcp, then asks you to finish signing in.

Check the connection

Ask: "Use Seedance 2 to check my credit balance, then list the video models and their prices." If Hermes answers with your balance and the model list (get_account and list_models), the connection works. Neither tool spends credits.

Prompts to try

  • Use Seedance 2 to make a 5-second Seedance 2.5 clip at 720p: steam rises from a ramen bowl on a night-market stall, slow push-in, with sound. Tell me the credit price first.
  • Every time I drop a product photo in ./inbox, make a 5-second Seedance 2.0 Fast clip at 9:16 with a slow orbit and save it to ./videos.
  • Make a 2K Nano Banana 2.1 cover image for this blog post, then animate it into a 6-second Seedance 2.5 loop.

What happens when you ask

  1. The assistant calls list_models and tells you the credit price of the settings it picked.
  2. It calls generate_video, which returns a task id right away.
  3. It polls get_task until the video is done, usually one to several minutes, and gives you the file.
  4. If a generation fails, its credits are refunded automatically.

What it costs

ModelLengthResolutionsCredits at defaultCredits range
Seedance 2 Mini4–15 s480p, 720p3 (4 s, 480p)3–27
Seedance 2.0 Fast4–15 s480p, 720p8 (5 s, 480p)6–49
Seedance 2.04–15 s480p, 720p, 1080p19 (5 s, 480p)15–304
Seedance 2.54–30 s480p, 720p, 1080p28 (5 s, 480p)22–885

Troubleshooting

  1. Login says the server is not configured: add the mcp_servers entry first, then run hermes mcp login seedance2 again.
  2. The tools do not appear: run hermes mcp list, check that seedance2 is enabled, and start a new session.
  3. Authorization expired: run hermes mcp login seedance2 again.

Questions

Do I need a Seedance or BytePlus API key?
No. Hermes signs in to your Seedance 2 account over OAuth, so no key is written to your shell history or config file.
Can Hermes use my local images?
Yes. Files at public https links work directly; for local files, Hermes calls upload_media, which returns an upload URL for each file, and then uses them as frames or references.
Does it work in OpenClaw too?
Yes. OpenClaw has its own setup steps on https://www.seedance2.net/plugin; any agent that supports remote MCP servers with OAuth sign-in can use https://www.seedance2.net/mcp.
How much does a video cost from Hermes?
The same as on the website: 28 credits for a 5-second 480p clip on Seedance 2.5 and 19 credits for a 5-second 480p clip on Seedance 2.0. Failed generations are refunded automatically.

Related