رفتن به محتوا

H3 Max Camera Controls

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

شناسه مدل minimax/h3-max/camera-controls
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/v1/run/minimax/h3-max/camera-controls?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt_expansion_mode": "balanced",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

این درخواست: ⁨‎$۰٫۱۷۵⁩ ۱۷۵ اعتبار API اجرای آن در این صفحه

دریافت کلید API
MiniMax تصویر به ویدیو ۰٫۹۲–۱۵ ثانیهحداکثر 1080P #stylized#transform#editing

متحرک‌سازی یک تصویر در مسیر دوربین کلیدگذاری‌شده با کنترل چرخش، ارتفاع و فاصله

MiniMax · ویدیو

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

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

ساخت درخواست

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

0 / 50000

پرامپت تولید ویدیو که رفتار پیش‌فرض صحنهٔ ثابت را بازنویسی می‌کند. خالی گذاشتن یا حذف آن، صحنهٔ مرجع را ثابت نگه می‌دارد و فقط حرکت دوربین را مجاز می‌کند.

•الزامی

میزان تلاش برای بازنویسی پرامپت پیش از تولید: 'quality' پرامپتی غنی‌تر را در حدود 30s ایجاد می‌کند، درحالی‌که 'balanced' تقریباً در یک ثانیه پاسخ می‌دهد. برای حذف گسترش پرامپت، 'disabled' را انتخاب کنید.

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

URL تصویر تعیین‌کنندهٔ فریم آغازین ویدیو.

resolution پیش‌فرض 480P

انتخاب وضوح تولید: 1080P به پالایش نهفتهٔ محتوای تولیدشده به‌صورت بومی در 768P نیاز دارد، نه تولید بومی در وضوح انتخاب‌شده.

پیش‌فرض 5

مدت درخواست‌شده برحسب ثانیه؛ طول واقعی ویدیو می‌تواند تقریباً تا 0.7 s بیشتر از آن باشد.

پیشرفته seed · enable_safety_checker · camera_trajectory

Seed برای تولید تصادفی؛ در صورت حذف، یک مقدار به‌صورت تصادفی انتخاب می‌شود.

فریم‌های کلیدی مرتب‌شدهٔ دوربین با حفظ چرخش‌های کامل علامت‌دار و محدودیت مجموع حرکت سمتی به 32 دور. خارج از بازهٔ زمانی فریم‌های کلیدی، دوربین پیش از زمان فریم نخست در وضعیت اول و تا پایان ویدیو در وضعیت نهایی باقی می‌ماند.

POST /run/minimax/h3-max/camera-controls?wait=20 قیمت → ⁨‎$۰٫۱۷۵⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/v1/run/minimax/h3-max/camera-controls?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt_expansion_mode": "balanced",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

اجرای این درخواست

کلید شما در این مرورگر باقی می‌ماند: فقط به Doitong API ارسال می‌شود و فقط در صورت فعال‌کردن گزینه «یادآوری»، در localStorage ذخیره می‌شود. دریافت کلید API

درباره H3 Max Camera Controls

`image_url` را به‌عنوان فریم اول استفاده می‌کند و دوربین را در امتداد `camera_trajectory`، فهرستی از 2 تا 12 فریم کلیدی مرتب، حرکت می‌دهد. به‌طور پیش‌فرض صحنه ثابت می‌ماند و فقط دوربین تغییر می‌کند. مدت‌زمان 0.92 تا 15 ثانیه و وضوح 480P، 768P یا 1080P است. گسترش پرامپت قابل تنظیم است.

پارامترها

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

