رفتن به محتوا
ورودشروع کنید
کسب‌وکار
تعرفه‌ها

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

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

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

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)
۱endpoint برای ده‌ها مدل
۲ خطتغییر برای آمدن از OpenAI SDK
۰اشتراک اجباری؛ پرداخت به‌ازای مصرف

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

از گفت‌وگو تا تصویر، ویدیو و صوت، همه از یک درگاه. مستندات هر endpoint در کنسول است.

گفت‌وگو

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

Streaming

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

Tool Calls

مدل پیشنهاد می‌دهد کدام تابع شما صدا زده شود و اجرا با شماست. یک رابط برای همهٔ مدل‌ها.

چندرسانه‌ای

تصویر، صوت و فایل را در پیام بفرستید؛ روی مدل‌هایی که از آن پشتیبانی می‌کنند.

Embeddings و بیشتر

جاسازی متن، تبدیل متن به گفتار و گفتار به متن، و ساخت تصویر و ویدیو در مدل‌های پشتیبانی‌شده.

مصرف و کیف پول

تعداد درخواست، هزینه، مدل‌ها و نمودار هفتگی. کیف پول دلاری را شارژ کنید و به‌ازای مصرف بپردازید.

اولین درخواست در سه قدم.

1

حساب بسازید

در کنسول ثبت‌نام کنید و کیف پول را شارژ کنید.

2

کلید API بسازید

از بخش «کلیدهای API» کلید تازه بسازید. برای محیط توسعه و تولید کلید جدا داشته باشید.

Authorization: Bearer YOUR_CHATQT_API_KEY
3

درخواست بفرستید

OpenAI SDK را به ChatQT وصل کنید، یا endpoint REST را از هر زبانی صدا بزنید.

pip install openai

همان SDK. آدرس تازه.

فقط base_url و api_key را عوض کنید. بقیهٔ کد همان می‌ماند.

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

جزئیات اتصال

کلید را در متغیر محیطی نگه دارید و هرگز در مخزن عمومی commit نکنید.

تنظیممقدار
Base URLhttps://api.chatqt.com/api/v1
هدرAuthorization: Bearer YOUR_CHATQT_API_KEY
فرمتJSON · سازگار با OpenAI Chat Completions
پیشوند کلیدsk-or-v1-
شناسهٔ مدلprovider/model-name، کپی‌شده از کنسول
مسیر Claude CLIhttps://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
شروع کنید