ข้ามไปยังเนื้อหา

H3 Max Camera Controls

ผสานการทำงาน

ID โมเดล 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 sสูงสุด 1080P #stylized#transform#editing

ทำให้ภาพหนึ่งภาพเคลื่อนไหวไปตามเส้นทางกล้องที่กำหนดด้วยคีย์เฟรม พร้อมควบคุมการโคจร ระดับความสูง และระยะห่าง

MiniMax · วิดีโอ

ผลลัพธ์แรกของคุณจะแสดงที่นี่

สร้างคำขอด้านล่างและเรียกใช้ด้วยคีย์ API ของคุณ เอาต์พุตจะถูกคัดลอกไปยังพื้นที่จัดเก็บของเรา และเก็บไว้ตลอดไปหรือฟรี 7 วัน

สร้างคำขอ

ตัวควบคุมสร้างจากสคีมาของโมเดล โค้ดและราคาจะอัปเดตเมื่อคุณเปลี่ยนค่า

0 / 50000

พรอมต์สำหรับการสร้างวิดีโอที่แทนที่พฤติกรรมฉากหยุดนิ่งตามค่าเริ่มต้น การเว้นว่างหรือละเว้นค่านี้จะตรึงฉากอ้างอิงไว้และอนุญาตให้เคลื่อนเฉพาะกล้อง

•จำเป็น

ระดับความพยายามในการเขียนพรอมต์ใหม่ก่อนการสร้าง: 'quality' จะพัฒนาพรอมต์ให้มีรายละเอียดมากขึ้นภายในเวลาประมาณ 30s ขณะที่ 'balanced' จะส่งผลลัพธ์กลับมาภายในประมาณหนึ่งวินาที เลือก 'disabled' เพื่อไม่ขยายพรอมต์

•จำเป็น image_url
วางไฟล์ หรือ

URL ของรูปภาพที่กำหนดเฟรมเปิดของวิดีโอ

resolution ค่าเริ่มต้น 480P

การเลือกความละเอียดการสร้าง: 1080P ต้องปรับแต่ง latent ของเนื้อหาที่สร้างโดยกำเนิดที่ 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 ต้องปรับแต่ง latent ของเนื้อหาที่สร้างโดยกำเนิดที่ 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:// สาธารณะ, data: URI ขนาดไม่เกิน 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-เดือน) หรือฟรี 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

โมเดลเพิ่มเติม: ภาพเป็นวิดีโอ

สำหรับเอเจนต์ AI: หน้า Markdown นี้อยู่ที่ https://doitong.com/th/developers/models/minimax/h3-max/camera-controls.md. โมเดลและคู่มือทั้งหมด: https://doitong.com/developers/llms.txt