Quickstart

The first request takes three steps: get a key, choose a model, send a request. The API is compatible with OpenAI and Anthropic, so their SDKs and any client with a configurable URL work.

Get a keyCopy Anchor Link

Open "API keys" in the console and click "Create key". A key like mg-… is shown in full once. Save it in an environment variable:

export MORPHOGEN_API_KEY=mg-...

More about key limits and access: Keys and access.

Choose a URLCopy Anchor Link

Pass the key in the Authorization: Bearer <key> header. The x-api-key: <key> header is accepted too: the Anthropic SDK sends it.

Choose a modelCopy Anchor Link

The models available to your key:

curl https://api.morphogen.ru/v1/models \
  -H "Authorization: Bearer $MORPHOGEN_API_KEY"

Take names from the response, not from memory: the catalog changes.

Send a requestCopy Anchor Link

curl https://api.morphogen.ru/v1/chat/completions \
  -H "Authorization: Bearer $MORPHOGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 200,
    "messages": [{"role": "user", "content": "Привет"}]
  }'

For a streaming response, add "stream": true to the request body.

What you can callCopy Anchor Link

All requests go to https://api.morphogen.ru with your key.

Any model of the "Text" or "Code" type accepts any of the three text formats.

If the request failedCopy Anchor Link

Errors come in the OpenAI format: the code is in error.code. Common cases:

• 401: the key is missing, invalid, revoked or expired.
• 402 insufficient_funds: the balance does not cover the request reserve.
• 403 model_not_allowed: the model is not in the key's list.
• 429 rate_limit_exceeded: the key went over its per-minute request or token limit (120 and 200,000 by default). Retry after the time in the Retry-After header.

Full list: Errors.

NextCopy Anchor Link

• Connect Claude Code or Codex: Agents.
• Give the documentation to an agent: every page has a markdown version. Add .md to the URL, for example /en/quickstart.md. Page index: llms.txt.