دیگر خطا نمی‌گیرید! به راحتی URL پایه و API کلودفلر را برای سازگاری با OpenAI پیکربندی کنید.

CloudFlare را AI چرا آدرس پایه همیشه خطای ۴۰۴ برمی‌گرداند؟

این مقاله در عرض چند ثانیه به شما آموزش می‌دهد که چگونه به سرعت یک URL پایه OpenAI سازگار با Cloudflare را دریافت و پیکربندی کنید. این مقاله شامل قالب‌های کاملی برای REST API رسمی، فرمت AI Gateway و کلاینت‌های شخص ثالث (Dify/One-API) است که به شما کمک می‌کند APIهای هوش مصنوعی رایگان را تنها با یک کلیک راه‌اندازی و اجرا کنید!

هفته‌ی پیش، یکی از دوستانم که توسعه‌دهنده‌ی مستقل است، ناگهان با من تماس گرفت و اسکرین‌شاتی برایم فرستاد که صفحه‌ای پر از خطای ۴۰۱ را نشان می‌داد. او گفت: «برادر، من تمام روز سعی کردم API هوش مصنوعی کلودفلر را دیباگ کنم، اما کار نمی‌کند.»

نگاهی به کد او انداختم. آدرس پایه (Base URL) روی /ai/v1 تنظیم شده بود، اما بدنه درخواست به صورت API رسمی REST قالب‌بندی شده بود، بنابراین این دو اصلاً با هم مطابقت نداشتند.

او گفت که فقط می‌خواسته از SDK شرکت OpenAI برای اشکال‌زدایی یک مدل روی Worker AI استفاده کند، مشکلی هست؟

این یک مشکل بزرگ است.

سرویس‌های هوش مصنوعی کلودفلر بسته به سناریو از سه آدرس اینترنتی پایه کاملاً متفاوت استفاده می‌کنند. هر کدام فرمت و سناریوهای کاربردی خاص خود را دارند. اگرچه مستنداتی وجود دارد، اما در صفحات مختلف پراکنده شده‌اند و همین امر تشخیص اینکه در اولین تلاش خود به کدام یک مراجعه کنید را دشوار می‌کند. استفاده از آدرس اینترنتی اشتباه منجر به خطای ۴۰۱ یا ۴۰۰ می‌شود و از دسترسی شما به سرویس جلوگیری می‌کند.

وقتی برای اولین بار با این مشکل مواجه شدم، چندین بار امتحان کردم تا بالاخره فهمیدم. با دیدن صفحه پر از پیام‌های خطا، زبانم بند آمده بود.

امروز این سه راه را به وضوح برای شما ترسیم می‌کنم، تا بعد از خواندن این مطلب دیگر اشتباه نکنید.

رابط سازگار با OpenAI، آدرس اینترنتی پایه

بیایید با پرکاربردترین آنها شروع کنیم.

اگر از OpenAI SDK یا ابزارهایی که از فرمت‌های سفارشی OpenAI مانند LangChain، Dify، NextChat یا One-API پشتیبانی می‌کنند استفاده می‌کنید، این رویکرد صحیح است.

https://api.cloudflare.com/client/v4/accounts/{你的account_id}/ai/v1

این چیزی است که Cloudflare به طور خاص برای همسو شدن با قالب رابط OpenAI طراحی کرده است. `/chat/completions` را بعد از نقطه پایانی کامل گفتگو اضافه کنید. URL اصلی OpenAI Base خود را با این جایگزین کنید و کلید API را با توکن Cloudflare خود جایگزین کنید، و باید مستقیماً اجرا شود. من مدل‌هایی مانند `@cf/deepseek-ai/deepseek-r1-distill-qwen-32b` و `@cf/meta/llama-3.1-8b-instruct` را امتحان کرده‌ام و همه آنها به خوبی کار می‌کنند.

با این حال، باید توجه داشت که این فقط از مدل‌های گفتگوی مبتنی بر متن پشتیبانی می‌کند.

رابط برنامه‌نویسی کاربردی REST بومی رسمی کلودفلر

اگر نیاز دارید از Stable Diffusion برای رسم نمودار، از Whisper برای رونویسی صدا یا هر مدل غیرمتنی استفاده کنید، مسیر دوم را انتخاب کنید که همان REST API بومی رسمی Cloudflare است.

https://api.cloudflare.com/client/v4/accounts/{你的account_id}/ai/run

