نستخدم ملفات تعريف الارتباط. تُبقيك ملفات تعريف الارتباط وتخزين المتصفح مسجّلًا للدخول وتتذكر تفضيلاتك. وبإذنك نقيس أيضًا كيفية استخدام الموقع. يمكنك في أي وقت. راجع سياسة ملفات تعريف الارتباط.

البحث عن عملية توليد

نقاط النهاية

البحث عن عملية توليد

استخدم 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 فور الطلب، أعد المحاولة بعد تأخير قصير.

الأخطاء

الحالةالرمزمتى يحدث
401invalid_api_keyالمفتاح مفقود أو غير صالح.
404not_foundالمعرّف غير معروف أو يعود إلى حساب آخر.
502upstream_unavailableتعذّر جلب السجل، أعد المحاولة.

راجع الأخطاء.