DeepSeek V4.1 Flash
קריאה ל-DeepSeek V4.1 Flash עם ה-API הרשמי בפורמט Chat Completions, Responses או Anthropic Messages: הקשר של 1M טוקנים, חשיבה שאפשר להפעיל או לכבות וקלט תמונות.
DeepSeek V4.1 Flash הוא המודל המהיר והזול של DeepSeek (ה-API של DeepSeek עצמה קוראת לו deepseek-flash). כברירת מחדל הוא חושב לפני שהוא עונה, ואתה יכול לכבות את החשיבה או לקבוע את רמתה בכל בקשה. שלח את בקשת DeepSeek הרשמית ל-SeedRouter: שנה את כתובת הבסיס ואת מפתח ה-API, שמור את גוף הבקשה.
מזהה המודל
| מזהה המודל | חלון הקשר | פלט מקסימלי | רמת הסקה | ברירת מחדל |
|---|---|---|---|---|
deepseek-v4.1-flash | 1M טוקנים | 384K טוקנים (393,216) | none, low, high, max | חשיבה פעילה, high |
קלט: טקסט ותמונות. פלט: טקסט. ראה את דף המודל לקבלת המחירים הנוכחיים.
דוגמה מהירה
curl https://api.seedrouter.ai/v1/chat/completions \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-v4.1-flash",
"messages": [{"role": "user", "content": "Give me three names for a coffee shop."}]
}'נקודות קצה
| פורמט | שיטה וכתובת | אימות |
|---|---|---|
| Chat Completions | POST https://api.seedrouter.ai/v1/chat/completions | Authorization: Bearer <key> |
| Responses | POST https://api.seedrouter.ai/v1/responses | Authorization: Bearer <key> |
| Anthropic Messages | POST https://api.seedrouter.ai/v1/messages | x-api-key: <key> או Authorization: Bearer <key>, בתוספת anthropic-version |
שלושתן מחזירות את פורמט התשובה הרשמי של DeepSeek, עם הזרמה או בלעדיה. שמור את מפתח ה-API בקוד שרץ בצד השרת.
פרמטרים
שדות Chat Completions:
| שם | סוג | חובה | ברירת מחדל | הערות |
|---|---|---|---|---|
model | string | כן | — | deepseek-v4.1-flash. |
messages | object[] | כן | — | הודעות טקסט; תמונות כחלקי image_url (ראה קלט תמונות). |
thinking.type | enum | לא | enabled | enabled או disabled. |
reasoning_effort | enum | לא | high | none (חשיבה כבויה), low, high או max. minimal פועל כמו low, ו-medium ו-xhigh כמו high. |
max_tokens | integer | לא | 8K, או 64K עם חשיבה (128K ברמה max) | 1–393216. כולל את ההסקה. |
stop | string or string[] | לא | — | רצפי עצירה. |
response_format | object | לא | {"type": "text"} | text או json_object. json_schema מחזיר 400. |
tools | object[] | לא | — | כלים מסוג פונקציה; strict מתקבל. |
tool_choice | string or object | לא | none ללא כלים, auto עם כלים | auto ו-none מופעלים. required ופונקציה בשם מתקבלים אך אינם מחייבים קריאה. |
stream | boolean | לא | false | הזרמת אירועים שנשלחים מהשרת. |
stream_options.include_usage | boolean | לא | false | כל מקטע נושא usage, שערכו null מלבד באחרון. |
temperature | number | לא | 1 | 0–2. אין השפעה במצב חשיבה. |
top_p | number | לא | 1 | 0–1. במצב חשיבה ערכים מתחת ל-0.95 פועלים כ-0.95; ללא חשיבה הערך נשאר 1. |
user_id | string | לא | — | המזהה של משתמש הקצה שלך. |
logprobs, top_logprobs | — | לא | — | מתקבלים (top_logprobs בין 0 ל-20), אך לא מוחזרות הסתברויות לוגריתמיות. |
frequency_penalty, presence_penalty | — | לא | — | הוצאו משימוש על ידי DeepSeek: מתקבלים, ללא השפעה. |
חשיבה ורמת הסקה
החשיבה פעילה כברירת מחדל ברמה high. כבה אותה עם "thinking": {"type": "disabled"} או "reasoning_effort": "none"; התשובה מגיעה אז מיד ועולה פחות טוקני פלט. max משקיע הכי הרבה הסקה בבעיות קשות. ההסקה חוזרת ב-reasoning_content, לצד content, ומחויבת כטוקני פלט.
כשבקשה כוללת tools, שלח בחזרה כל הודעת assistant קודמת עם ה-reasoning_content שלה, כפי ש-DeepSeek דורשת בשיחות עם קריאות לכלים.
קלט תמונות
תמונות נכנסות ל-content של הודעת משתמש כחלקי image_url, ככתובת http(s) ציבורית או כ-data URI בקידוד base64:
{"role": "user", "content": [
{"type": "image_url", "image_url": {"url": "https://example.com/chart.png"}},
{"type": "text", "text": "What does this chart show?"}
]}כתובת URL יכולה להכיל עד 8192 תווים ולהפנות לתמונה של עד 32 MiB. החלף את כתובת הדוגמה בתמונה ציבורית משלך.
מימדי חיוב
ראה את התעריפים הנוכחיים בדף המודל. בקשה מחויבת לפי הטוקנים בהם היא משתמשת:
- טוקני קלט שלא נמצאו במטמון (
prompt_cache_miss_tokens), - טוקני קלט שנמצאו במטמון (
prompt_cache_hit_tokens), - טוקני פלט, כולל הסקה.
התעריפים תלויים בזמן שבו הבקשה רצה. שעות השיא הן 01:00–04:00 ו-06:00–10:00 UTC, בימים שני עד שישי; כל שאר השעות, כולל סופי שבוע, הן מחוץ לשעות השיא, במחצית מתעריפי שעות השיא. הסכום נלקח מה-usage המדווח עם התשובה שהסתיימה. בקשה שנכשלת אינה מחויבת. רשומות השימוש של החשבון שלך מציגות את החיוב המדויק לכל בקשה.
פלט
בקשת Chat Completions שאינה בהזרמה מחזירה:
{
"id": "bc86988e-...",
"object": "chat.completion",
"created": 1790585983,
"model": "deepseek-v4.1-flash",
"choices": [{
"index": 0,
"finish_reason": "stop",
"logprobs": null,
"message": {"role": "assistant", "reasoning_content": "...", "content": "..."}
}],
"usage": {
"prompt_tokens": 36,
"completion_tokens": 39,
"total_tokens": 75,
"prompt_cache_hit_tokens": 0,
"prompt_cache_miss_tokens": 36,
"prompt_tokens_details": {"cached_tokens": 0},
"completion_tokens_details": {"reasoning_tokens": 0}
}
}עם "stream": true כל מקטע נושא delta עם reasoning_content או content, והמקטע האחרון לפני data: [DONE] נושא את נתוני השימוש.
Responses API ו-Codex
POST /v1/responses מקבל גוף Responses: input, instructions, max_output_tokens, reasoning.effort (כמו reasoning_effort למעלה), text.format (text או json_object; json_schema מתקבל אך לא נאכף), tools (function וכלי מותאם אישית apply_patch), tool_choice, temperature, top_p, top_logprobs, user ו-stream. ההסקה חוזרת כפריט reasoning עם תוכן reasoning_text, וזרם נושא אירועים ממוספרים מ-response.created עד response.completed, כשההסקה באירועי response.reasoning_text.delta. ה-API חסר מצב: previous_response_id, conversation וכלים מובנים כמו web_search נדחים, לכן שלח את כל השיחה ב-input.
כדי להשתמש ב-DeepSeek V4.1 Flash ב-Codex, הוסף provider ל-~/.codex/config.toml והגדר את SEEDROUTER_API_KEY:
model = "deepseek-v4.1-flash"
model_provider = "seedrouter"
show_raw_agent_reasoning = true
[model_providers.seedrouter]
name = "SeedRouter"
base_url = "https://api.seedrouter.ai/v1"
env_key = "SEEDROUTER_API_KEY"
wire_api = "responses"פורמט Anthropic Messages
גם קוד שנכתב עבור Anthropic Messages API יכול לקרוא ל-DeepSeek V4.1 Flash: שלח את גוף ה-Messages אל /v1/messages עם "model": "deepseek-v4.1-flash". system, max_tokens, tools, tool_choice (auto, none), thinking (enabled, disabled) ו-temperature (0–2) מופעלים; output_config.effort ו-metadata.user_id מתקבלים; ל-top_k, stop_sequences ו-tool_choice any אין השפעה. ההסקה חוזרת כבלוקי thinking. תמונות נשלחות כמקורות base64 או url.
שגיאות
שגיאות משתמשות בצורה {"error": {"code": ..., "message": "..."}} (נקודת הקצה של Messages משתמשת בצורת השגיאה של Anthropic). ה-code הוא קוד מ-קטלוג השגיאות המשותף. בקשות שנכשלו אינן מחויבות.
טיפים
- כבה את החשיבה לצעדים פשוטים ומהירים כמו סיווג או חילוץ; השאר אותה פעילה להסקה, מתמטיקה וקוד.
- שים הקשר ארוך שחוזר על עצמו בתחילת הפרומפט: קלט מהמטמון מחויב בשבריר מתעריף הקלט.
- הרץ משימות אצווה גדולות מחוץ לשעות השיא, כשכל התעריפים במחצית.
