← Home

Setup Guide

BytePlus API Key with Hermes Agent

Add your BytePlus API key to your Hermes Agent instances on the API Keys page and unlock Seedance video generation models from ByteDance — no redeploy required, and the key is encrypted at rest.

What Is BytePlus?

BytePlus is ByteDance’s international cloud services platform, bringing ByteDance’s AI research — best known through TikTok’s recommendation engine and video understanding — to developers worldwide. The platform’s Seedance video generation models are among the most capable text-to-video systems available via a public API.

Access is pay-as-you-go through a bp-... key. Once saved on OpenClaw Launch, the key activates Seedance generation across all your running Hermes Agent instances with no restart.

What Your BytePlus Key Unlocks

Once your BytePlus key is saved on the API Keys page, the following model becomes available in your Hermes Agent instance’s video settings:

  • Seedance 1.5 Pro (byteplus/seedance-1-5-pro-251215) — ByteDance’s flagship text-to-video model, producing cinematic-quality short clips from natural language prompts. Charges apply per generation at BytePlus pay-as-you-go rates.

Select Seedance 1.5 Pro in your Hermes instance’s video model picker after saving the key. Charges appear on your BytePlus account.

How to Get a BytePlus API Key

  1. Go to the BytePlus docs portal — Open docs.byteplus.com and navigate to the API Keys or account section.
  2. Create or sign into your BytePlus account — Register with an email address. Business verification may be required depending on your region.
  3. Enable the Video Generation service — Locate the Seedance / Video Generation product in the BytePlus console and activate it for your account.
  4. Generate an API key — Navigate to Access Control or API Keys in the console, create a new key, and copy it. Your key will start with bp-.
  5. Note your key prefix — BytePlus keys start with bp-. Treat your key like a password and store it securely.
  6. Add billing credits — Top up your BytePlus account balance before making generation requests.

Add It on OpenClaw Launch

  1. Sign in at openclawlaunch.com and open the API Keys page.
  2. Find the BytePlus card, paste your bp-... key, and click Save. OpenClaw Launch validates the key against BytePlus live before storing it.
  3. In your running Hermes Agent instance’s settings, open the video model picker and select Seedance 1.5 Pro. The key applies immediately — no redeploy needed.

Your key is encrypted at rest and scoped to your account. It applies to all your existing running Hermes Agent instances the moment you save it.

Troubleshooting

401 Unauthorized / Invalid Key

  • Verify your key starts with bp-. If it does not, you may have copied the wrong credential from the BytePlus console.
  • Check for trailing spaces or newline characters. BytePlus keys are case-sensitive.
  • If you regenerated the key in the BytePlus console, update it on the API Keys page to overwrite the old entry.

Model Not Found or Generation Fails

  • Confirm you have activated the Video Generation (Seedance) product in your BytePlus console. A valid key alone is not enough — the service must also be enabled for your account.
  • Check your BytePlus account balance. Insufficient credits cause generation requests to fail even when the key itself is valid.

Quota or Rate Limit Errors

  • BytePlus enforces per-account rate limits on video generation. If you receive 429 errors or “quota exceeded” responses, wait before retrying. Video generation is GPU-intensive and queues can build during peak hours.
  • Contact BytePlus support to request a higher quota limit if you consistently hit rate limits in production.

Frequently Asked Questions

Which Seedance model does Hermes Agent support on OpenClaw Launch?

Hermes Agent instances support Seedance 1.5 Pro (model ID byteplus/seedance-1-5-pro-251215), ByteDance’s flagship text-to-video model. Additional Seedance versions may be added to the catalog as they become available via the BytePlus API.

What does a BytePlus API key look like?

A BytePlus API key starts with the prefix bp-, followed by an alphanumeric string. You create keys in the BytePlus console under Access Control or API Keys. Keep your key private — it grants API-level access to the services you have enabled on your BytePlus account.

Is BytePlus pay-as-you-go?

Yes. BytePlus charges per video generation request at published rates. There is no subscription fee for API access; you pay for what you generate. OpenClaw Launch adds no markup — charges appear directly on your BytePlus account balance.

Does adding the key affect my existing Hermes Agent instances?

Yes. Once you save your BytePlus key on the API Keys page, it is available to all your running Hermes Agent instances immediately. You do not need to redeploy or restart anything — just open the video model picker in your Hermes instance settings and select Seedance 1.5 Pro.

What's Next?

Start Generating Videos

Add your BytePlus key and unlock Seedance 1.5 Pro video generation on your Hermes Agent instances — no redeploy needed.

Open OpenClaw Launch