Developer API: overview

AgentHere exposes an OpenAI-compatible API and an MCP server. You can connect the platform to your own code, Cursor, Claude Desktop, opencode, or any client that speaks the OpenAI-compatible endpoints.

What's available

• Chat Completions — POST /v1/chat/completions (streaming and non-streaming), OpenAI-compatible.
• Anthropic Messages — POST /anthropic/v1/messages (Anthropic-compatible, for Claude clients).
• Model list — GET /v1/models.
• MCP server — POST /api/mcp with vision, OCR, audio, image/video generation, search, and page-reader tools.

Every request is metered against your token balance — just like web chat.

Creating an API key

1. Sign in and open API keys.
2. Create a key of type proxy — it opens /v1/* and /api/mcp.
3. Copy the key right away: it's shown once and stored as a hash.

The key starts with ah_ and is sent in the Authorization: Bearer ah_... header.

curl https://agenthere.ru/v1/chat/completions \
  -H "Authorization: Bearer ah_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4-pro","messages":[{"role":"user","content":"Hi!"}]}'

The base URL is https://agenthere.ru/v1. Use agenthere.ru for API clients: agenthere.online redirects to it, which can strip your key mid-request.

The developer-info endpoint

To discover base URLs and the model catalog programmatically, call:

curl https://agenthere.ru/api/developer/info \
  -H "Authorization: Bearer ah_YOUR_KEY"

The response contains openai_base_url, mcp_url, and a list of models with their ids. The values are built live and always stay in sync with the gateway.

Key types

For most tasks a proxy key is enough.

What's next

• The chat endpoint in depth with Python/JS examples — in Chat Completions.
• The MCP server and tools — in The MCP server and tools.