Meridian/Documentation
GitHubDashboard

Quickstart

Go from zero to your first proxied LLM call in five steps. This guide takes about five minutes.

1

Create an account

Sign up at your Meridian instance. If you're self-hosting, deploy first (see the self-hosting guide), then navigate to /auth/signup.

After signup you'll land on the dashboard. It will be empty — that's expected.

2

Add a provider key

Navigate to the Providers page from the dashboard sidebar. Click 'Add Key' on any supported provider — OpenAI, Anthropic, or Google Gemini.

Your provider key is encrypted with AES-256-GCM before being stored. Meridian never exposes the raw key again after submission.

3

Create a proxy key

Go to the Keys page and click 'Create Key'. Give it a descriptive name like 'dev-local' or 'prod-backend'.

Important: Copy the key immediately

The full proxy key (starting with sk-mrd-) is displayed only once. Store it securely — Meridian only stores a SHA-256 lookup hash.

4

Make your first API call

Use your proxy key to call the chat completions endpoint. Meridian routes the request to the correct provider based on the model name.

curl
curl -X POST https://your-meridian.vercel.app/api/v1/chat/completions \
  -H "Authorization: Bearer sk-mrd-your-proxy-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4.1",
    "messages": [
      { "role": "user", "content": "Hello, world!" }
    ]
  }'
JavaScript (fetch)
const response = await fetch(
  "https://your-meridian.vercel.app/api/v1/chat/completions",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer sk-mrd-your-proxy-key",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      model: "gpt-4.1",
      messages: [{ role: "user", content: "Hello, world!" }],
    }),
  }
);

const data = await response.json();
console.log(data.choices[0].message.content);

You can use any supported model name. Meridian detects the provider automatically:

  • gpt-4.1, gpt-4.1-mini → OpenAI
  • claude-sonnet-4-20250514 → Anthropic
  • gemini-2.5-pro → Google Gemini
5

View your usage

Go back to the Dashboard. You'll see your request logged with model, cost, latency, and status information.

The dashboard shows total requests, total cost, average latency, and active keys over the last 30 days. You can also query usage programmatically via the Usage API.

Next steps