نامنوع پیش‌فرضمجاز توضیحات
promptاختیاری
نوعstring
پیش‌فرضThe same elements in the reference are rigid. Preserve every element exactly. The entire scene is frozen. Only the camera moves. no scene motion only camera motion
≤ ۵۰٬۰۰۰ نویسه
پرامپت تولید ویدیو که رفتار پیش‌فرض صحنهٔ ثابت را بازنویسی می‌کند. خالی گذاشتن یا حذف آن، صحنهٔ مرجع را ثابت نگه می‌دارد و فقط حرکت دوربین را مجاز می‌کند.
durationاختیاری
نوعnumber
پیش‌فرض5
۰٫۹۲ – ۱۵
مدت درخواست‌شده برحسب ثانیه؛ طول واقعی ویدیو می‌تواند تقریباً تا 0.7 s بیشتر از آن باشد.
resolutionاختیاری
نوعenum
پیش‌فرض480P
480P768P1080P
انتخاب وضوح تولید: 1080P به پالایش نهفتهٔ محتوای تولیدشده به‌صورت بومی در 768P نیاز دارد، نه تولید بومی در وضوح انتخاب‌شده.
seedاختیاری
نوعinteger | null
Seed برای تولید تصادفی؛ در صورت حذف، یک مقدار به‌صورت تصادفی انتخاب می‌شود.
enable_safety_checkerاختیاری
نوعboolean
پیش‌فرضtrue
فعال‌سازی بررسی‌کننده ایمنی؛ true بررسی را فعال می‌کند.
prompt_expansion_modeالزامی
نوعstring
پیش‌فرضbalanced
میزان تلاش برای بازنویسی پرامپت پیش از تولید: 'quality' پرامپتی غنی‌تر را در حدود 30s ایجاد می‌کند، درحالی‌که 'balanced' تقریباً در یک ثانیه پاسخ می‌دهد. برای حذف گسترش پرامپت، 'disabled' را انتخاب کنید.
image_urlالزامی image
نوعurl · image
URL تصویر تعیین‌کنندهٔ فریم آغازین ویدیو.
camera_trajectoryاختیاری
نوعobject[]
≤ ۱۲ مورد≥ ۲ مورد
فریم‌های کلیدی مرتب‌شدهٔ دوربین با حفظ چرخش‌های کامل علامت‌دار و محدودیت مجموع حرکت سمتی به 32 دور. خارج از بازهٔ زمانی فریم‌های کلیدی، دوربین پیش از زمان فریم نخست در وضعیت اول و تا پایان ویدیو در وضعیت نهایی باقی می‌ماند.
camera_trajectory[].timeالزامی
نوعnumber
۰ – ۱
زمان نرمال‌شده در ویدیو؛ بازهٔ [0, 1] به‌ترتیب آغاز و پایان آن را نشان می‌دهد.
camera_trajectory[].azimuthالزامی
نوعnumber
زاویهٔ افقی دوربین نسبت به سوژه، برحسب درجه.
camera_trajectory[].elevationالزامی
نوعnumber
−۹۰ – ۹۰
زاویهٔ عمودی دوربین نسبت به سوژه، برحسب درجه.
camera_trajectory[].distanceالزامی
نوعnumber
> ۰
فاصلهٔ دوربین و سوژه، برحسب واحدهای نرمال‌شدهٔ صحنه.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

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

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "minimax/h3-max/camera-controls",
  "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": 175,
    "usd": "0.175",
    "charged": 175,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "prompt_expansion_mode": "balanced"
  },
  "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
    },
    "expanded_prompt": "string",
    "timings": {}
  },
  "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://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://vit.doitong.com/api/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}ویدیوی تولیدشده توسط مدل.
expanded_prompt
string | nullپرامپت گسترش‌یافتهٔ آمادهٔ مدل، یا null اگر متن گسترش‌یافته‌ای موجود نباشد. موارد null شامل گسترش غیرفعال، گسترشی که تغییری ایجاد نکرده، و گسترشی است که به‌صورت داخلی توسط API میزبانی‌شدهٔ مدل پردازش شده است.
timings
object | nullاندازه‌گیری‌های زمان‌بندی برحسب ثانیه که فقط در مسیرهای گزارش‌دهندهٔ زمان‌های backend موجودند؛ در غیر این صورت null هستند. ورودی 'inference' مدت زمان حذف نویز DiT را در backend پردازندهٔ گرافیکی اندازه‌گیری می‌کند.

مدل‌های بیشتر: تصویر به ویدیو

برای عامل‌های هوش مصنوعی: این صفحه به‌صورت Markdown در دسترس است https://doitong.com/fa/developers/models/minimax/h3-max/camera-controls.md. همه مدل‌ها و راهنماها: https://doitong.com/developers/llms.txt