تکمیل گفتگو
نقطهٔ پایانی اصلی و پارامترها.
درخواست
POST /v1/chat/completions با بدنهٔ JSON. همان قالب OpenAI است؛ فیلدهای ناشناخته نادیده گرفته می‌شوند.
| پارامتر | نوع | توضیح |
|---|---|---|
model | رشته، الزامی | شناسهٔ مدل از /v1/models، یا auto. |
messages | فهرست، الزامی | پیام‌ها با نقش system، developer، user یا assistant. |
max_tokens / max_completion_tokens | عدد صحیح | سقف طول پاسخ. |
temperature | عدد، ۰ تا ۲ | خلاقیت پاسخ. |
stream | بولی | پاسخ را قطعه‌قطعه بفرستد. |
stream_options.include_usage | بولی | در استریم، مصرف را هم بفرستد. |
محتوای یک پیام می‌تواند متن ساده یا فهرستی از بخش‌های text و image_url باشد. تصویر را فقط مدلی می‌پذیرد که supports_vision دارد.
resp = client.chat.completions.create( model="MODEL_ID", messages=[ {"role": "system", "content": "Answer in Persian, briefly."}, {"role": "user", "content": "What is a token?"}, ], max_tokens=300, temperature=0.4,)print(resp.choices[0].message.content)print(resp.usage)
پاسخ
در حالت عادی یک شیء chat.completion با choices و usage برمی‌گردد. هر پاسخ، حتی خطا، هدر x-request-id دارد؛ اگر به پشتیبانی نوشتید، آن را بفرستید.
اندازهٔ درخواست
بدنهٔ درخواست حداکثر ۴۰ مگابایت است؛ بیشتر از آن 413 با request_too_large می‌گیرید. ورودی بلندتر از حد مدل 422 با context_length_exceeded است.
برای همهٔ پارامترها و پاسخ‌ها مرجع نقطه‌های پایانی را ببینید.
این صفحه کمکتان نکرد؟ به ما بگویید.