الأسعار

تكلّف كل نموذج بالضبط ما يفرضه صانع النموذج عليه، بالدولار الأمريكي. تدفع من رصيد API، الذي يُحتسب بـ أرصدة API: 1,000 رصيد API = ⁨‏1 $⁩. رصيد API مستقل، ومنفصل عن رصيد تطبيقات Doitong. لا توجد خطط أو حدود دنيا أو رسوم لكل نموذج: تكلفة الاستدعاء هي سعره، وتُخصم من رصيد API عند قبول الطلب.

في روسيا (doitong.ru أو api.doitong.ru أو ?currency=rub) تُعرض الأسعار أيضًا بالروبل: سعر USD × سعر USD/RUB × 1.3.

الوحدات#

لكل نموذج وحدة فوترة واحدة، تظهر في صفحته وفي GET https://api.doitong.com/v1/models/{model_id}:

السعر = الكمية × أرصدة API لكل وحدة، مع التقريب إلى رصيد API كامل (⁨‏0.001 $⁩)، ولا يقل عن 1. قد يكون سعر الوحدات الرخيصة جدًا كسريًا لكل وحدة (0.4 رصيد API لكل ثانية)؛ ويُقرّب إجمالي الاستدعاء فقط.

تفرض بعض النماذج سعرًا مختلفًا بحسب المدخل: فالفيديو المصحوب بصوت أغلى من غير المصحوب، و4K أغلى من 1K، وهكذا. تُدرج هذه القواعد في صفحة كل نموذج. تُحتسب المعلمة التي تتركها دون تحديد بقيمتها الافتراضية، لذا فالسعر الذي تراه لمدخل ما هو السعر الذي تدفعه.

أسعار دقيقة ومقاسة وتقديرية وأسعار الاستخدام#

لكل سعر mode:

• exact: يُحسب السعر من مدخلك (الثواني أو الصور أو الميغابكسل أو المحارف أو الخطوات، أو سعر ثابت واحد لكل فيديو أو استدعاء).
• measured: يتبع السعر الملفات التي ترسلها: مدة فيديو أو صوت المدخل، وحجم صورة المدخل، ومعدل الإطارات أو عدد إطارات الفيديو. تُسعّر أدوات تحسين الدقة ومزامنة الشفاه وتحويل الفيديو إلى فيديو والنسخ الصوتي وأدوات الصوت بهذه الطريقة. قبل التشغيل، يقرأ API مدة الملف ودقته ومعدل إطاراته (ويفعل عرض السعر الشيء نفسه)، لذا فإن السعر المعروض هو بالضبط ما يفرضه التشغيل. توضح صفحة النموذج ما تدفعه ("السعر لكل ثانية من فيديو المدخل")، وتستخدم الآلة الحاسبة أرقام ملفك. يُرفض الملف الذي يتعذر قراءته مع unmeasurable_input ولا تُفرض أي رسوم.
• estimate: تعتمد تكلفة النموذج نفسه على شيء لا يستطيع المدخل إخبارك به مسبقًا (الرموز ووقت الحوسبة). يفرض هذا النموذج سعرًا تقديريًا ثابتًا لكل تشغيل (لكل صورة مخرج عندما يكون له عدد صور)، محددًا استنادًا إلى متوسط تكلفة عمليات التشغيل الفعلية لذلك النموذج. ستعرف السعر قبل التشغيل: فعرض السعر هو ما تدفعه.
• metered: يُفرض على النموذج بحسب الاستخدام الفعلي، الذي لا يعرفه إلا التشغيل نفسه: الرموز التي يقرأها نموذج اللغة أو الرؤية ويكتبها، وثواني الكلام التي ينشئها نموذج الصوت، أو وقت معالجة النموذج. راجع الفوترة حسب الاستخدام أدناه.

تقول صفحات النماذج "السعر لكل تشغيل" أو "السعر لكل ثانية من فيديو المدخل" (وما شابه ذلك) أو "السعر التقديري لكل تشغيل" أو "الفوترة حسب الاستخدام"؛ وتسردها GET https://api.doitong.com/v1/models?mode=measured و?mode=estimate و?mode=metered.

