Wprowadzenie
DeepSeek V4 Flash to model DeepSeek z długim kontekstem, nastawiony na przepustowość, udostępniony tu jako jeden endpoint zgodny z OpenAI pod /v1/chat/completions. Żądanie przyjmuje do 1 048 576 tokenów wejścia w maksymalnie 256 wiadomościach i zwraca do 65 536, a poziom rozumowania domyślnie wynosi high.
Treść wiadomości to wyłącznie tekst. Do 128 narzędzi z tool_choice, wyjście JSON przez response_format i strumieniowanie SSE działają w tym samym wywołaniu, a rozliczenie rozdziela wejście, wejście z cache i wyjście.
Najważniejsze funkcje
Tani i staranny przebieg w jednej treści żądania
reasoning_effort domyślnie wynosi high, a low to ustawienie do przebiegów masowych. Zmiana kosztuje jeden string w tej samej treści, więc pierwsze przejście przez tysiąc rekordów i drugie spojrzenie na czterdzieści podejrzanych to ta sama integracja.
Przeczytać repozytorium, zwrócić ustalenie
Okno mieści 1 048 576 tokenów, a jedna odpowiedź sięga 65 536. Ta proporcja to kształt pracy: wrzuć cały serwis i poproś o przegląd, uszeregowaną listę ustaleń albo celowaną poprawkę, a nie o przepisanie wszystkiego, co wysłałeś.
JSON, gdy o niego poprosisz
Ustaw response_format na json_object i nazwij każde pole w wiadomości systemowej, a przy każdym uruchomieniu wróci ten sam kształt. Twoja aplikacja i tak parsuje i waliduje to, co otrzyma, zanim na tym zadziała.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
messages | Tak | Uporządkowane tury, od najstarszej, maksymalnie 256. Treść wyłącznie tekstowa; |
reasoning_effort | Nie | none, low albo high, domyślnie high. |
stop | Nie | 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. od 1 znaków · od 1 elementów · do 4 elementów |
max_tokens | Nie | Ogranicza odpowiedź do 65 536. Wartość domyślna to 32 768, która po cichu ucina długi materiał. |
tools | Nie | Do 128 definicji funkcji w jednym żądaniu. do 128 elementów |
tool_choice | Nie | auto, none, required albo obiekt wskazujący jedną funkcję. |
response_format | Nie | Poproś o obiekt JSON, gdy odpowiedź trafia do parsera, a nie do człowieka. |
Cennik
Wejście $0.44 / Wyjście $1.32 za 1 mln tokenów
Zastosowania
Przegląd całego repozytorium
Wyślij razem serwis, jego testy i odpowiednią specyfikację, i wymagaj, by każde ustalenie wskazywało plik, linię i zachowanie, którego dotyczy. Z całą bazą kodu w kontekście ustalenie może wskazać wywołującego dwa pakiety dalej, zamiast zgadywać.
Zestawy umów do JSON
Wyślij stos umów z response_format ustawionym na json_object i wczytaj sparsowane klauzule prosto do tabeli. Nazwij pola w wiadomości systemowej i przy przebiegu masowym zostaw poziom na low.
Tani szkic, potem powtórka trudnych przypadków
Przepuść całą kolejkę na low, oznacz rekordy, których wynik nie przeszedł twoich kontroli, i wyślij ponownie tylko je na high z tą samą tablicą wiadomości. Między dwiema odpowiedziami zmieniło się wtedy tylko pole poziomu rozumowania.
Wskazówki
Jedno wywołanie w kształcie OpenAI
POST https://api.spicyapi.ai/v1/chat/completions z {"model": "deepseek/v4-flash", "messages": [{"role": "system", "content": "You review Go services. Report only defects you can point to by file and line."}, {"role": "user", "content": "<the whole service>"}], "reasoning_effort": "high", "max_tokens": 8000}. Dodaj "stream": true, żeby czytać tokeny w miarę ich napływania.
Dobierz max_tokens do rezultatu
Domyślne 32 768 ucina długi rezultat bez błędu, a limit wynosi 65 536. Tokeny rozumowania też są rozliczane jako wyjście, więc zostaw zapas ponad oczekiwaną widoczną odpowiedź.
Co odrzuca schemat
Części image_url i plików są odrzucane, zanim żądanie zostanie wycenione, reasoning_content jest przyjmowane tylko w wiadomościach assistant, a okno 1 048 576 tokenów liczy każdą wiadomość, także prompt systemowy i wcześniejsze wyniki narzędzi. Przy trafieniach w cache ten endpoint nie jest tańszy niż cena samego DeepSeek, więc porównaj, zanim oprzesz się na długim prompcie odtwarzanym raz za razem.
Szybki start z API
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'
Uwierzytelnianie, pełny schemat, odpytywanie i obsługę błędów opisuje dokumentacja API.
