ShareAI Platform Docs

تولید ویدئوها

ارسال HTTP 202 را با شناسه کار ShareAI و URL نظرسنجی بازمی‌گرداند.

مشاهده به‌صورت Markdown
در این صفحه
POST https://api.shareai.now/api/v1/videos

تولید ویدئوها

URL پایه
https://api.shareai.now
احراز هویت
کلید API Bearer یا توکن دسترسی OAuth تأیید‌شده
دامنه مورد نیاز
inference or monetization_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
}'

فیلدهای درخواست#

فیلدنوعمعنا و محدودیت‌ها
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}

بررسی وضعیت کار#

GET 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 تأیید‌شده
دامنه مورد نیاز
inference or monetization_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.

لینک به واحدهای صورتحساب

مستندات پلتفرم ShareAI
تمام مستندات

جستجو بر اساس عنوان یا محتوا.

درباره این صفحه بپرسید

یک دستیار برای کاوش این صفحه انتخاب کنید. همچنین می‌توانید صفحه را کپی کرده و در مکالمه خود جای‌گذاری کنید.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI