API DeepSeek V4 Flash: kontekst 1M, wyjście JSON

deepseek/v4-flash/chat

DeepSeek V4 Flash przez endpoint zgodny z OpenAI. Przyjmuje do 1 048 576 tokenów tekstu i zwraca do 65 536, z wysiłkiem rozumowania low lub high, do 128 definicji narzędzi, formatem odpowiedzi JSON i streamingiem SSE.

Wejście $0.44Wyjście $1.32za 1 mln tokenówWejście z pamięci podręcznej $0.014

Uruchom model Zobacz API

Wyślij żądanie

Przykłady korzystają z publicznych definicji parametrów wybranego endpointu. Podmień klucz API i przykładowe media, a potem wyślij żądanie ze swojego serwera.

SDK i integracje

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

Uwierzytelnianie API

Klucz API trzymaj w zmiennej środowiskowej serwera SPICY_API_KEY. Dla żądań JSON używaj uwierzytelniania Bearer i 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-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'

Wygenerowane ze schematu wejścia tego modelu – tego samego, względem którego API waliduje każde żądanie.

Dla każdego logicznego żądania zachowaj jeden Idempotency-Key. Po przerwaniu połączenia nie wysyłaj automatycznie ponownie z nowym kluczem; zachowaj request_id, żeby sprawdzić przyjęte żądanie. Idempotentność nie odtwarza wcześniejszego strumienia czatu.

Parametry wejściowe

Parametry modelu umieść bezpośrednio w ciele żądania JSON, obok model. Ten endpoint nie używa opakowania input.

messagesarray<object>Wymagane

Uporządkowane tury, od najstarszej, maksymalnie 256. Treść wyłącznie tekstowa; reasoning_content jest dopuszczalne w wiadomościach assistant.

Domyślnie: Nie określono
Ograniczenia: minItems:1
maxItems:256

messages[].rolestringWymagane wewnątrz obiektu

Role of the message author.

Domyślnie: Nie określono
Dozwolone wartości: "system""developer""user""assistant""tool"

messages[].namestringOpcjonalne

Optional name identifying the speaker within its role.

Domyślnie: Nie określono

messages[].contentstring | array | nullOpcjonalne

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

Domyślnie: Nie określono

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

messages[].tool_callsarray<object>Opcjonalne

Tool calls the assistant requested in this message.

Domyślnie: Nie określono

messages[].tool_call_idstringOpcjonalne

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

Domyślnie: Nie określono

messages[].reasoning_contentstringOpcjonalne

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

Domyślnie: Nie określono

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

Poproś o obiekt JSON, gdy odpowiedź trafia do parsera, a nie do człowieka.

Domyślnie: Nie określono

tool_choicestring | objectOpcjonalne

auto, none, required albo obiekt wskazujący jedną funkcję.

Domyślnie: Nie określono

toolsarray<object>Opcjonalne

Do 128 definicji funkcji w jednym żądaniu.

Domyślnie: Nie określono
Ograniczenia: maxItems:128

max_tokensintegerOpcjonalne

Ogranicza odpowiedź do 65 536. Wartość domyślna to 32 768, która po cichu ucina długi materiał. Tokeny rozumowania są rozliczane również jako wyjście, więc zostaw zapas powyżej oczekiwanej widocznej odpowiedzi.

Domyślnie: 32768
Ograniczenia: minimum:1
maximum:65536

stopstring | arrayOpcjonalne

Do 4 sekwencji, jako string albo tablica. Odpowiedź kończy się, gdy tylko model zapisze którąś z nich, a dopasowany tekst nie jest zwracany. Brak wartości domyślnej. Stawka się nie zmienia – odpowiedź ucięta wcześniej jest rozliczana tylko za wygenerowane tokeny.

Domyślnie: Nie określono
Ograniczenia: minLength:1
minItems:1
maxItems:4

reasoning_effortstringOpcjonalne

none, low albo high, domyślnie high. none całkowicie pomija przebieg rozumowania – to jedyne ustawienie, przy którym tokeny rozumowania nie trafiają na rachunek, bo liczone są jako wyjście. low do przebiegów wolumenowych, high do odpowiedzi, które nie mogą być błędne.

Domyślnie: "high"
Dozwolone wartości: "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"
                    }
                  }
                }
              ]
            },
            "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": 65536,
      "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
}

Odczytaj wynik

Przy stream ustawionym na false żądanie zwraca gotową odpowiedź czatu od razu. Czytaj choices[].message; odpytywanie zadania nie jest potrzebne. Ustaw stream na true, jeśli twój klient obsługuje Server-Sent Events.

Przykład odpowiedzi po zakończeniu

{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "created": 1788652800,
  "model": "deepseek/v4-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
  }
}

Przykładowa odpowiedź jest poglądowa. usage podaje liczbę tokenów; liczba tokenów i opłata zależą od twojego rzeczywistego żądania.

SDK i integracje

Korzystaj ze SpicyAPI w aplikacji, terminalu, asystencie AI lub wizualnym przepływie pracy. Wybierz instrukcję konfiguracji.

SDKs

TypeScript · Python · Go · PHP · Java

CLI

Polecenia terminala i skrypty automatyzacji.

MCP

Claude Code · Cursor · Codex

Agent Skill

Instrukcje wielokrotnego użytku dla asystenta AI.

n8n

Węzły społecznościowe dla instalacji self-hosted i szablony HTTP Request do importu w n8n Cloud.

ComfyUI

Przepływy obrazów, wideo i dźwięku na płótnie węzłów.

Więcej integracji

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

Przeglądaj gotowe przepływy pracy

To model czatowy, więc działa wszędzie tam, gdzie działa czatowe API OpenAI: zostaw swojego klienta, zmień adres bazowy i wskaż ten model po jego identyfikatorze.

Podłącz dowolnego klienta zgodnego z OpenAI

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

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

Narzędzia obsługujące API czatu OpenAI działają w ten sam sposób: SDK, Vercel AI SDK, LangChain, aider i Cline. Serwer MCP i CLI spicyapi obsługują asynchroniczne zadania multimedialne. Konfiguracje poszczególnych narzędzi znajdziesz w centrum dla deweloperów.

Używaj w SillyTavern i aplikacjach do roleplayu

W SillyTavern, RisuAI, Agnai lub dowolnej aplikacji z ustawieniem zgodnym z OpenAI wklej poniższy bazowy URL i swój klucz API, a jako model wybierz deepseek/v4-flash/chat. Wywołania prosto z przeglądarki są dozwolone, a suwaki, których ten model nie obsługuje, są pomijane zamiast odrzucane.

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

Przewodnik po SillyTavern RisuAI, Agnai i inne Rozszerzenie SillyTavern

Użyj w ComfyUI

Zainstaluj węzły SpicyAPI przez ComfyUI Manager albo poleceniem poniżej, a potem wybierz deepseek/v4-flash/chat w węźle SpicyAPI Chat, aby używać tego modelu w schemacie ComfyUI.

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

Przykładowe workflowy Poradnik konfiguracji Kod źródłowy na GitHubie

Osadzony panel czyta ten sam schemat co ta strona, więc nie może się od API rozjechać. Jeśli twoja dokumentacja potrzebuje treści przeszukiwalnej, pobierz JSON spod /api/embed/models/ i wyrenderuj go samodzielnie.

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

Otwórz panel

Obszar roboczy

Wyślij żądanie

Uwierzytelnianie API

Parametry wejściowe

Odczytaj wynik

SDK i integracje

Używaj w SillyTavern i aplikacjach do roleplayu

Użyj w ComfyUI