> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# قدّر تكلفة الطلب قبل استدعاء نموذج

> قدّر تكلفة طلب CometAPI قبل استدعاء النموذج من خلال دمج تسعير دليل النماذج مع حجم الإدخال وحدود الإخراج أو عدد المهام.

قدّر التكلفة قبل استدعاء النموذج من خلال دمج سعر دليل النماذج مع الوحدات التي تحتسب عليها الفاتورة في نقطة النهاية: Tokens أو الصور أو مدة الصوت أو مهام الفيديو. تعامل مع التقدير باعتباره وسيلة لضبط الميزانية، ثم استخدم سجلات الاستخدام والفوترة الفعلية بعد اكتمال الطلب.

## تقدير الاستدعاءات المعتمدة على Token

يوضح مثال Python التالي كيفية تقدير تكلفة طلب يعتمد على Token انطلاقًا من قيم التسعير المُعدّة:

```python theme={null}
import math
import os

prompt = "Write a short product description for CometAPI."
max_output_tokens = 200

input_price_per_1m = float(os.environ["MODEL_INPUT_PRICE_PER_1M"])
output_price_per_1m = float(os.environ["MODEL_OUTPUT_PRICE_PER_1M"])

estimated_input_tokens = math.ceil(len(prompt) / 4)

estimated_cost = (
    estimated_input_tokens * input_price_per_1m
    + max_output_tokens * output_price_per_1m
) / 1_000_000

print(f"Estimated maximum cost: ${estimated_cost:.6f}")
```

النتيجة هي تقدير قبل الاستدعاء:

```text theme={null}
Estimated maximum cost: $0.000123
```

## تعيين حد أقصى لميزانية الإخراج

يضع الطلب التالي حدًا أقصى للإخراج المُولَّد بحيث يكون للتقدير حد أعلى:

```bash theme={null}
curl https://api.cometapi.com/v1/chat/completions \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model-id",
    "messages": [
      {
        "role": "user",
        "content": "Write a short product description for CometAPI."
      }
    ],
    "max_completion_tokens": 200
  }'
```

يتضمن الرد بيانات الاستخدام الفعلية بعد استدعاء النموذج:

```json theme={null}
{
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 42,
    "total_tokens": 52
  }
}
```

## تقدير الاستدعاءات المعتمدة على المهام

يوضح مثال JavaScript التالي كيفية تقدير سير عمل يعتمد على المهام، مثل إنشاء الصور أو الفيديو:

```javascript theme={null}
const taskCount = 3;
const pricePerTask = Number(process.env.MODEL_PRICE_PER_TASK);

const estimatedCost = taskCount * pricePerTask;

console.log(`Estimated maximum cost: $${estimatedCost.toFixed(4)}`);
```

النتيجة هي ميزانية المهام:

```text theme={null}
Estimated maximum cost: $0.4500
```

## الأخطاء الشائعة

| الخطأ                                | الحل                                                                                                  |
| ------------------------------------ | ----------------------------------------------------------------------------------------------------- |
| استخدام سعر من نموذج خاطئ            | انسخ التسعير من model ID نفسه في دليل النماذج.                                                        |
| تجاهل Tokens الخاصة بالإخراج         | حدّد `max_completion_tokens` أو حد الإخراج الخاص بنقطة النهاية.                                       |
| التعامل مع التقديرات على أنها فواتير | قارن التقديرات بالاستخدام الفعلي بعد الاستدعاء.                                                       |
| فقدان مضاعِفات المهام                | بالنسبة للصور والصوت والفيديو، تحقّق مما إذا كانت الفوترة تتم لكل مهمة أو لكل ثانية أو لكل أصل مُنشأ. |

## روابط ذات صلة

* [التسعير](https://www.cometapi.com/pricing/)
* [دليل النماذج](https://www.cometapi.com/models/)
* [صفحة النماذج](/ar/overview/models)
* [حول التسعير](/ar/pricing/about-pricing)
* [البدء السريع مع CometAPI](/ar/overview/quick-start)

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "TechArticle",
        "@id": "https://apidoc.cometapi.com/guides/how-to-estimate-cost-before-calling-a-model",
        "headline": "كيف أقدّر التكلفة قبل استدعاء نموذج؟",
        "description": "قدّر تكلفة طلب CometAPI قبل استدعاء النموذج من خلال الجمع بين تسعير دليل النماذج وحجم الإدخال وحدود الإخراج أو عدد المهام.",
        "url": "https://apidoc.cometapi.com/guides/how-to-estimate-cost-before-calling-a-model",
        "author": {
          "@type": "Organization",
          "name": "CometAPI"
        },
        "publisher": {
          "@type": "Organization",
          "name": "CometAPI",
          "url": "https://www.cometapi.com"
        }
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "مستندات CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "الأدلة",
            "item": "https://apidoc.cometapi.com/guides/use-cometapi-with-openai-sdk"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "كيف أقدّر التكلفة قبل استدعاء نموذج؟",
            "item": "https://apidoc.cometapi.com/guides/how-to-estimate-cost-before-calling-a-model"
          }
        ]
      }
    ]
    }
    `}
</script>