API | DeepSeek V4.1 Flash API – 384K-Token-Antworten

deepseek/v4.1-flash/chat

DeepSeek V4.1 Flash Chat über einen OpenAI-kompatiblen Endpunkt. Es nimmt bis zu 1.048.576 Token Text- und Bildkontext auf und antwortet mit bis zu 384.000, mit Reasoning-Aufwand low oder high, bis zu 128 Tool-Definitionen und JSON-Format.

Eingabe $0.30Ausgabe $1.20je 1 Mio. TokenEingabe aus dem Cache $0.006

Modell ausführen API ansehen

Anfrage senden

Die Beispiele verwenden die öffentlichen Parameter des gewählten Endpunkts. Ersetzen Sie API-Schlüssel und Beispielmedien und senden Sie die Anfrage von Ihrem Server.

SDKs & Integrationen

POSThttps://api.spicyapi.ai/v1/chat/completions

API-Authentifizierung

Bewahren Sie den API-Schlüssel serverseitig in der Umgebungsvariablen SPICY_API_KEY auf. Verwenden Sie Bearer-Authentifizierung und für JSON-Anfragen Content-Type: application/json.

Authorization: Bearer $SPICY_API_KEY

curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "deepseek/v4.1-flash/chat",
  "messages": [
    {
      "role": "user",
      "content": "Summarise the following release notes into three bullet points."
    }
  ],
  "stream": true
}' \
  | jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'

Erzeugt aus dem Eingabeschema dieses Modells – genau dem, gegen das die API jede Anfrage prüft.

Behalten Sie für jede logische Anfrage denselben Idempotency-Key. Senden Sie nach einem Verbindungsabbruch nicht automatisch mit einem neuen Key erneut, sondern bewahren Sie die request_id auf, um die angenommene Anfrage zu prüfen. Ein früherer Chat-Stream wird dabei nicht noch einmal ausgeliefert.

Eingabeparameter

Die Modellparameter stehen direkt im JSON-Request-Body auf derselben Ebene wie model. Dieser Endpunkt verwendet kein input-Objekt.

messagesarray<object>Erforderlich

Geordnete Züge, das älteste zuerst, höchstens 256. Der Inhalt ist ein String oder ein Array aus text- und image_url-Teilen; reasoning_content ist an Assistant-Nachrichten gültig.

Standardwert: Nicht festgelegt
Einschränkungen: minItems:1
maxItems:256

messages[].rolestringIm Objekt erforderlich

Role of the message author.

Standardwert: Nicht festgelegt
Zulässige Werte: "system""developer""user""assistant""tool"

messages[].namestringOptional

Optional name identifying the speaker within its role.

Standardwert: Nicht festgelegt

messages[].contentstring | array | nullOptional

Message content, either plain text or a list of content parts.

Standardwert: Nicht festgelegt

{
  "type": [
    "string",
    "array",
    "null"
  ],
  "items": {
    "oneOf": [
      {
        "type": "object",
        "required": [
          "type",
          "text"
        ],
        "properties": {
          "text": {
            "type": "string"
          },
          "type": {
            "const": "text"
          }
        }
      },
      {
        "type": "object",
        "required": [
          "type",
          "image_url"
        ],
        "properties": {
          "type": {
            "const": "image_url"
          },
          "image_url": {
            "type": "object",
            "required": [
              "url"
            ],
            "properties": {
              "url": {
                "type": "string"
              }
            }
          }
        }
      }
    ]
  },
  "description": "Message content, either plain text or a list of content parts."
}

messages[].tool_callsarray<object>Optional

Tool calls the assistant requested in this message.

Standardwert: Nicht festgelegt

messages[].tool_call_idstringOptional

Identifier of the tool call this message answers. Required on tool messages.

Standardwert: Nicht festgelegt

messages[].reasoning_contentstringOptional

Reasoning text from a previous assistant reply, preserved when continuing a tool conversation.

Standardwert: Nicht festgelegt

