کلیدهای API و امنیت
کلید API با 1xai- شروع میشود، فقط یک بار هنگام ساخت نمایش داده میشود و ما فقط هش SHA-256 آن را نگه میداریم. برای هر کلید میتوانی تاریخ انقضا (دستکم ۱۲ ساعت) و سقف خرج تومانی بگذاری؛ کلیدی که به سقفش برسد خودش باطل میشود. متن درخواست و پاسخ تا ۳۰ روز کنار گزارش مصرف میماند. نشانی IP، User-Agent و کلید تو به سازندهٔ مدل فرستاده نمیشود.
آخرین بهروزرسانی:
فهرست مستندات
مسیرهای API
حساب، کلید و تیم
کلیدها و امنیت · ۱
شکل کلید و نگهداری آن
- کلید با
1xai-شروع میشود و پس از آن ۳۲ بایت تصادفی (به شکل base64url) میآید. - کلید کامل فقط یک بار، همان لحظهٔ ساخت، نمایش داده میشود. همان موقع کپیاش کن.
- ما خود کلید را نگه نمیداریم: فقط هش SHA-256 آن و ۱۳ نویسهٔ اولش، تا در فهرست کلیدها بشناسیاش. کلید گمشده قابل بازیابی نیست؛ یک کلید تازه بساز و قبلی را باطل کن.
- هر درخواست با پایگاه داده سنجیده میشود؛ کلیدی که باطل کنی از درخواست بعدیاش رد میشود. درخواستهایی که همان لحظه در جریاناند تمام میشوند.
کلید را در یکی از این سه هدر بفرست؛ جزئیات در احراز هویت است. کلید در نشانی (?key=) پذیرفته نمیشود.
کلیدها و امنیت · ۲
ساخت و ابطال
کلید را در داشبورد، صفحهٔ کلیدهای API، میسازی و باطل میکنی. هنگام ساخت اینها را میتوانی تعیین کنی:
| تنظیم | مقدار | اگر خالی بماند |
|---|---|---|
| نام | هر متنی؛ در گزارش مصرف کنار هر تماس میآید | بینام |
| تاریخ انقضا | دستکم ۱۲ ساعت | منقضی نمیشود |
| سقف خرج | مبلغ به تومان | سقفی ندارد |
ساخت و ابطال کلید فقط از داشبورد است. API حساب کلیدها را فقط میخواند و خود کلید را هرگز برنمیگرداند.
کلیدها و امنیت · ۳
انقضا
کلیدی که تاریخ انقضایش گذشته باشد پاسخ 401 با کد key_revoked میگیرد. تاریخ انقضا را پس از ساخت نمیشود عوض کرد؛ کلید تازه بساز. برای کار موقت (یک پیمانکار، یک آزمایش، یک کارگاه) کلید کوتاهعمر بده تا فراموششدنش خطری نداشته باشد.
کلیدها و امنیت · ۴
سقف خرج: کلیدی که خودش باطل میشود
- هزینهٔ کامل هر تماس موفق به خرج همان کلید اضافه میشود، از هر منبعی که پرداخت شده باشد (کیف پول، اعتبار پلن یا اعتبار هدیه).
- وقتی خرج کلید به سقفش برسد، کلید همان لحظه باطل میشود. درخواست بعدی
401میگیرد، با کدkey_cappedیاkey_revoked. - سقف پس از تسویهٔ هر تماس سنجیده میشود. پس تماسی که از سقف میگذرد، و تماسهایی که همزمان با آن در جریاناند، کامل انجام و حساب میشوند: خرج نهایی میتواند به اندازهٔ همین تماسها از سقف بیشتر شود.
- اگر هشدار محدودیتها را روشن کرده باشی، وقتی خرج کلید به ۹۰٪ سقف برسد یک ایمیل میگیری.
- کلید باطلشده دوباره فعال نمیشود. یک کلید تازه با سقف تازه بساز.
کلیدها و امنیت · ۵
هشدارها
هشدارها را در صفحهٔ شارژ تنظیم میکنی. تا خودت ذخیرهشان نکنی چیزی فرستاده نمیشود.
| هشدار | کِی | از کجا |
|---|---|---|
| کم شدن اعتبار | وقتی اعتبار قابل خرج از آستانهای که خودت میگذاری پایینتر برود | ایمیل تأییدشده؛ پیامک، جایی که فعال باشد |
| سقف کلید | وقتی خرج یک کلید به ۹۰٪ سقفش برسد | ایمیل |
| اعتبار پلن | وقتی ۹۰٪ اعتبار هفتگی، ماهانه یا سهم API پلن خرج شده باشد | ایمیل |
هر هشدار برای هر بار رد شدن از آستانه یک بار فرستاده میشود. اعتبار قابل خرج همان spendable_toman در GET /v1/wallet/summary است (API حساب).
کلیدها و امنیت · ۶
چه چیزی ثبت میشود و تا کِی
کنار هر ردیف گزارش مصرف، ابتدای متن درخواست و پاسخ (تا ۶۴ کیلوبایت) و اگر بلندتر بود ۱۶ کیلوبایت پایانی آن نگه داشته میشود تا در گزارش مصرف خودت ببینیاش. این متن پس از ۳۰ روز پاک میشود. عددها (مدل، توکن، هزینه، وضعیت و زمان) برای حسابداری میمانند.
| داده | نگهداری |
|---|---|
| مدل، سازنده، مسیر، توکنها، هزینه به دلار و تومان، نرخ تبدیل، وضعیت، شناسهٔ درخواست، زمان، نام کلید | بدون تاریخ پاک شدن، برای حسابداری و پیگیری |
| ابتدای متن درخواست و پاسخ (تا ۶۴ کیلوبایت) و ۱۶ کیلوبایت پایانی | ۳۰ روز |
| فایل صوتی در تبدیل گفتار به متن، و صدای تماس زنده | نگه داشته نمیشود |
| تصویر ساختهشده (base64) در پاسخ | از متن ثبتشده حذف میشود |
این متن را خودت در داشبورد (گزارش تماسها) و با GET /v1/usage میبینی؛ از راه کلید API فقط متن تماسهایی برمیگردد که با کلید API فرستاده شدهاند، نه آنچه در چت نوشته شده (هر کلید چه میخواند). در این نسخه راهی برای خاموش کردن ثبت متن برای یک کلید نیست. متن کامل سیاست حریم خصوصی مرجع است.
کلیدها و امنیت · ۷
چه چیزی به سازندهٔ مدل میرسد
درخواست تو با کلید خود ما دوباره از سرور ما فرستاده میشود. از هدرهای تو فقط اینها عبور میکنند و بقیه حذف میشوند:
| مسیر | هدرهای عبوری |
|---|---|
/v1/* | Content-Type, Accept, OpenAI-Organization, OpenAI-Project, OpenAI-Beta |
/anthropic/*, /v1/messages | Content-Type, Accept, anthropic-version, anthropic-beta |
/gemini/* | Content-Type, Accept |
- فرستاده نمیشود: نشانی IP تو (و هدرهای
X-Forwarded-Forو مانند آن)،User-Agent، کوکیها،Referer،Origin،Accept-Languageو کلید1xai-*تو. - بدنهٔ درخواست همان است که فرستادی، جز چند تغییر مشخص که در مسیرهای سازگار با OpenAI فهرست شده است (مثلاً
store: falseروی مدلهای OpenAI). - متن درخواست به سازندهٔ همان مدلی میرود که انتخاب کردهای و سیاست نگهداری دادهٔ خود او روی آن برقرار است.
کلیدها و امنیت · ۸
چند توصیهٔ عملی
- برای هر برنامه و هر محیط (آزمایش، تولید) کلید جدا بساز و نامگذاری کن؛ گزارش مصرف هر تماس را با نام کلیدش نشان میدهد.
- روی کلیدهای آزمایشی سقف خرج و تاریخ انقضا بگذار.
- کلید را در کد مرورگر یا اپ موبایل نگذار. برای تماس صوتی از مرورگر، کلید موقت بگیر (صوت زنده).
- برای عوض کردن کلید: کلید تازه بساز، برنامه را بهروز کن، بعد کلید قبلی را باطل کن.
- برای تیم، به جای دستبهدست کردن یک کلید، حساب شرکتی و فضای کاری بساز.