API چراغ برای برنامه‌نویس‌ها: یک کلید برای همه‌ی مدل‌ها

API چراغ به برنامه‌نویس یک کلید می‌دهد که با آن به همه‌ی مدل‌های چت، عکس و ویدیوی چراغ وصل می‌شود؛ بخش چت کاملاً سازگار با OpenAI است، یعنی کتابخانه‌ی رسمی OpenAI را برمی‌داری و فقط آدرس پایه را عوض می‌کنی. هزینه‌ی هر درخواست به تومان از اعتبار حسابت کم می‌شود و هیچ اشتراک یا کارت ارزی لازم نیست. این مقاله می‌گوید API چراغ چه چیزهایی دارد، چطور در پنج دقیقه اولین درخواست را بفرستی و برای چه پروژه‌هایی به‌صرفه است.

چرا API چراغ به درد برنامه‌نویس ایرانی می‌خورد؟

ساختن یک محصول روی هوش مصنوعی در ایران سه مانع دارد: پرداخت ارزی برای هر سازنده‌ی مدل، نگهداری چند کلید و چند کتابخانه، و قطع‌شدن سرویس وقتی یکی از آن‌ها دسترسی را می‌بندد. API چراغ هر سه را یک‌جا جواب می‌دهد:

• یک کلید، همه‌ی مدل‌ها: GPT-6، Claude 5.5، Gemini 3، Grok 4.7، DeepSeek، Nano Banana، FLUX، Kling، Veo و بقیه پشت یک آدرس.
• سازگار با OpenAI: اگر کدت با کتابخانه‌ی OpenAI نوشته شده، با عوض‌کردن یک خط به چراغ وصل می‌شود.
• پرداخت تومانی به ازای مصرف: هر درخواست به اندازه‌ی خودش از اعتبار کم می‌کند؛ اعتبار هم منقضی نمی‌شود.
• نام مستعار auto: به‌جای شناسه‌ی دقیق، auto را بفرست تا چراغ بهترین مدل همان نوع کار را انتخاب کند؛ openai-latest هم همیشه تازه‌ترین مدل پرچم‌دار OpenAI است.

شروع در پنج دقیقه

1. وارد چراغ شو و به صفحه‌ی API برو. هر حساب یک کلید پیش‌فرض دارد (شکلش cq_live_… است)؛ می‌توانی کلیدهای بیشتری بسازی تا مصرف هر پروژه جدا دیده شود.
2. آدرس پایه را یادداشت کن: https://cheraq.ai/api/v1
3. اولین درخواست را بفرست:

curl https://cheraq.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $CHERAQ_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "auto", "messages": [{"role": "user", "content": "یک شعار کوتاه برای کافه بنویس"}]}'

همین. جواب دقیقاً با همان ساختار OpenAI برمی‌گردد.

Python با کتابخانه‌ی رسمی OpenAI

from openai import OpenAI

client = OpenAI(api_key="cq_live_…", base_url="https://cheraq.ai/api/v1")
r = client.chat.completions.create(
    model="anthropic/claude-sonnet-5.5",
    messages=[{"role": "user", "content": "سه ایده‌ی پست اینستاگرام برای فروشگاه کفش"}],
)
print(r.choices[0].message.content)

JavaScript / Node با استریم

import OpenAI from "openai";

const client = new OpenAI({ apiKey: process.env.CHERAQ_KEY, baseURL: "https://cheraq.ai/api/v1" });
const stream = await client.chat.completions.create({
  model: "auto",
  messages: [{ role: "user", content: "یک متن کوتاه برای استوری تخفیف پاییزی" }],
  stream: true,
});
for await (const chunk of stream) process.stdout.write(chunk.choices[0]?.delta?.content ?? "");

چه چیزهایی در API هست؟

شناسه‌ی مدل‌ها به شکل سازنده/نام است، مثل openai/gpt-6.1-sol، anthropic/claude-sonnet-5.5 یا google/gemini-3.1-pro-preview. فهرست کامل و به‌روز را از همان GET /models بگیر یا در صفحه‌ی مدل‌ها و قیمت‌ها ببین.

احراز هویت، محدودیت‌ها و امنیت

