📘 مستندات API

هزینه و اعتبار

هزینه بر اساس مجموع توکن ورودی و خروجی از کیف پول شما کم می‌شود. توکن فکرِ مدل داخل توکن خروجی حساب شده و جداگانه هزینه‌ای ندارد. درخواست‌هایی که با خطا تمام شوند رایگان‌اند.

اگر موجودی کافی نباشد، پاسخ با کد 402 و خطای insufficient_credit برمی‌گردد. موجودی را از صفحهٔ کیف پول شارژ کنید.

شروع

1. در صفحهٔ کلیدهای API یک کلید بسازید.
2. آدرس پایه را روی https://www.jadooland.ir/v1 بگذارید.
3. کلید را در هدر Authorization: Bearer sk-alo-… بفرستید.

curl https://www.jadooland.ir/v1/chat/completions \
  -H "Authorization: Bearer sk-alo-YOUR-KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-5.1",
    "messages": [{"role": "user", "content": "سلام!"}],
    "stream": true
  }'

استفاده در Cursor

1. Cursor را باز کنید و به Settings → Models بروید.
2. گزینهٔ Override OpenAI Base URL را روشن کنید.
3. آدرس https://www.jadooland.ir/v1 را وارد کنید.
4. در بخش OpenAI API Key کلید sk-alo-… را بگذارید.
5. یک مدل سفارشی با نام دقیق مدل جادولند اضافه کنید، مثلاً openai/gpt-5.1.
6. روی Verify بزنید.

استفاده در VS Code

با افزونهٔ Continue (یا هر افزونهٔ سازگار با OpenAI). در فایل پیکربندی Continue:

{
  "models": [
    {
      "title": "AlooHoosh",
      "provider": "openai",
      "model": "claude/claude-sonnet-4-5",
      "apiBase": "https://www.jadooland.ir/v1",
      "apiKey": "sk-alo-YOUR-KEY"
    }
  ]
}

چت

POST /v1/chat/completions

پارامترهای پشتیبانی‌شده:

ارسال تصویر

{
  "model": "claude/claude-sonnet-4-5",
  "messages": [{
    "role": "user",
    "content": [
      {"type": "text", "text": "این تصویر چیست؟"},
      {"type": "image_url", "image_url": {"url": "data:image/png;base64,iVBOR..."}}
    ]
  }]
}

متن فکر مدل در فیلد reasoning_content برمی‌گردد؛ کلاینت‌هایی که این فیلد را نمی‌شناسند به‌سادگی نادیده‌اش می‌گیرند.

ساخت تصویر

POST /v1/images/generations

{
  "model": "openai/gpt-image-1",
  "prompt": "یک شهر آینده‌نگر در غروب",
  "size": "1024x1024"
}

پاسخ شامل b64_json است. ساخت ویدیو چون طولانی است فقط از استودیو و API نشست‌محور در دسترس است.

مدل‌های موجود

GET /v1/models

در مجموع 5 مدل فعال است. جدول زیر 5 موردِ اول را نشان می‌دهد؛ فهرست کامل را از اندپوینت بالا بگیرید.

سطح تلاش

شش سطح داریم و هر سطح برای هر سرویس به پارامتر بومی خودش ترجمه می‌شود. اگر کلاینت شما فیلد reasoning_effort ندارد، سطح را به انتهای نام مدل بچسبانید: openai/gpt-5.1:high