Kubit logoکوبیت

هوش مصنوعی (AI)

معرفی

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


قابلیت‌ها

1. LLM به عنوان خدمت

  • ارائه APIی ابری برای استفاده سریع و آسان
  • سازگاری کامل با کلاینت‌های مرسوم OpenAI
  • مقیاس‌پذیری بالا برای استفاده در پروژه‌های کوچک تا سازمان‌های بزرگ
  • امکان سوییچ سریع و راحت بین مدل‌ها، Providerها و Endpointها با کمترین تغییرات
  • پشتیبانی از انواع مدل‌ها از جمله مدل‌های زبانی، مدل‌های تصویرسازی و مدل‌های چندرسانه‌ای

AI: Models

2. چت با مدل‌های هوش مصنوعی

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

AI: Chat

3. دستیار هوش مصنوعی شخصی

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

AI: Knowledge Base


راهنمای استفاده از API

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

AI: API Keys

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

AI: Create new API key

از کلید ساخته شده و endpoint داده شده، می‌توانید در انواع برنامه‌ها و سرویس‌های ساخت خودتان، مانند Chat Botها، AI Assistantها، AI Agentها، استفاده کنید و به راحتی توانایی‌های منحصر به فرد بهترین مدل‌های هوش مصنوعی را به آن‌ها بیفزایید. هم‌چنین، خواهید توانست با کمترین میزان تغییر در کدهای خود از به‌روزرسانی‌های آینده‌ی این صنعت بهره‌مند شوید.

احراز هویت

تمامی درخواست‌ها باید شامل header زیر باشند:

Authorization: Bearer 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": "یک تابع پایتون بنویس که رشته ورودی را معکوس کند."}
    ]
  }'

اتصال ابزارهای کدنویسی

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

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": "می‌تونی بهم بگی خدمات کوبیت چیه؟"
    ]
  }'

مزایا

  • کاهش زمان توسعه و هزینه‌های زیرساختی
  • دسترسی به آخرین مدل‌ها بدون دغدغه بروزرسانی
  • مناسب برای تیم‌های توسعه، استارتاپ‌ها و شرکت‌های مقیاس‌پذیر
  • سوییچ سریع و راحت بین مدل‌ها
  • امنیت و حفظ حریم خصوصی داده‌ها
  • ایجاد پایگاه دانش اختصاصی برای پاسخ‌دهی بهتر
  • پشتیبانی فنی و مشاوره تخصصی
هوش مصنوعی (AI) | مستندات | کوبیت