curl --request POST \
--url https://api.omnimux.ai/v1/video/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "ltx-2-3-kj",
"prompt": "角色面向镜头自然说话,固定镜头。",
"metadata": {
"nodeInfoList": [
{ "nodeId": "444", "fieldName": "image", "fieldValue": "https://example.com/face.jpg" },
{ "nodeId": "1755", "fieldName": "audio", "fieldValue": "https://example.com/speech.mp3" },
{ "nodeId": "1583", "fieldName": "value", "fieldValue": "10" },
{ "nodeId": "1776", "fieldName": "value", "fieldValue": "0" },
{ "nodeId": "1624", "fieldName": "value", "fieldValue": "角色面向镜头自然说话,固定镜头。" },
{ "nodeId": "1606", "fieldName": "value", "fieldValue": "1280" },
{ "nodeId": "1586", "fieldName": "value", "fieldValue": "25" }
]
}
}'
{
"id": "task_xxx",
"status": "in_progress",
"model": "ltx-2-3-kj"
}
{ "error": { "message": "metadata.nodeInfoList is required for model ltx-2-3-kj", "type": "invalid_request_error", "code": "bad_request" } }
{ "error": { "message": "Invalid token", "type": "authentication_error", "code": "unauthorized" } }
{
"error": {
"message": "Insufficient quota. Please top up your account.",
"type": "insufficient_quota",
"code": "insufficient_quota"
}
}
{ "error": { "message": "Forbidden", "type": "permission_error", "code": "forbidden" } }
{ "error": { "message": "Rate limit exceeded", "type": "rate_limit_error", "code": "rate_limit_exceeded" } }
{ "error": { "message": "Internal server error", "type": "server_error", "code": "internal_error" } }
curl --request POST \
--url https://api.omnimux.ai/v1/video/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "ltx-2-3-kj",
"prompt": "角色面向镜头自然说话,固定镜头。",
"metadata": {
"nodeInfoList": [
{ "nodeId": "444", "fieldName": "image", "fieldValue": "https://example.com/face.jpg" },
{ "nodeId": "1755", "fieldName": "audio", "fieldValue": "https://example.com/speech.mp3" },
{ "nodeId": "1583", "fieldName": "value", "fieldValue": "10" },
{ "nodeId": "1776", "fieldName": "value", "fieldValue": "0" },
{ "nodeId": "1624", "fieldName": "value", "fieldValue": "角色面向镜头自然说话,固定镜头。" },
{ "nodeId": "1606", "fieldName": "value", "fieldValue": "1280" },
{ "nodeId": "1586", "fieldName": "value", "fieldValue": "25" }
]
}
}'
{
"id": "task_xxx",
"status": "in_progress",
"model": "ltx-2-3-kj"
}
{ "error": { "message": "metadata.nodeInfoList is required for model ltx-2-3-kj", "type": "invalid_request_error", "code": "bad_request" } }
{ "error": { "message": "Invalid token", "type": "authentication_error", "code": "unauthorized" } }
{
"error": {
"message": "Insufficient quota. Please top up your account.",
"type": "insufficient_quota",
"code": "insufficient_quota"
}
}
{ "error": { "message": "Forbidden", "type": "permission_error", "code": "forbidden" } }
{ "error": { "message": "Rate limit exceeded", "type": "rate_limit_error", "code": "rate_limit_exceeded" } }
{ "error": { "message": "Internal server error", "type": "server_error", "code": "internal_error" } }
LTX
LTX 数字人对口型
GxgenAI LTX 2.3 照片对口型 · model ltx-2-3-kj
curl --request POST \
--url https://api.omnimux.ai/v1/video/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "ltx-2-3-kj",
"prompt": "角色面向镜头自然说话,固定镜头。",
"metadata": {
"nodeInfoList": [
{ "nodeId": "444", "fieldName": "image", "fieldValue": "https://example.com/face.jpg" },
{ "nodeId": "1755", "fieldName": "audio", "fieldValue": "https://example.com/speech.mp3" },
{ "nodeId": "1583", "fieldName": "value", "fieldValue": "10" },
{ "nodeId": "1776", "fieldName": "value", "fieldValue": "0" },
{ "nodeId": "1624", "fieldName": "value", "fieldValue": "角色面向镜头自然说话,固定镜头。" },
{ "nodeId": "1606", "fieldName": "value", "fieldValue": "1280" },
{ "nodeId": "1586", "fieldName": "value", "fieldValue": "25" }
]
}
}'
{
"id": "task_xxx",
"status": "in_progress",
"model": "ltx-2-3-kj"
}
{ "error": { "message": "metadata.nodeInfoList is required for model ltx-2-3-kj", "type": "invalid_request_error", "code": "bad_request" } }
{ "error": { "message": "Invalid token", "type": "authentication_error", "code": "unauthorized" } }
{
"error": {
"message": "Insufficient quota. Please top up your account.",
"type": "insufficient_quota",
"code": "insufficient_quota"
}
}
{ "error": { "message": "Forbidden", "type": "permission_error", "code": "forbidden" } }
{ "error": { "message": "Rate limit exceeded", "type": "rate_limit_error", "code": "rate_limit_exceeded" } }
{ "error": { "message": "Internal server error", "type": "server_error", "code": "internal_error" } }
POST
/
v1
/
video
/
generations
curl --request POST \
--url https://api.omnimux.ai/v1/video/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "ltx-2-3-kj",
"prompt": "角色面向镜头自然说话,固定镜头。",
"metadata": {
"nodeInfoList": [
{ "nodeId": "444", "fieldName": "image", "fieldValue": "https://example.com/face.jpg" },
{ "nodeId": "1755", "fieldName": "audio", "fieldValue": "https://example.com/speech.mp3" },
{ "nodeId": "1583", "fieldName": "value", "fieldValue": "10" },
{ "nodeId": "1776", "fieldName": "value", "fieldValue": "0" },
{ "nodeId": "1624", "fieldName": "value", "fieldValue": "角色面向镜头自然说话,固定镜头。" },
{ "nodeId": "1606", "fieldName": "value", "fieldValue": "1280" },
{ "nodeId": "1586", "fieldName": "value", "fieldValue": "25" }
]
}
}'
{
"id": "task_xxx",
"status": "in_progress",
"model": "ltx-2-3-kj"
}
{ "error": { "message": "metadata.nodeInfoList is required for model ltx-2-3-kj", "type": "invalid_request_error", "code": "bad_request" } }
{ "error": { "message": "Invalid token", "type": "authentication_error", "code": "unauthorized" } }
{
"error": {
"message": "Insufficient quota. Please top up your account.",
"type": "insufficient_quota",
"code": "insufficient_quota"
}
}
{ "error": { "message": "Forbidden", "type": "permission_error", "code": "forbidden" } }
{ "error": { "message": "Rate limit exceeded", "type": "rate_limit_error", "code": "rate_limit_exceeded" } }
{ "error": { "message": "Internal server error", "type": "server_error", "code": "internal_error" } }
- 创建:
POST /v1/video/generations,model为ltx-2-3-kj - 轮询:
GET /v1/video/generations/{task_id}(不要使用*-async/*-query模型名) - 这是 人设静帧 + 音频对口型,不是文生视频。必须传
metadata.nodeInfoList - 图片/音频先用公网 URL 或上游 fileName;不要传
data:URI - 产物 URL 请及时落盘(上游链接可能过期)
身份
| 字段 | 值 |
|---|---|
| 系列 | 视频系列 |
| 品牌 | LTX / GxgenAI |
| model | ltx-2-3-kj |
接口
| 方法 | 路径 |
|---|---|
POST | /v1/video/generations |
GET | /v1/video/generations/{task_id} |
https://api.omnimux.ai
鉴权
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
Authorization | header | string | 是 | Bearer sk-...(API Key) |
请求体
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 固定为 ltx-2-3-kj |
prompt | string | 否 | 动作提示;同时写入节点 1624 |
metadata.nodeInfoList | array | 是 | 人设图 + 音频 + 时长等节点 |
| nodeId | fieldName | 含义 |
|---|---|---|
444 | image | 人设静帧(9:16 或 16:9) |
1755 | audio | 语音或歌曲 |
1583 | value | 生成秒数(0=整段音频;建议 ≤35) |
1776 | value | 音频起始秒 |
1624 | value | 动作提示词 |
1606 | value | 最大分辨率(<1600) |
1586 | value | 帧率 |
响应
200(创建)
| 字段 | 类型 | 说明 |
|---|---|---|
id / task_id | string | 任务 id |
status | string | queued / in_progress / completed |