Μετάβαση στο περιεχόμενο

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

Βίντεο talking-head του άβαταρ X, που καθοδηγείται από τον ήχο σας και μια αναφορά εικόνας, βίντεο ή άβαταρ απόθεμα

Mirage · Βίντεο

Το πρώτο σας αποτέλεσμα θα εμφανιστεί εδώ

Δημιουργήστε ένα αίτημα παρακάτω και εκτελέστε το με το κλειδί API σας. Οι έξοδοι αντιγράφονται στην αποθήκευσή μας και διατηρούνται για πάντα ή 7 ημέρες δωρεάν.

Δημιουργία αιτήματος

Τα στοιχεία ελέγχου δημιουργούνται από το σχήμα του μοντέλου. Ο κώδικας και η τιμή ενημερώνονται καθώς τα αλλάζετε.

•απαιτείται audio_url
Αποθέστε ένα αρχείο ή

Δημόσια διεύθυνση HTTPS για τον ήχο που οδηγεί την παραγωγή του βίντεο, προσβάσιμη χωρίς κεφαλίδες εξουσιοδότησης ή cookie. Αποδεκτές μορφές ήχου είναι 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 βίντεο αναφοράς, χωρίς κεφαλίδες εξουσιοδότησης ή cookie, για αρχείο που περιέχει ακριβώς μία ροή βίντεο και τουλάχιστον ένα κατάλληλο τμήμα διάρκειας 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](https://captions.ai/help/docs/api/actor-catalog) και αντιγράψτε την ακριβή τιμή Avatar.

URL HTTPS εικόνας αναφοράς, δημόσια προσβάσιμο χωρίς cookie ή κεφαλίδες εξουσιοδότησης· η παροχή του video_reference_url προκαλεί αγνόησή του. Δέχεται μία στατική εικόνα σε μορφή .jpg, .jpeg, .png ή .webp, έως 25 MiB και 25 megapixels. Η μικρότερη πλευρά πρέπει να είναι τουλάχιστον 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 για τον ήχο που οδηγεί την παραγωγή του βίντεο, προσβάσιμη χωρίς κεφαλίδες εξουσιοδότησης ή cookie. Αποδεκτές μορφές ήχου είναι FLAC, Opus ή Vorbis, AAC ή ALAC, PCM WAV ή AIFF και MP3. Το αρχείο πρέπει να περιέχει μία μόνο μονοφωνική ή στερεοφωνική ροή, να διαρκεί 3–180 δευτερόλεπτα, να καταλαμβάνει έως 64 MiB και να έχει ρυθμό δειγματοληψίας 8–48 kHz.
video_reference_urlπροαιρετικό
Τύποςstring | null
Δημόσια προσβάσιμο URL HTTPS βίντεο αναφοράς, χωρίς κεφαλίδες εξουσιοδότησης ή cookie, για αρχείο που περιέχει ακριβώς μία ροή βίντεο και τουλάχιστον ένα κατάλληλο τμήμα διάρκειας 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](https://captions.ai/help/docs/api/actor-catalog) και αντιγράψτε την ακριβή τιμή Avatar.
image_reference_urlπροαιρετικό
Τύποςstring | null
URL HTTPS εικόνας αναφοράς, δημόσια προσβάσιμο χωρίς cookie ή κεφαλίδες εξουσιοδότησης· η παροχή του video_reference_url προκαλεί αγνόησή του. Δέχεται μία στατική εικόνα σε μορφή .jpg, .jpeg, .png ή .webp, έως 25 MiB και 25 megapixels. Η μικρότερη πλευρά πρέπει να είναι τουλάχιστον 512 px και καμία πλευρά δεν μπορεί να υπερβαίνει τα 8192 px· η αναλογία διαστάσεων πρέπει να βρίσκεται εντός 5% του 9:16 ή του 16:9.
απαιτείται Κανονικό όνομα, επίσης αποδεκτό

Οι παράμετροι αρχείων δέχονται ένα δημόσιο URL https://, ένα URI data: έως 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/el/developers/models/mirage-api/avatar-x/reference-to-video.md. Όλα τα μοντέλα και οι οδηγοί: https://doitong.com/developers/llms.txt