POST /v1/messages

Hlavní koncový bod kompatibilní s Anthropic. Podporuje streamování, rychlé ukládání do mezipaměti, vizi, použití nástrojů a rozšířené myšlení, pokud je podporováno vybraným modelem.

Autentizace

x-api-key: mg_live_...\nanthropic-version: 2023-06-01\ncontent-type: application/json

Minimální požadavek

curl https://api.model-gate.com/v1/messages \
  -H "x-api-key: mg_live_..." \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-4.8",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Pokročilý požadavek

{
  "model": "claude-opus-4.8",
  "max_tokens": 4096,
  "system": "You are a coding assistant.",
  "thinking": {"type": "enabled", "budget_tokens": 8000},
  "messages": [{"role": "user", "content": "Find the bug in this code."}],
  "tools": [{
    "name": "search_files",
    "description": "Search project files",
    "input_schema": {"type": "object", "properties": {"q": {"type": "string"}}}
  }]
}

Vidění

{
  "model": "claude-opus-4.8",
  "max_tokens": 1024,
  "messages": [{
    "role": "user",
    "content": [
      {"type": "text", "text": "What is shown in this image?"},
      {"type": "image", "source": {"type": "base64", "media_type": "image/png", "data": "..."}}
    ]
  }]
}

Okamžité ukládání do mezipaměti

{
  "messages": [{
    "role": "user",
    "content": [
      {"type": "text", "text": "Large reusable context...", "cache_control": {"type": "ephemeral"}},
      {"type": "text", "text": "New question"}
    ]
  }]
}

Streaming

Soubor "stream": true. Odpověď je vrácena jako události odeslané serverem.

Odpověď

{
  "id": "msg_...",
  "type": "message",
  "role": "assistant",
  "model": "claude-opus-4.8",
  "content": [{"type": "text", "text": "Hello!"}],
  "stop_reason": "end_turn",
  "usage": {"input_tokens": 12, "output_tokens": 8}
}

Struktura požadavků a odpovědí se řídí rozhraním API pro Anthropic Messages. Stávající Antropické SDK obvykle vyžadují pouze base_url přeměna.