للمطورين · API v1

API واحدة. كل النماذج.

صور وفيديو وصوت وثلاثي الأبعاد خلف واجهة API واحدة، بنفس رصيد الاستوديو. أنشئ مفتاحًا من الإعدادات؛ أداة CLI قادمة قريبًا.

قريبًاأداة Ducklygen CLI في الطريق. تعرض هذه الصفحة كيف ستعمل؛ وحتى ذلك الحين استخدم واجهة API.

$npm i -g @ducklygen/cli
النماذج
672
نقاط النهاية
9
الحد الأدنى للشحن
‏3 €

الاستدعاء نفسه، أي مخرجات

غيّر معرّف النموذج للتبديل بين الصورة والفيديو والكلام. الحقول تتبع النموذج.

curl -X POST https://ducklygen.com/api/v1/api/catalog/generations \
  -H "Authorization: Bearer $DUCKLYGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "modelId": "image-model-id",
  "inputs": {
    "prompt": "rubber duck floating on teal water, soft light"
  }
}'
مثال على التوليد

أول عملية توليد في ثلاث خطوات

  1. 1

    أنشئ مفتاح API

    سجّل الدخول ببريدك الإلكتروني، وافتح الإعدادات ثم مفاتيح API وأنشئ مفتاحًا. اشحن رصيدك بدءًا من ‏3 € في صفحة الفواتير.

    export DUCKLYGEN_API_KEY="dk_live_..."
  2. 2

    CLI قادمة قريبًا

    أداة سطر الأوامر لم تُنشر بعد. حتى ذلك الحين يعمل كل شيء في الاستوديو.

    npm i -g @ducklygen/cli
  3. 3

    نفّذ أول عملية توليد

    اختر معرّف نموذج من الكتالوج وأرسل وصفًا. أضف --dry-run لمعرفة السعر دون إنفاق أي شيء.

    ducklygen run <model> -p "duck on teal waves" -o ./out/
قريبًاDucklygen CLI

التوليد من الطرفية

شغّل أي نموذج من shell أو مهمة CI أو وكيل برمجة. يُحدَّد سعر كل عملية توليد قبل بدئها ويُخصم من الرصيد نفسه.

السكربتات وCIكل حقل في النموذج خيار سطر أوامر، ويُرفع الملف المحلي نيابةً عنك.
JSON على stdoutمستند JSON واحد لكل تشغيل، والتقدم والأخطاء على stderr، ورمز خروج غير صفري عند الفشل.
وكلاء البرمجةملف مهارة يعلّم وكيلك أن يتحقق من السعر أولًا وأن يضع له حدًا.

الحزمة @ducklygen/cli غير منشورة بعد. توضح الأوامر أدناه كيف ستعمل.

دليل CLI الكامل →
الأمر
ducklygen loginالصق مفتاح API مرة واحدة، فيُتحقق منه ويُحفظ
ducklygen whoamiاسم المفتاح ورصيدك
ducklygen models --type videoكل نماذج الفيديو مع سعرها الابتدائي
ducklygen run <model> -hحقول النموذج مباشرة: النوع والقيمة الافتراضية والقيم المسموح بها
ducklygen run <model> -p "<prompt>" -o ./out/التوليد وحفظ النتيجة في مجلد
ducklygen run <model> -p "..." --dry-runالسعر الدقيق دون إنفاق أي شيء
ducklygen run <model> -p "..." --max-price 0.50رفض التشغيل إذا كان السعر أعلى
ducklygen run <model> -p "..." --json -o ./out/نتيجة JSON واحدة جاهزة للخطوة التالية
ducklygen skill installعلّم وكيل البرمجة استخدام CLI

مصممة للإنتاج

المصادقة

رمز Bearer في ترويسة Authorization. أنشئ المفاتيح من الإعدادات وألغِ أيًّا منها في أي وقت.

Authorization: Bearer dk_live_...

التوليد في الخلفية

بدء عملية توليد يرد فورًا بالحالة queued. استعلم عنها حتى تنجح أو تفشل أو يُسترد مبلغها.

{ "status": "queued" }

السعر أولًا

اطلب السعر الدقيق لمدخلاتك دون بدء أي شيء. كل المبالغ بسنتات اليورو.

POST /v1/quote

إعادة محاولة آمنة

أرسل ترويسة Idempotency-Key ولن يُحتسب الطلب المعاد مرتين أبدًا.

Idempotency-Key: render-042

الحدود

لكل مفتاح حد في الدقيقة وسقف يومي اختياري. بعد تجاوز الحد ترد API بالرمز 429.

429 Too Many Requests

الأخطاء والاسترداد

أخطاء JSON برمز ورسالة. عملية التوليد التي تفشل يُرد مبلغها إلى رصيدك تلقائيًا.

{ "status": "refunded" }

نقاط النهاية

عنوان URL الأساسيhttps://ducklygen.com/api/v1/api/catalogمرجع API الكامل →

GET/meمفتاحك ورصيدك
GET/modelsكل النماذج
GET/models/detail?id=MODEL_IDنموذج واحد وحقوله
POST/quoteالسعر لمدخلات محددة
POST/generationsبدء التوليد
GET/generationsعمليات التوليد الأخيرة
GET/generations/IDحالة عملية توليد واحدة
GET/generations/ID/contentملف النتيجة
DELETE/generations/IDحذف عملية توليد

اشحن ‏3 € وانطلق اليوم

أنشئ مفتاح API من الإعدادات واستدعِ أي نموذج. أداة CLI قادمة قريبًا. تُسترد العمليات الفاشلة.