رفتن به محتوا

Mureka 9.5 Lyrics Video

یکپارچه‌سازی

شناسه مدل mureka/api/generate/lyrics-video
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/mureka/api/generate/lyrics-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

این درخواست: ⁨‎$۰٫۱۵⁩ ۱۵۰ اعتبار API اجرای آن در این صفحه

دریافت کلید API
Mureka همگام‌سازی لب و آواتارها همگام‌سازی لب #music#lyrics#video

از آهنگ تولیدشده یا بارگذاری‌شده، با هفت چیدمان و چهار نسبت تصویر، ویدئوی متن ترانه ایجاد می‌کند

Mureka · ویدیو

اولین نتیجه شما اینجا قرار می‌گیرد

درخواست را در زیر بسازید و با کلید API خود اجرا کنید. خروجی‌ها در فضای ذخیره‌سازی ما کپی می‌شوند و برای همیشه یا به‌مدت ۷ روز رایگان نگه‌داری می‌شوند.

ساخت درخواست

کنترل‌ها از شِمای مدل تولید می‌شوند. با تغییر آن‌ها، کد و قیمت به‌روزرسانی می‌شوند.

aspect_ratio پیش‌فرض 9:16

نسبت ابعاد ویدیوی تولیدشده.

پیشرفته layout · song_id · upload_audio_id · background_id · cover_url · title · lyrics_start_row · lyrics_end_row · selection_start · selection_end · enable_safety_checker
layout پیش‌فرض layout_1

قالب تعریف‌کننده چیدمان بصری ویدیوی متن ترانه.

شناسه صوت تولیدشده که به‌جای upload_audio_id به‌عنوان song_id ارائه می‌شود؛ دقیقاً یکی لازم است. مقدار آن را از song_id در پاسخ برای یک ترانه یا موسیقی بی‌کلام بردارید.

شناسه صوت بارگذاری‌شده که به‌جای song_id به‌عنوان upload_audio_id ارائه می‌شود؛ دقیقاً یکی لازم است. آن را از طریق /files/upload با purpose='audio' دریافت کنید.

شناسه تصویر پس‌زمینه که از /files/upload با استفاده از purpose='lyrics-video' دریافت شده است.

تصویر جلد اختیاری که برای layout_1 در دسترس نیست. یک JPG، PNG یا WebP را با URI داده یا URL عمومی HTTPS ارائه کنید.

عنوان اختیاری برای نمایش در ویدیوی متن ترانه.

نخستین ردیف متن ترانه شامل‌شده برای انتخاب مبتنی بر ردیف؛ این انتخاب به lyrics_end_row نیاز دارد و انتخاب مبتنی بر زمان را کنار می‌گذارد. شماره‌گذاری ردیف‌ها از 1 آغاز می‌شود.

آخرین ردیف متن ترانه شامل‌شده برای انتخاب مبتنی بر ردیف که همراه با lyrics_start_row تعریف می‌شود، نه انتخاب مبتنی بر زمان.

مرز محدوده صوت که به selection_end نیاز دارد و انتخاب ردیف متن ترانه را کنار می‌گذارد. این مقدار محل آغاز صوت شامل‌شده را برحسب میلی‌ثانیه مشخص می‌کند.

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

POST /run/mureka/api/generate/lyrics-video?wait=20 قیمت → ⁨‎$۰٫۱۵⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/mureka/api/generate/lyrics-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

اجرای این درخواست

کلید شما در این مرورگر باقی می‌ماند: فقط به Doitong API ارسال می‌شود و فقط در صورت فعال‌کردن گزینه «یادآوری»، در localStorage ذخیره می‌شود. دریافت کلید API

درباره Mureka 9.5 Lyrics Video

از یک `song_id` یا `upload_audio_id` ویدئوی متن ترانه می‌سازد؛ دقیقاً یکی را ارائه دهید. `aspect_ratio` را (16:9، 9:16، 3:4 یا 4:3) و یکی از هفت قالب `layout` را انتخاب کنید و در صورت نیاز `title`، `background_id` یا `cover_url` را اضافه کنید. برای استفاده از بخشی از آهنگ، ردیف‌های متن ترانه یا یک بازه زمانی میلی‌ثانیه‌ای را انتخاب کنید، اما هر دو را هم‌زمان استفاده نکنید.