نام مدل را می‌توان در مسیر نوشت، مانند /ai/run/@cf/bytedance/stable-diffusion-xl-lightning، یا می‌توان آن را در فیلد `model` در بدنه درخواست قرار داد. من ترجیح می‌دهم آن را در فیلد قرار دهم؛ مسیر کوتاه‌تر و تمیزتر است. من هم در ابتدا در مورد این جزئیات گیج شده بودم. برخی از مدل‌ها هر دو روش را می‌پذیرند، در حالی که برخی دیگر فقط یکی را می‌پذیرند. هنگام بررسی مستندات به این نکته توجه کنید.

آدرس اینترنتی پایه دروازه هوش مصنوعی

یک راه سوم هم وجود دارد: AI Gateway.

این سناریو کمی متفاوت است. اگر یک دروازه هوش مصنوعی در بک‌اند Cloudflare برای پروکسی APIهای شخص ثالث تنظیم کرده باشید، مانند ارسال درخواست‌های OpenAI از طریق دروازه Cloudflare برای ذخیره‌سازی، نظارت و محدود کردن سرعت، آنگاه URL پایه ... خواهد بود.

https://gateway.ai.cloudflare.com/v1/{你的account_id}/{你的gateway_id}/openai

اضافه کردن `/chat/completions` پس از تکمیل نقطه پایانی، تضمین می‌کند که تمام ترافیک از طریق دروازه Cloudflare عبور می‌کند و پنل گزارش، تأخیر و نتیجه هر درخواست را نشان می‌دهد. این ویژگی با رشد تیم و پروژه‌های بیشتر، فوق‌العاده مفید است و نیاز به جستجوی داده‌ها از بک‌اندهای فروشندگان مختلف را یک به یک از بین می‌برد.

نحوه انتخاب: سه مجموعه URL در یک جمله توضیح داده شده است.

خب، این سه مسیر را پوشش می‌دهد. خلاصه، فقط یک اصل وجود دارد.

مسیری که انتخاب می‌کنید به ابزارهایی که استفاده می‌کنید بستگی دارد.

برای استفاده از OpenAI SDK جهت فراخوانی یک مدل گفتگو، به `/ai/v1` بروید. برای فراخوانی یک مدل تصویر/صوت، به `/ai/run` بروید. برای مدیریت یکپارچه از طریق یک دروازه، به `/gateway/` بروید. روش احراز هویت یکسان است: `Authorization: Bearer` و به دنبال آن API Token خود را در هدر قرار دهید. توکن را در بک‌اند Cloudflare ایجاد کنید و به یاد داشته باشید که مجوز `Workers AI: Edit` را بررسی کنید.

از کجا می‌توان account_id را پیدا کرد؟ وارد پنل مدیریت Cloudflare خود شوید، به پایین صفحه بروید تا به بخش API در نوار کناری سمت راست برسید، یا نوار آدرس مرورگر خود را بررسی کنید؛ همان رشته‌ی ۳۲ کاراکتری الفبایی-عددی است.

راستش را بخواهید، بعد از اینکه آن روز به دوستم کمک کردم تا کارش را تمام کند، چیزی به من گفت که به نظرم کاملاً درست است: مسئله این نبود که من نمی‌دانستم چطور، بلکه این بود که مستندات آن را به روشنی برای من توضیح نداده بودند.

بسیاری از پیکربندی‌های فنی به این شکل هستند. نه اینکه خیلی سخت باشند، اما نقاط ورود زیادی وجود دارد که باعث می‌شود در اولین تلاش خود سردرگم شوید. اگر هنگام پیکربندی Cloudflare AI با خطاهای مختلف و غیرقابل توضیحی مواجه شده‌اید، به احتمال زیاد به دلیل URL پایه نادرست یا فرمت نادرست است. این سه مجموعه URL را دم دست داشته باشید؛ دفعه بعد می‌توانید به راحتی URL صحیح را پیدا کنید.

خواهش می‌کنم.

خب، حالا که تا اینجا خوندید، اگه براتون مفید بود، لطفاً لایک کنید و به اشتراک بذارید. اگه می‌خواید زودتر از بقیه از به‌روزرسانی‌ها مطلع بشید، می‌تونید من رو دنبال کنید! ⭐

ممنون که مقاله من را خواندید. دفعه بعد می‌بینمتان.