Documentație Router by MP

Pas 1

Quickstart — 5 minute de la zero la primul răspuns

Trei pași: cont nou, cheie API, primul apel. Fără PR de aprobat, fără ceremonie.

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.ROUTER_API_KEY,
  baseURL: "https://api.megapromoting.com/v1",
});

from openai import OpenAI
import os

client = OpenAI(
    api_key=os.environ["ROUTER_API_KEY"],
    base_url="https://api.megapromoting.com/v1",
)

export ROUTER_API_KEY="rk_..."
export ROUTER_BASE_URL="https://api.megapromoting.com/v1"

const response = await client.chat.completions.create({
  model: "claude-sonnet-4-6",
  messages: [
    { role: "user", content: "Salut! Răspunde scurt în română." }
  ],
  max_completion_tokens: 500,
});

console.log(response.choices[0]?.message?.content);

response = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[
        {"role": "user", "content": "Salut! Răspunde scurt în română."}
    ],
    max_completion_tokens=500,
)

print(response.choices[0].message.content)

curl https://api.megapromoting.com/v1/chat/completions \
  -H "Authorization: Bearer $ROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [
      { "role": "user", "content": "Salut! Răspunde scurt în română." }
    ],
    "max_completion_tokens": 500
  }'

Arhitectură

Cum funcționează

Router by MP e un AI gateway: un proxy OpenAI-compatible care normalizează cererile către providerii upstream (Anthropic, OpenAI, Google, Mistral, etc.), tracking-uiește costul cu markup, și emite factură lunară în MDL.

Catalog

Modele disponibile

100+ modele de la providerii majori, accesibile cu același SDK. Catalogul live la /models.

Securitate

Autentificare + chei API

Authorization: Bearer rk_live_...

Integrări

Compatibilitate SDK

Router by MP e OpenAI compatible la nivel de schema. Orice client care vorbește OpenAI API funcționează cu o modificare de baseURL.

Reference

Endpoint principal — /v1/chat/completions

99% din requesturi merg aici. Schema identică cu OpenAI Chat Completions API.

POST https://api.megapromoting.com/v1/chat/completions
Authorization: Bearer <ROUTER_API_KEY>
Content-Type: application/json

{
  "model": "claude-sonnet-4-6",       // obligatoriu — vezi /models
  "messages": [                         // obligatoriu
    { "role": "system", "content": "..." },
    { "role": "user",   "content": "..." }
  ],
  "max_completion_tokens": 1000,        // opțional, default model
  "temperature": 0.7,                   // opțional, 0-2
  "top_p": 1,                           // opțional
  "stream": false,                      // true = SSE streaming
  "tools": [...],                       // function calling (OpenAI format)
  "tool_choice": "auto",
  "response_format": { "type": "json_object" }
}

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "created": 1747600000,
  "model": "claude-sonnet-4-6",
  "choices": [{
    "index": 0,
    "message": { "role": "assistant", "content": "..." },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 42,
    "completion_tokens": 128,
    "total_tokens": 170,
    "cost_usd": 0.00234              // cost client-facing (post-markup)
  }
}

const stream = await client.chat.completions.create({
  model: "claude-sonnet-4-6",
  messages: [{ role: "user", content: "Scrie un haiku." }],
  stream: true,
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

Limite

Rate limits + Budget controls

Evenimente

Webhooks

Configurabile la /settings/webhooks. Notificări HMAC-SHA256 signed pentru evenimente critice.

Debugging

Erori frecvente — top 10

Fiecare răspuns include header x-router-request-id. Pentru suport, trimite request_id-ul + timestamp.

Billing

Facturare MDL via e-Factura

Help

Suport

Approfundare

Referință completă pe subiecte

15 ghiduri detaliate: quickstart, autentificare, OpenAI compatible, endpoint per endpoint, erori, rate limits, key management, billing, security și migrare de la OpenAI sau OpenRouter.