الفوترة حسب الاستخدام#

لدى نموذج metered سعر استخدام ("$0.01 لكل 1000 رمز"، و"$0.002 لكل ثانية من الصوت المُنشأ"، و"$0.00111 لكل ثانية من وقت المعالجة") وحد أقصى لكل تشغيل: وهو أكبر مبلغ قد يكلفه التشغيل، استنادًا إلى ما يقوله طلبك (max_tokens وطول نصك والدقة وعدد المخرجات) وحدود النموذج المنشورة. ولا يعتمد مطلقًا على محتوى ملف موجود خلف عنوان URL. بالنسبة إلى نموذج يُحاسب على وقت المعالجة أو طول جلسة صوتية، يكون الحد الأقصى هو أطول مدة يمكن أن يستغرقها الطلب (15 دقيقة للصور، و30 للصوت، و60 للفيديو)، لذا فهو أعلى بكثير من التشغيل المعتاد. يُرفض المدخل الذي يتجاوز حده الأقصى حد النموذج لكل تشغيل (مثل نص طويل جدًا) مع 422 invalid_input:

1. يعرض السعر ذلك الحد الأقصى باعتباره credits (مع hold وtypical، أي التشغيل المعتاد). عند بدء التشغيل، يُخصم الحد الأقصى من رصيد API، وهو المبلغ الذي يجب أن يغطيه الرصيد وميزانية مفتاحك.
2. عند نجاح التشغيل، يُسوّى الطلب وفق الاستخدام الذي يبلّغ عنه النموذج: الاستخدام × سعر الاستخدام، مع التقريب إلى رصيد API كامل. يُسترد باقي الحد الأقصى تلقائيًا مرة واحدة، كسطر refund في رصيد API.
3. لا يكلّف التشغيل أكثر من حده الأقصى مطلقًا، حتى لو تجاوز استخدامه ذلك. ويُسترد التشغيل الفاشل أو الملغى كاملًا، كالعادة.

تكلّف معظم عمليات التشغيل أقل بكثير من الحد الأقصى؛ وتعرض صفحة النموذج "حتى $X لكل تشغيل" لمدخل المنشئ والتشغيل المعتاد ("من" في الكتالوج). وبالنسبة إلى النماذج القليلة التي تُحاسب على وقت المعالجة، يكون الاستخدام هو وقت معالجة النموذج (الموسوم بـ approximate).

{
  "object": "quote",
  "credits": 621,
  "usd": "0.621",
  "mode": "metered",
  "label": "Charged by usage",
  "hold": { "credits": 621, "usd": "0.621" },
  "typical": { "credits": 10, "usd": "0.01" },
  "settlement": "usage",
  "display": "$0.01 / 1000 tokens",
  "breakdown": "up to 62.035 × 1000 tokens × $0.01"
}

بعد التشغيل، تعرض cost الخاصة بالطلب المبلغ المحجوز والمبلغ الذي بلغته تكلفة الاستخدام:

{
  "cost": { "credits": 621, "usd": "0.621", "charged": 621, "refunded": 611, "mode": "metered", "held": 621,
            "typical": 10, "settled": { "status": "settled", "credits": 10, "usd": "0.01", "quantity": 1,
            "unit": "1000_tokens", "unit_usd": "0.01", "source": "billed_usage", "approximate": false } }
}

charged − refunded هو تكلفة التشغيل. تكون settled.status بقيمة pending للفترة بين النتيجة والتسوية، وبقيمة no_usage في الحالة النادرة التي لا يبلّغ فيها النموذج عن أي استخدام على الإطلاق (وعندها يظل الحد الأقصى هو السعر).

عرض السعر قبل التشغيل#

تأخذ POST https://api.doitong.com/v1/quote/{model_id} النص نفسه الذي سترسله إلى run تمامًا، وتُرجع سعر ذلك المدخل: السعر الدقيق، باستثناء نموذج تُفرض تكلفته حسب الاستخدام، حيث يكون السعر هو أكبر تكلفة محتملة للتشغيل. لا تحتاج إلى مفتاح ولا تكلّف شيئًا:

