هوش مصنوعی (AI)
معرفی
سرویس هوش مصنوعی یک بستر ابری و مقیاسپذیر برای دسترسی به مدلهای هوش مصنوعی پیشرفته است. این سرویس به توسعهدهندگان، صاحبان کسبوکار و استارتاپها کمک میکند بدون نیاز به زیرساخت پیچیده، بهسادگی از قدرت مدلهای زبانی بزرگ (LLM) استفاده کنند. با استفاده از این سرویس، میتوانید به راحتی مدلهای مختلف را تست کنید، با آنها چت کنید و حتی دستیارهای هوشمند شخصیسازی شده بسازید که بر اساس پایگاه دانش اختصاصی شما پاسخ میدهند. این سرویس با ارائه APIی سازگار با استانداردهای OpenAI، امکان ادغام سریع و آسان در برنامهها و سیستمهای مختلف را فراهم میکند.
قابلیتها
1. LLM به عنوان خدمت
- ارائه APIی ابری برای استفاده سریع و آسان
- سازگاری کامل با کلاینتهای مرسوم OpenAI
- مقیاسپذیری بالا برای استفاده در پروژههای کوچک تا سازمانهای بزرگ
- امکان سوییچ سریع و راحت بین مدلها، Providerها و Endpointها با کمترین تغییرات
- پشتیبانی از انواع مدلها از جمله مدلهای زبانی، مدلهای تصویرسازی و مدلهای چندرسانهای

2. چت با مدلهای هوش مصنوعی
- رابط کاربری یکپارچه برای تست و گفتوگو با مدلها
- ارزیابی و مقایسه مدلها در یک محیط ساده و کاربرپسند
- دسترسی به بیش از ۸۰ مدل برتر از معتبرترین ارائهدهندگان جهانی

3. دستیار هوش مصنوعی شخصی
- ساخت دستیارهای هوشمند با قابلیتهای متنوع
- پاسخدهی بر اساس پایگاه دانش اختصاصی شما
- ادغام با سیستمها و سرویسهای مختلف برای افزایش بهرهوری
- پشتیبانی از سناریوهای مختلف مانند پشتیبانی مشتری، تولید محتوا و تحلیل داده

راهنمای استفاده از API
برای دریافت کلید API به صفحهی «کلیدهای API» بروید و بر روی دکمهی ساخت کلید API جدید کلیک کنید:

سپس در پنجرهی باز شده، یک نام اختیاری برای کلید خود انتخاب کنید و دکمهی ساخت کلید API جدید را بزنید. کلید شما آماده است:

