Глубокое исследование

Добавьте 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:, и эта задача продолжается после закрытия страницы. См. ниже.

Чат

Глубокое исследование, запущенное в чате, выполняется на сервере. Открытая страница — только живой просмотр.

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-инструменты в том же запросе не вызываются.