• کلید را در سرآیند Authorization: Bearer cq_live_… بفرست. اگر هاست یا پراکسی این سرآیند را حذف می‌کند، همان کلید را در X-Api-Key هم می‌توانی بگذاری.
• هر کلید ۱۲۰ درخواست در دقیقه دارد.
• کلید را فقط سمت سرور نگه دار؛ هر کس کلید را داشته باشد از اعتبار تو خرج می‌کند. در صفحه‌ی API مصرف هر کلید را می‌بینی و می‌توانی باطلش کنی؛ کلید پیش‌فرض را هم می‌شود با یک کلید تازه عوض کرد.
• اگر هاست‌ات به cheraq.ai (پشت کلودفلر) وصل نمی‌شود، آدرس مستقیم direct.cheraq.ai برای API و MCP هست.

هزینه چطور حساب می‌شود؟

هر درخواست بر اساس مدل و حجم کار (کلمه‌های ورودی و خروجی برای چت، تعداد عکس، ثانیه‌ی ویدیو) به اعتبار قیمت می‌خورد و از همان حساب کم می‌شود؛ GET /models هزینه‌ی تقریبی هر مدل را برمی‌گرداند. برای این‌که حسی از اعداد داشته باشی (تا ۱۹ مهر ۱۴۰۵): هر ۱٬۰۰۰ کلمه جواب با GPT-6 Luna حدود ۰٫۱۳ اعتبار، با Claude Sonnet 5.5 حدود ۲٫۶ اعتبار و با Claude Opus 5.5 حدود ۵٫۲ اعتبار است؛ یک عکس با GPT Image 2.5 Flare حدود ۷٫۸ اعتبار. هر اعتبار با نرخ امروز حدود ۲٬۶۰۰ تومان است.

چند سناریوی واقعی

• چت‌بات پشتیبانی روی سایت یا تلگرام: یک مدل اقتصادی برای جواب‌های سریع و یک مدل قوی‌تر برای سؤال‌های سخت؛ همه با یک کلید و یک کتابخانه.
• تولید انبوه توضیح محصول: اسکریپتی که روی فهرست محصولات حلقه می‌زند و برای هر کدام متن و یک عکس می‌سازد.
• ابزار داخلی شرکت: خلاصه‌کردن گزارش‌ها و قراردادهای بلند با Gemini 3.1 Pro یا GPT-6.1 Sol که برای اسناد حجیم ساخته شده‌اند.
• اتوماسیون بدون کد: n8n یا هر ابزاری که با OpenAI کار می‌کند، با عوض‌کردن آدرس پایه به چراغ وصل می‌شود.

اگر به‌جای کدنویسی می‌خواهی دستیار هوش مصنوعی‌ات (Claude، ChatGPT، Cursor) مستقیم از ابزارهای چراغ استفاده کند، MCP چراغ را ببین. برای تیم‌های فنی، حساب سازمانی یک کیف پول مشترک با گزارش مصرف می‌دهد و در برنامه‌ی همکاری در فروش مصرف API مشتری‌هایی که معرفی کرده‌ای هم سهم دارد.

سؤال‌های رایج

API چراغ با API خود OpenAI چه فرقی دارد؟

ساختار درخواست و پاسخ در بخش چت یکی است؛ فرقش این است که با همان کد به مدل‌های ده‌ها سازنده‌ی دیگر هم دسترسی داری و پرداخت تومانی و به ازای مصرف است.

آیا استریم پشتیبانی می‌شود؟

بله. stream: true مثل OpenAI کار می‌کند و جواب تکه‌تکه می‌آید.

برای ساخت عکس و ویدیو هم همان کلید کافی است؟

بله. مسیرهای /images و /videos با همان کلید کار می‌کنند و نتیجه را از /jobs و /assets می‌گیری.

محدودیت تعداد درخواست چقدر است؟

۱۲۰ درخواست در دقیقه برای هر کلید. برای مصرف بیشتر، از صفحه‌ی اشتراک سازمانی درخواست بده.

مستندات کامل کجاست؟

در cheraq.ai/docs با نمونه‌کد cURL، Python و JavaScript، فهرست خطاها و بخش MCP.