رفتن به محتوا

Kling O1 Reference Video to Video [Pro]

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

شناسه مدل kling-video/o1/video-to-video/reference
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/v1/run/kling-video/o1/video-to-video/reference?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }'

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

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

دریافت کلید API
Kling ویدیو به ویدیو ورودی‌های مرجع۳–۱۰ ثانیه

تبدیل ویدیو به ویدیو در سطح Pro برای ساخت نمایی جدید با هدایت کلیپ مرجع و امکان حفظ صدا

Kling · ویدیو

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

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

ساخت درخواست

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

•الزامی 88 / 2500

مراجع مرتب‌شده برای عناصر از @Element1، @Element2 و به همین ترتیب، و برای تصاویر از @Image1، @Image2 و به همین ترتیب استفاده می‌کنند.

•الزامی video_url
یک فایل بیندازید، یا

URL اشاره‌کننده به ویدیوی مرجع با قالب .mp4 یا .mov و حداکثر اندازه 200MB. هر دو بُعد باید بین 720px و 2160px، نرخ فریم بین 24.0–60.0 FPS و مدت ویدیو بین 3–10 ثانیه (حداکثر 10.05 ثانیه) باشد. مهلت زمانی 30.0 ثانیه است.

duration ۵ s

طول ویدیو برحسب ثانیه.

aspect_ratio پیش‌فرض auto

نسبت عرض به ارتفاع فریم‌های ویدیوی تولیدشده. انتخاب 'auto' نزدیک‌ترین نسبت به ویدیوی ورودی را به‌طور خودکار انتخاب می‌کند.

پیشرفته images · enable_safety_checker · keep_audio · elements
image_urls
یک فایل بیندازید، یا

تصاویر هدایت‌کننده سبک یا ظاهر که در پرامپت با @Image1، @Image2 و به همین ترتیب ارجاع داده می‌شوند. هنگام استفاده از ورودی ویدیو، مجموع عناصر و تصاویر مرجع نمی‌تواند بیشتر از 4 مورد باشد. اندازه هر فایل حداکثر 50 MB است؛ عرض و ارتفاع هرکدام باید حداقل 300 px و نسبت تصویر بین 0.40 و 2.50 باشد.

شخصیت‌ها یا اشیایی که باید گنجانده شوند و در پرامپت با @Element1، @Element2 و به همین ترتیب ارجاع داده می‌شوند. هنگام استفاده از ورودی ویدیو، مجموع عناصر و تصاویر مرجع نمی‌تواند بیشتر از 4 مورد باشد.

POST /run/kling-video/o1/video-to-video/reference?wait=20 قیمت → ⁨‎$۰٫۸۴⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/v1/run/kling-video/o1/video-to-video/reference?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }'

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

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

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

درباره Kling O1 Reference Video to Video [Pro]

یک ویدیوی مرجع در `video_url` (mp4 یا mov، 3 تا 10 ثانیه، 720 تا 2160 px، حداکثر 200MB) و `prompt` حداکثر 2500 نویسه می‌گیرد. تصاویر سبک و `elements` را می‌توان در مجموع تا 4 مورد افزود و با @Image1 یا @Element1 به آن‌ها ارجاع داد. برای حفظ صدای منبع، `keep_audio` را فعال کنید. نسبت تصویر می‌تواند auto، 16:9، 9:16 یا 1:1 و مدت‌زمان 3 تا 10 ثانیه باشد.

پارامترها

نام استاندارد یا نام بومی را ارسال کنید، نه هر دو. نام‌های استاندارد

نامنوع پیش‌فرضمجاز توضیحات
enable_safety_checkerاختیاری
نوعboolean
پیش‌فرضtrue
بررسی‌های ایمنی فقط با مجوز حساب قابل غیرفعال‌سازی هستند؛ درخواست‌های بدون مجوز همیشه بررسی می‌شوند.
promptالزامی
نوعstring
≤ ۲٬۵۰۰ نویسه
مراجع مرتب‌شده برای عناصر از @Element1، @Element2 و به همین ترتیب، و برای تصاویر از @Image1، @Image2 و به همین ترتیب استفاده می‌کنند.
video_urlالزامی video
نوعurl · video
URL اشاره‌کننده به ویدیوی مرجع با قالب .mp4 یا .mov و حداکثر اندازه 200MB. هر دو بُعد باید بین 720px و 2160px، نرخ فریم بین 24.0–60.0 FPS و مدت ویدیو بین 3–10 ثانیه (حداکثر 10.05 ثانیه) باشد. مهلت زمانی 30.0 ثانیه است.
keep_audioاختیاری
نوعboolean
پیش‌فرضfalse
مشخص می‌کند صوت اصلی ویدیو حفظ شود یا خیر.
image_urlsاختیاری images
نوعurl[] · image
تصاویر هدایت‌کننده سبک یا ظاهر که در پرامپت با @Image1، @Image2 و به همین ترتیب ارجاع داده می‌شوند. هنگام استفاده از ورودی ویدیو، مجموع عناصر و تصاویر مرجع نمی‌تواند بیشتر از 4 مورد باشد. اندازه هر فایل حداکثر 50 MB است؛ عرض و ارتفاع هرکدام باید حداقل 300 px و نسبت تصویر بین 0.40 و 2.50 باشد.
elementsاختیاری
نوعobject[]
شخصیت‌ها یا اشیایی که باید گنجانده شوند و در پرامپت با @Element1، @Element2 و به همین ترتیب ارجاع داده می‌شوند. هنگام استفاده از ورودی ویدیو، مجموع عناصر و تصاویر مرجع نمی‌تواند بیشتر از 4 مورد باشد.
elements[].frontal_image_urlالزامی
نوعurl · image
تصویر روبه‌رو که نمای اصلی عنصر را ارائه می‌دهد، با محدودیت 50 MB. عرض و ارتفاع هرکدام باید حداقل 300 px باشند و نسبت تصویر بین 0.40 و 2.50 باشد. مهلت زمانی 20 ثانیه است.
elements[].reference_image_urlsاختیاری
نوعurl[] · image
1–3 تصویر مرجع اضافی از زوایای مختلف ارائه کنید. نسبت تصویر هر تصویر باید بین 0.40 و 2.50 باشد، هر دو بُعد آن حداقل 300px و اندازه فایل حداکثر 50.0MB باشد.
aspect_ratioاختیاری
نوعenum
پیش‌فرضauto
auto16:99:161:1
نسبت عرض به ارتفاع فریم‌های ویدیوی تولیدشده. انتخاب 'auto' نزدیک‌ترین نسبت به ویدیوی ورودی را به‌طور خودکار انتخاب می‌کند.
durationاختیاری
نوعenum
پیش‌فرض5
345678910
طول ویدیو برحسب ثانیه.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

پارامترهای فایل یک URL عمومی https://، یک URI از نوع data: تا سقف 10 MB، یا file_url یک فایل بارگذاری‌شده را می‌پذیرند. فایل‌ها

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "kling-video/o1/video-to-video/reference",
  "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": 840,
    "usd": "0.84",
    "charged": 840,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  },
  "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://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://vit.doitong.com/api/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/kling-video/o1/video-to-video/reference.md. همه مدل‌ها و راهنماها: https://doitong.com/developers/llms.txt