تولید ویدئوها
ارسال HTTP 202 را با شناسه کار ShareAI و URL نظرسنجی بازمیگرداند.
در این صفحه
https://api.shareai.now/api/v1/videosتولید ویدئوها
- URL پایه
https://api.shareai.now- احراز هویت
- کلید API Bearer یا توکن دسترسی OAuth تأییدشده
- دامنه مورد نیاز
inferenceormonetization_gateway
ارسال HTTP 202 را با شناسه کار ShareAI و URL نظرسنجی بازمیگرداند. یک Idempotency-Key هدر پایدار برای تلاشهای مجدد همان درخواست ارسال کنید. استفاده مجدد از آن کلید با ورودی متفاوت رد میشود. نظرسنجی GET /api/v1/videos/{id} با همان اعتبار اولیه انجام شود. وضعیتها شامل صفبندی، در انتظار، در حال انجام، نهاییسازی، تکمیلشده، شکستخورده و نیازمند بررسی هستند. نتیجه نیازمند بررسی به هماهنگی تیم نیاز دارد؛ نظرسنجی هرگز تولید دیگری را آغاز نمیکند.
قبل از شروع#
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 کیلوبایت متن UTF-8. |
duration | عدد صحیح | مدت زمان ویدئوی درخواستشده اختیاری به ثانیه، 1–600، که توسط مدل انتخابشده محدود شده است. مدت زمانهای بازگشتی واقعی تعیینکننده صورتحساب مدت زمان هستند. |
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 تنظیمشده به یک URL HTTPS یا URL داده تصویر پشتیبانیشده. پشتیبانی مدل لازم است. |
provider | شیء | تنظیمات اختیاری ترجیحات مسیریابی ارائهدهنده. از provider.only برای برچسبهای ارائهدهنده پذیرفتهشده استفاده کنید، نه یک پیشوند در شناسه مدل. محدودیتهای حساب و اعتبار همچنان اعمال میشوند. |
allow_temporary_retention | بولین | فقط ویدئو. true صریح اجازه نگهداری موقت نتیجه بالادستی را در مسیرهایی که به آن نیاز دارند میدهد. حذفشده/false این مسیرها را غیرقابل دسترس نگه میدارد. با provider.zdr:true تضاد دارد؛ عملیات دیگر نگهداری اجباری ZDR را حفظ میکنند. |
خواندن نتیجه#
موفقیت HTTP 202 را با JSON بازمیگرداند. ارسال HTTP 202 را با شناسه کار ShareAI و URL نظرسنجی بازمیگرداند. یک Idempotency-Key هدر پایدار برای تلاشهای مجدد همان درخواست ارسال کنید. استفاده مجدد از آن کلید با ورودی متفاوت رد میشود. نظرسنجی GET /api/v1/videos/{id} با همان اعتبار اولیه انجام شود. وضعیتها شامل صفبندی، در انتظار، در حال انجام، نهاییسازی، تکمیلشده، شکستخورده و نیازمند بررسی هستند. نتیجه نیازمند بررسی به هماهنگی تیم نیاز دارد؛ نظرسنجی هرگز تولید دیگری را آغاز نمیکند.
واحدهای صورتحساب#
مسیرهای ویدئویی واحدهای صورتحساب خود را اعلام میکنند. یک مسیر بر اساس ثانیه با استفاده از مدت زمان اندازهگیریشده هر فایل بازگشتی تسویه میشود، نه مدت زمان درخواستشده یا هزینه USD بالادستی. مدت زمان درخواستشده باید بین 1 تا 600 ثانیه باشد و توسط مدل پشتیبانی شود. یک نگهداری اعتبار محافظهکارانه میتواند تا چهار خروجی را پوشش دهد.
مدل فعال مورد نظر را از Console انتخاب کنید. عملیات اعلامشده و قابلیتهای ورودی/خروجی آن باید با این نقطه پایانی مطابقت داشته باشد؛ یک مدل چت متنی نمیتواند جایگزین عملیات دیگری شود. محدودیتهای اعتبارنامه، ارائهدهنده و حساب شما همچنان اعمال میشوند.
قیمتگذاری و استفاده#
نرخها به صورت اعتبارهای AI به یورو برای مدل انتخابشده، ارائهدهنده، واحدها و انواع منتشر میشوند. فقط ابعاد موجود در تعرفه فعال آن شارژ میشوند. یک تخمین اعتبارها را قبل از اجرا رزرو میکند؛ هزینههای نهایی بر اساس استفاده اندازهگیریشده محاسبه میشوند. قیمتها ممکن است به وضوح، فرمت خروجی یا یک باند استفاده بستگی داشته باشند. برای بدهی نهایی ShareAI، Console Usage را بررسی کنید. فیلدهای هزینه بالادستی و بایتهای رسانه به شمارش توکنهای اختراعی تبدیل نمیشوند.
دسترسی و خطاها#
استفاده کنید inference برای استنتاج هزینه شبکه تأییدشده یا monetization_gateway برای افزایش قیمت تأییدشده Builder و شرایط صورتحساب پذیرفتهشده. دسترسی فقط به هویت، مجوز هزینه کردن را نمیدهد. اعتبارسنجی، مجوز مدل، اعتبار ناکافی، محدودیت نرخ و شکستهای اجرا یک ساختار بازگشتی را برمیگردانند. error. پس از یک زمان انتظار یا ارسال نامشخص، Usage یا کار ویدیویی را بررسی کنید قبل از ایجاد درخواست دیگری که ممکن است هزینهبر باشد.
نگهداری موقت ویدئو#
برخی مسیرهای ویدیویی نیاز به نگهداری موقت بالادستی دارند تا نتیجه تولیدشده قابل بازیابی باشد. آنها نیاز به پذیرش صریح شما در آن درخواست ویدیویی دارند. حذف آن باعث میشود این مسیرها در دسترس نباشند. این استثنا فقط برای ویدیو اعمال میشود و هرگز اجازه آموزش مدل یا نگهداری برای عملیات دیگر را نمیدهد. یک سیاست ZDR صریح نمیتواند به طور خاموش تضعیف شود. allow_temporary_retention:true یک تولید ویدیویی را با اعتبارنامه اصلی آن بخوانید.
JSON
{"allow_temporary_retention": true}بررسی وضعیت کار#
https://api.shareai.now/api/v1/videos/{id}JSON بالا فیلدهای کار پایدار را نشان میدهد، نه یک تولید واقعی. مسیر ShareAI را با همان کلید بررسی کنید و بین بررسیها منتظر بمانید. queued، pending، in_progress و finalizing به معنای انتظار هستند؛ completed دادهها را با URLهای محتوای ShareAI نشان میدهد؛ failed و requires_review به معنای توقف و بررسی هستند. وضعیت Retry پس از خطاهای گذرا خوانده میشود، اما تولید را به طور خودکار ارسال مجدد نکنید. یک اعتبارنامه متفاوت یا لغوشده نمیتواند کار را بازیابی کند.
- URL پایه
https://api.shareai.now- احراز هویت
- کلید API Bearer یا توکن دسترسی OAuth تأییدشده
- دامنه مورد نیاز
inferenceormonetization_gateway
JSON
{
"id": "YOUR_JOB_ID",
"object": "video",
"status": "pending",
"created_at": 1793664000,
"polling_url": "/api/v1/videos/YOUR_JOB_ID"
}هنگامی که تکمیل شد، هر ورودی داده شامل یک URL محتوای ShareAI است. دریافت کنید.
cURL
curl --fail-with-body "https://api.shareai.now/api/v1/videos/YOUR_JOB_ID" \
-H "Authorization: Bearer $SHAREAI_API_KEY"دانلود نتیجه#
با استفاده از همان اعتبارنامه اصلی. نقطه پایانی از یک محدوده بایت HTTP واحد پشتیبانی میکند. URLهای ارائهدهنده، بلیتهای خصوصی و اعتبارنامههای ارائهدهنده هرگز بازگردانده نمیشوند. بررسی و دانلود باعث ایجاد درخواست استنتاج دوم یا هزینه بلع Monetization Gateway نمیشود. یک کار تکمیلشده به معنای تأیید تسویه قبل از قابل دانلود شدن فایل است. GET /api/v1/videos/{id}/content?index=0 frame_images اختیاری باید شامل بخشهای image_url با first_frame یا last_frame باشد. از تصاویر فریم یا تصاویر مرجع در یک درخواست استفاده کنید، نه هر دو. مدت زمان مدلها، وضوحها و نسبتهای ابعاد ممکن است محدودتر از حدود ایمنی API باشند. Webhooks و URLهای callback دلخواه پشتیبانی نمیشوند.
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آخرین بهروزرسانی نوامبر 3, 2026.
لینک به واحدهای صورتحساب