API هوش مصنوعی رایگان — اعتبار هدیه برای ChatGPT، Claude، Gemini و DeepSeek

API کاملاً سازگار با OpenAI است؛ یعنی هر کتابخانه، فریم‌ورک یا ابزاری که کلاینت OpenAI دارد، بدون تغییر کد با 1xAi کار می‌کند. فقط دو چیز عوض می‌شود: base_url به https://1xai.ir/v1 و کلید به 1xai-*. اول با curl مطمئن شو کلید کار می‌کند:

curl https://1xai.ir/v1/chat/completions \
  -H "Authorization: Bearer 1xai-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "سلام! یک جملهٔ انگیزشی بگو."}]
  }'

بعد همان را در پایتون، با پکیج رسمی openai:

# pip install openai
from openai import OpenAI

client = OpenAI(
    api_key="1xai-...",              # کلید خودت از داشبورد
    base_url="https://1xai.ir/v1",   # به‌جای آدرس رسمی OpenAI
)

resp = client.chat.completions.create(
    model="gpt-4o-mini",  # یا claude-haiku-4-5 / gemini-2.5-flash / deepseek-chat
    messages=[{"role": "user", "content": "سلام! خودت را معرفی کن."}],
)
print(resp.choices[0].message.content)

جابه‌جایی بین ارائه‌دهنده‌ها فقط تغییر رشتهٔ model است — claude-* به Anthropic می‌رود، gemini-* به Google و deepseek-* به DeepSeek. مرجع کامل API — استریم، مسیرهای نیتیو و کدهای خطا — در مستندات است و راهنمای اتصال ابزارهایی مثل Cursor و n8n در صفحهٔ اتصال ابزارها. وضعیت لحظه‌ای سرویس هم همیشه در صفحهٔ وضعیت عمومی است.

جواب کوتاه: به انتخاب مدل بستگی دارد، و این دقیقاً جایی است که اعتبار هدیه یا می‌ماند یا دود می‌شود. مدل‌های اقتصادی مثل gpt-4o-mini، gemini-2.5-flash، claude-haiku-4-5 و deepseek-chat چند ده برابر ارزان‌تر از پرچم‌دارها هستند؛ با همین کفِ ۱۰۰٬۰۰۰ تومان می‌شود یک نمونهٔ اولیهٔ کامل را ساخت، تست کرد و بارها اجرا گرفت. پرچم‌دارها را برای همان چند جایی نگه دار که واقعاً کیفیت حداکثری می‌خواهی — این عادت بعد از اعتبار رایگان هم هزینه‌ات را پایین نگه می‌دارد.

دنبال چتِ آماده‌ای، نه API؟ پلنِ چتِ رایگان جداست: هر ۳۰ روز ۱۰۰٬۰۰۰ تومان اعتبارِ گفتگو روی مدل‌های سریع می‌گیری و ثبت‌نامش فقط ایمیل می‌خواهد. جزئیات و مقایسهٔ چهار پلنِ چت در صفحهٔ پلن‌ها آمده است.