پرامپت و بازخورد

اجرای پرامپت ذخیره‌شده

یک پرامپت ذخیره‌شده را با متغیرها پر و همان‌جا به عنوان درخواست گفتگو اجرا کنید. پاسخ و هزینه مثل چت کامپلیشن است.

POST/v1/prompts/{slug}/completions

این مسیر ساخت متن پرامپت و چت کامپلیشن را پشت سر هم اجرا می‌کند. پرامپت‌ها از پیش برای حساب شما ساخته شده‌اند و slug همان نامی است که برایتان تعریف شده؛ نمونه‌های این صفحه از support-reply استفاده می‌کنند.

مدل و پارامترهای ذخیره‌شده‌ی پرامپت پیش‌فرض هستند و هر فیلد گفتگو که در بدنه بفرستید (model، max_tokens، stream، stream_options و مانند آن) جای آن‌ها را می‌گیرد. messages را از پرامپت می‌آید و بدنه‌ی شما آن را عوض نمی‌کند. اگر پرامپت مدلی نداشته باشد و model نفرستید، 400 invalid_request می‌گیرید.

پاسخ، هدرها، استریم و هزینه دقیقاً مثل چت کامپلیشن است. انتخاب نسخه با version و label در query مثل مسیر ساخت متن کار می‌کند.

نمونه‌ها

curl https://1ai.ir/v1/prompts/support-reply/completions \
  -H "Authorization: Bearer $ONEAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "variables": {
    "customer_name": "Sara",
    "issue": "My order has not arrived."
  }
}'
200پاسخ
{
  "id": "chatcmpl-9a2f6c14",
  "object": "chat.completion",
  "created": 1793000000,
  "model": "openai/gpt-5.4-mini",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hi Sara, I am sorry your order is late. I have asked the courier for an update and will write back today."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 48,
    "completion_tokens": 27,
    "total_tokens": 75
  }
}

پارامترهای مسیر

  • slugstringالزامی

    نام پرامپت. حروف بزرگ و کوچک فرقی ندارد.

پارامترهای کوئری

  • versioninteger

    شماره‌ی نسخه. اگر نباشد، نسخه‌ی جاری به کار می‌رود.

  • labelstring

    برچسب نسخه؛ جدیدترین نسخه‌ی دارای آن انتخاب می‌شود.

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

  • variablesobject

    مقدار متغیرهای قالب.

  • strictbooleanپیش‌فرض: false

    اگر true باشد، متغیر بی‌مقدار خطا می‌دهد.

  • modelstring

    مدل گفتگو. اگر نباشد، مدل ذخیره‌شده در پرامپت به کار می‌رود.

  • streamboolean

    پاسخ را به صورت جریان رویداد بگیرید، مثل چت کامپلیشن.

  • max_tokensinteger

    جای مقدار ذخیره‌شده در پرامپت را می‌گیرد. دیگر فیلدهای چت کامپلیشن هم به همین شکل کار می‌کنند، به جز messages که از پرامپت می‌آید.

خطاها

  • prompt_render_failed400

    قالب نادرست است یا در حالت strict متغیری مقدار ندارد.

  • invalid_request400

    پرامپت مدل ندارد و model هم نفرستاده‌اید.

  • insufficient_credits402

    اعتبار برای این درخواست کافی نیست.

  • prompt_not_found404

    پرامپتی با این slug وجود ندارد.

  • prompt_version_not_found404

    نسخه یا برچسب خواسته‌شده وجود ندارد.

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