رفتن به محتوا

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: 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...

**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...

**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...

**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...

Моя первая глобальная цель — 10.000 подписчиков. Я хочу расти вместе с вами, делать сериалы ещё к... ویدیو

Моя первая глобальная цель — 10.000 подписчиков. Я хочу расти вместе с вами, делать сериалы ещё круче, масштабнее и в итоге превратить это в полноценный проект, чтобы в дальнейшем монетизировать свой блог. Путь к первой десятке объявляю открытым. Идём со мной? Мне нужно такое видео в трёх кадрах...

Оживи старую чёрно-белую свадебную фотографию. Молодожёны стоят рядом друг с другом. Жених нежно ... ویدیو

Оживи старую чёрно-белую свадебную фотографию. Молодожёны стоят рядом друг с другом. Жених нежно и с любовью смотрит на невесту, слегка улыбается и бережно касается её руки. Невеста мягко улыбается, немного поворачивает голову к жениху и смотрит на него с теплотой. Их движения естественные,...

The woman in the reference photo smiles naturally at the camera. Golden magical sparks begin swir... ویدیو

The woman in the reference photo smiles naturally at the camera. Golden magical sparks begin swirling around her body. Her eyes briefly glow with warm golden light. A beautiful black witch hat appears on her head, and her clothes magically transform into an elegant black-and-gold witch costume...

Кролик открывает дверь девушке, девушка дает чаевые кролику и говорит « спасибо, мой ушастый друг... ویدیو

Кролик открывает дверь девушке, девушка дает чаевые кролику и говорит « спасибо, мой ушастый друг», он закрывает за ней дверь и говорит «Пожалуйста, красотка» после того как она села в машину за руль, кролик немного отходит, девушка в дрифте уезжает, все в одной сцене. Съемка кинематографичная....

ساخت درخواست

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

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