API توسعهدهندگان
همهٔ مدلها. یک API.
API هوش مصنوعی برای دهها مدل پشت یک endpoint. همان OpenAI SDK را نگه دارید، دو خط را عوض کنید و فقط برای مصرفتان بپردازید.
from openai import OpenAI
client = OpenAI(
base_url="https://api.chatqt.com/api/v1",
api_key="<CHATQT_API_KEY>",
)
completion = client.chat.completions.create(
model="openai/gpt-4.1",
messages=[
{"role": "user", "content": "معنی زندگی چیست؟"},
],
)
print(completion.choices[0].message.content)یک API، دهها مدل.
از گفتوگو تا تصویر، ویدیو و صوت، همه از یک درگاه. مستندات هر endpoint در کنسول است.
گفتوگو
Chat Completions چندمرحلهای با تاریخچهٔ پیام و نقشهای system، user و assistant.
Streaming
پاسخ توکنبهتوکن با stream: true؛ مناسب رابطهای چت.
Tool Calls
مدل پیشنهاد میدهد کدام تابع شما صدا زده شود و اجرا با شماست. یک رابط برای همهٔ مدلها.
چندرسانهای
تصویر، صوت و فایل را در پیام بفرستید؛ روی مدلهایی که از آن پشتیبانی میکنند.
Embeddings و بیشتر
جاسازی متن، تبدیل متن به گفتار و گفتار به متن، و ساخت تصویر و ویدیو در مدلهای پشتیبانیشده.
مصرف و کیف پول
تعداد درخواست، هزینه، مدلها و نمودار هفتگی. کیف پول دلاری را شارژ کنید و بهازای مصرف بپردازید.
اولین درخواست در سه قدم.
حساب بسازید
در کنسول ثبتنام کنید و کیف پول را شارژ کنید.
کلید API بسازید
از بخش «کلیدهای API» کلید تازه بسازید. برای محیط توسعه و تولید کلید جدا داشته باشید.
Authorization: Bearer YOUR_CHATQT_API_KEYدرخواست بفرستید
OpenAI SDK را به ChatQT وصل کنید، یا endpoint REST را از هر زبانی صدا بزنید.
pip install openaiهمان SDK. آدرس تازه.
فقط base_url و api_key را عوض کنید. بقیهٔ کد همان میماند.
pip install openai
from openai import OpenAI
client = OpenAI(
base_url="https://api.chatqt.com/api/v1",
api_key="YOUR_CHATQT_API_KEY",
)
completion = client.chat.completions.create(
model="openai/gpt-4.1",
messages=[
{"role": "user", "content": "معنی زندگی چیست؟"},
],
)
print(completion.choices[0].message.content)import requests
url = "https://api.chatqt.com/api/v1/chat/completions"
headers = {
"Authorization": "Bearer YOUR_CHATQT_API_KEY",
"Content-Type": "application/json",
}
payload = {
"model": "openai/gpt-4.1",
"messages": [{"role": "user", "content": "سلام!"}],
}
response = requests.post(url, headers=headers, json=payload)
response.raise_for_status()
print(response.json()["choices"][0]["message"]["content"])stream = client.chat.completions.create(
model="openai/gpt-4.1",
messages=[{"role": "user", "content": "یک داستان کوتاه بنویس"}],
stream=True,
)
for chunk in stream:
if chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end=""){
"model": "openai/gpt-4o-mini",
"messages": [
{"role": "user", "content": "عنوان چند کتاب از جیمز جویس چیست؟"}
],
"tools": [
{
"type": "function",
"function": {
"name": "search_books",
"description": "جستجوی کتاب بر اساس نویسنده",
"parameters": {
"type": "object",
"properties": {
"author": {"type": "string"}
}
}
}
}
]
}جزئیات اتصال
کلید را در متغیر محیطی نگه دارید و هرگز در مخزن عمومی commit نکنید.
| تنظیم | مقدار |
|---|---|
| Base URL | https://api.chatqt.com/api/v1 |
| هدر | Authorization: Bearer YOUR_CHATQT_API_KEY |
| فرمت | JSON · سازگار با OpenAI Chat Completions |
| پیشوند کلید | sk-or-v1- |
| شناسهٔ مدل | provider/model-name، کپیشده از کنسول |
| مسیر Claude CLI | https://api.chatqt.com/api (بدون /v1) |
خطاهای رایج
| کد | یعنی | راهحل |
|---|---|---|
| 401 Unauthorized | کلید API نامعتبر یا منقضی است | کلید تازه در کنسول بسازید و هدر Authorization را بررسی کنید. |
| 402 Insufficient balance | موجودی کیف پول کافی نیست | از بخش کیف پول شارژ کنید. |
| 404 Model not found | شناسهٔ مدل اشتباه است | شناسه را دقیقاً از فهرست مدلهای کنسول کپی کنید. |
| 429 Rate limit | درخواست بیش از حد مجاز | با کمی تأخیر و backoff نمایی دوباره بفرستید. |
پرسشهای رایج
API هوش مصنوعی ChatQT با SDK رسمی OpenAI کار میکند؟
بله. base_url را روی https://api.chatqt.com/api/v1 و api_key را روی کلید ChatQT بگذارید.
فرق /api و /api/v1 چیست؟
برای OpenAI SDK و n8n از /api/v1 استفاده کنید. برخی کلاینتها، مثل Claude CLI، از /api بدون v1 استفاده میکنند.
شناسهٔ مدل را کجا پیدا کنم؟
در کنسول، بخش مدلها. شناسه معمولاً به شکل provider/model-name است و با نام نمایشی مدل یکی نیست.
هزینه چطور حساب میشود؟
بهازای مصرف، از کیف پول دلاری که آنلاین شارژ میکنید. اشتراک اجباری در کار نیست؛ با تمام شدن اعتبار، درخواستها تا شارژ بعدی متوقف میشوند.
کلید تازه کی فعال میشود؟
بلافاصله. کلید را در کنسول بسازید و همان لحظه اولین درخواست را بفرستید.
آمادهٔ ساختن هستید؟
کلید API بگیرید، اولین درخواست را بفرستید و مصرف را در کنسول دنبال کنید.
دریافت کلید API