Be the first to get access to new connectors. Get early access →
ConnectorBay Early access

Hedra (BYOK) — connector documentation

  • MCP endpoint: https://byok-hedra.connectorbay.com/mcp
  • REST API: POST https://byok-hedra.connectorbay.com/v1/tools/{tool_name}, described by the OpenAPI 3.1 spec at https://byok-hedra.connectorbay.com/openapi.json
  • Transport: Streamable HTTP, stateless, MCP specification 2025-06-18 or later
  • Authentication: your own Hedra Hedra API key in the form key_id:secret, sent in the X-Upstream-Key header of every request (never stored, logged or cached)
  • Health: https://byok-hedra.connectorbay.com/health · Tool schemas: https://byok-hedra.connectorbay.com/tools.json
  • Publisher: Unify Dynamics LLC · connectorbay.com/byok-hedra · agent@connectorbay.com

What Hedra (BYOK) is for

Hedra (BYOK) lets an AI assistant read your own Hedra data through the Hedra API with a key you supply (Hedra API key in the form key_id:secret). Read-only: 10 tools (get_balance, get_usage, list_transactions, list_models, get_model, list_model_voices, search_model_voices, list_jobs, list_model_jobs, get_job_status). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is only ever sent to api.hedra.com. Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by Hedra. Hedra and its logos are trademarks of their owners and are used only to say which service the connector works with.

Ask your assistant things like:

  • "How much Hedra API balance do I have left?"
  • "How much did I spend on Hedra per model in the last week?"
  • "What were my latest Hedra wallet transactions?"
  • "Which Hedra video models are available and what do they cost?"
  • "What does the Hedra model veo-31 cost?"
  • "Which voices can the Hedra model elevenlabs-v3 use?"

What it does

  • get_balance: Show the API wallet balance, amount spent and currency.
  • get_usage: Summarize jobs, requests and spend over a time window, as one total, one row per UTC day or one row per model.
  • list_transactions: List wallet movements, newest first: funds added, jobs charged, refunds and corrections.
  • list_models: List the image, video and audio models available through Hedra with modality and price description.
  • get_model: Get one model's modality, description and price description.
  • list_model_voices: List the voices a model accepts: the shared library plus your own cloned voices.
  • search_model_voices: Search a model's voices by a plain-language description such as 'warm british narrator', optionally filtered by gender or language.
  • list_jobs: List recent generation jobs with model, status (IN_QUEUE, IN_PROGRESS, COMPLETED or FAILED) and creation time.
  • list_model_jobs: List recent generation jobs of one model with status and creation time.
  • get_job_status: Check the status of one generation job: status, progress and estimated completion time.

BYOK key

You bring your own Hedra Hedra API key in the form key_id:secret (https://www.hedra.com/develop/api-keys). Your assistant sends it in the X-Upstream-Key header with each request. ConnectorBay uses it for that one call only: it is never stored, logged or cached, never shown in an answer, and it is only sent to api.hedra.com over https, with no redirects followed. Create a key with the fewest permissions the tools need (read-only if the provider offers it), and revoke it at the provider whenever you like.

Data sources

Live from the Hedra API (api.hedra.com) with a BYOK key; documentation: https://www.hedra.com/docs/api-reference/v3/models/list-models. Endpoints checked against that documentation on 2026-10-16.

What it is not

Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by Hedra. Hedra and its logos are trademarks of their owners and are used only to say which service the connector works with. It is read-only: it never creates, changes, sends or deletes anything in your Hedra account.

Built for: Worldwide. Languages: English.