Веб-поиск и инструменты

Модели могут искать в интернете в реальном времени. Передайте инструмент web_search — Ranvik сам маршрутизирует запрос в нужный API вендора. Важно: endpoint зависит от модели.

Какой endpoint для какой модели

• xAI (Grok) → POST /v1/responses
• OpenAI (GPT) → POST /v1/responses
• Anthropic (Claude) → POST /v1/chat/completions или /v1/messages
• Google (Gemini) → POST /v1/chat/completions
• DeepSeek, Mistral → веб-поиск не поддерживается (вернётся 400 с подсказкой)

Инструмент везде передаётся одинаково — tools: [{"type": "web_search"}]. Ranvik сам транслирует в нативный формат вендора. В доке конкретной модели (раздел «Пример запроса») всегда показан правильный для неё код — ориентируйтесь на него.

Grok / GPT — через /v1/responses

curl https://api.ranvik.ru/v1/responses \
  -H "Authorization: Bearer rk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.3",
    "input": "Что нового в AI сегодня?",
    "tools": [{"type": "web_search"}]
  }'

Через OpenAI SDK: client.responses.create(model="grok-4.3", input="...", tools=[{"type":"web_search"}]). Текст ответа — в resp.output_text; источники (URL + заголовок) — в output[] → элемент type:"message" → content[].annotations с type:"url_citation". Сам факт поиска виден как элемент type:"web_search_call".

Claude / Gemini — через /v1/chat/completions

curl https://api.ranvik.ru/v1/chat/completions \
  -H "Authorization: Bearer rk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "messages": [{"role":"user","content":"Что нового в AI сегодня?"}],
    "tools": [{"type": "web_search"}]
  }'

Источники возвращаются в choices[0].message: у Claude — массив web_search_results (поля url, title, age), у Gemini — объект grounding_metadata (с webSearchQueries и groundingChunks). Текст ответа — как обычно в choices[0].message.content.

code_interpreter (исполнение кода и генерация файлов)

Grok умеет запускать код в песочнице — для вычислений, анализа данных, генерации файлов. Только через /v1/responses:

curl https://api.ranvik.ru/v1/responses \
  -H "Authorization: Bearer rk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.3",
    "input": "Посчитай 12-е число Фибоначчи кодом",
    "tools": [{"type": "code_interpreter", "container": {"type": "auto"}}]
  }'