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

Mirage Avatar X

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

ID โมเดล mirage-api/avatar-x/reference-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/mirage-api/avatar-x/reference-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "audio": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3"
  }'

# 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"

ไฟล์เช่นเดียวกับตัวอย่าง: $3.00 3,000 เครดิต API ไฟล์ของคุณจะถูกวัดก่อนเรียกใช้ เรียกใช้ในหน้านี้

รับคีย์ API
Mirage ลิปซิงก์และอวตาร อินพุตอ้างอิงลิปซิงก์ #avatar#lipsync#talking-head

วิดีโอศีรษะพูดได้ อวตาร X ที่ขับเคลื่อนด้วยเสียงและรูปภาพ วิดีโอ หรือข้อมูลอ้างอิงอวตารจากคลังของคุณ

Mirage · วิดีโอ

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

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

สร้างคำขอ

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

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

ที่อยู่ HTTPS สาธารณะของเสียงที่ใช้สร้างวิดีโอ ซึ่งเข้าถึงได้โดยไม่มีส่วนหัวการอนุญาตหรือคุกกี้ รูปแบบเสียงที่รองรับ ได้แก่ FLAC, Opus หรือ Vorbis, AAC หรือ ALAC, PCM WAV หรือ AIFF และ MP3 ไฟล์ต้องมีสตรีมโมโนหรือสเตอริโอเพียงหนึ่งสตรีม มีความยาว 3–180 วินาที ขนาดไม่เกิน 64 MiB และมีอัตราการสุ่มตัวอย่าง 8–48 kHz

ขั้นสูง video_reference_url · avatar · image_reference_url

URL HTTPS ของวิดีโออ้างอิงที่เข้าถึงได้แบบสาธารณะโดยไม่มีส่วนหัวการอนุญาตหรือคุกกี้ สำหรับไฟล์ที่มีสตรีมวิดีโอเพียงหนึ่งสตรีมและมีส่วนความยาว 1 วินาทีที่เหมาะสมอย่างน้อยหนึ่งส่วนเพื่อใช้เป็นข้อมูลอ้างอิง ระบบจะไม่สนใจเสียง รูปแบบไฟล์ที่รองรับคือ .mp4, .mov หรือ .m4v ที่ใช้ H.264, H.265/HEVC หรือ ProRes หรือ .webm ที่ใช้ VP8 หรือ VP9 ความยาวต้องอยู่ในช่วง 1 ถึง 120 วินาที ขนาดไม่เกิน 1 GiB และอัตราส่วนภาพที่แสดงต้องอยู่ภายใน 5% ของ 9:16 หรือ 16:9 หากระบุ image_reference_url ด้วย วิดีโอจะมีลำดับความสำคัญสูงกว่า

การเลือกภาพจากคลังที่ใช้เฉพาะเมื่อไม่ได้ระบุข้อมูลอ้างอิงรูปภาพหรือวิดีโอ None และค่าเริ่มต้นจะปล่อยให้ไม่ได้ตั้งค่าไว้เสมอ เสียงจะไม่มาจากภาพนี้และมาจาก audio_url เสมอ หากต้องการเลือกภาพ ให้ดูตัวเลือกใน [avatar catalog](https://captions.ai/help/docs/api/actor-catalog) แล้วคัดลอกค่า Avatar ที่ตรงกันทุกประการ

URL HTTPS ของรูปภาพอ้างอิงที่เข้าถึงได้แบบสาธารณะโดยไม่มีคุกกี้หรือส่วนหัวการอนุญาต การระบุ video_reference_url จะทำให้ไม่สนใจรูปภาพนี้ รองรับรูปภาพนิ่งหนึ่งรูปในรูปแบบ .jpg, .jpeg, .png หรือ .webp ขนาดไม่เกิน 25 MiB และ 25 เมกะพิกเซล ด้านที่สั้นกว่าต้องมีขนาดอย่างน้อย 512 px และทั้งสองด้านต้องไม่เกิน 8192 px อัตราส่วนภาพต้องอยู่ภายใน 5% ของ 9:16 หรือ 16:9

POST /run/mirage-api/avatar-x/reference-to-video?wait=20 ใบเสนอราคา → $3.00
# 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/mirage-api/avatar-x/reference-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "audio": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3"
  }'

# 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

เกี่ยวกับ Mirage Avatar X

สร้างวิดีโออวตารที่ซิงก์ริมฝีปากจาก `audio_url` (3 ถึง 180 วินาที) ภาพมาจาก `video_reference_url`, `image_reference_url` หรือ `avatar` แบบสต็อก โดยวิดีโออ้างอิงจะมีลำดับความสำคัญเหนือรูปภาพเมื่อระบุทั้งสองรายการ ตัวเลือกอวตารให้เฉพาะภาพ ไม่รวมเสียง URL อ้างอิงต้องสามารถเข้าถึงแบบสาธารณะผ่าน HTTPS ได้

พารามิเตอร์

ส่งชื่อมาตรฐานหรือชื่อดั้งเดิมอย่างใดอย่างหนึ่งเท่านั้น ห้ามส่งทั้งสองชื่อ ชื่อมาตรฐาน

