شروع سریع API: اولین درخواست در چند دقیقه
حساب بساز، یک کلید 1xai-* بگیر، آدرس پایهٔ کتابخانهٔ OpenAI را روی https://1xai.ir/v1 بگذار و درخواست بفرست. همان کلید و همان آدرس به مدلهای ۱۰ سازنده میرسد و هزینه به تومان از کیف پول کم میشود. حساب تازه یک بار گردونهٔ هدیه را میچرخاند و میتواند پیش از هر پرداختی API را امتحان کند.
آخرین بهروزرسانی:
فهرست مستندات
مسیرهای API
حساب، کلید و تیم
شروع سریع · ۱
گامها
- حساب بساز. در صفحهٔ ثبتنام با ایمیل یا شمارهٔ موبایل ثبتنام و آن را تأیید کن.
- پروفایل هویتی را کامل کن. در /onboarding نام کامل، کد ملی و شمارهٔ موبایل را ثبت کن. تا این پروفایل کامل نشود داشبورد کلید صادر نمیکند و شارژ ممکن نیست.
- گردونهٔ هدیه را بچرخان. از ۱۰۰٬۰۰۰ تومان تا ۱٬۰۰۰٬۰۰۰ تومان اعتبار هدیه برای مدلهای سریع و ارزان، بهعلاوهٔ ۳۰٬۰۰۰ تومان برای هر مدلی؛ هر دو ۱۴ روز اعتبار دارند و روی تماسهای API خرج میشوند.
- کلید بساز. در کلیدهای API یک کلید صادر و همان لحظه کپی کن؛ کلید کامل فقط یک بار نمایش داده میشود (کلیدها و امنیت).
- درخواست بفرست. یکی از سه نمونهٔ پایین. برای عوض کردن سازنده فقط فیلد
modelرا عوض کن:gpt-5.5،claude-sonnet-5یاgemini-3.5-flash. - مصرف را ببین. همان تماس با هزینهٔ تومانی، توکنها و زمانش در داشبورد و در
GET /v1/usageهست (API حساب).
شروع سریع · ۲
اولین درخواست
curl https://1xai.ir/v1/chat/completions \
-H "Authorization: Bearer 1xai-..." \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.5",
"messages": [{"role": "user", "content": "سلام"}]
}'کتابخانهٔ رسمی OpenAI
from openai import OpenAI
client = OpenAI(
base_url="https://1xai.ir/v1",
api_key="1xai-...",
)
resp = client.chat.completions.create(
model="claude-sonnet-5",
messages=[{"role": "user", "content": "سلام"}],
)
print(resp.choices[0].message.content)بستهٔ openai در npm
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://1xai.ir/v1",
apiKey: "1xai-...",
});
const resp = await client.chat.completions.create({
model: "gemini-3.5-flash",
messages: [{ role: "user", content: "سلام" }],
});
console.log(resp.choices[0].message.content);پاسخ همان شکل پاسخ OpenAI را دارد. هدرهای X-RateLimit-* میگویند از سقف ۱٬۰۰۰ درخواست در دقیقهٔ کلید چقدر مانده است (محدودیت نرخ).
شروع سریع · ۳
آدرسهای پایه
| برای | آدرس پایه |
|---|---|
| کتابخانهها و ابزارهای سازگار با OpenAI | https://1xai.ir/v1 |
| کتابخانهٔ رسمی Anthropic و Claude Code | https://1xai.ir/anthropic |
| کتابخانهٔ رسمی Google GenAI | https://1xai.ir/gemini |
سرورهای اصلی 1xAi بیرون از ایران هستند. نشانی api.1xai.ir از یک سرور ما در ایران میگذرد که اتصال رمزشده را باز نمیکند؛ هر دو نشانی به همان سرویس میرسند و بدون فیلترشکن از ایران در دسترساند. روی https://api.1xai.ir همان مسیرها و همان کلیدها کار میکنند.
شروع سریع · ۴
قدم بعد
- احراز هویت: سه هدری که کلید را میپذیرند.
- مدلها: کدام مدل روی کدام مسیر.
- مسیرهای سازگار با OpenAI: چت، Responses، امبدینگ، تصویر، صدا و ویدیو.
- صورتحساب و خطاها.
- اتصال ابزارها: Cursor، Claude Code، n8n و بقیه.