Что такое DeepSeek V4-Pro? Объяснение моделей, API, вызова функций и вывода JSON • AI / API

Что такое DeepSeek V4-Pro? Объяснение моделей, API, вызова функций и вывода JSON

Вы подключаете агента DeepSeek, и в документах упоминаетсяdeepseek-v4-prodeepseek-v4-flashи пенсионерdeepseek-chat. Вызов функции иногда возвращает результатargumentsэто недопустимый JSON, а режим JSON и строгая схема следуют разными путями?

DeepSeek V4-Proявляется флагманской моделью MoE в семействе DeepSeek V4, Джорджия с 13 августа 2026 г. (сборка DeepSeek-V4-Pro-0813). Поверхность API не изменилась:base_urlостаетсяhttps://api.deepseek.com, наборmodelкdeepseek-v4-pro

Он совместим с OpenAI Chat Completions, а также предлагает интерфейс в антропном стиле; Вызов функций, вывод JSON и три уровня мыслительных усилий используют один и тот же API.

В этой статье рассматриваются:

• Что такое V4-Pro и V4-Flash и как выбрать
• Минимальный запрос на завершение чата
• Полный цикл инструмента вызова функций
• Режим JSON против строгой схемы бета-версии
• Как JSONNote помогает отлаживать модель JSON

Что такое DeepSeek V4-Pro

DeepSeek V4 запущен через API 24 апреля 2026 г. как стек Mixture-of-Experts. V4-Pro — самый большой вариант: общее количество параметров ~1,6Т, активные ~49Б на каждый прямой проход. Брат и сестраdeepseek-v4-flashон легче (284 Б/13 Б в активном режиме) для рабочих нагрузок, чувствительных к задержкам и затратам.

Выпуск общедоступной версии 2026-08-13 значительно повышает навыки агентов: официальные тесты, такие как Terminal Bench 2.1 и Toolathlon-Verified, сообщают о приросте производительности. Для разработчиков практические изменения заключаются в следующем:

• Многоэтапные вызовы инструментов становятся более стабильными, с меньшим количеством пустых циклов перед ответом.
• Родной OpenAIResponses APIподдержка форматов (рабочие процессы, совместимые с Кодексом)
• Режим мышления добавляетlow / high / maxтри уровня усилий

Если вы уже используете OpenAI SDK с другой моделью, переход на V4-Pro обычно означает изменение толькоbase_urlapi_key, иmodel

Модельный ряд V4 и устаревшие названия

В новых проектах и ​​сценариях CI следует использоватьdeepseek-v4-proилиdeepseek-v4-flashнапрямую — устаревшие псевдонимы были удалены 24 июля 2026 г.

Основы API

Минимальный запрос на завершение чата

API DeepSeek соответствует завершениям чата OpenAI. Пример Python (установитеopenaiупаковка):

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_DEEPSEEK_API_KEY",
    base_url="https://api.deepseek.com",
)

resp = client.chat.completions.create(
    model="deepseek-v4-pro",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "用 JSON 列出三个 HTTP 状态码及含义"},
    ],
)
print(resp.choices[0].message.content)

Три простые ловушки

1. 1
   API без сохранения состояния

   Каждый запрос должен включать полнуюmessagesистория. Сервер не запомнит для вас предыдущие результаты инструмента.

2. 2
   Prompt Cache

   Ответыusageможет включать в себяprompt_cache_hit_tokens. Повторные вызовы с одним и тем же префиксом попадают в кэш и обходятся дешевле.

3. 3
   Цены в часы пик/вне пика

   С 16 августа 2026 г. цены варьируются в зависимости от временного интервала: в непиковое время это примерно половина пиковой цены. Пакетные задания могут быть запланированы соответствующим образом.

Сквозной вызов функций

Вызов функций позволяет модели возвращать вызовы структурированных инструментов — запрашивать базу данных, вызывать HTTP, выполнять математические вычисления — вместо догадок. V4-Pro использует стиль OpenAI.toolsмассивы.

1. Определите инструменты (схема JSON).

{
  "type": "function",
  "function": {
    "name": "get_order",
    "description": "按订单号查询订单状态",
    "parameters": {
      "type": "object",
      "properties": {
        "order_id": { "type": "string", "description": "例如 ORD-10442" }
      },
      "required": ["order_id"]
    }
  }
}

2. Модель возвращаетtool_calls

Когда модели нужен инструмент,finish_reasonявляется"tool_calls"message.contentобычно пусто — настоящая инструкция находится вtool_callsмножество:

{
  "choices": [{
    "message": {
      "role": "assistant",
      "content": "",
      "tool_calls": [{
        "id": "call_0_f1c29a44",
        "type": "function",
        "function": {
          "name": "get_order",
          "arguments": "{\"order_id\": \"ORD-10442\"}"
        }
      }]
    },
    "finish_reason": "tool_calls"
  }]
}

Примечание:argumentsэтонитьВы должныjson.loadsсам. Официальные документы предупреждают, что модель не всегда выдает действительный JSON и может выдавать поля за пределами вашей схемы.

3. Выполнить и вернуть сообщение инструмента

import json

messages = [{"role": "user", "content": "查一下 ORD-10442 的状态"}]
tools = [/* 上面的 get_order 定义 */]

resp = client.chat.completions.create(
    model="deepseek-v4-pro",
    messages=messages,
    tools=tools,
)
msg = resp.choices[0].message

