عیبیابی اتصال
از URL و هدر تا مدل، Streaming و مصرف.
راهنمای اتصال مشتریان
curl · Python · JavaScript
درخواست به مسیر درست نمیرسد
- URL نهایی ابزار را با مرجع پروتکل مقایسه کنید؛ بعضی ابزارها /v1 را خودشان اضافه میکنند.
- برای Gemini نام مدل و :generateContent یا :streamGenerateContent را در URL بگذارید.
- از ارسال کلید EFARS به دامنه مستقیم ارائهدهنده یا ارسال کلید ارائهدهنده به EFARS جلوگیری کنید.
پاسخ خالی یا ناقص است
HTTP status را قبل از خواندن متن بررسی کنید. در Claude همه بلوکها text نیستند؛ در Gemini ممکن است خروجی با سیاست ایمنی متوقف شود؛ در OpenAI ممکن است پیام شامل فراخوانی ابزار باشد. finish reason و رویداد پایان را ثبت کنید. در stream، جمعکردن JSONهای data با چسباندن مستقیم کل قطعات شبکه درست نیست.
اطلاعات لازم برای پیگیری
- زمان درخواست همراه با منطقه زمانی، پروتکل، عملیات و نام مدل.
- HTTP status، error.code و شناسه درخواست یا X-Upstream-Request-Id در صورت وجود.
- نمونه حداقلی بدنه بدون کلید و داده حساس.
- مرحله بروز مشکل: پیش از پاسخ، داخل stream یا پس از قطع اتصال.
وجود یک مسیر در راهنما، دیدهشدن نام در فهرست یا پاسخ HTTP 200 صفحه وب، جای بررسی اجرای واقعی همان عملیات را نمیگیرد. برای مشکل دسترسی از وضعیت حساب و کد خطا شروع کنید.