۱۰۰ هزار تومان هدیهٔ ثبت‌نام، تا ۱ میلیونبا ثبت‌نام گردونهٔ هدیه را بچرخان: دست‌کم ۱۰۰٬۰۰۰ تومان و تا ۱٬۰۰۰٬۰۰۰ تومان اعتبار هدیه، بدون کارت بانکیگردونهٔ هدیه۱ میلیون برای تو، ۱ میلیون برای دوستتدوستانت را دعوت کن: برای هر دوستی که فعال شود ۱٬۰۰۰٬۰۰۰ تومان اعتبار هدیه می‌گیری و خودش هم ۱٬۰۰۰٬۰۰۰ تومانجوایز
1xAi
مستندات API

کلیدهای API و امنیت

کلید API با 1xai- شروع می‌شود، فقط یک بار هنگام ساخت نمایش داده می‌شود و ما فقط هش SHA-256 آن را نگه می‌داریم. برای هر کلید می‌توانی تاریخ انقضا (دست‌کم ۱۲ ساعت) و سقف خرج تومانی بگذاری؛ کلیدی که به سقفش برسد خودش باطل می‌شود. متن درخواست و پاسخ تا ۳۰ روز کنار گزارش مصرف می‌ماند. نشانی IP‏، User-Agent و کلید تو به سازندهٔ مدل فرستاده نمی‌شود.

آخرین به‌روزرسانی:

فهرست مستندات

کلیدها و امنیت · ۱

شکل کلید و نگهداری آن

  • کلید با 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/messagesContent-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).
  • متن درخواست به سازندهٔ همان مدلی می‌رود که انتخاب کرده‌ای و سیاست نگهداری دادهٔ خود او روی آن برقرار است.

کلیدها و امنیت · ۸

چند توصیهٔ عملی

  • برای هر برنامه و هر محیط (آزمایش، تولید) کلید جدا بساز و نام‌گذاری کن؛ گزارش مصرف هر تماس را با نام کلیدش نشان می‌دهد.
  • روی کلیدهای آزمایشی سقف خرج و تاریخ انقضا بگذار.
  • کلید را در کد مرورگر یا اپ موبایل نگذار. برای تماس صوتی از مرورگر، کلید موقت بگیر (صوت زنده).
  • برای عوض کردن کلید: کلید تازه بساز، برنامه را به‌روز کن، بعد کلید قبلی را باطل کن.
  • برای تیم، به جای دست‌به‌دست کردن یک کلید، حساب شرکتی و فضای کاری بساز.