نقاط النهاية
البحث عن عملية توليد
استخدم GET /generation للاطلاع على التكلفة الدقيقة وعدد الرموز والمزوّد وزمن الاستجابة لأي طلب سابق عبر معرّف التوليد الخاص به.
اطّلع على تفاصيل طلب سابق (تكلفته الدقيقة وعدد الرموز والمزوّد وزمن الاستجابة وسبب الانتهاء) عبر معرّف التوليد الخاص به. مفيد لمطابقة الفواتير وتدقيق الطلبات المبثوثة وتشخيص الاستدعاءات البطيئة.
GET https://api14.com/api/v1/generation?id={generation_id}
أين تجد المعرّف
- الحقل
idفي استجابة chat completion أو completion أو response (gen-...). - ترويسة الاستجابة
X-Generation-Idعند وجودها. - الحقل
idفي أول جزء من البث. - صفحة الاستهلاك (Usage) في لوحة التحكم.
الطلب
| معامل الاستعلام | مطلوب | الوصف |
|---|---|---|
id | نعم | معرّف التوليد. |
curl "https://api14.com/api/v1/generation?id=gen-1791100000-abc123" \
-H "Authorization: Bearer sk-api14-..."
يمكنك البحث فقط عن عمليات التوليد التي أجراها حسابك. أي معرّف آخر (أو معرّف لم يُسجَّل قط) يُعيد 404 not_found.
الاستجابة
الجسم هو سجل عملية التوليد:
{
"data": {
"id": "gen-1791100000-abc123",
"model": "anthropic/claude-sonnet-4.5",
"created_at": "2026-10-04T09:12:44Z",
"provider_name": "Anthropic",
"streamed": true,
"finish_reason": "stop",
"tokens_prompt": 1250,
"tokens_completion": 340,
"native_tokens_prompt": 1310,
"native_tokens_completion": 352,
"native_tokens_reasoning": 0,
"native_tokens_cached": 1024,
"latency": 412,
"generation_time": 3810,
"total_cost": 0.00918
}
}
| الحقل | الوصف |
|---|---|
total_cost | المبلغ المخصوم من رصيدك بالدولار. |
native_tokens_* | أعداد الرموز وفق محلل الرموز (tokenizer) الخاص بالمزوّد، وهي ما تُحاسَب عليه. |
native_tokens_cached | رموز الإدخال التي قُدِّمت من الذاكرة المؤقتة. راجع التخزين المؤقت للمطالبات. |
latency / generation_time | الزمن حتى أول رمز وزمن التوليد الكلي، بالمللي ثانية. |
التكلفة
total_cost (وusage.cost في الاستجابة الأصلية) هو المبلغ المحتسب عليك للطلب، وهو نفسه المعروض في صفحة الاستهلاك. راجع الأسعار والفوترة.
التوقيت
قد يستغرق ظهور السجل بضع ثوانٍ بعد انتهاء الطلب. إذا حصلت على 404 فور الطلب، أعد المحاولة بعد تأخير قصير.
الأخطاء
| الحالة | الرمز | متى يحدث |
|---|---|---|
| 401 | invalid_api_key | المفتاح مفقود أو غير صالح. |
| 404 | not_found | المعرّف غير معروف أو يعود إلى حساب آخر. |
| 502 | upstream_unavailable | تعذّر جلب السجل، أعد المحاولة. |
راجع الأخطاء.