一张人像 + 一段语音 → 说话视频,由 MiniMax H3 多模态引擎驱动:照片里的人把这段语音说出来,口型逐帧贴合,人物、服装、构图和背景与原图逐像素一致——只有脸在动,画面不漂移。480p 或 720p,时长固定 5 / 10 / 15 秒三档,按条计价:480p $0.07 起、720p $0.13 起,提交前价格就是确定的。
| 分辨率 | 5s | 10s | 15s |
|---|---|---|---|
| 480p(默认) | $0.07 | $0.11 | $0.22 |
| 720p | $0.13 | $0.22 | $0.44 |
按条固定价,不按秒计量,与音频实际长度无关。仅成功扣费、失败退款。16:9 下 480p 实际输出 864×480,720p 实际输出 1376×768(约 1 百万像素)。
与 AI 对口型(ai-lipsync,$0.02/音频秒)的取舍:音频很短(3 秒以内)时 ai-lipsync 更便宜;音频较长或要 720p 画质时本模型更划算,且价格提交前可知。
所有请求在 Header 携带 API Key:
Authorization: Bearer YOUR_API_KEY/api/v1/video/generations·GET/api/v1/video/generations?task_id=# Talking photo: 1 portrait + 1 driving audio -> talking video
curl -X POST https://api.apimodels.app/v1/video/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax-h3-talking-photo",
"image": "https://example.com/portrait.jpg",
"audio_url": "https://example.com/voice.mp3",
"duration": 5,
"resolution": "480p",
"ratio": "16:9"
}'
# Poll until completed (result files are kept 7 days)
curl "https://api.apimodels.app/v1/video/generations?task_id=TASK_ID" \
-H "Authorization: Bearer YOUR_API_KEY"
# The audio must FIT the chosen duration tier (5 / 10 / 15s) — we probe it at
# create time and return a clear 400 if it does not, before anything is billed.
# Shorter audio is fine: the person finishes speaking and idles naturally.| 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|
| model | 是 | string | minimax-h3-talking-photo |
| image | 是 | string | 人像图,恰好 1 张(公网 URL 或 base64)。真人照、插画、AI 生成的脸都可以。也接受 images[0] / image_urls[0]。 |
| audio_url | 是 | string | 驱动音频,恰好 1 段(公网 URL 或 base64,mp3 / wav)。也接受 audio_urls[0] / audio_list[0]。 |
| duration | 是 | number | 5 / 10 / 15 三档,必须选能装下音频的档位——创建时会读取音频实际时长,超长直接返回 400。也接受 seconds 这个字段名。 |
| resolution | 否 | string | 480p(默认)或 720p。 |
| ratio | 否 | string | 16:9(默认)/ 9:16 / 1:1 / 4:3 / 3:4 / 3:2 / 2:3 / 21:9。也接受 aspect_ratio。 |
| prompt | 否 | string | 可选,引导表演的语气与幅度;不传时使用中性描述。 |
| callback_url | 否 | string | 任务完成时我们向该地址 POST 结果;不传就轮询 GET 查询。 |
试一试:Playground
apimodels.app 按条固定档:480p 5/10/15 秒为 $0.07/$0.11/$0.22,720p 为 $0.13/$0.22/$0.44。价格与音频实际长度无关,提交前即确定。仅成功扣费,失败退款。
调 POST /api/v1/video/generations,model 设 minimax-h3-talking-photo,传恰好一张 image(人像)、一段 audio_url(mp3/wav 语音)和 duration(5、10 或 15)。可选 resolution(默认 480p,或 720p)、ratio(默认 16:9,共 8 种)和 prompt。轮询 GET /api/v1/video/generations?task_id=xxx 或传 callback_url。apimodels.app 一把 API Key 通调全站模型。
短没问题:人物说完自然待机(眨眼、轻微动作,不循环),音轨补静音。长则创建时拒绝:我们会读取音频实际时长,超过所选档位直接返回明确的 400,不建任务不扣费——选一个能装下音频的 5/10/15 秒档即可。
AI 对口型按音频秒数计费($0.02/秒),成片时长完全跟随音频。Talking Photo 用 MiniMax H3 引擎,5/10/15 秒固定档、按条计价,并多出 720p 档和 8 种画幅。3 秒以内的短音频用 AI 对口型更便宜;音频较长或要 720p 画质选 Talking Photo。