API هوش مصنوعی

اتصال به برنامه‌ها

سیستم‌عامل و برنامه‌تان را انتخاب کنید؛ راهنمای قدم‌به‌قدم با کلید و مدل خودتان آماده می‌شود.

۱ سیستم‌عامل

Windows
ویندوز ۱۰ و ۱۱
macOS
مک
Linux
اوبونتو، فدورا و…
Android
گوشی و تبلت اندروید

۲ برنامه

RikkaHub
پیشنهاد ما — رایگان و متن‌باز
ChatterUI
رایگان و متن‌باز، نصب از GitHub
Layla
از Google Play

کلید فقط در مرورگر شما جایگزین می‌شود و جایی ارسال نمی‌شود.

وارد شوید تا بتوانید همین‌جا کلید بسازید.

ضریب مصرف هر مدل در صفحه‌ی مدل‌ها آمده است.

راهنمای اتصال Layla

Android · ۵ قدم
  1. ۱

    انتخاب یا ساخت کلید API

    از بالای همین صفحه کلید کامل خود را بچسبانید یا با دکمه‌ی «ساخت کلید جدید برای این برنامه» یک کلید تازه بسازید؛ کدهای این راهنما خودکار با کلید و مدل انتخابی شما پر می‌شوند.

    کلید کامل فقط یک بار، هنگام ساخت، نمایش داده می‌شود. آن را در جای امنی نگه دارید و در گروه‌ها یا اسکرین‌شات‌ها منتشر نکنید.

  2. ۲

    نصب Layla

    Layla را از Google Play (یا App Store روی آیفون) نصب کنید.

    این راهنما هنوز روی دستگاه تست نشده (Layla فایل نصب مستقیم ندارد و فقط از فروشگاه نصب می‌شود). اگر جایی با برنامه‌ی شما فرق داشت، به پشتیبانی خبر بدهید.

  3. ۳

    افزودن مدل سفارشی

    این مسیر را باز کنید: Settings ← Inference Settings ← My Models ← Add Custom Model ← Connected Services ← OpenAI API.

  4. ۴

    وارد کردن آدرس و کلید

    Name
    2928
    Endpoint
    https://api.2928.ir/v1/chat/completions
    API key
    sk-...

    Endpoint باید آدرس کامل باشد؛ فقط https://api.2928.ir/v1 کار نمی‌کند. کلید را بدون کلمه‌ی «Bearer» وارد کنید؛ Layla خودش اضافه می‌کند.

  5. ۵

    انتخاب مدل و ذخیره

    دکمه‌ی Find models را بزنید تا فهرست مدل‌ها از سرور ما گرفته شود و claude-sonnet-5 را انتخاب کنید (یا نامش را دستی بنویسید). در صورت نیاز تنظیمات اضافه در Advanced request settings ← Extra JSON است. در آخر Save changes را بزنید.

خطاهای رایج

401 (Unauthorized)
کلید اشتباه است، ناقص چسبانده شده، یا کلمه‌ی «Bearer» را خودتان جلوی کلید نوشته‌اید (برنامه خودش اضافه می‌کند). فقط خود کلید sk-... را وارد کنید.
403 (اعتبار تمام شده)
اعتبار حساب تمام یا منقضی شده است. از صفحه‌ی «خرید اعتبار» بسته بخرید یا تمدید کنید.
503 — model_not_found
نام مدل اشتباه است. نام را دقیقاً از صفحه‌ی «مدل‌ها» کپی کنید.
404 یا «اتصال ناموفق»
این برنامه آدرس کامل می‌خواهد: https://api.2928.ir/v1/chat/completions. اگر فقط https://api.2928.ir/v1 یا آدرس بدون /v1 بنویسید، درخواست به جای درست نمی‌رسد.
پاسخ دیر شروع می‌شود
مدل‌های بزرگ (Opus، GPT-6 و Sol) گاهی چند ثانیه تا ده‌ها ثانیه قبل از شروع پاسخ فکر می‌کنند؛ برای کارهای سریع از Sonnet یا Haiku استفاده کنید. وضعیت لحظه‌ای مدل‌ها در صفحه‌ی «وضعیت سرویس» است.
کمک لازم دارید؟

بگویید در کدام قدم ماندید و متن خطا را بفرستید.

تماس با پشتیبانی