POSTITA /v1/messages

Peamine antroopiaga ühilduv lõpp-punkt. See toetab voogesitust, kiiret vahemällu salvestamist, nägemist, tööriista kasutamist ja laiendatud mõtlemist, kui valitud mudel seda toetab.

Autentimine

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

Minimaalne taotlus

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"}]
  }'

Täpsem taotlus

{
  "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"}}}
  }]
}

Nägemus

{
  "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": "..."}}
    ]
  }]
}

Kiire vahemällu salvestamine

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

Voogesitus

Määra "stream": true. Vastus tagastatakse serveri poolt saadetud sündmustena.

Vastus

{
  "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}
}

Päringu ja vastuse struktuur järgib Anthropic Messages API-t. Olemasolevad antroopsed SDK-d nõuavad tavaliselt ainult base_url muuta.