跳转到内容

অডিও, ভিডিও এবং কণ্ঠস্বর

একটি মিডিয়া জব তৈরি হওয়ার সাথে সাথেই চালু হয় এবং সার্ভার যে ব্যবহারের পরিমাণ পরিমাপ করে, তার জন্য ক্রেডিট মূল্যে চার্জ করা হয়। প্রথমে ক্যাটালগটি পড়ুন; শুধুমাত্র ওপেন চিহ্নিত পণ্যগুলোই চালানো যেতে পারে।

মূল্য সরাসরি ক্রেডিটে দেওয়া হয়:

পণ্যproductমূল্য
কথ্য চিহ্নিতকরণasr20 ক্রেডিট/মিনিট; fun-asr রিয়েল-টাইম মডেল 30 ক্রেডিট/মিনিট (মিলিসেকেন্ড অনুযায়ী চার্জ করা হয়)
উপশিরোনামের অনুবাদsubtitle_translation60 ক্রেডিট/মিনিট
মৌলিক ভিডিও প্রক্রিয়াকরণ (অনুবাদিত সাবটাইটেল, আসল অডিও)basic_video80 ক্রেডিট/মিনিট
সম্পূর্ণ ভিডিও প্রক্রিয়াকরণ (অনুবাদিত সাবটাইটেল এবং ডাবিং)full_video300 ক্রেডিট/মিনিট
কথ্য সংশ্লেষণtts10,000 বিলযোগ্য অক্ষরের জন্য 1,500 ক্রেডিট
একটি ভয়েসের প্রথম সফল ব্যবহার—প্রতি ভয়েসের জন্য 300 ক্রেডিট, একবার চার্জ করা হয়
  • কণ্ঠস্বর সনাক্তকরণের মূল্য নির্ধারিত হয় ব্যবহৃত সনাক্তকরণ মডেলের উপর; উভয় মডেলের মূল্য credit-catalog-এর prices (অর্থাৎ model ফিল্ড)-এ পৃথকভাবে তালিকাভুক্ত করা আছে।
  • সময়কাল মিলিসেকেন্ডে গণনা করা হয়: কথ্য চিহ্নিতকরণ এবং উপশিরোনাম অনুবাদের জন্য উৎসের সময়কাল, ভিডিওর জন্য সরবরাহিত ভিডিওর সময়কাল।
  • কথ্য সংশ্লেষণের জন্য চার্জযোগ্য অক্ষর: প্রতিটি চীনা অক্ষর 2 হিসেবে গণ্য হয়, অন্যান্য প্রতিটি অক্ষর (স্থান এবং বিরামচিহ্ন সহ) 1 হিসেবে গণ্য হয়।
  • একটি পণ্যের জন্য প্রয়োজনীয় স্বীকৃতি, অনুবাদ, ডাবিং এবং অন্যান্য ধাপগুলো তার মূল্যের মধ্যে অন্তর্ভুক্ত। যদি অনুরোধটি কম-স্তরের ফলাফল (allowed_fallback_products) গ্রহণ করে এবং সেই ফলাফলটি সরবরাহ করা হয়, তবে সরবরাহকৃত পণ্যের মূল্য প্রযোজ্য হবে।
  • খরচ = প্রতি ইউনিটের মূল্য × ব্যবহার, যা 0.001 ক্রেডিটে (1 মিলিক্রেডিট) গোলাকার করা হয়।
GET /api/v1/billing/media/credit-catalog
POST /api/v1/billing/media/credit-estimates

credit-catalog প্রতিটি পণ্যের মূল্য (prices, মিলিক্রেডিটে) এবং এটি খোলা আছে কিনা তা ফেরত দেয়; credit-estimates একটি নির্দিষ্ট সময়কাল, পাঠ্য বা ভয়েসের সংখ্যার জন্য প্রয়োজনীয় ক্রেডিট (rounded_millicredits) গণনা করে। এটি শুধুমাত্র প্রদর্শনের জন্য: এটি কোনো কাজ তৈরি করে না এবং কোনো চার্জ ধার্য করে না।

একটি কাজ তৈরি করুন

Section titled “একটি কাজ তৈরি করুন”
POST /api/v1/media-jobs
Idempotency-Key: unique-request-id

পণ্যসমূহ:

productউদ্দেশ্য
asrকথ্য চিহ্নিতকরণ
ttsকথ্য সংশ্লেষণ
subtitle_translationঅডিও এবং ভিডিওর জন্য সাবটাইটেল অনুবাদ
basic_videoমৌলিক ভিডিও প্রক্রিয়াকরণ
full_videoসম্পূর্ণ ভিডিও প্রক্রিয়াকরণ

