Меню документации — Веб-поиск и инструменты
Веб-поиск и инструменты
Модели могут искать в интернете в реальном времени. Передайте инструмент 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"}]
}'
web_search и в /v1/chat/completions для Grok/GPT — но вернётся 400 с подсказкой использовать /v1/responses. Ведём на самый совместимый путь.