احراز هویت

هدر Authorization

هر درخواست به /v1 باید کلید توسعه‌دهنده را در هدر Authorization بفرستد. کلیدها با hvd_ شروع می‌شوند.

curl https://<HOVEYDAI_BASE_URL>/v1/models \  -H "Authorization: Bearer $HOVEYDAI_API_KEY"

کتابخانهٔ رسمی OpenAI همین هدر را از api_key می‌سازد؛ لازم نیست خودتان چیزی اضافه کنید.

خطای احراز هویت

اگر کلید نباشد، نادرست باشد یا منقضی شده باشد، پاسخ 401 با قالب خطای OpenAI برمی‌گردد و error.code یکی از invalid_api_key، token_expired یا session_revoked است. قالب کامل در خطاها آمده است.

نگهداری کلید

• کلید را در متغیر محیطی یا مدیر رازها نگه دارید، نه در مخزن کد و نه در برنامهٔ مرورگر.
• برای هر برنامه کلید جدا بسازید. هم مصرف و هزینهٔ هر برنامه جدا دیده می‌شود و هم اگر کلیدی لو رفت فقط همان را حذف می‌کنید.
• هر درخواست به حساب همان کلید نوشته می‌شود و محدودیت درخواست هم برای هر کلید جدا حساب می‌شود.