ชื่อประเภท ค่าเริ่มต้นค่าที่อนุญาต คำอธิบาย
audio_urlจำเป็น audio
ประเภทurl · audio
ที่อยู่ HTTPS สาธารณะของเสียงที่ใช้สร้างวิดีโอ ซึ่งเข้าถึงได้โดยไม่มีส่วนหัวการอนุญาตหรือคุกกี้ รูปแบบเสียงที่รองรับ ได้แก่ FLAC, Opus หรือ Vorbis, AAC หรือ ALAC, PCM WAV หรือ AIFF และ MP3 ไฟล์ต้องมีสตรีมโมโนหรือสเตอริโอเพียงหนึ่งสตรีม มีความยาว 3–180 วินาที ขนาดไม่เกิน 64 MiB และมีอัตราการสุ่มตัวอย่าง 8–48 kHz
video_reference_urlไม่บังคับ
ประเภทstring | null
URL HTTPS ของวิดีโออ้างอิงที่เข้าถึงได้แบบสาธารณะโดยไม่มีส่วนหัวการอนุญาตหรือคุกกี้ สำหรับไฟล์ที่มีสตรีมวิดีโอเพียงหนึ่งสตรีมและมีส่วนความยาว 1 วินาทีที่เหมาะสมอย่างน้อยหนึ่งส่วนเพื่อใช้เป็นข้อมูลอ้างอิง ระบบจะไม่สนใจเสียง รูปแบบไฟล์ที่รองรับคือ .mp4, .mov หรือ .m4v ที่ใช้ H.264, H.265/HEVC หรือ ProRes หรือ .webm ที่ใช้ VP8 หรือ VP9 ความยาวต้องอยู่ในช่วง 1 ถึง 120 วินาที ขนาดไม่เกิน 1 GiB และอัตราส่วนภาพที่แสดงต้องอยู่ภายใน 5% ของ 9:16 หรือ 16:9 หากระบุ image_reference_url ด้วย วิดีโอจะมีลำดับความสำคัญสูงกว่า
avatarไม่บังคับ
ประเภทenum
NoneAyeshaAyesha (16:9)FarhanFarhan (16:9)GiuliaGiulia (16:9)JasmineJasmine (16:9)LukeLuke (16:9)MayaMaya (16:9)MichaelMichael (16:9)Neha
เพิ่มเติมอีก 5 ค่าNeha (16:9)TariqTariq (16:9)ValerieValerie (16:9)
การเลือกภาพจากคลังที่ใช้เฉพาะเมื่อไม่ได้ระบุข้อมูลอ้างอิงรูปภาพหรือวิดีโอ None และค่าเริ่มต้นจะปล่อยให้ไม่ได้ตั้งค่าไว้เสมอ เสียงจะไม่มาจากภาพนี้และมาจาก audio_url เสมอ หากต้องการเลือกภาพ ให้ดูตัวเลือกใน [avatar catalog](https://captions.ai/help/docs/api/actor-catalog) แล้วคัดลอกค่า Avatar ที่ตรงกันทุกประการ
image_reference_urlไม่บังคับ
ประเภทstring | null
URL HTTPS ของรูปภาพอ้างอิงที่เข้าถึงได้แบบสาธารณะโดยไม่มีคุกกี้หรือส่วนหัวการอนุญาต การระบุ video_reference_url จะทำให้ไม่สนใจรูปภาพนี้ รองรับรูปภาพนิ่งหนึ่งรูปในรูปแบบ .jpg, .jpeg, .png หรือ .webp ขนาดไม่เกิน 25 MiB และ 25 เมกะพิกเซล ด้านที่สั้นกว่าต้องมีขนาดอย่างน้อย 512 px และทั้งสองด้านต้องไม่เกิน 8192 px อัตราส่วนภาพต้องอยู่ภายใน 5% ของ 9:16 หรือ 16:9
จำเป็น ชื่อมาตรฐาน ซึ่งรองรับเช่นกัน

พารามิเตอร์ไฟล์รับ URL https:// สาธารณะ, data: URI ขนาดไม่เกิน 10 MB หรือ file_url ของไฟล์ที่อัปโหลด ไฟล์

เอาต์พุต

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "mirage-api/avatar-x/reference-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": 3000,
    "usd": "3.00",
    "charged": 3000,
    "refunded": 0
  },
  "input": {
    "audio_url": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3"
  },
  "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-เดือน) หรือฟรี 7 วัน โดยกำหนดได้ในการตั้งค่าบัญชีหรือ ?storage=
รูปแบบเดียวกันในทุกโมเดลtype, url, content_type, width, height และ duration สำหรับภาพ วิดีโอ และเสียงเหมือนกันทั้งหมด ส่วน output คือออบเจ็กต์ผลลัพธ์ของโมเดลเอง
ฟิลด์ของเอาต์พุต
video
object {url, content_type, file_name, file_size}

โมเดลเพิ่มเติม: ลิปซิงก์และอวตาร

สำหรับเอเจนต์ AI: หน้า Markdown นี้อยู่ที่ https://doitong.com/th/developers/models/mirage-api/avatar-x/reference-to-video.md. โมเดลและคู่มือทั้งหมด: https://doitong.com/developers/llms.txt