انتقل إلى المحتوى
كل التوثيق

المرجع

POST /v1/chat/completions

إكمال المحادثة من OpenAI، على https://nokeep.ai/v1/chat/completions. أرسل مفتاح bearer وجسم JSON؛ تحصل على إكمال محادثة، أو بثًّا من الأجزاء.

تم التحقق في 27 أكتوبر 2026

حقول الطلب

الحقلمطلوبوظيفته
modelنعممعرّف نموذج من GET /v1/models، مثل deepseek-v4.1-flash-uncensored.
messagesنعممن 1 إلى 2,000 رسالة. الأدوار: system وdeveloper وuser وassistant وtool. المحتوى نص، أو قائمة من أجزاء نصية وimage_url.
streamلاtrue لأحداث يرسلها الخادم. انظر البث.
stream_optionsلا{"include_usage": true} يضيف جزءًا أخيرًا فيه الاستخدام.
max_tokens، max_completion_tokensلاأطول رد، بما فيه التفكير، حتى الحد الأقصى الذي يملكه النموذج نفسه. إن لم يُحدَّد: المساحة التي يغطيها حدّك ورصيدك، حتى 8,192.
reasoning_effortلامقدار تفكير النموذج. انظر التفكير.
tools، tool_choice، parallel_tool_callsلاانظر استدعاءات الأدوات.
response_formatلاانظر مخرجات JSON.
temperature، top_p، top_k، min_pلاأخذ العينات. انظر أدوات أخذ العينات.
frequency_penalty، presence_penalty، repetition_penaltyلاالتحكم في التكرار.
stop، seedلانصوص الإيقاف، وبذرة لردود أكثر قابلية للتكرار.
prompt_cache_keyلاأي نص، ويبقى كما هو لمحادثة واحدة، فتصل استدعاءاتها إلى خادم خزّن بدايتها مؤقتًا. انظر الإدخال المخزَّن.
nلايجب أن يكون 1.

أيّ نموذج يقبل ماذا

الحقلDeepSeekGLM
temperatureنعميُتجاهل
top_pنعميُتجاهل
stopنعميُتجاهل
seedنعميُتجاهل
frequency_penaltyنعميُتجاهل
presence_penaltyنعميُتجاهل
repetition_penaltyنعميُتجاهل
min_pنعميُتجاهل
top_kنعميُتجاهل
toolsنعمنعم
tool_choiceنعمنعم
parallel_tool_callsنعميُتجاهل
response_formatنعميُتجاهل
reasoning_effortنعمنعم
prompt_cache_keyنعميُتجاهل

الحقل الذي لا يقبله النموذج يُحذف ويُذكر في ترويسة x-nokeep-ignored. والحقل الذي لا يعرفه أيٌّ من النموذجين يُحذف بالطريقة نفسها.

الرد

Response
{
  "id": "chatcmpl-…",
  "object": "chat.completion",
  "created": 1792972800,
  "model": "deepseek-v4.1-flash-uncensored",
  "choices": [{
    "index": 0,
    "message": { "role": "assistant", "content": "…" },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 412,
    "completion_tokens": 286,
    "total_tokens": 698,
    "nokeep_credits": 1
  }
}
  • id وmodel من عندنا. لا يُمرَّر شيء من جهة استضافة النموذج.
  • يحمل message.reasoning_content التفكير، إن وُجد.
  • يحمل message.tool_calls استدعاءات الأدوات، ويكون finish_reason فيها tool_calls.
  • usage.nokeep_credits هو تكلفة الاستدعاء بالأرصدة (1,000 منها تساوي دولارًا واحدًا).
  • usage.prompt_tokens_details.cached_tokens، عند وجوده، هو عدد رموز الموجّه التي قرأها النموذج من الذاكرة المؤقتة. تُحتسب بسعر المخزَّن؛ انظر الإدخال المخزَّن.

حدود الطلب

بحد أقصى 12 ميغابايت و2,000 رسالة و10 صور (DeepSeek فقط). الطلبات التي تتجاوزها تُرفض برمز؛ انظر الأخطاء.