ChatQT

API توسعه‌دهندگان

قدرت ChatQT، در دستان توسعه‌دهندگان.

ده‌ها مدل هوش مصنوعی از یک endpoint — سازگار با OpenAI SDK، بدون VPN از ایران. کلید API، مستندات، آمار مصرف و شارژ کیف پول در کنسول توسعه‌دهندگان. برای ترمینال: راهنمای Claude CLI؛ برای اتوماسیون: راهنمای n8n.

ورود به کنسول شروع سریع
Python 
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)

کنسول توسعه‌دهندگان

همه‌چیز در یک داشبورد.

در console.chatqt.com کلید API می‌سازید، مدل انتخاب می‌کنید، مستندات را می‌خوانید، مصرف را رصد می‌کنید و کیف پول را شارژ می‌کنید — بدون نیاز به VPN از ایران.

کلیدهای API

چند کلید جدا برای محیط توسعه و تولید؛ نمایش امن (ماسک‌شده) و مدیریت از یک جدول.

مدل‌ها

فهرست مدل‌های ChatGPT، Claude، Gemini، Grok و ده‌ها مدل دیگر با شناسهٔ یکتا برای درخواست API.

مستندات تعاملی

شروع سریع، Streaming، Tool Calls، چندرسانه‌ای، پارامترها و مدیریت خطا — همان محتوای کنسول.

آمار استفاده

تعداد درخواست، هزینه، مدل‌های استفاده‌شده، نمودار هفتگی و تاریخچهٔ تفصیلی هر فراخوانی.

کیف پول

موجودی دلاری، شارژ آنلاین از درگاه بانکی، و مصرف بر اساس استفادهٔ واقعی.

شروع سریع

شروع کار با چت‌کیوتی

چت‌کیوتی یک API یکپارچه برای دسترسی به ده‌ها مدل هوش مصنوعی از یک endpoint است. با چند خط کد و کلید API از کنسول، می‌توانید از فریم‌ورک یا SDK دلخواه استفاده کنید.

  1. ۱

    ثبت‌نام در کنسول

    حساب بسازید و کیف پول را شارژ کنید.

  2. ۲

    ساخت کلید API

    از بخش «کلیدهای API» یک کلید جدید بسازید.

  3. ۳

    اولین درخواست

    با OpenAI SDK یا REST تست کنید.

استفاده از OpenAI SDK

سازگار با کتابخانهٔ رسمی OpenAI — فقط base_url و api_key را عوض کنید:

Python 
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)

استفاده مستقیم از API

در هر زبان با HTTP — مثال با Python و requests:

Python 
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"])

احراز هویت

آدرس پایه و کلید API

Base URLhttps://api.chatqt.com/api/v1
هدرAuthorization: Bearer YOUR_CHATQT_API_KEY
فرمتJSON · سازگار با OpenAI Chat Completions

کلیدها با پیشوند sk-or-v1- در کنسول نمایش داده می‌شوند. هرگز کلید را در مخزن عمومی commit نکنید؛ از متغیر محیطی استفاده کنید.

قابلیت‌ها

یک API، ده‌ها مدل.

از گفت‌وگو و استریم تا تصویر، ویدئو، صوت و Tool Calls — همه از یک درگاه. جزئیات هر endpoint در کنسول → مستندات.

chat/completions

گفت‌وگو

Chat Completions چندمرحله‌ای، تاریخچهٔ پیام، و پشتیبانی از system / user / assistant.

Streaming

پاسخ توکن‌به‌توکن با stream: true — مناسب رابط چت.

Tool Calls

فراخوانی تابع و ابزار خارجی با رابط استاندارد بین مدل‌ها.

چندرسانه‌ای

ورودی تصویر، صوت و فایل در پیام‌ها — بسته به مدل انتخابی.

پارامترها

temperature، max_tokens، top_p و سایر تنظیمات مدل در بدنهٔ درخواست.

Embeddings و بیشتر

جاسازی متن، TTS، STT و تولید تصویر/ویدئو برای مدل‌های پشتیبانی‌شده.

Streaming

پاسخ جریانی

برای نمایش تدریجی پاسخ در UI، پارامتر stream را فعال کنید. SDK رسمی OpenAI از استریم پشتیبانی می‌کند.

Python 
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="")

