API هوش مصنوعی

کلید API

برای ساخت کلید باید وارد حسابت شوی. اعتبار همان اعتبار توکن چت‌بات است.

آدرس و مدل‌ها

• Base URL: https://codebezan.com/ai-api/v1
• codebezan-coding — مناسب کدنویسی (Hermes / Continue / Cline)
• codebezan-general — مناسب اپ و کارهای عمومی
• احراز هویت: Authorization: Bearer sk-cbz-...

درخواست‌ها از اعتبار توکن حساب کم می‌شوند. اگر اعتبار تمام شود پاسخ 429 با کد insufficient_quota برمی‌گردد.

نقطه‌های سازگار با OpenAI

• GET /ai-api/v1/models
• GET /ai-api/v1/models/codebezan-coding
• GET /ai-api/v1/models/codebezan-general
• POST /ai-api/v1/chat/completions با پاسخ معمولی و استریم SSE

پیام‌های system، user، assistant، tool و developer پذیرفته می‌شوند. API کدبزن از فیلدهای tools و tool_choice پشتیبانی می‌کند تا ایجنت بتواند ابزار صدا بزند.

curl

curl https://codebezan.com/ai-api/v1/chat/completions \
  -H "Authorization: Bearer sk-cbz-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "codebezan-coding",
    "messages": [{"role": "user", "content": "یک تابع فیبوناچی در پایتون بنویس"}]
  }'

Python

from openai import OpenAI

client = OpenAI(
    api_key="sk-cbz-YOUR_KEY",
    base_url="https://codebezan.com/ai-api/v1",
)
reply = client.chat.completions.create(
    model="codebezan-coding",
    messages=[{"role": "user", "content": "سلام"}],
)
print(reply.choices[0].message.content)

اتصال ایجنت Hermes

Hermes هر سرور سازگار با OpenAI را می‌پذیرد. آدرس باید خود /ai-api/v1 را شامل باشد، چون Hermes مسیر /chat/completions را به انتهای آن اضافه می‌کند و درخواست به /ai-api/v1/chat/completions می‌رود. برای کدنویسی مدل codebezan-coding را بگذار.

1. از همین صفحه یک کلید بساز.
2. در ترمینال hermes model را اجرا کن.
3. گزینه Custom endpoint را انتخاب کن.
4. Base URL را https://codebezan.com/ai-api/v1 بگذار.
5. API key را همان کلید sk-cbz-... بگذار.
6. نام مدل را دقیقاً codebezan-coding بنویس.

یا همین بلوک را در ~/.hermes/config.yaml قرار بده:

model:
  default: codebezan-coding
  provider: custom
  base_url: https://codebezan.com/ai-api/v1
  api_key: sk-cbz-YOUR_KEY

بعد از ذخیره، hermes را اجرا کن. فراخوانی ابزار با tools و پاسخ استریم در API کدبزن پشتیبانی می‌شود.

بقیه کلاینت‌های سازگار — Continue، Cline، Open WebUI، یا هر SDK اوپن‌ای‌آی — با همین Base URL، کلید و نام مدل کار می‌کنند. برای اپ‌های عمومی از codebezan-general استفاده کن.