رفتن به محتوا

Kling O3 Reference to Video [Pro]

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

شناسه مدل kling-video/o3/pro/reference-to-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/kling-video/o3/pro/reference-to-video?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"
  }'

# 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

ساخته‌شده در Doitong

آثار عمومی ساخته‌شده با Kling O3 توسط جامعه Doitong. یک پرامپت را با یک کلیک دوباره استفاده کنید.

آثار عمومی نمایش‌داده‌شده: 16
**Duration: 5 seconds | Aspect ratio: 16:9 | Children's YouTube Intro | Video with Audio** Animat... ویدیو

**Duration: 5 seconds | Aspect ratio: 16:9 | Children's YouTube Intro | Video with Audio** Animate the provided image into a bright, magical, energetic, professional YouTube intro for a children's entertainment channel, with perfectly synchronized sound effects, cheerful music, and a cute child's...

**Duration: 5 seconds | Aspect ratio: 16:9 | Children's YouTube Intro | Video with Audio** Animat... ویدیو

**Duration: 5 seconds | Aspect ratio: 16:9 | Children's YouTube Intro | Video with Audio** Animate the provided image into a bright, magical, energetic, professional YouTube intro for a children's entertainment channel, with perfectly synchronized sound effects, cheerful music, and a cute child's...

**Duration: 5 seconds | Aspect ratio: 16:9 | Children's YouTube Intro | Video with Audio** Animat... ویدیو

**Duration: 5 seconds | Aspect ratio: 16:9 | Children's YouTube Intro | Video with Audio** Animate the provided image into a bright, magical, energetic, professional YouTube intro for a children's entertainment channel, with perfectly synchronized sound effects, cheerful music, and a cute child's...

Уютная база отдыха с деревянными домиками-шале среди сосен. Майя и Клиентка заходят в теплое кафе... ویدیو

Уютная база отдыха с деревянными домиками-шале среди сосен. Майя и Клиентка заходят в теплое кафе с панорамными окнами. Внутри деревянный интерьер, мягкие диваны и живые цветы. Они садятся за столик, перед ними стоят дымящиеся чашки чая. Мягкий свет ламп создает уют. Средний план, уровень глаз. (...

**Duration: 4 seconds | Aspect ratio: 16:9 | Children's YouTube Intro | Video with Audio** Animat... ویدیو

**Duration: 4 seconds | Aspect ratio: 16:9 | Children's YouTube Intro | Video with Audio** Animate the provided image into a bright, magical, energetic, professional YouTube intro for a children's entertainment channel, with perfectly synchronized sound effects, cheerful music, and a cute child's...

Реалистично оживи старую семейную фотографию. Все люди сохраняют свои оригинальные лица, черты вн... ویدیو

Реалистично оживи старую семейную фотографию. Все люди сохраняют свои оригинальные лица, черты внешности, возраст, причёски и одежду. Мужчины слегка поворачивают головы, естественно моргают и едва заметно улыбаются. Женщина слева спокойно смотрит в камеру и мягко моргает. Маленький ребёнок слегка...

A five-second orbital camera move circling completely around a red-haired woman in a yellow rainc... ویدیو

A five-second orbital camera move circling completely around a red-haired woman in a yellow raincoat standing in an autumn forest holding a vintage lantern, she remains stationary facing forward while the camera circles 180 degrees from her left side to her right side at eye level, golden fallen...

A five-second whip pan transition starting on a chef in white uniform chopping fresh herbs on a w... ویدیو

A five-second whip pan transition starting on a chef in white uniform chopping fresh herbs on a wooden cutting board in a bright kitchen, camera suddenly swings in a rapid blur motion panning right at high speed creating motion blur, ending sharply focused on a barista pouring latte art in a...

ساخت درخواست

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

88 / 2500

دستورهای متنی برای تولید ویدیو. دقیقاً یکی از پرامپت یا multi_prompt را ارائه کنید.

duration ۵ s

طول ویدیو، از 3 تا 15 ثانیه.

aspect_ratio پیش‌فرض 16:9

نسبت عرض به ارتفاع فریم‌های ویدیوی تولیدشده.

پیشرفته image · end_image · images · shot_type · enable_safety_checker · multi_prompt · elements
start_image_url
یک فایل بیندازید، یا

تصویر استفاده‌شده برای فریم آغازین ویدیو. اندازه فایل نباید بیشتر از 50 MB باشد؛ عرض و ارتفاع هرکدام باید حداقل 300px و نسبت تصویر بین 0.40 و 2.50 باشد.

end_image_url
یک فایل بیندازید، یا

تصویری که فریم پایانی ویدیو را تأمین می‌کند، با محدودیت 50 MB. عرض و ارتفاع هرکدام باید حداقل 300 px باشند و نسبت تصویر بین 0.40 و 2.50 باشد.

image_urls
یک فایل بیندازید، یا

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

shot_type پیش‌فرض customize

نحوه برنامه‌ریزی نماها در تولید چندنما را انتخاب می‌کند؛ انتخاب 'intelligent' ساختار نماها را به مدل واگذار می‌کند.

فهرست پرامپت برای تولید ویدیویی با چند نما.

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

POST /run/kling-video/o3/pro/reference-to-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/kling-video/o3/pro/reference-to-video?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"
  }'

