কনটেন্টে যান
বাংলা
API কী পান
API গাইড

ফাইল

Markdown হিসেবে দেখুন আপডেট করা হয়েছে

যে মডেলগুলো ছবি, ভিডিও বা অডিও নেয়, সেগুলো তিনটির যেকোনো একটি ফর্মে গ্রহণ করে। প্রতিটি মডেল পেজে তার ফাইল প্যারামিটারগুলো চিহ্নিত করা থাকে (যেমন image, images, videos, audios)।

1. একটি সর্বজনীন URL

মডেলটি ডাউনলোড করতে পারে এমন যেকোনো https:// (অথবা http://) URL:

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

ফাইলটি কুকি বা লগইন ছাড়াই অ্যাক্সেসযোগ্য হতে হবে এবং রিকোয়েস্ট শুরু হওয়া পর্যন্ত অ্যাক্সেসযোগ্য থাকতে হবে। প্রতিটি মডেল পেজে তার ফাইল প্যারামিটারের আকার ও মাত্রার সীমা দেওয়া থাকে।

2. একটি data 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.ru/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.ru/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 অথবা data URI ব্যবহার করুন।

আউটপুট ফাইল

আউটপুট ফাইল কতক্ষণ রাখা হবে তা আপনি বেছে নিতে পারেন:

  • চিরকাল (permanent, ডিফল্ট): আপনি মুছে না দেওয়া পর্যন্ত, প্রতি GB প্রতি মাসে ১০০ API ক্রেডিট (০.১০$), দিনে একবার API ব্যালান্স থেকে চার্জ করা হবে (1 GB = 1024³ bytes)।
  • ৭ দিন (temporary): বিনামূল্যে, এরপর আমাদের স্টোরেজ থেকে মুছে ফেলা হবে।

ড্যাশবোর্ড-এর "ফাইল চিরকাল সংরক্ষণ করুন" সুইচ দিয়ে ডিফল্ট নির্ধারণ করুন অথবা PATCH /account/storage ব্যবহার করুন, এবং প্রতি রানের জন্য ?storage=temporary (অথবা permanent) দিয়ে তা পরিবর্তন করুন:

টার্মিনাল
curl -X PATCH "https://api.doitong.ru/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 ব্যালান্স স্টোরেজের খরচ পরিশোধ করতে না পারলে, আপনি একটি ইমেল পাবেন এবং রাখা ফাইলগুলো অস্থায়ী হয়ে যাওয়ার আগে টপ-আপ করার জন্য ৩০ দিন সময় পাবেন।