از کلید ساخته شده و endpoint داده شده، میتوانید در انواع برنامهها و سرویسهای ساخت خودتان، مانند Chat Botها، AI Assistantها، AI Agentها، استفاده کنید و به راحتی تواناییهای منحصر به فرد بهترین مدلهای هوش مصنوعی را به آنها بیفزایید. همچنین، خواهید توانست با کمترین میزان تغییر در کدهای خود از بهروزرسانیهای آیندهی این صنعت بهرهمند شوید.
احراز هویت
تمامی درخواستها باید شامل header زیر باشند:
Authorization: Bearer YOUR_API_KEY
به جای YOUR_API_KEY همان کلیدی را که در گام پیشین ساختید، قرار دهید.
ارسال پیام به مدل
curl https://ai.kubit.cloud/api/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "openai/gpt-5",
"messages": [
{"role": "system", "content": "You are a helpful assistant"},
{"role": "user", "content": "سلام! میشه یک داستان کوتاه بگی؟"}
]
}'
پاسخ نمونه:
{
"id": "chatcmpl-12345",
"object": "chat.completion",
"created": 1758730329,
"model": "openai/gpt-5",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "روزی روزگاری..."
},
"finish_reason": "stop"
}
]
}
مدلهای Embedding
curl https://ai.kubit.cloud/api/v1/embeddings \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "openai/text-embedding-3-small",
"input": ["متن نمونه برای تولید بردارهای جاسازی شده", "متن دوم برای تولید بردارهای جاسازی شده"]
}'
پاسخ نمونه:
{
"object": "list",
"data": [
{
"object": "embedding",
"embedding": [0.123, 0.456, ...],
"index": 0
},
{
"object": "embedding",
"embedding": [0.789, 0.012, ...],
"index": 1
}
],
"model": "openai/text-embedding-3-small",
"usage": {
"prompt_tokens": 10,
"total_tokens": 10
}
}
قرارداد OpenAI Responses
علاوه بر chat/completions، سرویس از قرارداد OpenAI Responses نیز پشتیبانی میکند. این قرارداد در ابزارهایی که بهصورت بومی با Responses API صحبت میکنند (مانند Codex) استفاده میشود:
curl https://ai.kubit.cloud/api/v1/responses \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "google/gemini-2.5-flash",
"input": "یک تابع پایتون بنویس که رشته ورودی را معکوس کند."
}'
قرارداد Anthropic Messages
سرویس همچنین از قرارداد Anthropic Messages پشتیبانی میکند تا ابزارهایی که بهصورت بومی با Messages API صحبت میکنند (مانند Claude Code) بتوانند بدون تغییر کد به آن متصل شوند. در این قرارداد کلید میتواند در هدر x-api-key نیز ارسال شود:
curl https://ai.kubit.cloud/api/v1/messages \
-H "x-api-key: YOUR_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "openai/gpt-5",
"max_tokens": 1024,
"messages": [
{"role": "user", "content": "یک تابع پایتون بنویس که رشته ورودی را معکوس کند."}
]
}'
مدلی که در model انتخاب میکنید از کاتالوگ کوبیت خوانده میشود و لزوماً به شرکت سازندهی همان قرارداد محدود نیست؛ برای مثال میتوانید یک مدل Gemini را از طریق /responses یا یک مدل GPT را از طریق /messages فراخوانی کنید.
اتصال ابزارهای کدنویسی
Codex
فایل ~/.codex/config.toml را با محتوای زیر بسازید (یا به آن اضافه کنید):
model_provider = "kubit"
model = "google/gemini-2.5-flash"
[model_providers.kubit]
name = "kubit"
base_url = "https://ai.kubit.cloud/api/v1"
[model_providers.kubit.auth]
command = "sh"
args = ["-c", "echo $KUBIT_API_KEY"]
سپس کلید خود را در متغیر محیطی قرار دهید و Codex را اجرا کنید:
export KUBIT_API_KEY="YOUR_API_KEY"
codex
مقدار base_url را تا /api/v1 بنویسید؛ خودِ Codex مسیر /responses را به انتهای آن اضافه میکند.
Claude Code
کافی است متغیرهای محیطی زیر را تنظیم کنید تا Claude Code بهجای سرورهای Anthropic به کوبیت متصل شود:
export ANTHROPIC_BASE_URL="https://ai.kubit.cloud/api"
export ANTHROPIC_API_KEY="YOUR_API_KEY"
export ANTHROPIC_MODEL="openai/gpt-5"
claude
استفاده از پایگاه دانش اختصاصی
برای استفاده از پایگاه دانش اختصاصی خود، ابتدا باید یک پایگاه دانش بسازید و محتوای مورد نظر خود را در آن بارگذاری کنید. سپس میتوانید UUID پایگاه دانش خود را در درخواست API قرار دهید تا مدل بتواند بر اساس آن پاسخ دهد.
curl https://ai.kubit.cloud/api/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "openai/gpt-5",
"knowledge_base_uuid": "your_knowledge_base_uuid",
"messages": [
{"role": "user", "content": "میتونی بهم بگی خدمات کوبیت چیه؟"
]
}'
مزایا
- کاهش زمان توسعه و هزینههای زیرساختی
- دسترسی به آخرین مدلها بدون دغدغه بروزرسانی
- مناسب برای تیمهای توسعه، استارتاپها و شرکتهای مقیاسپذیر
- سوییچ سریع و راحت بین مدلها
- امنیت و حفظ حریم خصوصی دادهها
- ایجاد پایگاه دانش اختصاصی برای پاسخدهی بهتر
- پشتیبانی فنی و مشاوره تخصصی