رفتن به محتوا

PixVerse V4 Text To Video

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

شناسه مدل pixverse/v4/text-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/v4/text-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
PixVerse متن به ویدیو ۵–۸ ثانیهحداکثر 1080p

تبدیل متن به ویدیوی PixVerse V4 با نسبت تصویر قابل انتخاب، وضوح تا 1080p و پیش‌تنظیم‌های سبک

PixVerse · ویدیو

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

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

ساخت درخواست

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

•الزامی

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

duration ۵ s

مدت ویدیو، با حداکثر 5 ثانیه برای خروجی 1080p؛ طول را بر حسب ثانیه مشخص کنید.

aspect_ratio پیش‌فرض 16:9

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

resolution پیش‌فرض 720p

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

پیشرفته negative_prompt · style · seed · enable_safety_checker
پیش‌فرض

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

style

سبک اعمال‌شده بر ویدیوی تولیدشده.

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

POST /run/pixverse/v4/text-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/v4/text-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

درباره PixVerse V4 Text To Video

از `prompt` با حداکثر 2048 بایت UTF-8 ویدیو ایجاد می‌کند. `aspect_ratio` را از میان 16:9، 4:3، 1:1، 3:4 و 9:16 و `resolution` را از 360p تا 1080p انتخاب کنید. `duration` برابر 5 یا 8 ثانیه است و 1080p روی 5 می‌ماند. `style`، `negative_prompt` و `seed` پشتیبانی می‌شوند؛ این گونه متنی گزینه حرکت دوربین ندارد.

پارامترها

نامنوع پیش‌فرضمجاز توضیحات
promptالزامی
نوعstring
پرامپت تولید ویدیو با سقف اندازه بر اساس بایت: حتی متن کوتاه از نظر بصری ممکن است هنگام استفاده از ایموجی، حروف دارای اَکسان یا نویسه‌های غیرلاتین، به‌دلیل اشغال چند بایت برای هر نویسه، از این سقف فراتر برود. حداکثر طول کدگذاری‌شده 2048 بایت با UTF-8 است؛ تعداد نویسه‌ها تعیین نمی‌کند که متن در این محدوده جا می‌گیرد یا نه.
aspect_ratioاختیاری
نوعenum
پیش‌فرض16:9
16:94:31:13:49:16
نسبت ابعاد ویدیوی خروجی.
resolutionاختیاری
نوعenum
پیش‌فرض720p
360p540p720p1080p
وضوح ویدیوی خروجی.
durationاختیاری
نوعenum
پیش‌فرض5
58
مدت ویدیو، با حداکثر 5 ثانیه برای خروجی 1080p؛ طول را بر حسب ثانیه مشخص کنید.
negative_promptاختیاری
نوعstring
پیش‌فرض
پرامپت منفی تولید با محدودیت طول بر اساس بایت: حتی متن کوتاه از نظر بصری ممکن است به‌دلیل اشغال چند بایت توسط ایموجی، حروف دارای اَکسان و نویسه‌های غیرلاتین، از سقف فراتر برود. حداکثر 2048 بایت است که با UTF-8 اندازه‌گیری می‌شود، نه تعداد نویسه‌ها.
styleاختیاری
نوعenum
anime3d_animationclaycomiccyberpunk
سبک اعمال‌شده بر ویدیوی تولیدشده.
seedاختیاری
نوعinteger | null
seed برای تولید تکرارپذیر ویدیو. بازتولید دقیق در هر اجرا به ثابت‌ماندن نسخه مدل، پرامپت و seed نیاز دارد.
enable_safety_checkerاختیاری
نوعboolean
پیش‌فرضtrue
با تنظیم false، در صورت مجاز بودن فراخواننده، می‌توان بررسی را آسان‌گیرانه‌تر کرد.
الزامی

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "pixverse/v4/text-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": 200,
    "usd": "0.20",
    "charged": 200,
    "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/pixverse/v4/text-to-video.md. همه مدل‌ها و راهنماها: https://doitong.com/developers/llms.txt