Tool Calls

فراخوانی ابزار و تابع

Tool Calling به مدل اجازه می‌دهد ابزارهای خارجی را پیشنهاد دهد. مدل مستقیماً ابزار را اجرا نمی‌کند — شما تابع را صدا می‌زنید و نتیجه را به مکالمه برمی‌گردانید. ChatQT رابط یکسان برای همهٔ مدل‌های پشتیبانی‌شده فراهم می‌کند.

مرحله ۱: درخواست با tools
مرحله ۲: اجرای ابزار
مرحله ۳: ارسال نتیجه
JSON 
{
  "model": "openai/gpt-4o-mini",
  "messages": [
    {"role": "user", "content": "عنوان چند کتاب از جیمز جویس چیست؟"}
  ],
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "search_books",
        "description": "جستجوی کتاب بر اساس نویسنده",
        "parameters": {
          "type": "object",
          "properties": {
            "author": {"type": "string"}
          }
        }
      }
    }
  ]
}

مدل‌ها

شناسهٔ مدل (Model ID)

در فیلد model از شناسهٔ یکتای کنسول استفاده کنید — معمولاً به شکل provider/model-name (مثلاً openai/gpt-4.1، anthropic/claude-sonnet-4.6). فهرست کامل در کنسول → مدل‌ها و در جدول قیمت.

نکته: نام نمایشی مدل (مثلاً «Claude Opus 4.7») با شناسهٔ API یکی نیست — همیشه از کنسول کپی کنید.

آمار و گزارشات

آمار استفاده

در کنسول بخش «آمار استفاده» شامل کارت‌های خلاصه، نمودار مصرف هفتگی و جدول تاریخچهٔ درخواست‌ها (تاریخ، مدل، توکن Context، هزینه) است.

کل درخواست‌ها

—

کل هزینه

$—

مدل‌های استفاده‌شده

—

میانگین هزینه

$—

مالی

کیف پول و شارژ

API بر پایهٔ پرداخت به‌ازای مصرف است. موجودی کیف پول را در کنسول می‌بینید و با درگاه بانکی (پرداخت آنلاین ریالی) شارژ می‌کنید. بدون اشتراک اجباری — فقط برای آنچه مصرف می‌کنید هزینه می‌دهید.

  • •موجودی به دلار نمایش داده می‌شود؛ نرخ تبدیل و پرداخت ریالی در فرایند شارژ.
  • •پس از اتمام اعتبار، درخواست‌های API تا شارژ مجدد متوقف می‌شوند.
  • •جزئیات نرخ هر مدل در صفحه تعرفه‌ها.

مدیریت خطا

خطاهای رایج

401 Unauthorized

کلید API نامعتبر یا منقضی. کلید جدید از کنسول بسازید و هدر Authorization را بررسی کنید.

402 / Insufficient balance

موجودی کیف پول کافی نیست — از بخش کیف پول شارژ کنید.

404 Model not found

شناسهٔ مدل اشتباه است. دقیقاً از فهرست مدل‌های کنسول کپی کنید.

429 Rate limit

تعداد درخواست بیش از حد مجاز — backoff نمایی و retry با تأخیر توصیه می‌شود.

سوالات متداول

پرسش‌های رایج توسعه‌دهندگان

آیا با SDK رسمی OpenAI سازگار است؟
بله. کافی است base_url را به https://api.chatqt.com/api/v1 و api_key را به کلید ChatQT تنظیم کنید.
تفاوت api.chatqt.com/api و /api/v1 چیست؟
برای OpenAI SDK و n8n از /api/v1 استفاده کنید. برخی کلاینت‌ها (مثل Claude CLI) از /api بدون v1 استفاده می‌کنند — راهنمای Claude CLI و راهنمای n8n.
مستندات کامل کجاست؟
نسخهٔ تعاملی و به‌روز در کنسول → مستندات است. این صفحه مرور کلی و شروع سریع است.
آیا نیاز به VPN دارم؟
خیر — API چت‌کیوتی برای دسترسی از ایران بدون VPN طراحی شده است.

آمادهٔ ساخت با API هستید؟

کلید API بگیرید، اولین درخواست را بفرستید و مصرف را در کنسول دنبال کنید.

ورود به کنسول Claude CLI n8n تعرفه‌ها