DeepSeek V4.1 Flash API: كيف تحصل على مفتاح وترسل أول استدعاء

لاستدعاء DeepSeek V4.1 Flash، تحتاج إلى مفتاح API من منصّة تقدّمه، وإلى طلب يتضمّن معرّف النموذج. في API الخاصة بـ DeepSeek يكون اسم النموذج deepseek-flash، والاسمان القديمان deepseek-v4-flash و deepseek-v4-flash-vision-exp يُوجَّهان إليه. أما على SeedRouter فمعرّف النموذج هو deepseek-v4.1-flash، ومفتاح واحد يستدعيه بالدفع حسب الاستخدام وبصيغة الطلبات الرسمية: وجّه OpenAI SDK إلى https://api.seedrouter.ai/v1 واحتفظ بكودك كما هو.

يستخدم هذا الدليل SeedRouter؛ ونصوص الطلبات هي نفسها في API الخاصة بـ DeepSeek.

كيف أحصل على مفتاح DeepSeek V4.1 Flash API؟

1. سجّل الدخول إلى SeedRouter وافتح مفاتيح API.
2. أنشئ مفتاحًا وانسخه؛ فهو لا يظهر إلا مرة واحدة.
3. أضف رصيدًا عندما تحتاج إليه. تبدأ الحسابات الجديدة برصيد مجاني صغير، ولا يوجد اشتراك.

احفظ المفتاح في متغيّر بيئة مثل SEEDROUTER_API_KEY، ولا تستخدمه إلا من كود يعمل على الخادم.

كيف أستدعي DeepSeek V4.1 Flash من Python؟

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["SEEDROUTER_API_KEY"],
    base_url="https://api.seedrouter.ai/v1",
)

completion = client.chat.completions.create(
    model="deepseek-v4.1-flash",
    messages=[{"role": "user", "content": "Give me three names for a coffee shop."}],
)
print(completion.choices[0].message.content)

التفكير مفعّل افتراضيًا، لذا تحمل الرسالة أيضًا استدلال النموذج في reasoning_content، إلى جانب الإجابة في content.

كيف أستدعيه من Node.js أو cURL؟

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.SEEDROUTER_API_KEY,
  baseURL: "https://api.seedrouter.ai/v1",
});

const completion = await client.chat.completions.create({
  model: "deepseek-v4.1-flash",
  messages: [{ role: "user", content: "Give me three names for a coffee shop." }],
});
console.log(completion.choices[0].message.content);

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."}]}'

يستجيب المفتاح نفسه أيضًا لـ Responses API (/v1/responses) ولصيغة Anthropic Messages (/v1/messages) مع deepseek-v4.1-flash.

كيف أوقف التفكير أو أضبط مستواه؟

التفكير مفعّل افتراضيًا بمستوى high. أوقفه عبر thinking، أو اختر مستوى عبر reasoning_effort. يمرّر OpenAI SDK المعامل thinking من خلال extra_body. الطلب الأول يوقف التفكير للحصول على أسرع إجابة وأرخصها؛ والثاني يستخدم أعلى مستوى:

completion = client.chat.completions.create(
    model="deepseek-v4.1-flash",
    messages=[{"role": "user", "content": "Classify: 'my card was charged twice'"}],
    extra_body={"thinking": {"type": "disabled"}},
)

completion = client.chat.completions.create(
    model="deepseek-v4.1-flash",
    messages=[{"role": "user", "content": "How many primes are there below 150?"}],
    reasoning_effort="max",
)

تقبل DeepSeek أيضًا minimal (يعمل كـ low)، و medium و xhigh (يعملان كـ high). في اختبارنا على سؤال لعدّ الأعداد الأولية، استخدم إيقاف التفكير 2 توكن إخراج، و low عدد 258، و max عدد 319. يُحتسب الاستدلال كإخراج.

كيف أبثّ الإجابة؟

أضف stream=True. عند تفعيل التفكير، يصل الاستدلال أولًا في delta.reasoning_content، ثم الإجابة في delta.content، ويحمل آخر جزء استهلاك التوكنات:

stream = client.chat.completions.create(
    model="deepseek-v4.1-flash",
    messages=[{"role": "user", "content": "Write a haiku about latency."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

هل يمكنني إرسال صور؟

نعم. يقرأ DeepSeek V4.1 Flash الصور بشكل أصلي. أرسل رابطًا عامًا أو data URI مرمّزًا بـ base64 في جزء image_url:

completion = client.chat.completions.create(
    model="deepseek-v4.1-flash",
    messages=[{
        "role": "user",
        "content": [
            {"type": "image_url", "image_url": {"url": "https://example.com/chart.png"}},
            {"type": "text", "text": "What does this chart show?"},
        ],
    }],
)

يمكن أن يصل طول رابط الصورة إلى 8,192 حرفًا، وأن يشير إلى ملف يصل حجمه إلى 32 MiB.

ما الأخطاء التي قد أواجهها؟

تعود الأخطاء بصيغة {"error": {"code": ..., "message": "..."}}، والطلب الذي يفشل لا يُحتسب.

الأسئلة الشائعة

هل DeepSeek V4.1 Flash API متوافقة مع OpenAI؟

نعم. تقبل صيغتَي Chat Completions و Responses، لذا يعمل OpenAI SDK بعد تغيير عنوان URL الأساسي واسم النموذج فقط. وتقبل أيضًا صيغة Anthropic Messages.

لماذا يختلف معرّف النموذج عن معرّف DeepSeek؟

تسمّي DeepSeek النموذج deepseek-flash في API الخاصة بها. أما SeedRouter فتستخدم deepseek-v4.1-flash حتى يكون الإصدار جزءًا من الاسم. وفيما عدا ذلك يبقى نص الطلب كما هو.

كم يكلّف طلب DeepSeek V4.1 Flash واحد؟

يُحتسب لكل توكن، بأسعار ساعات الذروة أو خارج ساعات الذروة بحسب الساعة. يعرض دليل أسعار DeepSeek V4.1 Flash الأسعار المباشرة وأمثلة محسوبة.

أين أجد قائمة المعاملات الكاملة؟

يسرد مرجع DeepSeek V4.1 Flash API كل حقل، وتوفّر صفحة DeepSeek V4.1 Flash ساحة اللعب والأسعار المباشرة.