if msg.tool_calls:
    messages.append(msg)  # 保留 assistant 的 tool_calls
    call = msg.tool_calls[0]
    try:
        args = json.loads(call.function.arguments)
    except json.JSONDecodeError:
        args = {}  # 降级或重试
    result = get_order(**args)  # 你的业务函数
    messages.append({
        "role": "tool",
        "tool_call_id": call.id,
        "content": json.dumps(result, ensure_ascii=False),
    })
    # 再次请求，模型基于真实数据生成最终回答
    final = client.chat.completions.create(
        model="deepseek-v4-pro",
        messages=messages,
        tools=tools,
    )

поведение инструмента_выбора

max_tokensСлишком маленькийargumentsусекает вызов инструментаfinish_reasonстановитсяlengthс неполными аргументами. Рабочие нагрузки агентов требуют щедрых бюджетов на завершение.

Вывод JSON и строгий режим

Режим JSON (response_format)

Если вам нужен только текст JSON, а не внешние инструменты, используйте режим JSON:

resp = client.chat.completions.create(
    model="deepseek-v4-pro",
    messages=[
        {"role": "system", "content": "只输出合法 JSON，不要 markdown 代码块"},
        {"role": "user", "content": "生成一个含 name、age 的用户对象"},
    ],
    response_format={"type": "json_object"},
)
raw = resp.choices[0].message.content
data = json.loads(raw)  # 仍建议 try/except

DeepSeek поднял внутреннюю скорость анализа JSON с 78% до 85% в эпоху V2; Очистка регулярных выражений может достигать 97%. V4 совершенствуется дальше, новсегда проверяйте в своем приложении— не относитесь к успешнымjson.loadsкак доказательство того, что схема правильна.

Строгая схема (бета)

Для вызова функций, которые должны точно соответствовать схеме JSON, включите строгий бета-режим:

• base_urlИзменятьhttps://api.deepseek.com/beta
• Набор"strict": true
• Каждыйobjectобъектpropertiesдолжен перечислить все ключи вrequired, сadditionalProperties: false

Строгая проверка назапросить время— неверные схемы перед генерацией возвращают 400. Хорошо подходит для обнаружения ошибок схемы во время развертывания.

JSON Mode vs Function Calling

Три уровня мыслительного усилия

Поддержка режимов мышления V4-Pro и V4-Flashlow / high / maxуровни усилий (см.официальная документация APIраздел Режим мышления):

• low: простые вопросы и ответы, форматирование, краткое изложение.
• high: ежедневные агенты, многоэтапное рассуждение
• max: сложная генерация кода, долгое планирование

Мышление требует больше жетонов и задержки. Для «превратить этот текст в JSON» режим «без мышления» + режим JSON обычно дешевле.

V4-Pro vs V4-Flash

Оба используют один и тот же API — для A/B-тестов требуется толькоmodelизменять. Обычное развертывание: проверка цепочки инструментов на Flash, обновление до Pro при необходимости.

Отладка модели JSON с помощью JSONNote

Интеграция V4-Pro означает много времени, задаваясь вопросом: «А этот анализ JSON соответствует схеме?» JSONNote запускается локально в браузере — ваш ключ API и тела ответов никогда не загружаются.

1. 1
   Формат & подтвердить

   Вставитьmessage.contentилиtool_calls[].function.argumentsвФорматер JSONилиJSON-валидаторчтобы мгновенно увидеть синтаксические ошибки.

2. 2
   Проверка по схеме

   ВJSON Schemaинструмент, вставьте схему параметров функции и выходные данные модели, чтобы проверить поля.

3. 3
   Разница двух вызовов

   После настройки подсказок или переключения Pro/Flash используйтеJSON Diffдля сравнения структурированных результатов.

4. 4
   Поделитесь с товарищами по команде

   ИспользоватьСовместное использование URL-хешакодировать неверный JSON и состояние инструмента в ссылке — получатели воспроизводят локально; данные никогда не попадают на наши серверы.

Часто задаваемые вопросы

Как называется модель API DeepSeek V4-Pro?

deepseek-v4-probase_urlявляетсяhttps://api.deepseek.com, аутентификация соответствует OpenAI (Authorization: Bearer …

Как мне выбрать между V4-Pro и V4-Flash?

Комплексные агенты, длинный контекст, высокая точность инструмента → Профи. Высокая степень параллелизма, экономичность, стандартные задачи → Flash. Оба поддерживают вызов функций и вывод JSON.

Что, если вызов функции вернет неверный формат JSON?

Обернуть синтаксический анализ вtry/except json.JSONDecodeError; проверить обязательные поля; повторите попытку или вернитесь в режим JSON; используйте бета-версию Strict, когда вам нужно строгое соблюдение.

Нужна ли мне еще собственная схема с режимом JSON?

Режим JSON гарантирует только объект JSON, а не соответствие полей вашей бизнес-схеме. Принудительно используйте форму с помощью системного приглашения, пост-проверки или вызова функции + Strict.

Могу ли я по-прежнему использовать deepseek-чат?

Нет. Устаревшие имена удалены 24 июля 2026 г. Мигрировать вdeepseek-v4-proилиdeepseek-v4-flash

Чем вызов функций отличается от OpenAI gpt-4o?

Поля запроса/ответа и циклы инструментов в значительной степени совместимы. Различия: цена, длина контекста, уровни мышления и строгий путь бета-тестирования DeepSeek. Регрессионный тестargumentsанализ иmax_tokensбюджеты при миграции.

Краткое содержание

DeepSeek V4-Pro по сути:

Совместимый с OpenAI API + флагманский MoE + встроенный вызов функций / вывод JSON + дополнительные мыслительные усилия.

Наборmodelкdeepseek-v4-pro, напишите циклы инструментов в стиле OpenAI, но помните:argumentsгенерируется моделью — анализируйте и проверяйте на своей стороне. Инструменты форматирования, схемы и сравнения JSONNote помогают локально отлаживать структурированный вывод.

← Вернуться в блог