Was ist DeepSeek V4-Pro? Modelle, API, Funktionsaufrufe und JSON-Ausgabe erklärt • AI / API

Was ist DeepSeek V4-Pro? Modelle, API, Funktionsaufrufe und JSON-Ausgabe erklärt

Sie verkabeln einen DeepSeek-Agenten und die Dokumente erwähnendeepseek-v4-prodeepseek-v4-flash, und die Rentnerdeepseek-chat. Funktionsaufrufe führen manchmal zu FehlernargumentsDas ist kein gültiges JSON – während der JSON-Modus und das strikte Schema unterschiedliche Pfade verfolgen?

DeepSeek V4-Proist das Flaggschiff-MoE-Modell in der DeepSeek V4-Familie, GA seit 13.08.2026 (Build DeepSeek-V4-Pro-0813). Die API-Oberfläche bleibt unverändert:base_urlbleibthttps://api.deepseek.com, SatzmodelZudeepseek-v4-pro

Es ist mit OpenAI Chat Completions kompatibel und bietet außerdem eine Schnittstelle im Anthropic-Stil. Funktionsaufrufe, JSON-Ausgabe und drei Ebenen des Denkaufwands nutzen dieselbe API.

Dieser Artikel behandelt:

• Was V4-Pro und V4-Flash sind und wie man sie wählt
• Eine minimale Chat-Abschlussanfrage
• Die vollständige Funktionsaufruf-Toolschleife
• JSON-Modus vs. Beta-Strict-Schema
• Wie JSONNote beim Debuggen von JSON-Modellen hilft

Was ist DeepSeek V4-Pro?

DeepSeek V4 wurde am 24.04.2026 über API als Mixture-of-Experts-Stack gestartet. V4-Pro ist die größte Variante: ~1,6T Gesamtparameter, ~49B aktiv pro Vorwärtsdurchlauf. Das Geschwisterchendeepseek-v4-flashist leichter (284B/13B aktiv) für latenz- und kostenempfindliche Arbeitslasten.

Die GA-Version vom 13.08.2026 verbessert die Fähigkeiten der Agenten erheblich – offizielle Benchmarks wie Terminal Bench 2.1 und Toolathlon-Verified berichten über Verbesserungen auf Produktionsniveau. Für Entwickler sind die praktischen Änderungen:

• Mehrstufige Werkzeugaufrufe sind stabiler und es gibt weniger Leerschleifen vor der Beantwortung
• Native OpenAIResponses APIFormatunterstützung (Codex-freundliche Workflows)
• Denkmodus fügt hinzulow / high / maxdrei Leistungsstufen

Wenn Sie das OpenAI SDK bereits mit einem anderen Modell verwenden, bedeutet der Wechsel zu V4-Pro in der Regel nur einen Wechselbase_urlapi_key, Undmodel

V4-Reihe und Legacy-Namen

Neue Projekte und CI-Skripte sollten verwendet werdendeepseek-v4-prooderdeepseek-v4-flashdirekt – alte Aliase wurden am 24.07.2026 eingestellt.

API-Grundlagen

Minimale Anfrage für Chat-Abschlüsse

Die DeepSeek-API stimmt mit OpenAI-Chat-Abschlüssen überein. Python-Beispiel (installieren Sie dieopenaiPaket):

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)

Drei einfache Fallstricke

1. 1
   Zustandslose API

   Jede Anfrage muss vollständig seinmessagesGeschichte. Der Server merkt sich nicht die Ergebnisse früherer Tools für Sie.

2. 2
   Prompt Cache

   Antwortenusagekann beinhaltenprompt_cache_hit_tokens. Wiederholte Anrufe mit demselben Präfix werden im Cache gespeichert und kosten weniger.

3. 3
   Preise zu Haupt- und Nebenzeiten

   Seit dem 16.08.2026 variieren die Preise je nach Zeitfenster – außerhalb der Hauptverkehrszeit beträgt etwa die Hälfte der Hauptverkehrszeit. Batch-Jobs können entsprechend eingeplant werden.

Funktionsaufruf End-to-End

Durch Funktionsaufrufe kann das Modell strukturierte Toolaufrufe zurückgeben – eine Datenbank abfragen, HTTP aufrufen, Mathematik ausführen –, anstatt zu raten. V4-Pro verwendet den OpenAI-StiltoolsArrays.

1. Tools definieren (JSON-Schema)

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

2. Das Modell gibt tool_calls zurück

Wenn das Modell ein Werkzeug möchte,finish_reasonIst"tool_calls"message.contentist normalerweise leer – die eigentliche Anweisung befindet sich imtool_callsArray:

{
  "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"
  }]
}

Notiz:argumentsist einZeichenfolgedu musstjson.loadsselbst. Offizielle Dokumente warnen davor, dass das Modell nicht immer gültiges JSON ausgibt und möglicherweise Felder außerhalb Ihres Schemas halluziniert.

3. Führen Sie das Tool aus und geben Sie eine Nachricht zurück

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,
    )

tool_choice-Verhalten

max_tokensZu kleinargumentskürzt den Tool-Aufruffinish_reasonwirdlengthmit unvollständigen Argumenten. Agenten-Workloads erfordern großzügige Fertigstellungsbudgets.

JSON-Ausgabe und strikter Modus

JSON-Modus (response_format)

