OpenAPI and SDKs

Merki is compatible with the OpenAI and Anthropic client ecosystems. There is no proprietary SDK to learn.

Quick path

  1. Keep your existing OpenAI or Anthropic SDK.
  2. Change the base URL to Merki and the key to a Merki key.
  3. Add the Merki model name from the catalog.

Details

TopicDecision
OpenAI SDKsbaseURL: "https://api.merki.dev/v1", apiKey: <merki-key>. Works with the official Python/JS SDKs, LangChain, LlamaIndex, and IDE integrations.
Anthropic SDKsbaseURL: "https://api.merki.dev/v1/messages", apiKey: <merki-key>.
Machine specOpenAPI document: https://api.merki.dev/openapi.json.
Field coverageCommon request/response shapes for each family. Out-of-coverage fields return 400 invalid_request naming the field. See Endpoints and Errors.
VersioningAdditive changes only within a major version; breaking changes get a new versioned prefix and a deprecation notice.
from openai import OpenAI
client = OpenAI(base_url="https://api.merki.dev/v1", api_key="...")
client.chat.completions.create(model="Qwen3-32B", messages=[{"role": "user", "content": "Hi"}])

Checklist

  • [ ] Only the base URL and key changed; no request-shape rewrite.
  • [ ] Model name is a Merki catalog name or a BYOK provider ID.
  • [ ] SDK version pins are recorded for reproducibility.

Next step

First call walkthrough: Quickstart.