API انتقال حرکت: فردی تازه را در هر ویدیویی بگذارید

ویدیویی دارید که جواب می‌دهد. حالا می‌خواهید فرد دیگری در آن باشد: کریتور خودتان، یک مشتری، یا فردی که هنوز وجود ندارد. API Hermoso این کار را با یک درخواست انجام می‌دهد. ویدیو و فرد را بفرستید، و فرد تازه همه حرکات، حالت‌های چهره و شکل دهان نسخه اصلی را اجرا می‌کند، روی همان ضرب‌ها و کات‌ها، در همان اتاق و همان نور. صدای اصلی می‌ماند.

مستندات API را بخوانید →

یک فراخوانی چه شکلی است؟

ویدیو را بفرستید و بگویید چه کسی باید در آن باشد. با "dry_run": true هیچ چیز اجرا نمی‌شود و پاسخ، قیمت دقیق است.

curl -sX POST https://app.hermoso.ai/v1/recasts \
  -H "Authorization: Bearer hmk_..." \
  -H 'content-type: application/json' \
  -d '{
    "video": "https://www.tiktok.com/@someone/video/7400000000000000000",
    "person": { "describe": "a woman in her 30s, curly dark hair, denim jacket" },
    "dry_run": true
  }'

همین درخواست را بدون "dry_run": true بفرستید تا شروع شود. فوراً یک job دریافت می‌کنید، و ویدیوی نهایی را وقتی آماده شد: چند دقیقه برای یک کلیپ کوتاه، بیشتر برای یک کلیپ بلند.

چه کسی را می‌توانید در ویدیو بگذارید؟

• کریتور ذخیره‌شده شما، یا یکی از کریتورهای آماده هوش مصنوعی، با شناسه (id).
• یک عکس از آن فرد، با لینک.
• یک فرد ساخته‌شده با هوش مصنوعی از روی توصیف شما. او را توصیف کنید (سن، مو، سبک، حال‌وهوا) و Hermoso اول او را می‌سازد، بعد در ویدیو قرارش می‌دهد. او در کتابخانه شما ذخیره می‌شود تا دوباره از او استفاده کنید.

می‌خواهید صدایش هم فرق کند؟ یک صدای تازه با همان کلمات و همان زمان‌بندی اضافه کنید، یا بگذارید به زبان دیگری حرف بزند و دهانش با کلمات تازه هماهنگ شود. همان درخواست است و همان job.

چه ویدیوهایی کار می‌کنند؟

لینک TikTok، Reel، Facebook، X یا YouTube، لینک یک فایل ویدیو، یا فایلی که در Hermoso آپلود کرده‌اید. هر فراخوانی تا 60 ثانیه را پوشش می‌دهد، و می‌توانید با تعیین شروع و پایان، بازه‌ای را انتخاب کنید.

هزینه‌اش چقدر است؟

به طول ویدیو و به اینکه صدای تازه اضافه کنید یا نه بستگی دارد، پس هیچ‌وقت حدس نمی‌زنیم. یک اجرای آزمایشی قیمت دقیق را مرحله به مرحله، پیش از اجرای هر چیزی، به شما می‌دهد. فراخوانی واقعی همان مبلغ را رزرو می‌کند و با هزینه واقعی رندر تسویه می‌شود، هرگز بیشتر. برای ارزش هر اعتبار، صفحه قیمت‌ها را ببینید.

می‌توانید به جای فرد، یک شیء را عوض کنید؟

بله. یک endpoint دوم با یک دستور ساده یک چیز را در کلیپ تغییر می‌دهد: «فقط لیوان را قرمز کن»، «بطری را با محصول ما عوض کن»، «شبش کن». حرکت، زمان‌بندی و کادربندی می‌مانند. عکسی از محصول یا جنس واقعی اضافه کنید تا تغییر با آن جور شود.

curl -sX POST https://app.hermoso.ai/v1/edits \
  -H "Authorization: Bearer hmk_..." \
  -H 'content-type: application/json' \
  -d '{ "video": "https://example.com/clip.mp4", "instruction": "change only the mug to red", "dry_run": true }'

مطمئن نیستید چه شکلی می‌شود؟ اول پیش‌نمایش یک فریم ثابت را بخواهید. تغییر را روی یک فریم می‌بینید، با قیمت کل کلیپ کنارش، و کلیپ فقط وقتی اجرا می‌شود که شما بگویید.

ساخته‌شده برای بک‌اند شما

• ناهمگام (Async). یک فراخوانی واقعی فوراً با یک job پاسخ می‌دهد. job را بررسی کنید، یا به ما یک لینک بدهید تا ویدیوی نهایی را برایتان بفرستیم.
• تلاش دوباره بی‌خطر است. همان کلید idempotency را دوباره بفرستید و همان job را پس می‌گیرید، هرگز رندر دوم.
• رد صریح. وقتی چیزی نمی‌تواند اجرا شود، پیش از هر هزینه‌ای دلیلش را می‌شنوید، با کدی که کد شما می‌تواند بر اساس آن تصمیم بگیرد.
• یک کلید API از اپ، همان کلیدی که سرور MCP و خط فرمان استفاده می‌کنند.

افراد واقعی چطور؟

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

کلیک را به کد ترجیح می‌دهید؟

همین جابه‌جایی در اپ هم هست، در جابه‌جایی فرد در ویدیو، و ایجنت هوش مصنوعی شما می‌تواند آن را از طریق MCP اجرا کند. هر سه با یک موتور کار می‌کنند و هزینه یکسانی دارند.

پرسش‌های متداول

API انتقال حرکت چیست؟

یک ویدیو و یک فرد دیگر را می‌گیرد و ویدیو را با آن فرد برمی‌گرداند، که دقیقاً همان کاری را می‌کند که فرد اصلی کرد: همان حرکات، حالت‌های چهره، زمان‌بندی و کات‌ها. نسخه Hermoso صدای اصلی را هم نگه می‌دارد و می‌تواند به فرد تازه صدا یا زبان تازه‌ای بدهد.

هزینه تعویض فرد چقدر است؟

به طول ویدیو و به اینکه صدای تازه اضافه کنید یا نه بستگی دارد. درخواست را با dry_run بفرستید تا پیش از اجرای هر چیزی قیمت دقیق را بگیرید. فراخوانی واقعی هرگز بیشتر از آن هزینه نمی‌گیرد.

می‌توانم از عکس یک فرد واقعی استفاده کنم؟

بله، در پلن پولی، و فقط با اجازه آن فرد. فرستادن عکس یعنی تأیید می‌کنید این اجازه را دارید. یک فرد ساخته‌شده با هوش مصنوعی از روی توصیف، یا یک کریتور آماده هوش مصنوعی، در همه پلن‌ها کار می‌کند.

چقدر طول می‌کشد؟

به طول ویدیو بستگی دارد: چند دقیقه برای یک کلیپ کوتاه، بیشتر برای کلیپ بلند یا کلیپی با صدای تازه. فراخوانی فوراً با یک job پاسخ می‌دهد، و شما آن را بررسی می‌کنید یا ویدیوی نهایی به لینکی که انتخاب کرده‌اید فرستاده می‌شود.

می‌توانم به جای فرد، یک شیء را تغییر دهم؟

بله. endpoint ویرایش (edits) با یک دستور ساده یک چیز را در کلیپ تغییر می‌دهد، مثل عوض کردن رنگ یک لیوان یا جایگزین کردن یک بطری با محصول شما، و بقیه را همان‌طور که بود نگه می‌دارد.