مرجع

POST /v1/chat/completions

chat completions از OpenAI، در آدرس https://nokeep.ai/v1/chat/completions. یک کلید bearer و بدنهٔ JSON بفرست؛ یک chat completion یا جریانی از تکه‌ها برمی‌گردد.

بررسی‌شده در ۵ آبان ۱۴۰۵

فیلدهای درخواست

فیلد	لازم است؟	کارش
`model`	بله	یک شناسهٔ مدل از `GET /v1/models`، مثل `deepseek-v4.1-flash-uncensored`.
`messages`	بله	۱ تا ۲٬۰۰۰ پیام. نقش‌ها: system، developer، user، assistant، tool. محتوا یک رشته است، یا فهرستی از بخش‌های متنی و image_url.
`stream`	خیر	true برای server-sent events. بخش Streaming را ببین.
`stream_options`	خیر	`{"include_usage": true}` یک تکهٔ آخر با مصرف اضافه می‌کند.
`max_tokens`, `max_completion_tokens`	خیر	بلندترین پاسخ، شامل فکر کردن، تا بلندترین حد خود مدل. اگر تنظیم نشود: فضایی که سقف و موجودی تو می‌پردازند، تا ۸٬۱۹۲.
`reasoning_effort`	خیر	مدل چقدر سخت فکر کند. بخش Thinking را ببین.
`tools`, `tool_choice`, `parallel_tool_calls`	خیر	بخش Tool calls را ببین.
`response_format`	خیر	بخش JSON output را ببین.
`temperature`, `top_p`, `top_k`, `min_p`	خیر	نمونه‌گیری. بخش Samplers را ببین.
`frequency_penalty`, `presence_penalty`, `repetition_penalty`	خیر	کنترل تکرار.
`stop`, `seed`	خیر	رشته‌های توقف، و یک seed برای پاسخ‌های تکرارپذیرتر.
`prompt_cache_key`	خیر	هر رشته‌ای که برای یک گفتگو یکسان باشد، تا تماس‌هایش به سروری برسند که ابتدای آن در کش دارد. ورودی کش‌شده را ببین.
`n`	خیر	باید ۱ باشد.

هر مدل کدام فیلدها را می‌پذیرد

فیلد	DeepSeek	GLM
`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 هزینهٔ تماس به اعتبار است (۱٬۰۰۰ اعتبار برابر ۱ دلار است).
usage.prompt_tokens_details.cached_tokens، وقتی وجود داشته باشد، تعداد توکن‌های پرامپتی است که مدل از کش خوانده. آن‌ها با قیمت کش‌شده حساب می‌شوند؛ ورودی کش‌شده را ببین.

محدودیت‌های یک درخواست

حداکثر ۱۲ مگابایت، ۲٬۰۰۰ پیام و ۱۰ تصویر (فقط DeepSeek). درخواستی که از آن‌ها بگذرد با یک کد رد می‌شود؛ Errors را ببین.

گرفتن کلید API کلید آزمایشی رایگان را امتحان کن: sk-nokeep-test

فیلدهای درخواست

هر مدل کدام فیلدها را می‌پذیرد

پاسخ

محدودیت‌های یک درخواست

به چه فکر می‌کنید؟