सामग्री पर जाएँ
हिन्दी
API कुंजी प्राप्त करें
API गाइड

फ़ाइलें

Markdown के रूप में देखें अपडेट किया गया

इमेज, वीडियो या ऑडियो लेने वाले मॉडल इन्हें तीन में से किसी भी रूप में स्वीकार करते हैं। हर मॉडल पेज अपने फ़ाइल पैरामीटर (उदाहरण के लिए image, images, videos, audios) चिह्नित करता है।

1. सार्वजनिक URL

कोई भी https:// (या http://) URL जिसे मॉडल डाउनलोड कर सके:

JSON
{ "image": "https://example.com/photos/product.jpg" }

फ़ाइल कुकी या लॉगिन के बिना पहुँच योग्य होनी चाहिए और अनुरोध शुरू होने तक पहुँच योग्य बनी रहनी चाहिए। हर मॉडल पेज अपने फ़ाइल पैरामीटर की आकार और आयाम सीमाएँ सूचीबद्ध करता है।

2. डेटा URI

छोटी फ़ाइलों को अधिकतम 10 MB की data: URI के रूप में इनलाइन भेजा जा सकता है:

JSON
{ "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..." }

Base64 से बॉडी फ़ाइल की तुलना में लगभग एक-तिहाई बड़ी हो जाती है, इसलिए बड़ी फ़ाइलों के लिए अपलोड को प्राथमिकता दें।

3. अपलोड

स्थानीय फ़ाइलों के लिए, अपलोड URL माँगें, वहाँ बाइट्स को PUT करें और लौटाए गए file_url को मॉडल को दें। अपलोड URL बनाना निःशुल्क है।

1 · अपलोड URL प्राप्त करें
curl -X POST "https://api.doitong.com/v1/files" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filename": "product.jpg", "content_type": "image/jpeg", "size": 482113}'
201 Created · अपलोड
{
  "object": "upload",
  "upload_url": "https://…signed upload URL…",
  "file_url": "https://content.doitong.com/…/product.jpg",
  "method": "PUT",
  "headers": { "Content-Type": "image/jpeg" },
  "content_type": "image/jpeg",
  "expires_in": 3600,
  "max_bytes": 15728640
}
2 · लौटाए गए हेडर के साथ बाइट्स अपलोड करें
curl -X PUT "<upload_url>" -H "Content-Type: image/jpeg" --data-binary @product.jpg
3 · मॉडल इनपुट के रूप में file_url का उपयोग करें
curl -X POST "https://api.doitong.com/v1/run/{model_id}?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image": "https://content.doitong.com/…/product.jpg", "prompt": "..."}'
  • समर्थित अपलोड: .jpg, .jpeg, .png, .webp (अधिकतम 15 MB) और .mp4, .mov, .webm (अधिकतम 200 MB)। एक्सटेंशन प्रकार निर्धारित करता है; content_type उससे मेल खाना चाहिए।
  • अपलोड URL एक घंटे के लिए मान्य होता है। file_url मान्य बना रहता है।
  • ऑडियो के लिए सार्वजनिक URL या डेटा URI का उपयोग करें।

आउटपुट फ़ाइल

आप चुनते हैं कि आउटपुट फ़ाइलें कितने समय तक रखी जाएँ:

  • हमेशा के लिए (permanent, डिफ़ॉल्ट): जब तक आप उन्हें हटा न दें, प्रति GB प्रति माह 100 API क्रेडिट ($0.10), API शेष राशि से दिन में एक बार शुल्क लिया जाएगा (1 GB = 1024³ bytes)।
  • 7 दिन (temporary): निःशुल्क, इसके बाद हमारे स्टोरेज से हटा दी जाएँगी।

डैशबोर्ड में "फ़ाइलें हमेशा के लिए रखें" स्विच से डिफ़ॉल्ट सेट करें या PATCH /account/storage से सेट करें, और प्रति रन इसे ?storage=temporary (या permanent) से ओवरराइड करें:

टर्मिनल
curl -X PATCH "https://api.doitong.com/v1/account/storage" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mode": "temporary"}'

हर अनुरोध अपना storage (mode, bytes, expires_at, expired) दिखाता है। यह सेटिंग नए अनुरोधों पर लागू होती है; पहले से हमेशा के लिए रखी गई फ़ाइलें तब तक बनी रहती हैं जब तक आप उन्हें DELETE /requests/{id}/files से हटा न दें (देखें अनुरोध)। यदि API शेष राशि स्टोरेज का भुगतान नहीं कर सकती, तो आपको एक ईमेल मिलेगा और रखी गई फ़ाइलों के अस्थायी होने से पहले टॉप-अप करने के लिए 30 दिन मिलेंगे।