Factory

Factory Droid یک CLI عامل کدنویسی است. OneProvider را به‌عنوان مدل سفارشی سازگار با Anthropic در ~/.factory/settings.json اضافه کنید.

پیکربندی

Factory Droid مدل‌های bring-your-own-key را از ~/.factory/settings.json می‌خواند — رابط وب برای ارائه‌دهندگان وجود ندارد. یک مدل به آرایهٔ customModels اضافه کنید؛ baseUrl را بدون /v1 نگه دارید، چون ارائه‌دهندهٔ anthropic خودش /v1/messages را اضافه می‌کند.

{
"customModels": [
{
"model": "claude-sonnet-5-5",
"displayName": "OneProvider claude-sonnet-5-5",
"baseUrl": "https://api.oneprovider.dev",
"apiKey": "sk-your-key-here",
"provider": "anthropic",
"maxOutputTokens": 8192
}
]
}

برای مدل‌های دیگر Claude ورودی‌های بیشتری با model متفاوت اضافه کنید. سپس در droid دستور /model را اجرا کنید و مدل را زیر Custom models انتخاب کنید.

اختصاص مدل به droidها

هر droid در Factory یک مدل پیش‌فرض دارد. claude-sonnet-5-5 را به‌عنوان پیش‌فرض کاربردی یا claude-opus-5-5 را برای کارهای سنگین معماری به کار ببرید.

کدام مدل را انتخاب کنیم

برای هر مدل یک ورودی customModels اضافه کنید. claude-sonnet-5-5 پیش‌فرض کاربردی droidهاست؛ claude-opus-5-5 را برای کارهای سنگین معماری و claude-haiku-5-5 را برای droidهای سریع و ارزان به کار ببرید. provider را روی "anthropic" نگه دارید. شناسه‌ها در صفحهٔ مدل‌ها و نرخ‌ها در صفحهٔ قیمت‌ها است.

خطاهای رایج و راه‌حل‌ها

404

baseUrl باید https://api.oneprovider.dev بدون /v1 باشد: ارائه‌دهندهٔ anthropic خودش /v1/messages را اضافه می‌کند.

401

کلید در ورودی ناقص است یا نقل‌قول اضافه دارد. کل کلید را جایگذاری کنید.

مدل در /model نیست

~/.factory/settings.json را ذخیره کنید (JSON معتبر، بدون نقل‌قول هوشمند) و droid را دوباره باز کنید؛ ورودی‌های سفارشی زیر Custom models ظاهر می‌شوند.

429 «Insufficient balance»

موجودی یا سقف کلید تمام شده است. حساب کاربری را شارژ کنید.

پرسش‌های متداول

رابط وب برای ارائه‌دهندگان هست؟

نه. مدل‌های bring-your-own-key فقط در ~/.factory/settings.json پیکربندی می‌شوند.

می‌توانم چند مدل اضافه کنم؟

بله، برای هر مدل یک شیء به آرایه اضافه کنید؛ همان کلید برای همه کار می‌کند.

هزینه را کجا ببینم؟

در صفحهٔ «مصرف» داشبورد برای آن کلید.

پاسخ‌های سریع

از کدام base URL استفاده کنم؟

Claude Code و SDKهای Anthropic از https://api.oneprovider.dev استفاده می‌کنند. SDKهای OpenAI و کلاینت‌های سازگار با OpenAI از https://api.oneprovider.dev/v1 استفاده می‌کنند. یک کلید پشت هر دو آدرس کار می‌کند؛ فهرست مدل‌ها در صفحهٔ مدل‌ها و نرخ‌ها در صفحهٔ قیمت‌ها است.

چگونه احراز هویت کنم؟

کلید خام sk-… را در x-api-key یا Authorization: Bearer بفرستید: یکی از این دو، نه هر دو. کلید را در یک متغیر محیطی نگه دارید، نه در فایلی که commit می‌شود. اطلاعات بیشتر دربارهٔ احراز هویت .

کلید را از کجا بگیرم؟

حساب کاربری خود را در ربات Telegram به نام @oneprovider_robot یا در app.oneprovider.dev باز کنید، موجودی را شارژ کنید و «صدور کلید» را بزنید. هر کلید می‌تواند سقف مصرف مخصوص خودش را داشته باشد. حساب کاربری و کلیدهای API .

کدهای 401، 404 و 429 یعنی چه؟

401: کلید ارسال نشده، اشتباه تایپ شده یا در هدر نادرست فرستاده شده است؛ کلید را کامل و بدون گیومه و فاصله جای‌گذاری کنید. 404: معمولاً base URL نادرست است، مثلاً /v1 جا افتاده یا دوبار آمده است. 429 با پیام «Insufficient balance»: موجودی حساب کاربری یا سقف مصرف کلید تمام شده است؛ به‌جای تلاش دوباره، شارژ کنید. هر 429 دیگری محدودیت نرخ است؛ تا پایان زمان Retry-After صبر کنید. جزئیات: کدهای خطا و رفع اشکال .

چرا استریم‌ها قطع یا ریست می‌شوند؟

VPN و پروکسی‌های VLESS اغلب SSE را بافر می‌کنند یا مذاکرهٔ HTTP/2 را مختل می‌کنند. OneProvider هیچ محدودیت منطقه‌ای ندارد و استریم‌ها را بافر نمی‌کند؛ پروکسی را خاموش کنید و دوباره امتحان کنید.

اگر این‌ها کافی نبود از کجا بپرسم؟

در Telegram به @Oneproviderhelpbot پیام بدهید یا در حساب کاربری وب «پشتیبانی» را باز کنید و کد وضعیت HTTP و متن دقیق خطا را بفرستید. پشتیبانی چگونه کار می‌کند .