ShareAI Platform Docs

ویڈیوز تخلیق کریں

جمع کرانے پر HTTP 202 کے ساتھ ShareAI جاب آئی ڈی اور پولنگ URL واپس آتا ہے۔.

Markdown کے طور پر دیکھیں
اس صفحے پر
POST https://api.shareai.now/api/v1/videos

ویڈیوز تخلیق کریں

بیس URL
https://api.shareai.now
تصدیق
Bearer API کلید یا منظور شدہ OAuth ایکسیس ٹوکن
مطلوبہ اسکوپ
inference or monetization_gateway

جمع کرانے پر HTTP 202 کے ساتھ ShareAI جاب آئی ڈی اور پولنگ 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
}'

درخواست کے فیلڈز#

فیلڈقسممعنی اور حدود
model ضروریسٹرنگدرست فعال عوامی ماڈل شناخت کنندہ۔ اس آپریشن کا اعلان کرنا ضروری ہے اور آپ کی اسناد کے ذریعے اجازت یافتہ ہونا چاہیے۔.
prompt ضروریسٹرنگغیر خالی جنریشن پرامپٹ، زیادہ سے زیادہ 256 KiB UTF-8 متن۔.
durationعددیاختیاری درخواست کردہ ویڈیو دورانیہ سیکنڈز میں، 1–600، منتخب کردہ ماڈل کے ذریعہ مزید محدود۔ اصل واپس کردہ دورانیے دورانیہ بلنگ کا تعین کرتے ہیں۔.
resolutionسٹرنگماڈل کی حمایت یافتہ ریزولوشن سلیکٹر، زیادہ سے زیادہ 100 حروف؛ شائع شدہ ٹیرف ویرینٹ سے میل کھانا ضروری ہے۔.
aspect_ratioسٹرنگماڈل کی حمایت یافتہ اسپیکٹ ریشو سلیکٹر، زیادہ سے زیادہ 100 حروف۔.
sizeسٹرنگماڈل کی حمایت یافتہ آؤٹ پٹ سائز، زیادہ سے زیادہ 100 حروف، مثال کے طور پر 1024×1024۔ ہر ماڈل اس آپشن کی حمایت نہیں کرتا۔.
generate_audioبولیناختیاری ویڈیو ساؤنڈ ٹریک سلیکٹر۔ ماڈل کی حمایت اور مماثل ٹیرف ویرینٹ کی ضرورت ہے۔.
seedعددیاختیاری ماڈل کی حمایت یافتہ سیڈ۔ ویڈیو کے لیے غیر منفی عدد درکار ہے؛ دوبارہ پیدا کرنے کی صلاحیت ایگزیکیوٹر پر منحصر ہے۔.
frame_imagesارےزیادہ سے زیادہ دو image_url حصے، ہر ایک کے ساتھ frame_type پہلے_فریم یا آخری_فریم، بغیر نقل کے۔ 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 جاب آئی ڈی اور پولنگ URL واپس آتا ہے۔ ایک مستحکم Idempotency-Key ہیڈر بھیجیں تاکہ اسی درخواست کو دوبارہ بھیجا جا سکے۔ مختلف ان پٹ کے ساتھ اس کلید کا دوبارہ استعمال مسترد کر دیا جاتا ہے۔ پول کریں GET /api/v1/videos/{id} اسی اصل اسناد کے ساتھ۔ حالتوں میں شامل ہیں: queued، pending، in_progress، finalizing، completed، failed اور requires_review۔ requires_review نتیجہ ٹیم کی مفاہمت کی ضرورت ہوتی ہے؛ پولنگ کبھی بھی ایک اور جنریشن شروع نہیں کرتی۔.

بلنگ یونٹس#

ویڈیو راستے اپنے بلنگ یونٹس کا اعلان کرتے ہیں۔ فی سیکنڈ راستہ ہر واپس کردہ فائل کے ماپے گئے دورانیے کا استعمال کرتے ہوئے طے ہوتا ہے، کبھی بھی درخواست کردہ دورانیہ یا اپ اسٹریم USD لاگت نہیں۔ درخواست کردہ دورانیہ 1 اور 600 سیکنڈ کے درمیان ہونا چاہیے اور ماڈل کے ذریعہ تعاون یافتہ ہونا چاہیے۔ ایک محتاط کریڈٹ ہول چار آؤٹ پٹس تک کا احاطہ کر سکتا ہے۔.

کنسول سے درست فعال ماڈل شناخت کنندہ منتخب کریں۔ اس کا اعلان کردہ آپریشن اور ان پٹ/آؤٹ پٹ صلاحیتیں اس اینڈپوائنٹ سے مطابقت رکھنی چاہئیں؛ ایک ٹیکسٹ چیٹ ماڈل کو کسی دوسرے آپریشن کے لیے تبدیل نہیں کیا جا سکتا۔ آپ کی اسناد، پرووائیڈر اور اکاؤنٹ کی پابندیاں اب بھی لاگو ہوتی ہیں۔.

