۱۰۰ هزار تومان هدیهٔ ثبت‌نام، تا ۱ میلیونبا ثبت‌نام گردونهٔ هدیه را بچرخان: دست‌کم ۱۰۰٬۰۰۰ تومان و تا ۱٬۰۰۰٬۰۰۰ تومان اعتبار هدیه، بدون کارت بانکیگردونهٔ هدیه۱ میلیون برای تو، ۱ میلیون برای دوستتدوستانت را دعوت کن: برای هر دوستی که فعال شود ۱٬۰۰۰٬۰۰۰ تومان اعتبار هدیه می‌گیری و خودش هم ۱٬۰۰۰٬۰۰۰ تومانجوایز
1xAi
مستندات API

استفاده با SDK: کتابخانه‌های OpenAI‏، Anthropic و Google

کتابخانهٔ جدایی لازم نیست: کتابخانه‌های رسمی OpenAI‏، Anthropic و Google GenAI با عوض کردن آدرس پایه و گذاشتن کلید 1xai-* کار می‌کنند. برای OpenAI آدرس پایه https://1xai.ir/v1 است، برای Anthropic https://1xai.ir/anthropic و برای Google https://1xai.ir/gemini.

آخرین به‌روزرسانی:

فهرست مستندات

SDKها · ۱

کتابخانهٔ OpenAI

Python
from openai import OpenAI

client = OpenAI(
    base_url="https://1xai.ir/v1",
    api_key="1xai-...",
)

resp = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role": "user", "content": "سلام"}],
)
print(resp.choices[0].message.content)
JavaScript
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://1xai.ir/v1",
  apiKey: "1xai-...",
});

const resp = await client.chat.completions.create({
  model: "gpt-5.5",
  messages: [{ role: "user", content: "سلام" }],
});
console.log(resp.choices[0].message.content);

هر کلاینت دیگری که آدرس پایهٔ سفارشی بپذیرد (Go، ‎.NET‏، Java‏، LangChain‏، LlamaIndex‏، Vercel AI SDK و مانند آن) با همین دو تنظیم کار می‌کند: آدرس پایه و کلید.

با متغیر محیطی، بدون تغییر کد

ترمینال
export OPENAI_BASE_URL="https://1xai.ir/v1"
export OPENAI_API_KEY="1xai-..."

SDKها · ۲

کتابخانهٔ Anthropic و Claude Code

Python
from anthropic import Anthropic

client = Anthropic(
    base_url="https://1xai.ir/anthropic",
    api_key="1xai-...",
)

resp = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "سلام"}],
)
print(resp.content[0].text)

دو متغیر محیطی

Claude Code
export ANTHROPIC_BASE_URL="https://1xai.ir/anthropic"
export ANTHROPIC_AUTH_TOKEN="1xai-..."
claude

اگر آدرس پایهٔ کتابخانهٔ Anthropic را روی https://1xai.ir بگذاری هم کار می‌کند، چون /v1/messages به همان مسیر نیتیو می‌رسد (Anthropic).

SDKها · ۳

کتابخانهٔ Google GenAI

Python
from google import genai
from google.genai import types

client = genai.Client(
    api_key="1xai-...",
    http_options=types.HttpOptions(base_url="https://1xai.ir/gemini"),
)

resp = client.models.generate_content(
    model="gemini-3.5-flash",
    contents="سلام",
)
print(resp.text)

کلید باید در هدر فرستاده شود، نه در نشانی (احراز هویت). جزئیات مسیر در Gemini است.

SDKها · ۴

بستهٔ متن‌باز 1xai-sdk

برای اینکه هر بار آدرس پایه و کلید را دستی ندهی، بستهٔ متن‌باز 1xai-sdk همان کتابخانهٔ رسمی OpenAI را از پیش تنظیم می‌کند و برآورد هزینه به تومان را هم دارد.

نصب
npm install 1xai-sdk
pip install 1xai-sdk

SDKها · ۵

ابزارهای آماده

برای Cursor‏، Claude Code‏، n8n‏، Cline‏، Open WebUI‏، LibreChat و Continue راهنمای گام‌به‌گام هست: اتصال ابزارها.