Bỏ qua đến nội dung

Mirage Avatar X

Tích hợp

Id mô hình 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"

Các tệp như ví dụ: 3,00 $ 3.000 tín dụng API tệp của bạn được đo trước khi chạy Chạy trên trang này

Lấy khóa API
Mirage Lipsync & avatar Đầu vào tham chiếuLipsync #avatar#talking-head

Video avatar nói chuyện Avatar X được điều khiển bằng âm thanh và tham chiếu hình ảnh, video hoặc avatar có sẵn

Mirage · Video

Kết quả đầu tiên của bạn sẽ xuất hiện ở đây

Tạo một yêu cầu bên dưới và chạy bằng khóa API của bạn. Đầu ra được sao chép vào bộ lưu trữ của chúng tôi, giữ vĩnh viễn hoặc 7 ngày miễn phí.

Tạo một yêu cầu

Các điều khiển được tạo từ lược đồ mô hình. Mã và giá sẽ cập nhật khi bạn thay đổi chúng.

•bắt buộc audio_url
Thả tệp hoặc

Địa chỉ HTTPS công khai của âm thanh điều khiển video được tạo, có thể truy cập mà không cần header ủy quyền hoặc cookie. Định dạng âm thanh được chấp nhận là FLAC, Opus hoặc Vorbis, AAC hoặc ALAC, PCM WAV hoặc AIFF và MP3. Tệp phải chứa một luồng mono hoặc stereo duy nhất, dài 3–180 giây, không quá 64 MiB và có tốc độ lấy mẫu 8–48 kHz.

Nâng cao video_reference_url · avatar · image_reference_url

URL HTTPS của video tham chiếu, có thể truy cập công khai mà không cần header ủy quyền hoặc cookie, trỏ đến tệp chứa chính xác một luồng video và ít nhất một đoạn 1 giây phù hợp để làm tham chiếu; âm thanh bị bỏ qua. Tệp được chấp nhận gồm .mp4, .mov hoặc .m4v với H.264, H.265/HEVC hoặc ProRes, hoặc .webm với VP8 hoặc VP9; thời lượng phải từ 1 đến 120 giây, kích thước không quá 1 GiB và tỷ lệ khung hình hiển thị phải nằm trong phạm vi 5% của 9:16 hoặc 16:9. Nếu image_reference_url cũng được cung cấp, video sẽ được ưu tiên.