curl -X POST "https://api.doitong.com/v1/quote/flux/schnell" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "A lighthouse at dusk", "num_images": 2}'

{
  "object": "quote",
  "model": "flux/schnell",
  "credits": 6,
  "usd": "0.006",
  "unit": "megapixel",
  "quantity": 2,
  "unit_credits": 3,
  "mode": "exact",
  "label": "Price per run",
  "display": "$0.003 / megapixel",
  "breakdown": "2 MP (2 images) × 3 API credits",
  "input": { "prompt": "A lighthouse at dusk", "num_images": 2 },
  "warnings": []
}

مع وجود مفتاح، يعرض السعر أيضًا balance_credits وbalance_usd (رصيد API الخاص بك)، وaffordable وkey_budget_remaining. أضف ?currency=rub للحصول على مبلغ rub.

كائنات الأسعار#

لكل سعر في API البنية نفسها:

• النماذج: price: { "credits": 112, "usd": "0.112", "unit": "second", "display": "$0.112 / second", "credits_display": "112 API credits / second", "from_credits": 560, "from_usd": "0.56", "mode": "exact" } — بالإضافة إلى rub وrub_display وfrom_rub في روسيا أو مع ?currency=rub؛
• الطلبات: cost: { "credits": 560, "usd": "0.56", "charged": 560, "refunded": 0 } (أرصدة API؛ يضيف الطلب بنظام الفوترة حسب الاستخدام mode وheld وtypical وsettled، راجع الفوترة حسب الاستخدام)؛
• الحساب: يعرض GET https://api.doitong.com/v1/account قيمة credits (رصيد API)، وbalance: { "credits", "usd" } وstorage (سعر تخزين الملفات واستخدامه والتقدير الشهري).

عمليات استرداد المبالغ#

• لا تُفرض رسوم على الطلب غير الصالح (أي 4xx قبل بدء التشغيل).
• يُسترد الطلب الذي ينتهي بحالة failed (بما في ذلك timeout) كاملًا إلى رصيد API تلقائيًا.
• يُسترد الطلب الذي تلغيه قبل بدئه كاملًا. بعد أن يبدأ النموذج في الإنشاء، لا يكون الإلغاء سوى طلب: فإذا أنهى النموذج عمله، تُسلّم النتيجة وتُفرض التكلفة.
• يُعاد إلى الطلب metered الناجح الجزء من حده الأقصى الذي لم يستخدمه.

يعرض كائن الطلب كل ذلك: cost.credits وcost.charged وcost.refunded.

تخزين الملفات#

تُحفظ ملفات المخرج في تخزيننا. تختار الإعداد في الحساب أو لكل تشغيل (?storage=):

تُفرض تكلفة التخزين الدائم مرة واحدة يوميًا من رصيد API: المساحة المحتفظ بها بالـGB × السعر الشهري ÷ عدد أيام الشهر، كسطور دفتر أستاذ من النوع storage. تُرحّل كسور رصيد API إلى اليوم التالي، لذا يساوي مجموع الشهر تمامًا المساحة بالـGB × 100 رصيد API (1 GB = 1024³ بايت؛ وتكلفة الاحتفاظ بـ10 GB لشهر واحد هي 1,000 رصيد API). لا ينخفض الرصيد أبدًا إلى أقل من الصفر: عندما يتعذر الدفع، لا تُفرض تكلفة ذلك اليوم، وتتلقى رسالة بريد إلكتروني، ولديك 30 أيام لشحن الرصيد قبل أن تصبح الملفات المحتفظ بها مؤقتة وتُحذف بعد 7 يومًا. التفاصيل: الملفات.

الأسعار الحالية#

هذه هي النماذج المميزة. توجد النماذج البالغ عددها 1,496 وأسعارها في كتالوج النماذج وفي GET /models (لا يلزم مفتاح).

شحن الرصيد#

أضف المال إلى رصيد API من https://doitong.com/developers/dashboard#balance. عندما يكون الرصيد منخفضًا جدًا، يجيب التشغيل بـ 402 insufficient_credits مع top_up_url. ويمكن أيضًا وضع حد أقصى لكل مفتاح API بميزانيته الخاصة بأرصدة API (راجع المصادقة).