跳转到内容

Avatar X

集成

模型 id mirage-api/avatar-x/text-to-video
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/mirage-api/avatar-x/text-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "script": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

此请求: ≈$54.00 54,000 API 积分 · ≈ ₽5,809.30 在此页面运行

获取 API 密钥
Mirage 唇形同步与数字人 参考输入唇形同步 #avatar#lipsync#talking-head

根据脚本生成口播头像视频,可使用素材头像或你自己的视频和音色参考

Mirage · 视频

你的第一个结果将在此显示

在下方构建请求,并使用你的 API 密钥运行。输出会复制到我们的存储中,可永久保存或免费保存 7 天。

构建请求

控件根据模型架构生成。更改控件时,代码和价格会同步更新。

•必填 88 / 1500

同时受字符数和生成时长限制的脚本:即使语速导致较短脚本超过该限制,语音时长也不得超过 180 秒。提供 50 到 1,500 个字符;50 个字符的最小值通常会生成约 4 秒的语音。

高级 avatar · video_reference_url · audio_reference_url
默认 Jasmine

素材外观和声音选择;同时提供 video_reference_url 和 audio_reference_url 时无需设置,因为这些参考会完全替代它。使用 None 保持头像未设置,或在 [avatar catalog](https://captions.ai/help/docs/api/actor-catalog) 中预览所有选项后复制准确的 Avatar 值。

替代所选头像且要求提供 audio_reference_url 的参考视频 URL;视频中嵌入的任何音频都会被忽略。媒体时长必须为 1 到 120 秒,大小不超过 1 GiB,显示宽高比必须与 9:16 或 16:9 相差不超过 5%;支持的编解码器/容器组合包括 .mp4、.mov 或 .m4v 中的 H.264、H.265/HEVC 或 ProRes,以及 .webm 中的 VP8 或 VP9。必须通过 HTTPS 公开获取,且无需 Cookie 或授权标头。

要求同时提供 video_reference_url 且会使所选头像失效的声音参考 HTTPS URL;必须可公开获取且无需授权标头或 Cookie。处理时仅使用前 60 秒,但文件时长必须为 10 到 180 秒,大小不超过 64 MiB,并包含单个单声道或立体声流,采样率为 8 到 48 kHz。支持的格式包括 FLAC、MP3、PCM WAV 或 AIFF、AAC 或 ALAC,以及 Opus 或 Vorbis。

POST /run/mirage-api/avatar-x/text-to-video?wait=20 报价 → $54.00
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/mirage-api/avatar-x/text-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "script": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

运行此请求

你的密钥会保留在此浏览器中:仅发送到 Doitong API;只有勾选“记住”后才会保存到 localStorage。 获取 API 密钥

关于 Avatar X

将 50 到 1,500 个字符的 `script` 转换为口播头像视频,生成的语音最长 180 秒。可选择 Jasmine、Luke 或 Maya 等素材 `avatar`,包括 16:9 变体。也可以同时提供 `video_reference_url` 和 `audio_reference_url`,使用自己的视频素材和音色参考;此时会忽略素材头像。

参数

名称类型 默认值允许值 描述
script必填
类型string
≤ 1,500 个字符≥ 50 个字符
同时受字符数和生成时长限制的脚本:即使语速导致较短脚本超过该限制,语音时长也不得超过 180 秒。提供 50 到 1,500 个字符;50 个字符的最小值通常会生成约 4 秒的语音。
avatar可选
类型enum
默认值Jasmine
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)
素材外观和声音选择;同时提供 video_reference_url 和 audio_reference_url 时无需设置,因为这些参考会完全替代它。使用 None 保持头像未设置,或在 [avatar catalog](https://captions.ai/help/docs/api/actor-catalog) 中预览所有选项后复制准确的 Avatar 值。
video_reference_url可选
类型string | null
替代所选头像且要求提供 audio_reference_url 的参考视频 URL;视频中嵌入的任何音频都会被忽略。媒体时长必须为 1 到 120 秒,大小不超过 1 GiB,显示宽高比必须与 9:16 或 16:9 相差不超过 5%;支持的编解码器/容器组合包括 .mp4、.mov 或 .m4v 中的 H.264、H.265/HEVC 或 ProRes,以及 .webm 中的 VP8 或 VP9。必须通过 HTTPS 公开获取,且无需 Cookie 或授权标头。
audio_reference_url可选
类型string | null
要求同时提供 video_reference_url 且会使所选头像失效的声音参考 HTTPS URL;必须可公开获取且无需授权标头或 Cookie。处理时仅使用前 60 秒,但文件时长必须为 10 到 180 秒,大小不超过 64 MiB,并包含单个单声道或立体声流,采样率为 8 到 48 kHz。支持的格式包括 FLAC、MP3、PCM WAV 或 AIFF、AAC 或 ALAC,以及 Opus 或 Vorbis。
必填

输出

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "mirage-api/avatar-x/text-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": 54000,
    "usd": "54.00",
    "charged": 54000,
    "refunded": 0
  },
  "input": {
    "script": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/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/zh/developers/models/mirage-api/avatar-x/text-to-video.md. 所有模型和指南: https://doitong.com/developers/llms.txt