डेवलपर · API v1

एक API. हर मॉडल.

इमेज, वीडियो, ऑडियो और 3D एक API के पीछे, स्टूडियो वाले ही बैलेंस से। कुंजी सेटिंग्स में बनाएं; CLI जल्द आ रहा है।

जल्द आ रहा हैDucklygen CLI जल्द आ रहा है। यह पेज दिखाता है कि वह कैसे काम करेगा; तब तक API का उपयोग करें।

$npm i -g @ducklygen/cli
मॉडल
672
एंडपॉइंट
9
न्यूनतम टॉप-अप
€3

एक ही कॉल, कोई भी आउटपुट

इमेज, वीडियो और स्पीच के बीच बदलने के लिए बस मॉडल ID बदलें। फ़ील्ड मॉडल के अनुसार होते हैं।

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 key बनाएँ

    अपने ईमेल से साइन इन करें, Settings में API keys खोलें और एक key बनाएँ। Billing में €3 से टॉप-अप करें।

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

    CLI जल्द आ रहा है

    कमांड-लाइन टूल अभी प्रकाशित नहीं हुआ है। तब तक सब कुछ स्टूडियो में चलता है।

    npm i -g @ducklygen/cli
  3. 3

    पहला रेंडर करें

    कैटलॉग से मॉडल ID चुनें और प्रॉम्प्ट भेजें। बिना कुछ खर्च किए कीमत देखने के लिए --dry-run जोड़ें।

    ducklygen run <model> -p "duck on teal waves" -o ./out/
जल्द आ रहा हैDucklygen CLI

टर्मिनल से रेंडर करें

किसी भी मॉडल को shell, CI जॉब या कोडिंग एजेंट से चलाएँ। हर रेंडर की कीमत शुरू होने से पहले तय होती है और उसी बैलेंस से कटती है।

स्क्रिप्ट और CIमॉडल का हर फ़ील्ड एक फ़्लैग है; लोकल फ़ाइल आपके लिए अपलोड हो जाती है।
stdout पर JSONहर रन पर एक JSON डॉक्यूमेंट, प्रोग्रेस और एरर stderr पर, विफल होने पर नॉन-ज़ीरो एग्ज़िट कोड।
कोडिंग एजेंटएक skill फ़ाइल आपके एजेंट को पहले कीमत जाँचना और उसकी सीमा तय करना सिखाती है।

@ducklygen/cli पैकेज अभी प्रकाशित नहीं हुआ है। नीचे दिए कमांड दिखाते हैं कि यह कैसे काम करेगा।

पूरी CLI गाइड →
कमांड
ducklygen loginअपनी API key एक बार पेस्ट करें; वह जाँचकर सेव हो जाती है
ducklygen whoamikey का नाम और आपका बैलेंस
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 इस्तेमाल करना सिखाएँ

प्रोडक्शन के लिए बना

ऑथेंटिकेशन

Authorization हेडर में एक Bearer टोकन। Settings में keys बनाएँ और किसी को भी कभी भी रद्द करें।

Authorization: Bearer dk_live_...

बैकग्राउंड रेंडर

रेंडर शुरू करने पर तुरंत queued स्टेटस मिलता है। रेंडर को तब तक पोल करें जब तक वह सफल, विफल या रिफ़ंड न हो जाए।

{ "status": "queued" }

पहले कीमत

कुछ भी शुरू किए बिना अपने इनपुट की सटीक कीमत पूछें। हर राशि यूरो सेंट में है।

POST /v1/quote

सुरक्षित रीट्राई

Idempotency-Key हेडर भेजें, तो दोबारा भेजा गया अनुरोध कभी दो बार चार्ज नहीं होगा।

Idempotency-Key: render-042

सीमाएँ

हर key की प्रति मिनट सीमा और एक वैकल्पिक दैनिक सीमा होती है। सीमा पार होने पर API 429 लौटाता है।

429 Too Many Requests

एरर और रिफ़ंड

कोड और मैसेज के साथ JSON एरर। विफल रेंडर अपने आप आपके बैलेंस में रिफ़ंड हो जाता है।

{ "status": "refunded" }

एंडपॉइंट

बेस URLhttps://ducklygen.com/api/v1/api/catalogपूरा API रेफ़रेंस →

GET/meआपकी key और बैलेंस
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 जल्द आ रहा है। विफल रेंडर लौटा दिए जाते हैं।