گفتگو و متن

تکمیل متن (قالب قدیمی)

قالب قدیمی تکمیل متن OpenAI برای ابزارهای قدیمی. یک پرامپت می‌گیرد و پشت صحنه همیشه با یک گفتگوی ساده پاسخ می‌دهد.

POST/v1/completions

این مسیر فقط برای ابزارهایی است که هنوز قالب قدیمی prompt را می‌فرستند. برای کار تازه از تکمیل گفتگو استفاده کنید. مدل‌ها همه مدل گفتگو هستند: پرامپت شما به یک پیام کاربر تبدیل می‌شود و پاسخ به شکل text_completion برمی‌گردد. چون مدل تکمیل متن خالص وجود ندارد، فیلدهای echo ، logprobs ، suffix و best_of با 400 unsupported_parameter رد می‌شوند (مقدار false ، 1 یا نبودن آن‌ها اشکالی ندارد). از فیلدهای دیگر فقط max_tokens ، temperature ، top_p ، stop ، presence_penalty ، frequency_penalty ، seed ، stream و stream_options به مدل می‌رسند و بقیه نادیده گرفته می‌شوند؛ مثلاً n اثری ندارد و همیشه یک پاسخ می‌گیرید. استریم با data: [DONE] تمام می‌شود. تکهٔ مصرف فقط با stream_options.include_usage می‌آید. هزینهٔ درخواست غیر استریم در هدر x-1ai-credits است.

نمونه‌ها

curl https://1ai.ir/v1/completions \
  -H "Authorization: Bearer $ONEAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "openai/gpt-6-luna",
  "prompt": "Write a one-sentence tagline for a coffee shop.",
  "max_tokens": 60,
  "temperature": 0.7
}'

200پاسخ

{
  "id": "cmpl-e18b4a62-9d3c-47f5-a0e1-5c7b2d9f6a03",
  "object": "text_completion",
  "created": 1794484800,
  "model": "openai/gpt-6-luna",
  "choices": [
    {
      "index": 0,
      "text": "Where every cup tastes like a good morning.",
      "logprobs": null,
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 14,
    "completion_tokens": 10,
    "total_tokens": 24
  }
}

هدرها

Authorizationstringالزامی
$Bearer sk-1ai-... با کلید API شما.$

بدنه‌ی درخواست

modelstringالزامی
$نام کامل مدل گفتگو، مثل openai/gpt-6-luna .$
promptstring | arrayالزامی
$متن پرامپت؛ یک رشته یا آرایه‌ای با یک رشته.$
max_tokensinteger
$سقف توکن خروجی، از 1 تا 10,000,000.$
temperaturenumber
$به مدل می‌رسد.$
top_pnumber
$به مدل می‌رسد.$
stopstring | array
$رشته‌هایی که تولید را متوقف می‌کنند.$
presence_penaltynumber
$به مدل می‌رسد.$
frequency_penaltynumber
$به مدل می‌رسد.$
seedinteger
$به مدل می‌رسد.$
streambooleanپیش‌فرض: false
$پاسخ را به‌صورت رویدادهای SSE بفرست.$
stream_optionsobject
$تنظیمات استریم.$
ویژگی‌های داخلی
- include_usageboolean
  $پیش از [DONE] یک تکهٔ آخر با usage بفرست.$

خطاها

unsupported_parameter400
echo، logprobs، suffix یا best_of فرستاده‌اید.
invalid_request400
بدنه نادرست است؛ مثلاً prompt نیامده یا بیش از یک رشته دارد.
invalid_api_key401
کلید نادرست، غیرفعال یا منقضی است.
insufficient_credits402
اعتبار کافی نیست.
model_not_found404
مدل وجود ندارد یا در دسترس شما نیست.

تکمیل متن (قالب قدیمی)

نمونه‌ها

هدرها

بدنه‌ی درخواست

خطاها

صفحه‌های مرتبط