কথ্য চিহ্নিতকরণের উদাহরণ:

{
"product": "asr",
"document_id": "4q8mx2q9z1k7p6ra",
"source_language": "auto",
"max_duration_ms": 600000
}

কথ্য সংশ্লেষণ (tts) ব্যতীত প্রতিটি পণ্যের জন্য max_duration_ms (মিলিসেকেন্ড, সর্বোচ্চ 21600000, যা 6 ঘণ্টা) প্রয়োজন।

ক্রিয়েট অনুরোধ $ 202 $ ফেরত দেওয়ার পর, সার্ভার ফাইলটি চেক করে এবং প্রক্রিয়াকরণ শুরু করে:

  1. শুরু হওয়ার আগে কেবল ব্যালেন্স পরীক্ষা করা হয় : ব্যালেন্স (ঋণ বিয়োগ করে) সার্ভার পরিমাপ করা সময়কাল থেকে গণনা করা খরচের ঊর্ধ্বে থাকতে হবে (কথ্য সংশ্লেষণের জন্য, চার্জ করা অক্ষর থেকে, যার মধ্যে এখনও আদায় করা না হওয়া প্রথম ব্যবহারের ভয়েস ফি অন্তর্ভুক্ত); একটি বাজেটযুক্ত API কী ব্যবহার করলে, কীটির অবশিষ্ট বাজেটও ওই খরচের ঊর্ধ্বে থাকতে হবে। শুরু হলে ব্যালেন্স পরিবর্তিত হয় না।
  2. প্রকৃত ব্যবহার শেষ হলে চার্জ করা হয় : সরবরাহিত পণ্য এবং ব্যবহারের উপর ভিত্তি করে মূল্য নির্ধারণ করা হয় এবং চার্জ করা হয়। ব্যালেন্স যা কভার করতে পারে না তা ঋণ হিসেবে রেকর্ড করা হয় এবং ব্যালেন্স নেগেটিভ হিসেবে দেখায়; পরে আসা ক্রেডিটগুলো প্রথমে ঋণ পরিশোধ করে। ব্যালেন্স নেগেটিভ থাকা অবস্থায় নতুন জব শুরু করা যায় না।
  3. ব্যর্থ বা বাতিল হওয়া কাজের জন্য কোনো চার্জ ধার্য করা হয় না।

যখন ব্যালেন্স খুব কম থাকে বা সময়কাল উপযুক্ত না হয়, তখন কিছুই শুরু হয় না এবং কোনো চার্জও ধার্য করা হয় না: স্পিচ সিন্থেসিস তৈরির সময় পরীক্ষা করা হয় এবং ব্যালেন্স খুব কম থাকলে 402 ফেরত দেয়; অন্যান্য পণ্যগুলো সার্ভার সময়কাল পরিমাপ করার পর পরীক্ষা করা হয়, এবং কাজটি error_code insufficient_credits (ব্যালেন্স খুব কম) বা media_duration_exceeds_confirmed_cap (প্রকৃত সময়কাল max_duration_ms অতিক্রম করেছে) সহ ব্যর্থ হয়ে শেষ হয়।

অনুসন্ধান করুন এবং বাতিল করুন

Section titled “অনুসন্ধান করুন এবং বাতিল করুন”
GET /api/v1/media-jobs/{operation_id}
GET /api/v1/media-jobs?limit=25
POST /api/v1/media-jobs/{operation_id}/cancel

ক্যোয়ারির প্রতিক্রিয়ায় জবের স্ট্যাটাস, ডেলিভারি করা ফাইলগুলো এবং সেটেলমেন্ট রেফারেন্স অন্তর্ভুক্ত থাকে।

GET /api/v1/media-voices
POST /api/v1/media-voices
GET /api/v1/media-voices/{asset_id}
POST /api/v1/media-voices/{asset_id}/confirm
POST /api/v1/media-voices/{asset_id}/reconcile
POST /api/v1/media-voices/{asset_id}/revoke

reconcile একটি অনিশ্চিত রিমোট ফলাফল পুনরুদ্ধার করে; এটি কেবল আসল অপারেশনটি পরীক্ষা করে এবং কখনও দ্বিতীয় ভয়েস তৈরি করে না।

একটি ভয়েস তৈরি করতে আপনাকে রেকর্ডিংয়ের উপর আপনার অধিকার নিশ্চিত করতে হবে:

{
"document_id": "authorized_recording_document_id",
"consent": true,
"consent_version": "voice-source-rights-v1"
}

কলার দায়িত্ব হলো নিশ্চিত করা যে রেকর্ডিংটি তার নিজস্ব অথবা বৈধ অনুমতি সহকারে ব্যবহৃত হচ্ছে।