پارامترها

نامنوع پیش‌فرضمجاز توضیحات
song_idاختیاری
نوعstring | null
شناسه صوت تولیدشده که به‌جای upload_audio_id به‌عنوان song_id ارائه می‌شود؛ دقیقاً یکی لازم است. مقدار آن را از song_id در پاسخ برای یک ترانه یا موسیقی بی‌کلام بردارید.
upload_audio_idاختیاری
نوعstring | null
شناسه صوت بارگذاری‌شده که به‌جای song_id به‌عنوان upload_audio_id ارائه می‌شود؛ دقیقاً یکی لازم است. آن را از طریق /files/upload با purpose='audio' دریافت کنید.
background_idاختیاری
نوعstring | null
شناسه تصویر پس‌زمینه که از /files/upload با استفاده از purpose='lyrics-video' دریافت شده است.
cover_urlاختیاری
نوعstring | null
تصویر جلد اختیاری که برای layout_1 در دسترس نیست. یک JPG، PNG یا WebP را با URI داده یا URL عمومی HTTPS ارائه کنید.
titleاختیاری
نوعstring | null
عنوان اختیاری برای نمایش در ویدیوی متن ترانه.
aspect_ratioاختیاری
نوعenum
پیش‌فرض9:16
16:99:163:44:3
نسبت ابعاد ویدیوی تولیدشده.
layoutاختیاری
نوعenum
پیش‌فرضlayout_1
layout_1layout_2layout_3layout_4layout_5layout_6layout_7
قالب تعریف‌کننده چیدمان بصری ویدیوی متن ترانه.
lyrics_start_rowاختیاری
نوعinteger | null
≥ ۱
نخستین ردیف متن ترانه شامل‌شده برای انتخاب مبتنی بر ردیف؛ این انتخاب به lyrics_end_row نیاز دارد و انتخاب مبتنی بر زمان را کنار می‌گذارد. شماره‌گذاری ردیف‌ها از 1 آغاز می‌شود.
lyrics_end_rowاختیاری
نوعinteger | null
≥ ۱
آخرین ردیف متن ترانه شامل‌شده برای انتخاب مبتنی بر ردیف که همراه با lyrics_start_row تعریف می‌شود، نه انتخاب مبتنی بر زمان.
selection_startاختیاری
نوعinteger | null
≥ ۰
مرز محدوده صوت که به selection_end نیاز دارد و انتخاب ردیف متن ترانه را کنار می‌گذارد. این مقدار محل آغاز صوت شامل‌شده را برحسب میلی‌ثانیه مشخص می‌کند.
selection_endاختیاری
نوعinteger | null
≥ ۰
مرز انتهای صوت که به selection_start نیاز دارد و انتخاب ردیف شعر را حذف می‌کند. این مقدار محل پایان صوت گنجانده‌شده را برحسب میلی‌ثانیه مشخص می‌کند.
enable_safety_checkerاختیاری
نوعboolean
پیش‌فرضtrue
با تنظیم false، در صورت مجاز بودن فراخواننده، می‌توان بررسی را آسان‌گیرانه‌تر کرد.
الزامی

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "mureka/api/generate/lyrics-video",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 150,
    "usd": "0.15",
    "charged": 150,
    "refunded": 0
  },
  "input": {},
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    }
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
فایل‌های شما، انتخاب شماهر outputs[].url کپی‌ای در فضای ذخیره‌سازی ماست: برای همیشه (با هزینه به‌ازای هر GB-ماه) یا به‌مدت ۷ روز رایگان، بر اساس تنظیم حساب شما یا ?storage=.
ساختار یکسان در همه مدل‌هاtype، url، content_type، width، height و duration برای تصاویر، ویدیو و صدا یکسان هستند. output شیء نتیجه اختصاصی مدل است.
فیلدهای خروجی
video
object {url, content_type, file_name, file_size}فایل ویدیویی تولیدشده.

مدل‌های بیشتر: همگام‌سازی لب و آواتارها

برای عامل‌های هوش مصنوعی: این صفحه به‌صورت Markdown در دسترس است https://doitong.com/fa/developers/models/mureka/api/generate/lyrics-video.md. همه مدل‌ها و راهنماها: https://doitong.com/developers/llms.txt