ใช้ Hailuo Standard ผ่าน Rivya Public API v1 ด้วย model id hailuo-standard, อินพุตที่รองรับ, พารามิเตอร์, กฎ Files API, เครดิต และตัวอย่างคำตอบ

พร้อมใช้งานผ่าน APIข้อความหรือ URL พร้อม; โหมดอ้างอิงใช้ Files APIวิดีโอ

ID โมเดล API

hailuo-standard

อินพุต

text, file

Files API

จำเป็นสำหรับโหมดอ้างอิง

เครดิตพื้นฐาน

ความสามารถ

วิดีโอ

การชำระเงิน

FIXED

ขีดจำกัดพรอมต์

1500 อักขระ

สัญญาของคำขอ

ส่ง model id ที่ระดับบนสุด การควบคุมเฉพาะโมเดลอยู่ใน params

คีย์	ประเภท	จำเป็น	ค่าเริ่มต้น	คำอธิบาย
model	string	ใช่	hailuo-standard	ใช้ API model id hailuo-standard
prompt	string	ใช่	-	สูงสุด 1500 อักขระสำหรับโมเดลนี้
params	object	ไม่ใช่	-	object พารามิเตอร์เฉพาะโมเดล ใช้แถวด้านล่างสำหรับ key ที่อนุญาต
client_request_id	string	ไม่ใช่	-	ID ฝั่งไคลเอนต์แบบเลือกได้สำหรับติดตามคำขอในระบบของคุณ

พารามิเตอร์โมเดล

คีย์	ประเภท	จำเป็น	ค่าเริ่มต้น	ช่วง	ตัวเลือก	คำอธิบาย
duration	select	ไม่ใช่	6	-	6, 10	ระยะเวลา
resolution	select	ไม่ใช่	512P	-	512P, 768P	ความละเอียด
prompt_optimizer	select	ไม่ใช่	false	-	false, true	ให้ Hailuo เขียนและปรับพรอมป์ของคุณก่อนสร้าง ปิดเมื่อคุณต้องการให้รอบสร้างอยู่ใกล้ถ้อยคำดิบของคุณมากขึ้น

นโยบายการอัปโหลด

อัปโหลดไฟล์อ้างอิงก่อน จากนั้นใส่ URL และ duration token ที่ได้กลับมาไว้ใน params.referenceMediaItems

กฎอ้างอิง

รูปอ้างอิง: โหมดรูปภาพรับรูปได้สูงสุด 2 รูป และรูปที่สองจะกลายเป็นเฟรมสุดท้าย

ไฟล์สูงสุด

ชนิดไฟล์ที่รับ

image

Duration token

ไฟล์อ้างอิงวิดีโอและเสียงควรมี durationToken จาก /api/v1/files เมื่อจำเป็นต้องตรวจระยะเวลา

kind	ขนาดสูงสุด	MIME type
image	10 MB	image/jpeg, image/png, image/webp

คำขอขั้นต่ำ

{
  "model": "hailuo-standard",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "duration": "6",
    "resolution": "512P",
    "prompt_optimizer": "false"
  }
}

คำขอแบบไฟล์อ้างอิง

{
  "model": "hailuo-standard",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "duration": "6",
    "resolution": "512P",
    "prompt_optimizer": "false",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

คำตอบจากการสร้าง

endpoint create ส่ง ID งานสาธารณะกลับมา ให้ตรวจ endpoint สถานะซ้ำจนกว่างานจะสำเร็จหรือล้มเหลว

{
  "id": "task_hailuo_standard_example",
  "status": "queued",
  "model": "hailuo-standard",
  "reserved_credits": 30,
  "final_credits": 0,
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

ข้อผิดพลาดทั่วไป

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

บางโหมดต้องใช้การอัปโหลดไฟล์อ้างอิงผ่าน Files API

การเชื่อมต่อ API ของ Hailuo Standard