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

متادیتای پاسخ: شناسهٔ درخواست و هزینهٔ هر تماس

هر پاسخ روی /v1، /anthropic و /gemini، موفق یا ناموفق، هدر X-Request-Id دارد: شناسهٔ خود 1xAi برای همان تماس، که در گزارش مصرف، خروجی CSV و تراکنش کیف پول هم همان است. پاسخ موفق و غیراستریم مسیرهای حساب‌شونده هدر X-1xai-Cost-Toman هم دارد: مبلغی که برای همان تماس حساب شد، به تومان و با کارمزد. هزینهٔ تماس استریم را پس از پایان استریم با همان شناسه از GET /v1/usage می‌خوانی.

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

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

شناسه و هزینهٔ پاسخ · ۱

شناسهٔ درخواست: X-Request-Id

هدرهای یک پاسخ غیراستریم

http
HTTP/1.1 200 OK
Content-Type: application/json
X-Request-Id: gw_01JD3Z5T8Q0V6W4M2K9R7N1PXA
X-1xai-Request-Id: gw_01JD3Z5T8Q0V6W4M2K9R7N1PXA
X-1xai-Cost-Toman: 158
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1
  • هر پاسخ روی /v1 (API حساب هم)، /anthropic و /gemini دقیقاً یک X-Request-Id دارد، چه درخواست انجام شود و چه رد: 401، 402، 403، 404، 429، خطایی که از سازندهٔ مدل رسیده و 502 یا 504 خود دروازه هم آن را دارند.
  • مقدار آن شناسهٔ خود 1xAi برای همان تماس است: gw_ و پس از آن ۲۶ نویسه، روی‌هم ۲۹ نویسه. هرگز شناسهٔ سازندهٔ مدل نیست و X-Request-Id سازنده به تو فرستاده نمی‌شود.
  • روی /anthropic اگر Anthropic هدر Request-Id فرستاده باشد، پاسخ آن را هم دارد، با همان شناسهٔ 1xAi. پس _request_id در کتابخانه‌های Anthropic و OpenAI همان شناسه‌ای است که به پشتیبانی می‌دهی.
  • همین شناسه است: request_id ردیف همان تماس در GET /v1/usage و مقداری که فیلتر request_id= می‌گیرد، ستون request_id خروجی CSV، «شناسهٔ درخواست» در گزارش تماس‌های داشبورد (و در جست‌وجوی همان صفحه)، و reference کسر همان تماس در GET /v1/wallet/transactions (API حساب).
  • هدر X-1xai-Request-Id با همان مقدار هنوز فرستاده می‌شود.
  • شناسهٔ پاسخ POST /v1/realtime/client_secret فقط همان درخواست را نشان می‌دهد؛ تماس‌های یک گفت‌وگوی صوتی در گزارش مصرف ردیف‌ها و شناسه‌های خودشان را دارند (rt_…) (صوت زنده).

خواندن هدرها با کتابخانهٔ OpenAI

Python
from openai import OpenAI

client = OpenAI(base_url="https://1xai.ir/v1", api_key="1xai-...")

raw = client.chat.completions.with_raw_response.create(
    model="gpt-5.5",
    messages=[{"role": "user", "content": "سلام"}],
)
print(raw.headers.get("x-request-id"))       # gw_…
print(raw.headers.get("x-1xai-cost-toman"))  # مبلغ تومانی
completion = raw.parse()

شناسه و هزینهٔ پاسخ · ۲

هزینهٔ تماس: X-1xai-Cost-Toman

مبلغی که برای همین تماس حساب شد، به تومان: قیمت با کارمزد 1xAi، برابر با cost_toman ردیف همان تماس در گزارش مصرف. یک عدد ساده بدون جداکنندهٔ هزارگان است (در عمل عدد صحیح، چون کسرها به تومان کامل‌اند)، هر موجودی‌ای که آن را پرداخته باشد: اعتبار پلن، اعتبار هدیه یا کیف پول. تصویری که هزینه‌اش را آزمایش رایگان تصویر پرداخته 0 را نشان می‌دهد (صورت‌حساب).

مسیرهایی که هدر هزینه دارند
مسیرکِی
POST /v1/chat/completions, /v1/completions, /v1/responses, /v1/embeddingsپاسخ 2xx بدون استریم
POST /v1/messages, /anthropic/v1/messagesپاسخ 2xx بدون استریم
POST /gemini/v1beta/models/{model}:generateContentپاسخ 2xx
POST /v1/images/generations, /v1/images/edits, /v1/images/variationsپاسخ 2xx
POST /v1/audio/transcriptions, /v1/audio/translations, /v1/audio/speechپاسخ 2xx
  • هیچ پاسخ استریمی ("stream": true و :streamGenerateContent) این هدر را ندارد: هدرها پیش از رسیدن پاسخ فرستاده می‌شوند. راهش در بخش بعد است.
  • هیچ پاسخی با وضعیت 400 یا بالاتر آن را ندارد، حتی 0: درخواست ردشده یا ناموفق هزینه‌ای ندارد.
  • مسیرهایی که فقط کاری را شروع می‌کنند و هزینه‌شان بعداً حساب می‌شود آن را ندارند: /v1/videos، :predictLongRunning و /interactions در Gemini، دسته‌های پیام Anthropic، دسته‌های OpenAI (POST /v1/batches) و تماس صوتی زنده. هزینهٔ آن‌ها در ردیف‌هایشان در GET /v1/usage است.
  • مسیرهای رایگان آن را ندارند: /v1/moderations، شمارش توکن، /v1/models، API حساب و مسیرهای /v1/files.
  • هیچ رویدادی از استریم عوض نمی‌شود و رویدادی اضافه نمی‌شود.

هدر را اختیاری بگیر

برنامه‌ات را طوری بنویس که اگر X-1xai-Cost-Toman نبود، مبلغ را از ردیف همان تماس در گزارش مصرف بخواند. X-Request-Id همیشه هست.

شناسه و هزینهٔ پاسخ · ۳

هزینهٔ یک تماس استریم

  1. X-Request-Id را از هدرهای پاسخ بخوان؛ هدرها پیش از اولین رویداد می‌رسند.
  2. استریم را تا آخر بخوان.
  3. GET /v1/usage?request_id=<همان شناسه> را صدا بزن. ردیف وقتی نوشته می‌شود که استریم تمام و تماس حساب شده باشد، معمولاً کمتر از یک ثانیه پس از آخرین رویداد. فهرست خالی usage یعنی «هنوز حساب نشده»؛ یکی دو ثانیه بعد دوباره بپرس.
  4. cost_toman آن ردیف مبلغ حساب‌شده است؛ اگر چند ردیف بود، جمعشان را بگیر.
Python
import time
import requests

BASE = "https://1xai.ir/v1"
HEADERS = {"Authorization": "Bearer 1xai-..."}

body = {
    "model": "gpt-5.5",
    "stream": True,
    "messages": [{"role": "user", "content": "سلام"}],
}
with requests.post(f"{BASE}/chat/completions", headers=HEADERS, json=body, stream=True) as r:
    request_id = r.headers["X-Request-Id"]
    for line in r.iter_lines():
        pass  # رویدادها را این‌جا به کار ببر

for _ in range(5):
    rows = requests.get(f"{BASE}/usage", headers=HEADERS, params={"request_id": request_id}).json()["usage"]
    if rows:
        print(request_id, sum(row["cost_toman"] for row in rows))
        break
    time.sleep(1)

همین راه برای هر تماسی کار می‌کند، استریم یا غیراستریم. فیلتر request_id و خروجی CSV در API حساب آمده‌اند.