تخطّي إلى المحتوى

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"

هذا الطلب: ⁨‏0.175 $⁩ 175 رصيد API تشغيله في هذه الصفحة

الحصول على مفتاح API
MiniMax من صورة إلى فيديو 0.92–15 ثحتى 1080P #stylized#transform#editing

يحرّك صورة واحدة على مسار كاميرا محدد بإطارات رئيسية مع التحكم في الدوران والارتفاع والمسافة

MiniMax · فيديو

ستظهر نتيجتك الأولى هنا

أنشئ طلبًا أدناه وشغّله باستخدام مفتاح API الخاص بك. تُنسخ المخرجات إلى تخزيننا، وتُحفظ إلى الأبد أو لمدة 7 أيام مجانًا.

إنشاء طلب

تُنشأ عناصر التحكم من مخطط النموذج. يتحدّث الرمز والسعر عند تغييرها.

0 / 50000

موجّه توليد فيديو يتجاوز سلوك المشهد الثابت الافتراضي. يؤدي تركه فارغًا أو حذفه إلى إبقاء المشهد المرجعي ثابتًا والسماح بحركة الكاميرا فقط.

•مطلوب

جهد إعادة صياغة الموجّه قبل التوليد: تطوّر 'quality' موجّهًا أكثر ثراءً خلال مدة تصل تقريبًا إلى 30s، بينما تعيد 'balanced' النتيجة خلال نحو ثانية. اختر 'disabled' لإلغاء توسيع الموجّه.

•مطلوب image_url
أفلت ملفًا، أو

عنوان URL لصورة تحدد الإطار الافتتاحي للفيديو.

resolution الافتراضي 480P

اختيار دقة التوليد: تتطلب 1080P تحسينًا كامنًا للمادة المولدة أصليًا بدقة 768P، بدلًا من التوليد الأصلي بالدقة المحددة.

الافتراضي 5

المدة المطلوبة بالثواني، مع السماح بطول فيديو فعلي يزيد عن ذلك الطلب بنحو 0.7 s كحد أقصى.

متقدم seed · enable_safety_checker · camera_trajectory

بذرة التوليد العشوائي؛ إذا لم تُحدَّد، تُختار عشوائيًا.

إطارات مفتاحية مرتبة للكاميرا مع الاحتفاظ بالدورات الكاملة الموقعة، وتحديد إجمالي حركة السمت عند 32 دورة. خارج النطاق الزمني للإطارات المفتاحية، تثبّت الكاميرا الوضعية الأولى قبل طابعها الزمني، والوضعية النهائية حتى نهاية الفيديو.

POST /run/minimax/h3-max/camera-controls?wait=20 عرض السعر → ⁨‏0.175 $⁩
# 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
≤ 50,000 حرف
موجّه توليد فيديو يتجاوز سلوك المشهد الثابت الافتراضي. يؤدي تركه فارغًا أو حذفه إلى إبقاء المشهد المرجعي ثابتًا والسماح بحركة الكاميرا فقط.
durationاختياري
النوعnumber
الافتراضي5
0.92 – 15
المدة المطلوبة بالثواني، مع السماح بطول فيديو فعلي يزيد عن ذلك الطلب بنحو 0.7 s كحد أقصى.
resolutionاختياري
النوعenum
الافتراضي480P
480P768P1080P
اختيار دقة التوليد: تتطلب 1080P تحسينًا كامنًا للمادة المولدة أصليًا بدقة 768P، بدلًا من التوليد الأصلي بالدقة المحددة.
seedاختياري
النوعinteger | null
بذرة التوليد العشوائي؛ إذا لم تُحدَّد، تُختار عشوائيًا.
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
تنشيط مدقق السلامة؛ تُمكّن true الفحص.
prompt_expansion_modeمطلوب
النوعstring
الافتراضيbalanced
جهد إعادة صياغة الموجّه قبل التوليد: تطوّر 'quality' موجّهًا أكثر ثراءً خلال مدة تصل تقريبًا إلى 30s، بينما تعيد 'balanced' النتيجة خلال نحو ثانية. اختر 'disabled' لإلغاء توسيع الموجّه.
image_urlمطلوب image
النوعurl · image
عنوان URL لصورة تحدد الإطار الافتتاحي للفيديو.
camera_trajectoryاختياري
النوعobject[]
≤ 12 عنصرًا≥ 2 عنصرين
إطارات مفتاحية مرتبة للكاميرا مع الاحتفاظ بالدورات الكاملة الموقعة، وتحديد إجمالي حركة السمت عند 32 دورة. خارج النطاق الزمني للإطارات المفتاحية، تثبّت الكاميرا الوضعية الأولى قبل طابعها الزمني، والوضعية النهائية حتى نهاية الفيديو.
camera_trajectory[].timeمطلوب
النوعnumber
0 – 1
الوقت المطبَّع داخل الفيديو، باستخدام المجال [0, 1] لتمثيل بدايته ونهايته على التوالي.
camera_trajectory[].azimuthمطلوب
النوعnumber
الزاوية الأفقية للكاميرا حول الهدف، مقاسة بالدرجات.
camera_trajectory[].elevationمطلوب
النوعnumber
-90 – 90
الزاوية الرأسية للكاميرا حول الهدف، مقاسة بالدرجات.
camera_trajectory[].distanceمطلوب
النوعnumber
> 0
المسافة بين الكاميرا والهدف، مقاسة بوحدات المشهد المطبَّعة.
مطلوب الاسم الأساسي، مقبول أيضًا

تقبل معاملات الملفات عنوان 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 هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 7 أيام مجانًا، وفق إعداد حسابك أو ?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قياسات التوقيت معبَّرًا عنها بالثواني، ومتاحة فقط في المسارات التي تُبلغ عن توقيتات الواجهة الخلفية؛ وإلا فالقيمة null. يقيس الإدخال 'inference' المدة التي استغرقها إزالة الضوضاء DiT على الواجهة الخلفية لوحدة GPU.

مزيد من النماذج: من صورة إلى فيديو

لوكلاء الذكاء الاصطناعي: تتوفر هذه الصفحة بصيغة Markdown على https://doitong.com/ar/developers/models/minimax/h3-max/camera-controls.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt