ПОСТ /v1/сообщения

Основная конечная точка, совместимая с Anthropic. Он поддерживает потоковую передачу, кэширование подсказок, видение, использование инструментов и расширенное мышление, если это поддерживается выбранной моделью.

Аутентификация

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

Минимальный запрос

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

Расширенный запрос

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

Зрение

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

Оперативное кэширование

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

Потоковое вещание

Набор "stream": true. Ответ возвращается как события, отправленные сервером.

Ответ

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

Структура запросов и ответов соответствует API Anthropic Messages. Существующие Anthropic SDK обычно требуют только base_url изменять.