Ducklygen API

कैटलॉग का हर मॉडल, आपके अपने कोड से। एक key, एक बैलेंस, स्टूडियो जैसी ही कीमतें।

मॉडल देखेंडेवलपर

1 · ऑथेंटिकेशन

सेटिंग्स में API keys पर जाकर एक key बनाएँ। हर रिक्वेस्ट के साथ इसे Bearer टोकन के रूप में भेजें। Keys dk_live_ से शुरू होती हैं और सिर्फ़ Ducklygen पर काम करती हैं; इन्हें अपने सर्वर पर रखें, कभी भी ब्राउज़र या ऐप में नहीं।

curl https://ducklygen.com/api/v1/api/catalog/me \
  -H "Authorization: Bearer $DUCKLYGEN_API_KEY"

3 · रेंडर शुरू करें

एक कॉल आपके सटीक इनपुट की कीमत तय करती है और बैलेंस से काट लेती है। जवाब तुरंत status queued के साथ आता है; रेंडर बैकग्राउंड में चलता है। Idempotency-Key हेडर भेजें ताकि दोबारा भेजी गई रिक्वेस्ट पर कभी दो बार पैसे न कटें।

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"
  }
}'

पहले कीमत जाँचें (वैकल्पिक)

वही इनपुट, बिना कुछ शुरू किए कीमत के साथ। जवाब सेंट में होता है।

curl -X POST https://ducklygen.com/api/v1/api/catalog/quote \
  -H "Authorization: Bearer $DUCKLYGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"modelId":"image-model-id","inputs":{"prompt":"rubber duck floating on teal water, soft light"}}'

4 · स्टेटस जाँचें और डाउनलोड करें

हर कुछ सेकंड में रेंडर का स्टेटस पूछें, जब तक status succeeded, failed या refunded न हो जाए। सफल होने पर उसी key से contentUrl से फ़ाइल डाउनलोड करें। टेक्स्ट मॉडल अपना जवाब इसके बजाय textOutput में लौटाता है।

curl https://ducklygen.com/api/v1/api/catalog/generations/ID \
  -H "Authorization: Bearer $DUCKLYGEN_API_KEY"

curl https://ducklygen.com/api/v1/api/catalog/generations/ID/content \
  -H "Authorization: Bearer $DUCKLYGEN_API_KEY" \
  -o result.png

एंडपॉइंट

बेस URLhttps://ducklygen.com/api/v1/api/catalog

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रेंडर हटाएँ

एरर और सीमाएँ

एरर JSON में एक कोड और संदेश के साथ लौटते हैं। 401: key नहीं है, गलत है या रद्द की गई है। 400: कोई फ़ील्ड अमान्य है (डिटेल में उसका नाम होता है)। 402: बैलेंस काफ़ी नहीं है। 409 API_KEY_DAILY_CAP: key की अपनी दैनिक सीमा पूरी हो गई है। 429: बहुत ज़्यादा रिक्वेस्ट, रफ़्तार कम करें। असफल रेंडर का पैसा अपने आप लौटा दिया जाता है।

कीमतें और बैलेंस

API रेंडर स्टूडियो वाला ही बैलेंस इस्तेमाल करते हैं और उनकी कीमत भी वही है। API में हर रकम यूरो सेंट में होती है: costCents बताता है कि रेंडर पर कितना कटा, balanceCents बताता है कि कितना बचा है।