رفتن به محتوا

PixVerse C1 Reference To Video

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

شناسه مدل pixverse/c1/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/pixverse/c1/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",
    "image_references": [
      {
        "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
        "ref_name": "character"
      }
    ]
  }'

# 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
PixVerse مرجع به ویدیو صوت بومیورودی‌های مرجع۱–۱۵ ثانیهحداکثر 1080p #video-generation#reference-to-video#pixverse#character-consistency

ویدیوی C1 که شخصیت‌ها و پس‌زمینه‌ها را با حداکثر 7 تصویر مرجع یکدست نگه می‌دارد

PixVerse · ویدیو

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

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

ساخت درخواست

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

•الزامی

پرامپت تبدیل مرجع به ویدیو؛ در آن به مراجع بارگذاری‌شده با @ref_name اشاره می‌شود. حتی متن کوتاه از نظر بصری ممکن است از حداکثر 2048 بایت UTF-8 فراتر برود: ایموجی، حروف دارای اَکسان و نویسه‌های غیرلاتین هرکدام چند بایت اشغال می‌کنند؛ بنابراین سقف بر اندازه کدگذاری‌شده اعمال می‌شود، نه تعداد نویسه‌ها.

aspect_ratio پیش‌فرض 16:9

نسبت ابعاد ویدیوی خروجی.

resolution پیش‌فرض 720p

وضوح ویدیوی خروجی.

پیش‌فرض 5

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

•الزامی

تصاویر مرجع که برای هر مورد با type و ref_name ارائه می‌شوند و هر تصویر را در پرامپت از طریق @ref_name قابل ارجاع می‌کنند.

پیشرفته seed · enable_safety_checker

seed برای تولید تکرارپذیر ویدیو. بازتولید دقیق در هر اجرا به ثابت‌ماندن نسخه مدل، پرامپت و seed نیاز دارد.

POST /run/pixverse/c1/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/pixverse/c1/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",
    "image_references": [
      {
        "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
        "ref_name": "character"
      }
    ]
  }'

# 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

درباره PixVerse C1 Reference To Video

از 1 تا 7 مورد در `image_references` ویدیویی تولید می‌کند که هرکدام نوع و نام دارند. برای اشاره به مرجع، از `@ref_name` در `prompt` استفاده کنید. هشت نسبت تصویر از جمله 21:9 و 2:3، وضوح حداکثر 1080p، مدت 1 تا 15 ثانیه و صدای تولیدشده اختیاری را پشتیبانی می‌کند.

پارامترها

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

نامنوع پیش‌فرضمجاز توضیحات
promptالزامی
نوعstring
پرامپت تبدیل مرجع به ویدیو؛ در آن به مراجع بارگذاری‌شده با @ref_name اشاره می‌شود. حتی متن کوتاه از نظر بصری ممکن است از حداکثر 2048 بایت UTF-8 فراتر برود: ایموجی، حروف دارای اَکسان و نویسه‌های غیرلاتین هرکدام چند بایت اشغال می‌کنند؛ بنابراین سقف بر اندازه کدگذاری‌شده اعمال می‌شود، نه تعداد نویسه‌ها.
aspect_ratioاختیاری
نوعenum
پیش‌فرض16:9
16:94:31:13:49:162:33:221:9
نسبت ابعاد ویدیوی خروجی.
resolutionاختیاری
نوعenum
پیش‌فرض720p
360p540p720p1080p
وضوح ویدیوی خروجی.
durationاختیاری
نوعinteger
پیش‌فرض5
۱ – ۱۵
طول ویدیوی تولیدشده، از 1 تا 15 ثانیه.
seedاختیاری
نوعinteger | null
seed برای تولید تکرارپذیر ویدیو. بازتولید دقیق در هر اجرا به ثابت‌ماندن نسخه مدل، پرامپت و seed نیاز دارد.
generate_audio_switchاختیاری generate_audio
نوعboolean
پیش‌فرضfalse
کلید روشن/خاموش تولید صوت برای موسیقی پس‌زمینه، جلوه‌های صوتی و دیالوگ.
image_referencesالزامی
نوعobject[]
≤ ۷ مورد
تصاویر مرجع که برای هر مورد با type و ref_name ارائه می‌شوند و هر تصویر را در پرامپت از طریق @ref_name قابل ارجاع می‌کنند.
image_references[].image_urlالزامی
نوعurl · image
URL تصویر مرجع.
image_references[].typeاختیاری
نوعenum
پیش‌فرضsubject
subjectbackground
دسته‌بندی مرجع: 'subject' یک شخصیت یا شیء را مشخص می‌کند، درحالی‌که 'background' یک صحنه یا محیط را مشخص می‌کند.
image_references[].ref_nameالزامی
نوعstring
شناسه مرجع (ref_name): نام کوتاهی انتخاب کنید تا پرامپت بتواند با @ref_name به این تصویر اشاره کند.
enable_safety_checkerاختیاری
نوعboolean
پیش‌فرضtrue
با تنظیم false، در صورت مجاز بودن فراخواننده، می‌توان بررسی را آسان‌گیرانه‌تر کرد.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

خروجی

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