ГлавнаяДокументация
Меню документации — Веб-поиск и инструменты

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

Модели могут искать в интернете в реальном времени. Передайте инструмент 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 + цитаты в output[].

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.web_search_results (Claude) или grounding_metadata (Gemini).

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"}]
  }'
Тарификация: server-tool'ы оплачиваются ПОВЕРХ токенов. Каждый вызов виден в истории списаний.
Совместимость: можно слать web_search и в /v1/chat/completions для Grok/GPT — но вернётся 400 с подсказкой использовать /v1/responses. Ведём на самый совместимый путь.