مهاجرت از OpenAI

سه خط تغییر. SDK فعلی OpenAI شما همچنان کار می‌کند.

پچ

- client = OpenAI()
+ client = OpenAI(
+ api_key=os.environ["ONEPROVIDER_KEY"],
+ base_url="https://api.oneprovider.dev/v1",
+ )

بر اساس بار کاری انتخاب کنید

ما ادعای هم‌ارزی یک‌به‌یک ساختگی میان نام مدل‌های شرکت‌های مختلف نمی‌کنیم. ردهٔ فعلی GPT را بر اساس نیاز به کیفیت، هزینه و تأخیر انتخاب کنید:

آنچه بدون تغییر کار می‌کند

• chat.completions.create با messages، temperature، max_tokens، stream.
• فراخوانی تابع از طریق tools؛ tool_choice: "auto".
• حالت JSON (response_format: {"type": "json_object"}).
• استریم با iteratorهای ناهمگام در هر دو Python و Node.

چه چیزی تغییر می‌کند

• seed و logprobs بی‌صدا نادیده گرفته می‌شوند.
• شناسه‌های برگشتی به‌جای chatcmpl- پیشوند chatcmpl-op- دارند.
• شکل قدیمی function_call در داخل به tool_use در Anthropic نگاشت می‌شود؛ سطح پاسخ بدون تغییر است.

استفاده از Codex CLI شرکت OpenAI

اگر از CLI به نام Codex شرکت OpenAI استفاده می‌کنید، آن را به endpoint مربوط به Responses API ما وصل کنید و همان کلید را به کار ببرید. راه‌اندازی کامل در صفحهٔ کلاینت Codex است — خلاصه: ~/.codex/auth.json برای کلید، و ~/.codex/config.toml با base_url = "https://api.oneprovider.dev/v1" و wire_api = "responses".

بررسی پس از مهاجرت

response = client.chat.completions.create(
model="gpt-6.1-terra",
messages=[{"role": "user", "content": "Reply with: migration works"}],
)
print(response.choices[0].message.content)

جابه‌جایی از OpenRouter یا گیت‌وی دیگر

در کلاینت من چه چیزی تغییر می‌کند؟

سه تنظیم: base URL، کلید و شناسهٔ مدل. SDKهای OpenAI و ابزارهای سازگار با OpenAI از https://api.oneprovider.dev/v1 استفاده می‌کنند؛ Claude Code و SDKهای Anthropic از https://api.oneprovider.dev. یک کلید OneProvider پشت هر دو کار می‌کند.

شناسه‌های مدل چه فرقی دارند؟

شناسه‌های OneProvider پیشوند شرکت سازنده ندارند، مثلاً claude-sonnet-5-5 یا gpt-6.1-terra. آن‌ها را از صفحهٔ مدل‌ها کپی کنید: شناسهٔ ناشناخته 400 برمی‌گرداند که مشکل را نام می‌برد.

OneProvider چه چیزی اضافه می‌کند؟

endpointهای بومی Anthropic و سازگار با OpenAI زیر یک کلید، موجودی پیش‌پرداخت که منقضی نمی‌شود و اشتراک ندارد، شارژ با ارز دیجیتال، کارت، Apple Pay، Google Pay یا SBP، سقف مصرف و انقضا برای هر کلید و گزارش مصرف هر درخواست. طبق سیاست ما متن پرامپت ذخیره نمی‌شود؛ سرورها در فرانکفورت هستند.

هزینه را چگونه مقایسه کنم؟

همان مدل را مقایسه کنید: نرخ هر میلیون توکن، از جمله نرخ کش، در صفحهٔ قیمت‌ها است. سپس یک کار واقعی اجرا کنید و هزینه را در گزارش مصرف خود بخوانید.

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

از کدام 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 و متن دقیق خطا را بفرستید. پشتیبانی چگونه کار می‌کند .