Lựa chọn hình ảnh có sẵn, chỉ dùng khi không cung cấp tham chiếu hình ảnh hoặc video; None và mặc định đều để trống. Hình ảnh này không bao giờ cung cấp âm thanh; âm thanh luôn lấy từ audio_url. Để chọn hình ảnh, hãy xem trước các tùy chọn trong [avatar catalog](https://captions.ai/help/docs/api/actor-catalog) và sao chép chính xác giá trị Avatar.

URL HTTPS của hình ảnh tham chiếu, có thể truy cập công khai mà không cần cookie hoặc header ủy quyền; việc cung cấp video_reference_url khiến URL này bị bỏ qua. Chấp nhận một hình ảnh tĩnh duy nhất ở định dạng .jpg, .jpeg, .png hoặc .webp, tối đa 25 MiB và 25 megapixel. Cạnh ngắn hơn phải dài ít nhất 512 px và không cạnh nào được vượt quá 8192 px; tỷ lệ khung hình phải nằm trong phạm vi 5% của 9:16 hoặc 16:9.

POST /run/mirage-api/avatar-x/reference-to-video?wait=20 báo giá → 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"

Chạy yêu cầu này

Key của bạn vẫn nằm trong trình duyệt này: key chỉ được gửi đến Doitong API và chỉ được lưu trong localStorage nếu bạn chọn Ghi nhớ. Nhận khóa API

Giới thiệu về Mirage Avatar X

Tạo video avatar đồng bộ khẩu hình từ `audio_url` (3 đến 180 giây). Hình ảnh lấy từ `video_reference_url`, `image_reference_url` hoặc `avatar` có sẵn; tham chiếu video được ưu tiên hơn hình ảnh khi cung cấp cả hai. Tùy chọn avatar chỉ cung cấp hình ảnh, không cung cấp âm thanh. URL tham chiếu phải có thể truy cập công khai qua HTTPS.

Tham số

Gửi tên chuẩn hoặc tên gốc, không gửi cả hai. Tên chuẩn

TênKiểu Mặc địnhĐược phép Mô tả
audio_urlbắt buộc audio
Kiểuurl · audio
Địa chỉ HTTPS công khai của âm thanh điều khiển video được tạo, có thể truy cập mà không cần header ủy quyền hoặc cookie. Định dạng âm thanh được chấp nhận là FLAC, Opus hoặc Vorbis, AAC hoặc ALAC, PCM WAV hoặc AIFF và MP3. Tệp phải chứa một luồng mono hoặc stereo duy nhất, dài 3–180 giây, không quá 64 MiB và có tốc độ lấy mẫu 8–48 kHz.
video_reference_urltùy chọn
Kiểustring | null
URL HTTPS của video tham chiếu, có thể truy cập công khai mà không cần header ủy quyền hoặc cookie, trỏ đến tệp chứa chính xác một luồng video và ít nhất một đoạn 1 giây phù hợp để làm tham chiếu; âm thanh bị bỏ qua. Tệp được chấp nhận gồm .mp4, .mov hoặc .m4v với H.264, H.265/HEVC hoặc ProRes, hoặc .webm với VP8 hoặc VP9; thời lượng phải từ 1 đến 120 giây, kích thước không quá 1 GiB và tỷ lệ khung hình hiển thị phải nằm trong phạm vi 5% của 9:16 hoặc 16:9. Nếu image_reference_url cũng được cung cấp, video sẽ được ưu tiên.
avatartùy chọn
Kiểuenum
NoneAyeshaAyesha (16:9)FarhanFarhan (16:9)GiuliaGiulia (16:9)JasmineJasmine (16:9)LukeLuke (16:9)MayaMaya (16:9)MichaelMichael (16:9)Neha
+5 giá trị khácNeha (16:9)TariqTariq (16:9)ValerieValerie (16:9)
Lựa chọn hình ảnh có sẵn, chỉ dùng khi không cung cấp tham chiếu hình ảnh hoặc video; None và mặc định đều để trống. Hình ảnh này không bao giờ cung cấp âm thanh; âm thanh luôn lấy từ audio_url. Để chọn hình ảnh, hãy xem trước các tùy chọn trong [avatar catalog](https://captions.ai/help/docs/api/actor-catalog) và sao chép chính xác giá trị Avatar.
image_reference_urltùy chọn
Kiểustring | null
URL HTTPS của hình ảnh tham chiếu, có thể truy cập công khai mà không cần cookie hoặc header ủy quyền; việc cung cấp video_reference_url khiến URL này bị bỏ qua. Chấp nhận một hình ảnh tĩnh duy nhất ở định dạng .jpg, .jpeg, .png hoặc .webp, tối đa 25 MiB và 25 megapixel. Cạnh ngắn hơn phải dài ít nhất 512 px và không cạnh nào được vượt quá 8192 px; tỷ lệ khung hình phải nằm trong phạm vi 5% của 9:16 hoặc 16:9.
bắt buộc Tên chuẩn, cũng được chấp nhận

Các tham số tệp nhận URL https:// công khai, URI data: tối đa 10 MB hoặc file_url của một tệp tải lên. Tệp

Đầu ra

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"
  }
}
Tệp của bạn, lựa chọn của bạnMỗi outputs[].url là một bản sao trên bộ lưu trữ của chúng tôi: được giữ vĩnh viễn (tính phí theo GB-tháng) hoặc 7 ngày miễn phí, theo cài đặt tài khoản hoặc ?storage=.
Cùng một cấu trúc trên mọi mô hìnhtype, url, content_type, width, height và duration cho hình ảnh, video và âm thanh. output là đối tượng kết quả riêng của mô hình.
Các trường đầu ra
video
object {url, content_type, file_name, file_size}

Thêm mô hình: Lipsync & avatar

Dành cho tác nhân AI: trang này ở dạng Markdown tại https://doitong.com/vi/developers/models/mirage-api/avatar-x/reference-to-video.md. Tất cả mô hình và hướng dẫn: https://doitong.com/developers/llms.txt