استفاده با SDK: کتابخانههای OpenAI، Anthropic و Google
کتابخانهٔ جدایی لازم نیست: کتابخانههای رسمی OpenAI، Anthropic و Google GenAI با عوض کردن آدرس پایه و گذاشتن کلید 1xai-* کار میکنند. برای OpenAI آدرس پایه https://1xai.ir/v1 است، برای Anthropic https://1xai.ir/anthropic و برای Google https://1xai.ir/gemini.
آخرین بهروزرسانی:
فهرست مستندات
مسیرهای API
حساب، کلید و تیم
SDKها · ۱
کتابخانهٔ OpenAI
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)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
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)دو متغیر محیطی
export ANTHROPIC_BASE_URL="https://1xai.ir/anthropic"
export ANTHROPIC_AUTH_TOKEN="1xai-..."
claudeاگر آدرس پایهٔ کتابخانهٔ Anthropic را روی https://1xai.ir بگذاری هم کار میکند، چون /v1/messages به همان مسیر نیتیو میرسد (Anthropic).
SDKها · ۳
کتابخانهٔ Google GenAI
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-sdkSDKها · ۵
ابزارهای آماده
برای Cursor، Claude Code، n8n، Cline، Open WebUI، LibreChat و Continue راهنمای گامبهگام هست: اتصال ابزارها.