embeddinggemma-2 API

مدل embeddinggemma-2 چیست؟

برای استفاده از embeddinggemma-2 در سرورنت، شناسهٔ عمومی di-googleembeddinggemma-2-39b44716f6 را ارسال کنید. درگاه با این شناسه مسیر تنظیم‌شده را انتخاب می‌کند؛ سازندهٔ مدل google است.

برای embeddinggemma-2، اندازهٔ دقیق مدل را روی کار خودتان بسنجید. قابلیت چندرسانه‌ای خانواده، ورودی رسانه را در مسیر متنی درگاه فعال نمی‌کند.

کاربردهای embeddinggemma-2

• قطعه‌های اسناد را با embeddinggemma-2 برای جستجوی معنایی نمایه‌سازی کنید.
• عبارت جستجو را با همان مدل embeddinggemma-2 که نمایه را ساخته است به بردار تبدیل کنید.
• کیفیت بازیابی را پیش از ترکیب نتیجه با مدل تولید متن بسنجید.

طراحی اتصال به مدل

یک رشته یا فهرست رشته‌ها را به /v1/embeddings بفرستید و بردارها را در نمایهٔ جستجو ذخیره کنید. هنگام تغییر مدل، نمایه را بازسازی و ابعاد بردار را بررسی کنید؛ بردارهای ناسازگار را مخلوط نکنید.

ورودی‌ها و محدودیت‌های سرویس

مسیر، متن ساده و دسته‌های حداکثر ۱۲۸ متنی را می‌پذیرد. آرایهٔ شناسهٔ توکن، ورودی رسانه و قالب خروجی پشتیبانی‌نشده رد می‌شوند. اندازهٔ قطعه‌ها را متناسب با حد ورودی تنظیم‌شدهٔ مدل انتخاب کنید.

نمونهٔ محاسبهٔ هزینهٔ درخواست

برای 1,000 توکن ورودی و 0 توکن خروجی، بدون تخفیف کش. این عدد برآورد کاتالوگ است و هزینهٔ ثابت هر درخواست نیست. مصرف گزارش‌شده و قیمت تثبیت‌شدهٔ درخواست، مبلغ مصرف را تعیین می‌کنند.

برآورد مبلغ مصرف، تومان

7

اتصال به API مدل embeddinggemma-2

مجوز ai:embedding را روی کلید و ai:models:read را برای بررسی موجودی فعال کنید. SERVERNET_API_KEY را در محیط سرور نگه دارید. برای هر درخواست تازه، کلید تکرارناپذیری را عوض کنید؛ فقط هنگام تکرار همان درخواست، آن را ثابت نگه دارید.

curl https://servernet.cloud/v1/embeddings \
  -H "Authorization: Bearer $SERVERNET_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: CHANGE_FOR_EACH_NEW_REQUEST' \
  -d '{
    "model": "di-googleembeddinggemma-2-39b44716f6",
    "input": [
        "Hello world",
        "Search documents"
    ]
}'

برای تلاش مجدد همان درخواست، Idempotency-Key ثابت بفرستید. پاسخ موفق تا ۲۴ ساعت بدون کسر دوباره بازپخش می‌شود. با x-should-retry:false درخواست را خودکار تکرار نکنید. کلید فقط یک بار نمایش داده می‌شود. آن را در متغیر محیطی سرور نگه دارید و در کد مرورگر، گیت‌هاب یا لاگ قرار ندهید.

مقایسه با مدل‌های همین کاربرد