متادیتای پاسخ: شناسهٔ درخواست و هزینهٔ هر تماس
هر پاسخ روی /v1، /anthropic و /gemini، موفق یا ناموفق، هدر X-Request-Id دارد: شناسهٔ خود 1xAi برای همان تماس، که در گزارش مصرف، خروجی CSV و تراکنش کیف پول هم همان است. پاسخ موفق و غیراستریم مسیرهای حسابشونده هدر X-1xai-Cost-Toman هم دارد: مبلغی که برای همان تماس حساب شد، به تومان و با کارمزد. هزینهٔ تماس استریم را پس از پایان استریم با همان شناسه از GET /v1/usage میخوانی.
آخرین بهروزرسانی:
فهرست مستندات
مسیرهای API
حساب، کلید و تیم
شناسه و هزینهٔ پاسخ · ۱
شناسهٔ درخواست: X-Request-Id
هدرهای یک پاسخ غیراستریم
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
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 همیشه هست.
شناسه و هزینهٔ پاسخ · ۳
هزینهٔ یک تماس استریم
X-Request-Idرا از هدرهای پاسخ بخوان؛ هدرها پیش از اولین رویداد میرسند.- استریم را تا آخر بخوان.
GET /v1/usage?request_id=<همان شناسه>را صدا بزن. ردیف وقتی نوشته میشود که استریم تمام و تماس حساب شده باشد، معمولاً کمتر از یک ثانیه پس از آخرین رویداد. فهرست خالیusageیعنی «هنوز حساب نشده»؛ یکی دو ثانیه بعد دوباره بپرس.cost_tomanآن ردیف مبلغ حسابشده است؛ اگر چند ردیف بود، جمعشان را بگیر.
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 حساب آمدهاند.