Wenn Sie nur JSON-Text und keine externen Tools benötigen, verwenden Sie den JSON-Modus:

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 erhöhte die internen JSON-Parse-Raten in der V2-Ära von 78 % auf 85 %; Die Regex-Bereinigung kann 97 % erreichen. V4 verbessert sich weiter, aberBestätigen Sie dies immer in Ihrer Bewerbung– Behandeln Sie keinen Erfolgjson.loadsals Beweis, dass das Schema korrekt ist.

Strenges Schema (Beta)

Für Funktionsaufrufe, die genau mit dem JSON-Schema übereinstimmen müssen, aktivieren Sie den Beta-Strict-Modus:

• base_urlÄndernhttps://api.deepseek.com/beta
• Satz"strict": true
• JederobjectObjektpropertiesmuss alle Schlüssel auflistenrequired, mitadditionalProperties: false

Strenge Validierungen beiZeit anfordern– Ungültige Schemata geben vor der Generierung 400 zurück. Gut geeignet, um Schemafehler zum Zeitpunkt der Bereitstellung zu erkennen.

JSON Mode vs Function Calling

Drei Denkanstrengungsstufen

Unterstützung der Denkmodi V4-Pro und V4-Flashlow / high / maxAufwandsstufen (sieheoffizielle API-DokumenteAbschnitt „Denkmodus“):

• low: einfache Fragen und Antworten, Formatierung, kurze Zusammenfassungen
• high: tägliche Agenten, mehrstufiges Denken
• max: komplexe Codegenerierung, lange Planung

Denken kostet mehr Token und Latenz. Für „Diesen Text in JSON umwandeln“ ist der Nicht-Denkmodus + JSON-Modus normalerweise günstiger.

V4-Pro vs V4-Flash

Beide nutzen die gleiche API – A/B-Tests benötigen nur einemodeländern. Ein gemeinsamer Rollout: Testen Sie die Toolkette auf Flash und aktualisieren Sie bei Bedarf auf Pro.

Debuggen Sie das JSON-Modell mit JSONNote

Die Integration von V4-Pro bedeutet viel Zeit mit der Frage: „Wird dieser JSON-Code analysiert, stimmt das Schema überein?“ JSONNote wird lokal im Browser ausgeführt – Ihr API-Schlüssel und Ihre Antworttexte werden nie hochgeladen.

1. 1
   Formatieren & bestätigen

   Pastemessage.contentodertool_calls[].function.argumentshineinJSON-FormatiereroderJSON-Validatorum Syntaxfehler sofort zu erkennen.

2. 2
   Gegen Schema prüfen

   ImJSON SchemaFügen Sie im Tool das Funktionsparameterschema und die Modellausgabe ein, um die Felder zu überprüfen.

3. 3
   Differenzieren Sie zwei Anrufe

   Nachdem Sie die Eingabeaufforderungen angepasst oder Pro/Flash gewechselt haben, verwenden SieJSON Diffum strukturierte Ausgaben zu vergleichen.

4. 4
   Mit Teamkollegen teilen

   VerwendenURL-Hash-Sharingum fehlerhafte JSON- und Tool-Status in einem Link zu kodieren – Empfänger reproduzieren lokal; Daten gelangen niemals auf unsere Server.

FAQ

Wie lautet der Name des DeepSeek V4-Pro API-Modells?

deepseek-v4-probase_urlIsthttps://api.deepseek.com, Auth stimmt mit OpenAI überein (Authorization: Bearer …

Wie wähle ich zwischen V4-Pro und V4-Flash?

Komplexe Agenten, langer Kontext, hohe Werkzeuggenauigkeit → Pro. Hohe Parallelität, kostensensibel, Standardaufgaben → Flash. Beide unterstützen Funktionsaufrufe und JSON-Ausgabe.

Was passiert, wenn Funktionsaufrufe fehlerhaftes JSON zurückgeben?

Schließen Sie das Parsen eintry/except json.JSONDecodeError; erforderliche Felder validieren; Versuchen Sie es erneut oder greifen Sie auf den JSON-Modus zurück. Verwenden Sie Beta Strict, wenn Sie eine strikte Einhaltung benötigen.

Benötige ich weiterhin mein eigenes Schema mit JSON-Modus?

Der JSON-Modus garantiert nur ein JSON-Objekt – nicht, dass die Felder Ihrem Geschäftsschema entsprechen. Form über Systemeingabeaufforderung, Nachvalidierung oder Funktionsaufruf + Strikt erzwingen.

Kann ich den Deepseek-Chat weiterhin nutzen?

Nein. Legacy-Namen wurden am 24.07.2026 eingestellt. Migrieren nachdeepseek-v4-prooderdeepseek-v4-flash

Wie unterscheidet sich Funktionsaufruf von OpenAI gpt-4o?

Anfrage-/Antwortfelder und Werkzeugschleifen sind weitgehend kompatibel. Unterschiede: Preise, Kontextlänge, Denkebenen und der strikte Beta-Pfad von DeepSeek. RegressionstestargumentsParsen undmax_tokensBudgets bei der Migration.

Zusammenfassung

DeepSeek V4-Pro ist im Wesentlichen:

OpenAI-kompatible API + Flaggschiff-MoE + nativer Funktionsaufruf / JSON-Ausgabe + optionaler Denkaufwand.

SatzmodelZudeepseek-v4-pro, schreiben Sie Tool-Schleifen auf OpenAI-Art, aber denken Sie daran:argumentsist modellgeneriert – analysieren und validieren Sie auf Ihrer Seite. Die Formatierungs-, Schema- und Diff-Tools von JSONNote helfen beim lokalen Debuggen strukturierter Ausgaben.

← Zurück zum Blog