ভিডিও তৈরি করুন
জমা দেওয়া HTTP 202 ফেরত দেয় একটি ShareAI জব আইডি এবং পোলিং URL সহ।.
এই পৃষ্ঠায়
https://api.shareai.now/api/v1/videosভিডিও তৈরি করুন
- বেস URL
https://api.shareai.now- অথেন্টিকেশন
- Bearer API কী বা অনুমোদিত OAuth অ্যাক্সেস টোকেন
- প্রয়োজনীয় স্কোপ
inferenceormonetization_gateway
জমা দেওয়া HTTP 202 ফেরত দেয় একটি ShareAI কাজের ID এবং পোলিং URL সহ। একটি স্থিতিশীল Idempotency-Key অনুরোধ পুনরায় চেষ্টা করার জন্য হেডার পাঠান। একই ইনপুটের সাথে সেই কী পুনরায় ব্যবহার করা প্রত্যাখ্যান করা হয়। পোল GET /api/v1/videos/{id} একই উৎস ক্রেডেনশিয়াল দিয়ে। অবস্থাগুলির মধ্যে রয়েছে queued, pending, in_progress, finalizing, completed, failed এবং requires_review। একটি requires_review ফলাফল দলীয় সমন্বয় প্রয়োজন; পোলিং কখনও অন্য প্রজন্ম শুরু করে না।.
শুরু করার আগে#
আপনার সার্ভারে SHAREAI_API_KEY সেট করুন এবং মডেল প্লেসহোল্ডারটি বর্তমানে সক্রিয় মডেলের সাথে প্রতিস্থাপন করুন। ব্রাউজার কোডে API কী কখনো প্রকাশ করবেন না। মডেল, অ্যাকাউন্ট, ক্রেডেনশিয়াল এবং প্রোভাইডার অবশ্যই এই অপারেশন অনুমোদন করতে হবে। নিচের ঐচ্ছিক সেটিংস মডেল সমর্থনের প্রয়োজন; API নিরাপত্তা সীমা প্রতিশ্রুতি নয় যে প্রতিটি মডেল প্রতিটি মান সমর্থন করবে।.
একটি অনুরোধ পাঠান#
cURL
curl --fail-with-body --request POST "https://api.shareai.now/api/v1/videos" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
--data '{
"model": "YOUR_ENABLED_VIDEOS_MODEL",
"prompt": "A slow camera move through a quiet forest.",
"duration": 8
}'Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_VIDEOS_MODEL',
'prompt': 'A slow camera move through a quiet forest.',
'duration': 8}
headers = {'Content-Type': 'application/json', 'Idempotency-Key': 'YOUR_UNIQUE_REQUEST_ID'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/videos', data=json.dumps(payload).encode(), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
result = json.load(response)
print(result)TypeScript
const response = await fetch("https://api.shareai.now/api/v1/videos", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json", "Idempotency-Key": "YOUR_UNIQUE_REQUEST_ID"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_VIDEOS_MODEL",
"prompt": "A slow camera move through a quiet forest.",
"duration": 8
}),
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
console.log(result);অনুরোধ ক্ষেত্র#
| ক্ষেত্র | প্রকার | অর্থ এবং সীমাবদ্ধতা |
|---|---|---|
model প্রয়োজনীয় | স্ট্রিং | সঠিক সক্রিয় পাবলিক মডেল শনাক্তকারী। এই অপারেশন ঘোষণা করতে হবে এবং আপনার ক্রেডেনশিয়াল দ্বারা অনুমোদিত হতে হবে।. |
prompt প্রয়োজনীয় | স্ট্রিং | খালি নয় এমন জেনারেশন প্রম্পট, সর্বাধিক 256 KiB UTF-8 টেক্সট।. |
duration | পূর্ণসংখ্যা | সেকেন্ডে ঐচ্ছিক অনুরোধকৃত ভিডিও সময়কাল, ১–৬০০, নির্বাচিত মডেলের দ্বারা আরও সীমাবদ্ধ। প্রকৃত ফেরত সময়কাল সময়কাল বিলিং নির্ধারণ করে।. |
resolution | স্ট্রিং | মডেল-সমর্থিত রেজোলিউশন সিলেক্টর, সর্বাধিক 100 অক্ষর; প্রকাশিত ট্যারিফ ভেরিয়েন্টের সাথে মিলতে হবে।. |
aspect_ratio | স্ট্রিং | মডেল-সমর্থিত অ্যাসপেক্ট রেশিও সিলেক্টর, সর্বাধিক 100 অক্ষর।. |
size | স্ট্রিং | মডেল-সমর্থিত আউটপুট আকার, সর্বাধিক 100 অক্ষর, উদাহরণস্বরূপ 1024×1024। প্রতিটি মডেল এই অপশন সমর্থন করে না।. |
generate_audio | বুলিয়ান | ঐচ্ছিক ভিডিও সাউন্ডট্র্যাক সিলেক্টর। মডেল সমর্থন এবং মিলিত ট্যারিফ ভেরিয়েন্ট প্রয়োজন।. |
seed | পূর্ণসংখ্যা | ঐচ্ছিক মডেল-সমর্থিত সিড। ভিডিওর জন্য একটি অ-নেতিবাচক পূর্ণসংখ্যা প্রয়োজন; পুনরুত্পাদনযোগ্যতা নির্বাহকের উপর নির্ভর করে।. |
frame_images | অ্যারে | সর্বাধিক দুটি image_url অংশ, প্রতিটি frame_type first_frame বা last_frame সহ, ডুপ্লিকেট ছাড়া। frame_images এবং input_references একত্রিত করবেন না।. |
input_references | অ্যারে | সর্বাধিক 16 টাইপ করা image_url অংশ যেখানে image_url.url একটি HTTPS URL বা সমর্থিত ইমেজ ডেটা URL সেট করা হয়েছে। মডেল সমর্থন প্রয়োজন।. |
provider | অবজেক্ট | ঐচ্ছিক প্রদানকারী রাউটিং পছন্দ। গ্রহণযোগ্য প্রদানকারী ট্যাগের জন্য provider.only ব্যবহার করুন, মডেল ID-তে প্রিফিক্স নয়। অ্যাকাউন্ট এবং ক্রেডেনশিয়াল সীমাবদ্ধতা এখনও প্রযোজ্য।. |
allow_temporary_retention | বুলিয়ান | শুধুমাত্র ভিডিও। স্পষ্ট true অস্থায়ী আপস্ট্রিম ফলাফল সংরক্ষণ অনুমতি দেয় রুটগুলিতে যা এটি প্রয়োজন। বাদ দেওয়া/false সেই রুটগুলিকে অপ্রাপ্য রাখে। provider.zdr:true এর সাথে দ্বন্দ্ব; অন্যান্য অপারেশন বাধ্যতামূলক ZDR সংরক্ষণ করে।. |
ফলাফল পড়ুন#
সফলতা HTTP 202 ফেরত দেয় JSON সহ। জমা দেওয়া HTTP 202 ফেরত দেয় একটি ShareAI কাজের ID এবং পোলিং URL সহ। একটি স্থিতিশীল Idempotency-Key অনুরোধ পুনরায় চেষ্টা করার জন্য হেডার পাঠান। একই ইনপুটের সাথে সেই কী পুনরায় ব্যবহার করা প্রত্যাখ্যান করা হয়। পোল GET /api/v1/videos/{id} একই উৎস ক্রেডেনশিয়াল দিয়ে। অবস্থাগুলির মধ্যে রয়েছে queued, pending, in_progress, finalizing, completed, failed এবং requires_review। একটি requires_review ফলাফল দলীয় সমন্বয় প্রয়োজন; পোলিং কখনও অন্য প্রজন্ম শুরু করে না।.
বিলিং ইউনিট#
ভিডিও রুটগুলি তাদের বিলড ইউনিট ঘোষণা করে। প্রতি-সেকেন্ড রুট প্রতিটি ফেরত ফাইলের পরিমাপিত সময়কাল ব্যবহার করে নিষ্পত্তি করে, কখনও অনুরোধকৃত সময়কাল বা আপস্ট্রিম USD খরচ নয়। অনুরোধকৃত সময়কাল ১ থেকে ৬০০ সেকেন্ডের মধ্যে হতে হবে এবং মডেল দ্বারা সমর্থিত হতে হবে। একটি রক্ষণশীল ক্রেডিট হোল চারটি আউটপুট পর্যন্ত কভার করতে পারে।.
Console থেকে সঠিক সক্রিয় মডেল আইডেন্টিফায়ার নির্বাচন করুন। এর ঘোষিত অপারেশন এবং ইনপুট/আউটপুট সক্ষমতা এই এন্ডপয়েন্টের সাথে মিলতে হবে; একটি টেক্সট চ্যাট মডেল অন্য অপারেশনের জন্য প্রতিস্থাপন করা যাবে না। আপনার ক্রেডেনশিয়াল, প্রোভাইডার এবং অ্যাকাউন্ট সীমাবদ্ধতা এখনও প্রযোজ্য।.
মূল্য নির্ধারণ এবং ব্যবহার#
নির্বাচিত মডেল, প্রোভাইডার, ইউনিট এবং ভেরিয়েন্টের জন্য EUR AI ক্রেডিটে রেট প্রকাশিত হয়। শুধুমাত্র এর সক্রিয় ট্যারিফের মাত্রাগুলি চার্জ করা হয়। একটি অনুমান কার্যকর করার আগে ক্রেডিট সংরক্ষণ করে; চূড়ান্ত চার্জ পরিমাপ করা ব্যবহারের উপর ভিত্তি করে। মূল্য রেজোলিউশন, আউটপুট ফরম্যাট বা একটি ব্যবহার ব্যান্ডের উপর নির্ভর করতে পারে। চূড়ান্ত ShareAI ডেবিটের জন্য Console Usage চেক করুন। আপস্ট্রিম খরচ ক্ষেত্র এবং মিডিয়া বাইটগুলি উদ্ভাবিত টোকেন গণনায় রূপান্তরিত হয় না।.
অ্যাক্সেস এবং ত্রুটি#
ব্যবহার inference অনুমোদিত নেটওয়ার্ক-খরচ ইনফারেন্সের জন্য বা monetization_gateway অনুমোদিত Builder মার্কআপ এবং গৃহীত বিলিং শর্তের জন্য। শুধুমাত্র পরিচয়-ভিত্তিক অ্যাক্সেস ব্যয় অনুমোদন করে না। যাচাই, মডেল অনুমোদন, অপর্যাপ্ত ক্রেডিট, রেট সীমা এবং কার্যকরী ব্যর্থতা একটি গঠিত error. টাইমআউট বা অনিশ্চিত জমা দেওয়ার পরে, Usage বা ভিডিও কাজটি পরিদর্শন করুন অন্য একটি সম্ভাব্য অর্থপ্রদত্ত অনুরোধ তৈরি করার আগে।.
অস্থায়ী ভিডিও সংরক্ষণ#
কিছু ভিডিও রুট অস্থায়ী আপস্ট্রিম সংরক্ষণ প্রয়োজন যাতে তৈরি ফলাফল পুনরুদ্ধার করা যায়। তারা আপনার স্পষ্ট allow_temporary_retention:true সেই ভিডিও অনুরোধে গ্রহণযোগ্যতা প্রয়োজন। এটি বাদ দিলে সেই রুটগুলিকে অপ্রাপ্য রাখে। এই ব্যতিক্রম শুধুমাত্র ভিডিওর জন্য প্রযোজ্য এবং কখনও মডেল প্রশিক্ষণ বা অন্যান্য অপারেশনের জন্য সংরক্ষণ অনুমতি দেয় না। একটি স্পষ্ট ZDR নীতি নীরবে দুর্বল করা যাবে না।.
JSON
{"allow_temporary_retention": true}কাজের অবস্থা পরীক্ষা করুন#
https://api.shareai.now/api/v1/videos/{id}তার উৎস ক্রেডেনশিয়াল দিয়ে একটি ভিডিও প্রজন্ম পড়ুন
- বেস URL
https://api.shareai.now- অথেন্টিকেশন
- Bearer API কী বা অনুমোদিত OAuth অ্যাক্সেস টোকেন
- প্রয়োজনীয় স্কোপ
inferenceormonetization_gateway
JSON
{
"id": "YOUR_JOB_ID",
"object": "video",
"status": "pending",
"created_at": 1793664000,
"polling_url": "/api/v1/videos/YOUR_JOB_ID"
}উপরের JSON স্থিতিশীল কাজের ক্ষেত্রগুলি চিত্রিত করে, একটি বাস্তব প্রজন্ম নয়। একই কী দিয়ে ShareAI পথ পোল করুন, চেকগুলির মধ্যে অপেক্ষা করুন। queued, pending, in_progress এবং finalizing মানে অপেক্ষা করুন; completed ShareAI বিষয়বস্তু URL সহ ডেটা প্রকাশ করে; failed এবং requires_review মানে থামুন এবং পরিদর্শন করুন। অস্থায়ী ত্রুটির পরে পুনরায় চেষ্টা করুন, তবে প্রজন্ম স্বয়ংক্রিয়ভাবে পুনরায় জমা দেবেন না। একটি ভিন্ন বা প্রত্যাহৃত ক্রেডেনশিয়াল কাজটি পুনরুদ্ধার করতে পারে না।.
cURL
curl --fail-with-body "https://api.shareai.now/api/v1/videos/YOUR_JOB_ID" \
-H "Authorization: Bearer $SHAREAI_API_KEY"ফলাফল ডাউনলোড করুন#
সম্পন্ন হলে, প্রতিটি ডেটা এন্ট্রি একটি ShareAI বিষয়বস্তু URL ধারণ করে। আনুন GET /api/v1/videos/{id}/content?index=0 একই উৎস ক্রেডেনশিয়াল ব্যবহার করে। এন্ডপয়েন্ট একটি একক HTTP বাইট রেঞ্জ সমর্থন করে। Provider URLs, private tickets এবং provider credentials কখনও ফেরত দেওয়া হয় না। পোলিং এবং ডাউনলোডিং একটি দ্বিতীয় ইনফারেন্স অনুরোধ বা Monetization Gateway ingestion চার্জ তৈরি করে না। একটি সম্পন্ন কাজ মানে নিষ্পত্তি নিশ্চিত হয়েছে ফাইল ডাউনলোডযোগ্য হওয়ার আগে।.
cURL
curl --fail-with-body "https://api.shareai.now/api/v1/videos/YOUR_JOB_ID/content?index=0" \
-H "Authorization: Bearer $SHAREAI_API_KEY" --output result.mp4ঐচ্ছিক frame_images-এ প্রথম ফ্রেম বা শেষ ফ্রেমের image_url অংশ থাকতে হবে। এক অনুরোধে frame images বা reference images ব্যবহার করুন, দুটো একসাথে নয়। মডেলের সময়কাল, রেজোলিউশন এবং অ্যাসপেক্ট রেশিও API-এর নিরাপত্তা সীমার চেয়ে বেশি সীমাবদ্ধ হতে পারে। Webhooks এবং ইচ্ছামত callback URLs সমর্থিত নয়।.
সর্বশেষ আপডেট নভেম্বর 3, 2026