LogoLogoLogoLogo
سرویس فعال و در دسترس

مستندات API سیتی‌جی‌پی‌تی

از طریق این API می‌توانید به تمام مدل‌های هوش مصنوعی سیتی‌جی‌پی‌تی دسترسی داشته باشید. این سرویس با ساختار OpenAI-compatible طراحی شده و ادغام آن در پروژه‌هایتان بسیار ساده است.

Base URLhttps://citygpt.ir/api/v1
🔑

احراز هویت

تمام درخواست‌ها نیاز به API Key دارند

روش احراز هویت

Authorization: Bearer YOUR_KEY

محل دریافت API Key

پنل کاربری ← API Keys

Rate Limit

۶۰ درخواست در دقیقه

حداقل اعتبار لازم

۱۰ تومان به ازای هر درخواست

🔗

Endpoints

مسیرهای API موجود

POSTارسال پیام، استریم، ابزارها (alias برای /responses)https://citygpt.ir/api/v1/chat/completions
POSTendpoint اصلی — همه قابلیت‌هاhttps://citygpt.ir/api/v1/responses
POSTآپلود فایل (تصویر، PDF، Word، Excel)https://citygpt.ir/api/v1/files

Video Generation (مسیر اختصاصی)

POSTgoogle/veo-3.1-litecitygpt.ir/api/video
POSTgoogle/veo-3.1-fastcitygpt.ir/api/video
POSTkwaivgi/kling-v3.0-stdcitygpt.ir/api/video
POSTkwaivgi/kling-v3.0-procitygpt.ir/api/video
💻

نمونه کد

قابلیت مورد نظر را انتخاب کنید

💬

اتصال ساده

ارسال پیام و دریافت پاسخ

⚡

استریم

پاسخ لحظه به لحظه

📁

آپلود فایل

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

👁️

Vision

تحلیل تصاویر

🎨

تولید تصویر

ساخت عکس با هوش مصنوعی

🎬

تولید ویدئو

ساخت ویدئو با هوش مصنوعی

🐍

Code Interpreter

اجرای کد و خروجی فایل

🔍

جستجو در اسناد

RAG روی فایل‌های شما

🔧

Function Calling

اتصال به توابع خارجی

import requests

response = requests.post(
    "https://citygpt.ir/api/v1/chat/completions",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "model": "gpt-5",
        "messages": [{"role": "user", "content": "سلام، چطوری؟"}]
    }
)
data = response.json()
print(data["text"])
# Response: {"text": "...", "usage": {"input_tokens": 10, "output_tokens": 15, "total_tokens": 25}}

ساختار پاسخ (Response)

{
  "text": "پاسخ مدل هوش مصنوعی اینجا قرار می‌گیرد...",
  "usage": {
    "input_tokens": 25,
    "output_tokens": 120,
    "total_tokens": 145
  }
}
🤖

مدل‌های پشتیبانی شده

از هر کدام می‌توانید در فیلد model استفاده کنید

📌

نکات مهم فنی

🔒
امنیت API Key

هرگز API Key را مستقیم در کد کلاینت قرار ندهید. همیشه از یک لایه سرور (Proxy) استفاده کنید.

💾
ذخیره‌سازی هوشمند فایل

فایل‌های آپلود شده روی سرورهای اختصاصی ما ذخیره می‌شوند. از id برگشتی برای ارجاع در چت استفاده کنید.

📦
ساختار پاسخ

پاسخ‌ها شامل text (متن پاسخ) و usage (مصرف توکن) هستند.

⚡
استریم برای UX بهتر

برای نمایش پاسخ لحظه‌به‌لحظه، پارامتر stream: true را ارسال کنید. پاسخ با فرمت SSE برگشت می‌دهد.

🚦
Rate Limiting

درصورت تجاوز از ۶۰ درخواست در دقیقه، پاسخ ۴۲۹ دریافت می‌کنید. منتظر بمانید و دوباره تلاش کنید.

💳
مدیریت اعتبار

در صورت ناکافی بودن اعتبار (زیر ۱۰ تومان)، پاسخ ۴۰۲ دریافت می‌کنید. از پنل کاربری حساب را شارژ کنید.