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

يمكن أن يصل طول الرابط إلى 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. الواجهة عديمة الحالة: يُتجاهَل 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 هو رمز من كتالوج الأخطاء المشترك. لا تُفوتَر الطلبات الفاشلة.

نصائح

أوقف التفكير في الخطوات البسيطة والسريعة مثل التصنيف أو الاستخراج؛ وأبقه مفعّلًا للاستدلال والرياضيات والشيفرة.
ضع السياق الطويل المُعاد استخدامه في بداية الموجّه: يُفوتَر الإدخال المخزّن مؤقتاً بجزء صغير من سعر الإدخال.
شغّل مهام الدُفعات الكبيرة خارج ساعات الذروة، حين تكون كل الأسعار بالنصف.