رفتن به محتوا

Veo3.1 Reference to Video

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

شناسه مدل veo3.1/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/veo3.1/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",
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

# 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
Google مرجع به ویدیو صوت بومیخروجی 4Kورودی‌های مرجعحداکثر 4k

ویدیوی Veo 3.1 که با استفاده از چند تصویر مرجع، سوژه را ثابت نگه می‌دارد و صدای اختیاری دارد

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

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

آثار عمومی نمایش‌داده‌شده: 16
Art style: Реалистичный кулинарный блог. Камера немного отдаляется, показывая ведущую по пояс. Он... ویدیو

Art style: Реалистичный кулинарный блог. Камера немного отдаляется, показывая ведущую по пояс. Она активно жестикулирует, призывая зрителей писать комментарии и подписываться. В конце она машет рукой или делает приветственный жест. Ее улыбка сияет, создавая позитивный финал. Свет из окна...

Art style: Реалистичный кулинарный блог. Камера плавно перемещается от рук ведущей к противню. Ве... ویدیو

Art style: Реалистичный кулинарный блог. Камера плавно перемещается от рук ведущей к противню. Ведущая совершает мягкие вращательные движения ладонями, формируя шарик теста. Видно, как мягкое тесто податливо меняет форму под ее пальцами. Затем она аккуратно кладет готовый шарик на пергамент рядом...

Art style: Modern Webtoon Illustration. Нари сначала спокойно спит с закрытыми глазами. Затем рез... ویدیو

Art style: Modern Webtoon Illustration. Нари сначала спокойно спит с закрытыми глазами. Затем резко распахивает глаза от осознания, что проспала. Быстрое, выразительное комедийное пробуждение. Голова неподвижна, камера статична. Плавный переход от первого кадра ко второму. Сохранить внешность...

Art style: Реалистичный кулинарный блог. Камера направлена сверху под небольшим углом, создавая д... ویدیو

Art style: Реалистичный кулинарный блог. Камера направлена сверху под небольшим углом, создавая детальный крупный план миски. Ложка медленно опускает густой греческий йогурт на поверхность яиц, йогурт плавно соскальзывает и ложится плотной массой. Яичные желтки слегка подрагивают от движения...

ویدیو

Марк резко стартует с места, его кроссовки громко стучат по брусчатке, камера быстро движется за ним на уровне земли, создавая эффект скорости. На заднем плане размываются стены старого города. Пыль слегка поднимается из-под ног, передавая энергию и суету гиперактивного туриста. Off-screen...

ویدیو

Кинематографичная сцена в современном офисном коридоре. Огромная дверь с надписью «Фарм» резко открыта, изнутри виден пиксельный мир в стиле Minecraft: квадратные фермы, зелёные блоки, механизмы, лёгкое зелёное и тёплое свечение. Из двери выходит главный герой — толстый, неприятного вида, немного...

ویدیو

Кинематографичная сцена: главный герой открывает дверь и попадает в бесконечный тёмный мир серверов. Камера медленно движется вперёд, показывая бесконечные серверные стойки, мигающие лампы и холодный неоновый свет. Из темноты появляется глава разработки — абсурдно огромный качок с идеальной...

ویدیو

Главный герой открывает дверь и попадает в розовый сказочный HR-мир. Камера показывает пони, сердечки, блестящие облачка, розовый свет и всё вокруг как будто сделано из милоты. В центре появляется бимбо-глава HR — очень гламурная, в розовом, с идеальной внешностью и ярким макияжем. Она дружелюбно...

ساخت درخواست

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

•الزامی 88 / 20000

توضیح متنی ویدیوی موردنظر برای تولید.

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

URLهای تصاویر مرجع برای حفظ سازگاری ظاهر سوژه.

aspect_ratio پیش‌فرض 16:9

نسبت تصویر ویدیوی خروجی.

resolution پیش‌فرض 720p

وضوح استفاده‌شده برای ویدیوی خروجی.

پیش‌فرض 8s

طول ویدیوی خروجی.

پیشرفته safety_tolerance · auto_fix
safety_tolerance پیش‌فرض 4

تحمل تعدیل محتوا را بین کم‌محدودکننده‌ترین سطح، 6، و سخت‌گیرانه‌ترین سطح، 1، تنظیم می‌کند؛ سطح 1 بیشتر محتوا را مسدود می‌کند.

POST /run/veo3.1/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/veo3.1/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",
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

# 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

درباره Veo3.1 Reference to Video

از یک `prompt` و فهرست تصاویر مرجع در `image_urls` ویدیو تولید می‌کند تا ظاهر سوژه ثابت بماند. نسبت تصویر 16:9 یا 9:16 و وضوح 720p، 1080p یا 4k است. مدت‌زمان پیش‌فرض 8s است و تولید صدا به‌طور پیش‌فرض فعال است.

پارامترها

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

نامنوع پیش‌فرضمجاز توضیحات
promptالزامی
نوعstring
≤ ۲۰٬۰۰۰ نویسه
توضیح متنی ویدیوی موردنظر برای تولید.
aspect_ratioاختیاری
نوعenum
پیش‌فرض16:9
16:99:16
نسبت تصویر ویدیوی خروجی.
durationاختیاری
نوعstring
پیش‌فرض8s
طول ویدیوی خروجی.
resolutionاختیاری
نوعenum
پیش‌فرض720p
720p1080p4k
وضوح استفاده‌شده برای ویدیوی خروجی.
generate_audioاختیاری
نوعboolean
پیش‌فرضtrue
مشخص می‌کند که ویدیو شامل صوت تولیدشده باشد یا نه.
auto_fixاختیاری
نوعboolean
پیش‌فرضfalse
بازنویسی خودکار پرامپت برای تلاش جهت رفع خطاهای بررسی خط‌مشی محتوا یا اعتبارسنجی‌های دیگر.
safety_toleranceاختیاری
نوعenum
پیش‌فرض4
123456
تحمل تعدیل محتوا را بین کم‌محدودکننده‌ترین سطح، 6، و سخت‌گیرانه‌ترین سطح، 1، تنظیم می‌کند؛ سطح 1 بیشتر محتوا را مسدود می‌کند.
image_urlsالزامی images
نوعurl[] · image
URLهای تصاویر مرجع برای حفظ سازگاری ظاهر سوژه.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

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

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "veo3.1/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": 3200,
    "usd": "3.20",
    "charged": 3200,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  },
  "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/veo3.1/reference-to-video.md. همه مدل‌ها و راهنماها: https://doitong.com/developers/llms.txt