پرش به محتوا
همه مستندات

شروع

کلیدها و سقف‌های روزانه

کلید متعلق به حساب nokeep توست و اعتباری را خرج می‌کند که خریده‌ای. برای هر اپ کلید و سقف روزانهٔ جدا بگذار، تا اگر یک کلید لو رفت، فقط تا همان سقف خرج کند.

بررسی‌شده در ۴ آبان ۱۴۰۵

ساختن کلید

  1. کنسول را باز کن. اگر در این مرورگر حسابی نداری، ابتدا اعتبار بخر، از ۵ دلار؛ خریدن اعتبار حساب را می‌سازد.
  2. روی New key بزن. آن را به اسم اپی که برایش است نامگذاری کن.
  3. اگر می‌خواهی، سقف روزانه را به دلار تعیین کن، از ۰٫۱۰ تا ۱٬۰۰۰٫۰۰ دلار. اگر خالی بگذاری، کلید سقف روزانه ندارد و موجودی حساب تنها محدودیتش است.
  4. تأیید کن که ۱۸ سال یا بیشتر داری، و روی Create key بزن.
  5. کلید را کپی کن. فقط یک‌بار نشان داده می‌شود.

ما اثرانگشت کلید (SHA-256 آن) را نگه می‌داریم، نه خود کلید، پس کلیدی که گم شود دوباره نشان داده نمی‌شود. آن را ابطال کن و یکی دیگر بساز.

ارسال کلید

کلید را در هر درخواست به‌صورت bearer token بفرست: Authorization: Bearer sk-nokeep-…. SDKهای OpenAI وقتی api_key را بدهی این کار را برایت انجام می‌دهند.

کلیدها را روی سرور یا در فیلد کلید اپ نگه دار. کلیدی که در یک صفحهٔ وب عمومی باشد، برای هر کسی که صفحه را باز کند قابل کپی است.

سقف‌های روزانه

هر کلید سقف جدای خودش را برای هزینهٔ یک روز دارد، به دلار. سقف‌ها ساعت ۰۰:۰۰ UTC بازنشانی می‌شوند.

پیش از اجرای هر تماس، بیشترین هزینهٔ ممکنش رزرو می‌شود. تماسی که ممکن است از سقف بگذرد با 429 daily_cap متوقف می‌شود و هزینه‌ای ندارد؛ هدر Retry-After می‌گوید تا بازنشانی چند ثانیه مانده. تماسی که max_tokens ندارد، طولی از پاسخ می‌گیرد که سقف و موجودی حساب هنوز می‌توانند هزینه‌اش را بدهند، پس کلیدی که سقفش تقریباً تمام شده هم به تماس‌های کوتاه جواب می‌دهد.

سقف را هر وقت بخواهی در کنسول عوض کن. سقف تازه برای تماس بعدی اعمال می‌شود.

ابطال کلید

در کنسول روی کلید Revoke و بعد Revoke key بزن. اپ‌هایی که از آن استفاده می‌کنند، از تماس بعدی 401 invalid_key می‌گیرند. تماس‌های آن ۳۰ روز در فهرست می‌مانند.

کلیدها و کلید حساب تو

کلید APIکلید حساب
شکلشsk-nokeep- و ۳۲ نویسهnk- و چهار گروه چهارتایی
کاربردکد و اپ‌های تو، برای صدا زدن APIخودت، برای باز کردن حسابت در مرورگر دیگر
کجاستبخش Keys در کنسولبخش تنظیمات اپ، کلید حساب

اعتبار را روی دستگاه دیگری خریده‌ای؟ آن کلید حساب را در کادر Bought on another device? کنسول بچسبان تا موجودی و کلیدهایت ظاهر شوند.

پرسش‌ها

چند کلید می‌توانم داشته باشم؟

تا ۱۰ کلید فعال برای هر حساب. برای ساختن کلید تازه یکی را ابطال کن.

کلیدها منقضی می‌شوند؟

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

آیا کلید می‌تواند اعتبار طرح را خرج کند؟

نه. API اعتباری را خرج می‌کند که خریده‌ای؛ اعتبار طرح‌ها در اپ می‌ماند.