قیمتیں اور استعمال#

شرحیں منتخب ماڈل، پرووائیڈر، یونٹس اور ویریئنٹس کے لیے EUR AI کریڈٹس میں شائع کی جاتی ہیں۔ صرف اس کے فعال ٹیرف میں موجود ڈائمینشنز چارج کی جاتی ہیں۔ ایک تخمینہ عمل درآمد سے پہلے کریڈٹس محفوظ کرتا ہے؛ حتمی چارجز ماپی گئی استعمال پر مبنی ہوتے ہیں۔ قیمتیں ریزولوشن، آؤٹ پٹ فارمیٹ یا استعمال کے بینڈ پر منحصر ہو سکتی ہیں۔ حتمی ShareAI ڈیبٹ کے لیے کنسول استعمال چیک کریں۔ اپ اسٹریم لاگت کے فیلڈز اور میڈیا بائٹس کو ایجاد کردہ ٹوکین گنتی میں تبدیل نہیں کیا جاتا۔.

رسائی اور غلطیاں#

استعمال کریں inference منظور شدہ نیٹ ورک-لاگت انفرنس کے لیے یا monetization_gateway منظور شدہ بلڈر مارک اپ اور قبول شدہ بلنگ شرائط کے لیے۔ صرف شناختی رسائی خرچ کی اجازت نہیں دیتی۔ توثیق، ماڈل کی اجازت، ناکافی کریڈٹس، شرح کی حدود اور عمل درآمد کی ناکامیوں کے نتیجے میں ایک ساختہ error. ٹائم آؤٹ یا غیر یقینی جمع کرانے کے بعد، ایک اور ممکنہ طور پر ادا شدہ درخواست بنانے سے پہلے استعمال یا ویڈیو جاب کا معائنہ کریں۔.

عارضی ویڈیو برقرار رکھنا#

کچھ ویڈیو راستوں کو عارضی اپ اسٹریم برقرار رکھنے کی ضرورت ہوتی ہے تاکہ پیدا شدہ نتیجہ بازیافت کیا جا سکے۔ انہیں اس ویڈیو درخواست پر آپ کی واضح allow_temporary_retention:true قبولیت کی ضرورت ہے۔ اسے چھوڑنا ان راستوں کو دستیاب نہیں رکھتا۔ یہ استثناء صرف ویڈیو پر لاگو ہوتا ہے اور کبھی بھی ماڈل کی تربیت یا دیگر آپریشنز کے لیے برقرار رکھنے کی اجازت نہیں دیتا۔ ایک واضح ZDR پالیسی کو خاموشی سے کمزور نہیں کیا جا سکتا۔.

JSON

{"allow_temporary_retention": true}

کام کی حالت چیک کریں#

GET https://api.shareai.now/api/v1/videos/{id}

ویڈیو جنریشن کو اس کی اصل اسناد کے ساتھ پڑھیں

بیس URL
https://api.shareai.now
تصدیق
Bearer API کلید یا منظور شدہ 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"
}

اوپر دیا گیا JSON مستحکم جاب فیلڈز کی وضاحت کرتا ہے، حقیقی جنریشن نہیں۔ ShareAI راستے کو اسی کلید کے ساتھ پول کریں، چیک کے درمیان انتظار کریں۔ queued، pending، in_progress اور finalizing کا مطلب ہے انتظار کریں؛ completed ShareAI مواد کے URLs کے ساتھ ڈیٹا کو ظاہر کرتا ہے؛ 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، پرائیویٹ ٹکٹس اور پرووائیڈر کریڈینشلز کبھی واپس نہیں کیے جاتے۔ پولنگ اور ڈاؤن لوڈنگ ایک دوسرا انفرنس ریکویسٹ یا Monetization Gateway انٹیک چارج نہیں بناتے۔ مکمل شدہ جاب کا مطلب ہے کہ فائل ڈاؤن لوڈ کے قابل ہونے سے پہلے سیٹلمنٹ کی تصدیق ہو چکی ہے۔.

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 حصے شامل ہونے چاہئیں جن میں first_frame یا last_frame ہو۔ ایک درخواست میں فریم امیجز یا ریفرنس امیجز استعمال کریں، دونوں نہیں۔ ماڈل کے دورانیے، ریزولوشنز اور اسپیکٹ ریشوز API کی سیفٹی باؤنڈز سے زیادہ محدود ہو سکتے ہیں۔ ویب ہُکس اور من مانی callback URLs سپورٹ نہیں کیے جاتے۔.

آخری بار اپ ڈیٹ کیا گیا نومبر 3, 2026

ShareAI پلیٹ فارم دستاویزات
تمام دستاویزات

عنوان یا مواد کے ذریعے تلاش کریں۔

اس صفحے کے بارے میں پوچھیں

اس صفحے کو دریافت کرنے کے لیے ایک معاون منتخب کریں۔ آپ صفحہ کو کاپی کر کے اپنی گفتگو میں چسپاں بھی کر سکتے ہیں۔

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI