Agnes API Key on Hermes Agent: Free Multimodal AI in Minutes

What Is Agnes?

Agnes is a multimodal AI gateway built by Sapiens AI. It exposes an OpenAI-compatible REST API, so any tool or framework that already speaks the OpenAI chat completions format — including Hermes Agent — can use Agnes without any code changes. Agnes is fully free during its current public availability period: no credit card, no usage caps, no catch.

The flagship model, agnes-2.0-flash, supports text and image inputs with a generous 256K token context window and full tool-calling support. Agnes also serves a dedicated image generation model and a video generation model, making it one of the few providers where a single free key covers all three modalities.

What Your Agnes Key Unlocks on Hermes Agent

Once you add your Agnes key on the API Keys page, the following models become available across your Hermes Agent instances:

• Agnes 2.0 Flash (agnes-2.0-flash) — Fast multimodal chat model, text + image input, 256K context window, tool calling supported. Free.
• Agnes Image 2.0 Flash (agnes-image-2.0-flash) — Text-to-image generation. Free.
• Agnes Video 2.0 (agnes-video-v2.0) — Text-to-video generation, 5-second clips at $0. Free.

Chat and image-input are handled through the standard completions endpoint. Image and video generation are available in your Hermes Agent instance’s media settings once the key is saved.

How to Get an Agnes API Key

1. Visit the Agnes platform — Go to platform.agnes-ai.com and click Sign Up.
2. Create a free account — Register with your email address. No payment information is required.
3. Navigate to API Keys — After logging in, open the API Keys section of your Agnes dashboard.
4. Generate a new key — Click Create Key (or equivalent). Your key will be shown once — copy it immediately.
5. Confirm the prefix — Agnes keys start with sk-. If the value you copied does not start with sk-, you may have copied the wrong field.

Add Your Agnes Key on OpenClaw Launch

1. Sign in at openclawlaunch.com and open the API Keys page.
2. Find the Agnes card. Paste your sk- key into the input field and click Save. We validate the key against the Agnes API live before storing it.
3. For the chat model, click “Set as primary model” to route your Hermes Agent instances to agnes-2.0-flash immediately.
4. For image and video generation, open your Hermes Agent instance settings and select agnes-image-2.0-flash or agnes-video-v2.0 in the image / video model selector.

Your Agnes key is encrypted at rest and applied to your existing running Hermes Agent instances — no redeploy needed.

Using OpenClaw instances instead? See the Agnes setup guide for OpenClaw instances.

Troubleshooting

401 Unauthorized / Invalid Key

• Confirm your key starts with sk-. Agnes keys are case-sensitive; no extra spaces or newlines should be present.
• Try regenerating the key from the Agnes dashboard and saving the fresh value on the API Keys page.
• If you signed up very recently, wait a minute and try again — account provisioning can take a moment.

Model Not Found

• Use the exact model IDs: agnes-2.0-flash, agnes-image-2.0-flash, agnes-video-v2.0. Typos or guessed variants will return a 404.
• Make sure you saved a valid Agnes key first — the models are only available once the key is confirmed on the API Keys page.

Quota or Rate Limit Errors

• Agnes is currently free with no published hard quota. If you receive a 429, wait a few seconds and retry — short bursts may trigger per-minute rate limits.
• For sustained high-volume usage, check the Agnes platform for any plan options or announcements.

Frequently Asked Questions

Is Agnes really free for Hermes Agent?

Yes. Agnes (Sapiens AI) is free during its current public availability period. Chat, image generation, and video generation all carry a $0 cost per request when routed through your Agnes key — whether your instance is Hermes Agent or OpenClaw.

What does an Agnes API key look like?

Agnes keys start with sk-, the same prefix used by OpenAI keys. The two are not interchangeable — an Agnes key only works with the Agnes API base URL, which OpenClaw Launch configures automatically when you save your key.

Does Agnes work with the standard OpenAI SDK?

Yes. Agnes exposes an OpenAI-compatible completions endpoint. Hermes Agent routes requests through the standard OpenAI-compatible path, so no additional configuration is needed beyond saving your key on the API Keys page.

Can I use Agnes alongside other providers on the same Hermes Agent instance?

Yes. Each provider key is stored independently. You can save an Agnes key alongside OpenRouter, Groq, or any other provider key. Switch between them using the “Set as primary model” control or the instance model selector.

What's Next?

• Agnes on OpenClaw — Same free key, set up for OpenClaw instances instead
• Hermes Agent BYOK overview — All supported providers and how bring-your-own-key works on Hermes Agent
• AI coding plans compared — See how Agnes stacks up for coding tasks alongside other free and paid models
• API Keys page — Add or manage all your provider keys in one place