المصادقة
رمز Bearer في ترويسة Authorization. أنشئ المفاتيح من الإعدادات وألغِ أيًّا منها في أي وقت.
Authorization: Bearer dk_live_...صور وفيديو وصوت وثلاثي الأبعاد خلف واجهة API واحدة، بنفس رصيد الاستوديو. أنشئ مفتاحًا من الإعدادات؛ أداة CLI قادمة قريبًا.
قريبًاأداة Ducklygen CLI في الطريق. تعرض هذه الصفحة كيف ستعمل؛ وحتى ذلك الحين استخدم واجهة API.
npm i -g @ducklygen/cliغيّر معرّف النموذج للتبديل بين الصورة والفيديو والكلام. الحقول تتبع النموذج.
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"
}
}'const res = await fetch("https://ducklygen.com/api/v1/api/catalog/generations", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.DUCKLYGEN_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({ modelId: "image-model-id", inputs: { prompt: "rubber duck floating on teal water, soft light" } }),
});
const job = await res.json(); // { id, status: "queued" }import os, requests
job = requests.post(
"https://ducklygen.com/api/v1/api/catalog/generations",
headers={"Authorization": f"Bearer {os.environ['DUCKLYGEN_API_KEY']}"},
json={"modelId": "image-model-id", "inputs": {"prompt": "rubber duck floating on teal water, soft light"}},
).json() # { id, status: "queued" }
سجّل الدخول ببريدك الإلكتروني، وافتح الإعدادات ثم مفاتيح API وأنشئ مفتاحًا. اشحن رصيدك بدءًا من 3 € في صفحة الفواتير.
export DUCKLYGEN_API_KEY="dk_live_..."أداة سطر الأوامر لم تُنشر بعد. حتى ذلك الحين يعمل كل شيء في الاستوديو.
npm i -g @ducklygen/cliاختر معرّف نموذج من الكتالوج وأرسل وصفًا. أضف --dry-run لمعرفة السعر دون إنفاق أي شيء.
ducklygen run <model> -p "duck on teal waves" -o ./out/شغّل أي نموذج من shell أو مهمة CI أو وكيل برمجة. يُحدَّد سعر كل عملية توليد قبل بدئها ويُخصم من الرصيد نفسه.
الحزمة @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 الكامل →
/meمفتاحك ورصيدك/modelsكل النماذج/models/detail?id=MODEL_IDنموذج واحد وحقوله/quoteالسعر لمدخلات محددة/generationsبدء التوليد/generationsعمليات التوليد الأخيرة/generations/IDحالة عملية توليد واحدة/generations/ID/contentملف النتيجة/generations/IDحذف عملية توليدأنشئ مفتاح API من الإعدادات واستدعِ أي نموذج. أداة CLI قادمة قريبًا. تُسترد العمليات الفاشلة.