Replicate API Key with Hermes Agent

What Is Replicate?

Replicate is a cloud platform that lets you run thousands of open-source machine learning models through a single REST API. You do not need to manage GPU servers or ML infrastructure — Replicate handles provisioning, cold starts, and billing automatically on a pay-as-you-go basis.

For Hermes Agent instances on OpenClaw Launch, Replicate serves as the back-end for a curated selection of video and music generation models. A single r8_... key activates them across all your running Hermes instances.

What Your Replicate Key Unlocks

Once your Replicate key is saved on the API Keys page, your Hermes Agent instances gain access to video and music generation models hosted on Replicate. Select the model you want inside your Hermes instance’s video or music settings.

• Video generation models — text-to-video and image-to-video models hosted on Replicate, billed per generation at Replicate’s standard rates.
• Music generation models — AI music composition and audio generation, from short clips to full tracks.
• Pay-as-you-go pricing — charges appear on your Replicate account; there is no markup from OpenClaw Launch.

How to Get a Replicate API Key

1. Go to replicate.com — Open replicate.com/account/api-tokens in your browser.
2. Sign in or create an account — Use GitHub OAuth or email to register. New accounts receive free credits for initial testing.
3. Open the API tokens page — Click API tokens in your account settings, or use the direct link above.
4. Create a new token — Click Create token, give it a descriptive name (for example, “Hermes Agent — OpenClaw Launch”), and confirm.
5. Copy your token — Your token starts with r8_. Copy it immediately — Replicate only shows it once.
6. Add billing if needed — Free credits cover initial tests; add a payment method under Billing for sustained use.

Add It on OpenClaw Launch

1. Sign in at openclawlaunch.com and open the API Keys page.
2. Find the Replicate card, paste your r8_... key, and click Save. OpenClaw Launch validates the key against Replicate live before storing it.
3. In your running Hermes Agent instance’s settings, open the video or music model picker and select the Replicate-hosted model you want to use. 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 token starts with r8_. If it does not, you may have copied the wrong value from the Replicate dashboard.
• Check for trailing spaces or newline characters. Replicate tokens are case-sensitive.
• If you rotated the token in Replicate, update it on the API Keys page to overwrite the old entry.

Model Not Found or Generation Fails

• Some Replicate models require you to accept usage terms on the Replicate website before your token can call them. Visit the model’s page at replicate.com and accept any agreements shown.
• Check your Replicate account’s billing status — a lapsed payment method causes generation requests to fail even when the token itself is valid.

Quota or Rate Limit Errors

• Replicate enforces per-account concurrency and rate limits. If you receive 429 or “queue full” errors, wait a moment and retry. Heavy video models may queue for up to 30 seconds during peak hours.
• Check your usage on the Replicate dashboard to see if you are approaching any account-level limits.

Frequently Asked Questions

What models does the Replicate key unlock for Hermes Agent?

Your Replicate key unlocks video and music generation models hosted on the Replicate platform. The catalog is curated by OpenClaw Launch and visible inside your Hermes Agent instance’s model picker once the key is saved. Replicate itself hosts thousands of open-source models, but only those wired into OpenClaw’s Hermes integration are selectable here.

What does a Replicate API token look like?

A Replicate API token starts with the prefix r8_, followed by a long alphanumeric string. You create and manage tokens at replicate.com/account/api-tokens. Tokens are only shown once at creation time, so copy yours to a safe place.

Is Replicate pay-as-you-go?

Yes. Replicate charges per prediction (per generation). Costs vary by model and hardware tier — video models typically cost more than image models due to higher GPU time. New accounts receive free credits. OpenClaw Launch adds no markup; charges appear directly on your Replicate account.

Does adding the key affect my existing Hermes Agent instances?

Yes. Once you save your Replicate 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 model picker in your instance settings and select a Replicate-hosted model.

What's Next?

• Replicate with OpenClaw — The same Replicate key setup guide for OpenClaw instances
• Hermes Agent BYOK overview — All supported providers and how bring-your-own-key works for Hermes Agent
• What is Hermes Agent? — A primer on the Hermes Agent framework
• API Keys page — Manage all your provider keys in one place