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

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

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

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

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

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

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

از کلید ساخته شده و 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"
    }
  ]
}

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
  }
}

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

برای دسته‌بندی متن و انتخاب یک پاسخ مشخص، از مسیر https://ai.kubit.cloud/api/v1/decisions استفاده کنید. این مسیر قرارداد OpenAI Decisions را می‌پذیرد: ورودی در input و پرسش‌ها در آرایهٔ questions قرار می‌گیرند. نوع پرسش می‌تواند predicate برای سنجش درستی یک گزاره، choice برای انتخاب گزینه یا score برای امتیازدهی باشد. مدل انتخابی باید از تصمیم‌گیری پشتیبانی کند؛ شناسهٔ آن را از فهرست مدل‌ها در https://ai.kubit.cloud/api/v1/models بردارید.

در مثال زیر، مدل باید اولویت یک درخواست پشتیبانی را از بین دو گزینهٔ urgent و normal انتخاب کند. مقدار value شناسهٔ گزینه در پاسخ است و description معیار انتخاب آن را توضیح می‌دهد. به‌جای YOUR_API_KEY کلید API کوبیت خود را قرار دهید:

curl -i -sS https://ai.kubit.cloud/api/v1/decisions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-6-luna-decisions",
    "input": "I cannot sign in and my entire team is unable to work. We have no workaround.",
    "questions": [{
      "type": "choice",
      "name": "priority",
      "instructions": "Classify the support request by its impact on the customer.",
      "choices": [
        {"value": "urgent", "description": "Work is blocked and no workaround is available."},
        {"value": "normal", "description": "Work can continue or a workaround is available."}
      ]
    }]
  }'

پاسخ‌ها در آرایهٔ answers و به ترتیب پرسش‌ها برمی‌گردند. برای این مثال، بخش answers می‌تواند چنین باشد؛ choice گزینهٔ انتخاب‌شده، confidence میزان اطمینان و probabilities احتمال هر گزینه را نشان می‌دهد. اعداد نمونه‌اند و ممکن است در هر اجرا تغییر کنند:

{
  "answers": [
    {
      "type": "choice",
      "name": "priority",
      "choice": "urgent",
      "confidence": 0.96,
      "probabilities": [
        {"value": "urgent", "probability": 0.96},
        {"value": "normal", "probability": 0.04}
      ]
    }
  ]
}

برای کلاینت‌هایی که از قرارداد System One، مانند TypeSafe و مدل‌های تصمیم‌گیری Microsoft، استفاده می‌کنند، مسیر https://ai.kubit.cloud/api/v1/systemone در دسترس است. در این قرارداد ورودی در state قرار می‌گیرد، پرسش‌ها یک آبجکت با کلیدهای دلخواه هستند و گزینه‌های پرسش choice در criteria تعریف می‌شوند. نوع‌های noul برای سنجش درستی یک گزاره و score برای امتیازدهی نیز پشتیبانی می‌شوند.

مثال زیر همان مدل و همان دو گزینهٔ بخش OpenAI Decisions را با قالب System One فراخوانی می‌کند. نام قرارداد، مدل را به شرکت سازندهٔ آن محدود نمی‌کند؛ مدل باید از این نوع درخواست پشتیبانی کند:

curl -i -sS https://ai.kubit.cloud/api/v1/systemone \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-6-luna-decisions",
    "state": "I cannot sign in and my entire team is unable to work. We have no workaround.",
    "questions": {
      "priority": {
        "type": "choice",
        "instructions": "Classify the support request by its impact on the customer.",
        "criteria": {
          "urgent": "Work is blocked and no workaround is available.",
          "normal": "Work can continue or a workaround is available."
        }
      }
    }
  }'

پاسخ‌ها با همان کلید پرسش‌ها برمی‌گردند؛ در این مثال نتیجه در answers.priority.choice قرار می‌گیرد. بخش answers می‌تواند به شکل زیر باشد. در این قرارداد، confidence و probabilities اختیاری‌اند و ممکن است ارائه‌دهنده آن‌ها را برنگرداند:

{
  "answers": {
    "priority": {
      "type": "choice",
      "choice": "urgent",
      "confidence": 0.96,
      "probabilities": {"urgent": 0.96, "normal": 0.04}
    }
  }
}

اگر کلاینت مسیر v1/systemone را خودش اضافه می‌کند، نشانی پایه را https://ai.kubit.cloud/api تنظیم کنید. برای کلاینتی که فقط systemone را اضافه می‌کند، نشانی پایه https://ai.kubit.cloud/api/v1 است.

فایل ~/.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 به‌جای سرورهای 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": "می‌تونی بهم بگی خدمات کوبیت چیه؟"
    ]
  }'

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