# 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

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

صحنه‌های ویدیویی را از تصاویر مرجع `image_urls` که با @Image1 و غیره ارجاع داده می‌شوند، به‌همراه `elements` برای شخصیت‌ها یا اشیا می‌سازد. `start_image_url` و `end_image_url` اختیاری، فریم اول و آخر را تعیین می‌کنند. مدت‌زمان 3 تا 15 ثانیه و نسبت تصویر 16:9، 9:16 یا 1:1 است. از نماهای `multi_prompt` و صدای اختیاری پشتیبانی می‌کند.

پارامترها

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

نامنوع پیش‌فرضمجاز توضیحات
enable_safety_checkerاختیاری
نوعboolean
پیش‌فرضtrue
بررسی‌های ایمنی فقط با مجوز حساب قابل غیرفعال‌سازی هستند؛ درخواست‌های بدون مجوز همیشه بررسی می‌شوند.
promptاختیاری
نوعstring | null
≤ ۲٬۵۰۰ نویسه
دستورهای متنی برای تولید ویدیو. دقیقاً یکی از پرامپت یا multi_prompt را ارائه کنید.
multi_promptاختیاری
نوعobject[]
فهرست پرامپت برای تولید ویدیویی با چند نما.
multi_prompt[].promptالزامی
نوعstring
دستورهای متنی برای نمای فعلی.
multi_prompt[].durationاختیاری
نوعenum
پیش‌فرض5
123456789101112131415
طول نمای فعلی، برحسب ثانیه.
start_image_urlاختیاری image
نوعurl · image
تصویر استفاده‌شده برای فریم آغازین ویدیو. اندازه فایل نباید بیشتر از 50 MB باشد؛ عرض و ارتفاع هرکدام باید حداقل 300px و نسبت تصویر بین 0.40 و 2.50 باشد.
end_image_urlاختیاری end_image
نوعurl · image
تصویری که فریم پایانی ویدیو را تأمین می‌کند، با محدودیت 50 MB. عرض و ارتفاع هرکدام باید حداقل 300 px باشند و نسبت تصویر بین 0.40 و 2.50 باشد.
image_urlsاختیاری images
نوعurl[] · image
تصاویر هدایت‌کننده سبک یا ظاهر که در پرامپت با @Image1، @Image2 و به همین ترتیب ارجاع داده می‌شوند. هنگام استفاده از ورودی ویدیو، مجموع عناصر و تصاویر مرجع نمی‌تواند بیشتر از 4 مورد باشد. اندازه هر فایل حداکثر 50 MB است؛ عرض و ارتفاع هرکدام باید حداقل 300 px و نسبت تصویر بین 0.40 و 2.50 باشد.
elementsاختیاری
نوعobject[]
شخصیت‌ها یا اشیایی که باید گنجانده شوند و در پرامپت با @Element1 و @Element2 ارجاع داده می‌شوند.
elements[].frontal_image_urlاختیاری
نوعurl · image
تصویر روبه‌رو که نمای اصلی عنصر را نشان می‌دهد. اندازه فایل نباید بیشتر از 50 MB باشد؛ عرض و ارتفاع هرکدام باید حداقل 300px و نسبت تصویر بین 0.40 و 2.50 باشد.
elements[].reference_image_urlsاختیاری
نوعurl[] · image
1–3 تصویر مرجع اضافی از زوایای مختلف ارائه کنید. نسبت تصویر هر تصویر باید بین 0.40 و 2.50 باشد، هر دو بُعد آن حداقل 300px و اندازه فایل حداکثر 50.0MB باشد.
elements[].video_urlاختیاری
نوعurl · video
URL اشاره‌کننده به ویدیوی یک عنصر؛ در هر درخواست فقط یک عنصر می‌تواند ویدیو داشته باشد. اندازه فایل حداکثر 200 MB، عرض و ارتفاع هرکدام بین 720px و 2160px، مدت بین 3 ثانیه و 10.05 ثانیه و FPS بین 24.0 و 60.0 باشد.
elements[].voice_idاختیاری
نوعstring | null
Voice ID اختصاص‌یافته به عنصر. ارجاع‌ها به آن عنصر از صدای اختصاص‌یافته استفاده می‌کنند.
generate_audioاختیاری
نوعboolean
پیش‌فرضfalse
مشخص می‌کند صوت بومی همراه با ویدیو تولید شود یا خیر.
durationاختیاری
نوعenum
پیش‌فرض5
3456789101112131415
طول ویدیو، از 3 تا 15 ثانیه.
shot_typeاختیاری
نوعenum
پیش‌فرضcustomize
customizeintelligent
نحوه برنامه‌ریزی نماها در تولید چندنما را انتخاب می‌کند؛ انتخاب 'intelligent' ساختار نماها را به مدل واگذار می‌کند.
aspect_ratioاختیاری
نوعenum
پیش‌فرض16:9
16:99:161:1
نسبت عرض به ارتفاع فریم‌های ویدیوی تولیدشده.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

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

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "kling-video/o3/pro/reference-to-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": 560,
    "usd": "0.56",
    "charged": 560,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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/kling-video/o3/pro/reference-to-video.md. همه مدل‌ها و راهنماها: https://doitong.com/developers/llms.txt