Глубокое исследование
Добавьте deep_research: true к обычному completion. Прокси запускает тот же цикл, что и чат: планирует несколько поисков, читает публичные страницы и просит вашу модель написать отчёт со ссылками.
curl https://api.proxy.gonka.gg/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-your-api-key-here" \
-d '{
"model": "deepseek-ai/DeepSeek-V4-Flash-0731",
"deep_research": true,
"messages": [
{"role": "user", "content": "What moved Brent crude prices in 2026?"}
]
}'Без stream ответ — один chat completion. Прокси сразу пишет перевод строки и повторяет его каждые 5 секунд, пока идёт исследование, затем отдаёт JSON. Парсеры JSON эти переводы строк пропускают.
С stream: true то же соединение сначала шлёт цикл исследования, потом отчёт.
Стриминг
Прогресс идёт комментарием SSE, поэтому SDK OpenAI его пропускает и по-прежнему разбирает отчёт. Комментарий начинается с : research , дальше JSON:
: research {"type":"research","stage":"search","detail":"Searching the web","pass":1,"done":1,"total":4,"elapsed_ms":1200,"eta_ms":90000}
: research {"type":"research_jev","query":"brent crude forecast 2026","decisions":[{"title":"Brent crude forecast","url":"https://example.com","score":0.91,"kept":true}]}
: research {"type":"tool_call","name":"web_search","query":"brent crude forecast 2026","count":1,"results":[],"detail":""}stage — это plan, search, judge, deepen, read или write. Комментарий : heartbeat уходит каждые 5 секунд, пока не начнётся отчёт.
Дальше отчёт идёт обычными чанками chat completion и заканчивается data: [DONE]. Чтобы увидеть цикл, читайте сырой стрим и разбирайте строки, которые начинаются с : research . SDK OpenAI отдаёт только отчёт.
Если цикл падает после начала стрима, прокси шлёт data: {"type":"error","error":"..."} и затем data: [DONE]. HTTP-статус остаётся 200.
Этот раздел — публичный API. Чат шлёт те же стадии событиями data:, и эта задача продолжается после закрытия страницы. См. ниже.
Чат
Глубокое исследование, запущенное в чате, выполняется на сервере. Открытая страница — только живой просмотр.
- Закрытие вкладки, обновление страницы или обрыв соединения его не отменяют.
- Откройте тот же чат снова. В списке будет Researching, а в переписке — последняя стадия (
plan,search,judge,deepen,readилиwrite). - Готовый отчёт сохраняется сообщением ассистента. Пока задача идёт, этот чат не принимает новое сообщение.
- Перезапуск прокси прерывает задачу, которая ещё шла. В переписке будет сказано об этом, и её можно отправить снова.
POST /v1/chat/completions остаётся на своём HTTP-соединении. Если этот клиент отключился, исследование по API останавливается. После закрытия страницы продолжает работать только чат.
Пока страница чата открыта, она читает SSE-события data::
data: {"type":"research","stage":"search","detail":"Searching the web","pass":1,"done":1,"total":4,"elapsed_ms":1200,"eta_ms":90000}
data: {"type":"research_jev","query":"brent crude forecast 2026","decisions":[{"title":"Brent crude forecast","url":"https://example.com","score":0.91,"kept":true}]}
data: {"type":"tool_call","name":"web_search","query":"brent crude forecast 2026","count":1,"results":[],"detail":""}Комментарий : heartbeat по-прежнему приходит каждые 5 секунд, пока не начнётся отчёт. Отчёт — обычные чанки completion. Держать этот стрим открытым не нужно: сервер записывает сообщение, когда отчёт готов.
Таймауты
Держите общий таймаут не меньше 5 минут. Оба режима отправляют байты в первую секунду и дальше не реже чем раз в 5 секунд, поэтому лимит простоя в 60 секунд соединение не рвёт. stream: true шлёт SSE-комментарии (: heartbeat). Без stream это переводы строк перед JSON.
client = OpenAI(
base_url="https://api.proxy.gonka.gg/v1",
api_key="sk-your-api-key-here",
timeout=300,
)curl --max-time 300 https://api.proxy.gonka.gg/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-your-api-key-here" \
-d '{
"model": "deepseek-ai/DeepSeek-V4-Flash-0731",
"deep_research": true,
"stream": true,
"messages": [
{"role": "user", "content": "What moved Brent crude prices in 2026?"}
]
}'SDK
SDK OpenAI могут выкинуть неизвестные ключи. Кладёте флаг в extra_body:
client.chat.completions.create(
model="deepseek-ai/DeepSeek-V4-Flash-0731",
messages=[{"role": "user", "content": "What moved Brent crude prices in 2026?"}],
extra_body={"deep_research": True},
)Псевдо-инструмент
Клиенты, которые умеют слать только массив tools, могут передать {"type":"deep_research"}. Прокси забирает его и не пересылает этот tool наверх.
Стоимость
Списываются токены модели, которую вы указали: вызовы планирования и финальный отчёт, по ставке этой модели. Сам поиск отдельной строкой не тарифицируется.
Jev решает, какие страницы оставить. Это внутреннее использование цикла, как в чате. Оно не тарифицируется и не требует порога в 100 000 000 токенов, который нужен для прямого вызова Jev. Не указывайте jev в model. Отчёт пишет не Jev.
С чем это не совмещается
web_search в том же запросе игнорируется. Глубокое исследование ищет само. MCP-инструменты в том же запросе не вызываются.