{
  "type": "array",
  "x-ui": {
    "order": 100,
    "widget": "chat-messages",
    "primary": true
  },
  "items": {
    "type": "object",
    "allOf": [
      {
        "if": {
          "required": [
            "reasoning_content"
          ]
        },
        "then": {
          "properties": {
            "role": {
              "const": "assistant"
            }
          }
        }
      }
    ],
    "required": [
      "role"
    ],
    "properties": {
      "name": {
        "type": "string",
        "description": "Optional name identifying the speaker within its role."
      },
      "role": {
        "enum": [
          "system",
          "developer",
          "user",
          "assistant",
          "tool"
        ],
        "type": "string",
        "description": "Role of the message author."
      },
      "content": {
        "type": [
          "string",
          "array",
          "null"
        ],
        "items": {
          "oneOf": [
            {
              "type": "object",
              "required": [
                "type",
                "text"
              ],
              "properties": {
                "text": {
                  "type": "string"
                },
                "type": {
                  "const": "text"
                }
              }
            },
            {
              "type": "object",
              "required": [
                "type",
                "image_url"
              ],
              "properties": {
                "type": {
                  "const": "image_url"
                },
                "image_url": {
                  "type": "object",
                  "required": [
                    "url"
                  ],
                  "properties": {
                    "url": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          ]
        },
        "description": "Message content, either plain text or a list of content parts."
      },
      "tool_calls": {
        "type": "array",
        "items": {
          "type": "object"
        },
        "description": "Tool calls the assistant requested in this message."
      },
      "tool_call_id": {
        "type": "string",
        "description": "Identifier of the tool call this message answers. Required on tool messages."
      },
      "reasoning_content": {
        "type": "string",
        "description": "Reasoning text from a previous assistant reply, preserved when continuing a tool conversation."
      }
    },
    "additionalProperties": false
  },
  "maxItems": 256,
  "minItems": 1,
  "description": "Conversation history in order, oldest message first."
}

response_formatobjectOptional

Verlangen Sie ein JSON-Objekt, wenn die Antwort in einen Parser geht und nicht zu einem Menschen.

Standardwert: Nicht festgelegt

tool_choicestring | objectOptional

auto, none, required – oder ein Objekt, das eine Funktion benennt.

Standardwert: Nicht festgelegt

toolsarray<object>Optional

Bis zu 128 Funktionsdefinitionen in einer Anfrage.

Standardwert: Nicht festgelegt
Einschränkungen: maxItems:128

max_tokensintegerOptional

Deckelt die Antwort bei 384.000. Die Vorgabe ist 32.768 und schneidet ein langes Ergebnis unbemerkt ab. Dieses Modell denkt vor der Antwort, und dieses Denken geht vom selben Budget ab: Ein kleines Limit kann vollständig fürs Nachdenken draufgehen und eine leere Antwort zurückgeben – gemessen bei 120 Token kam kein Inhalt zurück, die Anfrage wurde als Fehlschlag erstattet statt als Antwort berechnet. Lassen Sie auch für kurze Antworten einige tausend Token Luft.

Standardwert: 32768
Einschränkungen: minimum:1
maximum:384000

stopstring | arrayOptional

Bis zu 4 Sequenzen, als String oder Array. Die Antwort endet, sobald das Modell eine davon schreibt; der getroffene Text selbst wird nicht zurückgegeben. Kein Standardwert. Der Tarif ändert sich nicht – eine vorzeitig beendete Antwort wird nur nach den tatsächlich erzeugten Tokens abgerechnet.

Standardwert: Nicht festgelegt
Einschränkungen: minLength:1
minItems:1
maxItems:4

reasoning_effortstringOptional

none, low oder high, Vorgabe high. none überspringt den Denkdurchgang vollständig – nur so bleiben Reasoning-Token außen vor, denn sie werden als Ausgabe abgerechnet. low für Mengendurchläufe, high für Antworten, die nicht falsch sein dürfen.

Standardwert: "high"
Zulässige Werte: "none""low""high"

{
  "type": "object",
  "required": [
    "messages"
  ],
  "x-pricing": {
    "billingMode": "formula",
    "variantFields": []
  },
  "properties": {
    "stop": {
      "type": [
        "string",
        "array"
      ],
      "x-ui": {
        "order": 65,
        "widget": "text",
        "affects_price": false
      },
      "items": {
        "type": "string",
        "minLength": 1
      },
      "maxItems": 4,
      "minItems": 1,
      "minLength": 1,
      "description": "Sequences that end the reply as soon as the model writes one; the matched text is not returned."
    },
    "tools": {
      "type": "array",
      "x-ui": {
        "order": 35,
        "widget": "json"
      },
      "items": {
        "type": "object"
      },
      "maxItems": 128,
      "description": "Tool definitions the model may call."
    },
    "messages": {
      "type": "array",
      "x-ui": {
        "order": 100,
        "widget": "chat-messages",
        "primary": true
      },
      "items": {
        "type": "object",
        "allOf": [
          {
            "if": {
              "required": [
                "reasoning_content"
              ]
            },
            "then": {
              "properties": {
                "role": {
                  "const": "assistant"
                }
              }
            }
          }
        ],
        "required": [
          "role"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Optional name identifying the speaker within its role."
          },
          "role": {
            "enum": [
              "system",
              "developer",
              "user",
              "assistant",
              "tool"
            ],
            "type": "string",
            "description": "Role of the message author."
          },
          "content": {
            "type": [
              "string",
              "array",
              "null"
            ],
            "items": {
              "oneOf": [
                {
                  "type": "object",
                  "required": [
                    "type",
                    "text"
                  ],
                  "properties": {
                    "text": {
                      "type": "string"
                    },
                    "type": {
                      "const": "text"
                    }
                  }
                },
                {
                  "type": "object",
                  "required": [
                    "type",
                    "image_url"
                  ],
                  "properties": {
                    "type": {
                      "const": "image_url"
                    },
                    "image_url": {
                      "type": "object",
                      "required": [
                        "url"
                      ],
                      "properties": {
                        "url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              ]
            },
            "description": "Message content, either plain text or a list of content parts."
          },
          "tool_calls": {
            "type": "array",
            "items": {
              "type": "object"
            },
            "description": "Tool calls the assistant requested in this message."
          },
          "tool_call_id": {
            "type": "string",
            "description": "Identifier of the tool call this message answers. Required on tool messages."
          },
          "reasoning_content": {
            "type": "string",
            "description": "Reasoning text from a previous assistant reply, preserved when continuing a tool conversation."
          }
        },
        "additionalProperties": false
      },
      "maxItems": 256,
      "minItems": 1,
      "description": "Conversation history in order, oldest message first."
    },
    "max_tokens": {
      "type": "integer",
      "x-ui": {
        "unit": "tokens",
        "order": 60,
        "widget": "number",
        "advanced": false,
        "affects_price": false
      },
      "default": 32768,
      "maximum": 384000,
      "minimum": 1,
      "description": "Maximum number of tokens to generate in the reply."
    },
    "tool_choice": {
      "type": [
        "string",
        "object"
      ],
      "x-ui": {
        "order": 30,
        "widget": "json"
      },
      "description": "Controls whether and which tool the model may call."
    },
    "response_format": {
      "type": "object",
      "x-ui": {
        "order": 25,
        "widget": "json"
      },
      "description": "Requested reply format, such as plain text or a JSON object."
    },
    "reasoning_effort": {
      "enum": [
        "none",
        "low",
        "high"
      ],
      "type": "string",
      "x-ui": {
        "order": 70,
        "widget": "radio"
      },
      "default": "high",
      "description": "How much reasoning the model spends before answering."
    }
  },
  "x-input-token-limit": 1048576,
  "additionalProperties": false
}

Ergebnis auslesen

Mit stream: false liefert die Anfrage die vollständige Chat-Antwort direkt zurück. Lesen Sie choices[].message; ein Auftrag muss dafür nicht abgefragt werden. Für Clients mit Unterstützung für Server-Sent Events können Sie stream auf true setzen.

Beispiel einer fertigen Antwort

{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "created": 1788652800,
  "model": "deepseek/v4.1-flash/chat",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Here is a concise summary of the release notes."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 32,
    "completion_tokens": 14,
    "total_tokens": 46
  }
}

Die Antwort dient als Strukturbeispiel. usage enthält Tokenzahlen; tatsächlicher Verbrauch und Kosten hängen von der Anfrage ab.

SDKs & Integrationen

Nutzen Sie SpicyAPI in Ihrer App, im Terminal, mit KI-Assistenten oder in visuellen Workflows. Wählen Sie die passende Anleitung.

SDKs

TypeScript · Python · Go · PHP · Java

CLI

Terminalbefehle und Automatisierungsskripte.

MCP

Claude Code · Cursor · Codex

Agent Skill

Wiederverwendbare Anweisungen für Ihren KI-Assistenten.

n8n

Community-Nodes für selbst gehostetes n8n und importierbare HTTP Request-Vorlagen für n8n Cloud.

ComfyUI

Bild-, Video- und Audio-Workflows auf einer Node-Oberfläche.

Weitere Integrationen

SillyTavern Telegram / Discord App proxy OpenAI SDK LangChain Vercel AI SDK

Fertige Workflows entdecken

Ein Chat-Modell: Es läuft überall dort, wo die Chat-API von OpenAI läuft. Client behalten, Base-URL austauschen, dieses Modell über seine ID auswählen.

Jeden OpenAI-kompatiblen Client hierher zeigen lassen

export OPENAI_BASE_URL="https://api.spicyapi.ai/v1"
export OPENAI_API_KEY="$SPICY_API_KEY"

aider --model openai/deepseek/v4.1-flash/chat

Alles, was die OpenAI-Chat-API nutzt, funktioniert auf dieselbe Weise – SDKs, das Vercel AI SDK, LangChain, aider und Cline. Der MCP-Server und die spicyapi-CLI decken asynchrone Medienaufgaben ab. Die Einrichtung der einzelnen Tools finden Sie im Entwicklerbereich.

In SillyTavern und Rollenspiel-Apps nutzen

In SillyTavern, RisuAI, Agnai oder jeder App mit OpenAI-kompatibler Einstellung fügen Sie die Basis-URL unten und Ihren API-Schlüssel ein und wählen deepseek/v4.1-flash/chat als Modell. Aufrufe direkt aus dem Browser sind erlaubt, und Regler, die dieses Modell nicht kennt, werden ignoriert statt abgelehnt.

Base URL: https://api.spicyapi.ai/v1
Model: deepseek/v4.1-flash/chat

SillyTavern-Anleitung RisuAI, Agnai und mehr SillyTavern-Erweiterung

In ComfyUI nutzen

Installieren Sie die SpicyAPI-Nodes über den ComfyUI Manager oder mit dem Befehl unten und wählen Sie im SpicyAPI Chat-Node deepseek/v4.1-flash/chat, um dieses Modell in einem ComfyUI-Graphen zu nutzen.

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi

Workflow-Beispiele Einrichtungsanleitung Quellcode auf GitHub

Das eingebettete Panel liest dasselbe Schema wie diese Seite und kann daher nicht von der API abweichen. Soll der Inhalt in Ihrer Dokumentation durchsuchbar bleiben, holen Sie stattdessen das JSON unter /api/embed/models/ und rendern es selbst.

<iframe src="https://spicyapi.ai/embed/de/models/deepseek-v4-1-flash/api?model=deepseek%2Fv4.1-flash%2Fchat" width="100%" height="560" loading="lazy" title="Anfragebeispiel" style="border:1px solid rgba(0,0,0,.12)"></iframe>

Panel öffnen

Playground

Anfrage senden

API-Authentifizierung

Eingabeparameter

Ergebnis auslesen

SDKs & Integrationen

In SillyTavern und Rollenspiel-Apps nutzen

In ComfyUI nutzen