luma_video_api

视频异步任务

Luma AI API 文生视频，支持上传2张参考图片；可以打造出 Luma 官网同款平台，支持官网所有操作; 兼容 GoAmz; SVIP、SSVIP 分组为快速模式，价格略高，大概40秒出视频，排队优先无水印；VIP、VVIP 分组为慢速模式，价格略低，大概5分钟出视频点击查看接入文档

¥--已优惠

----

申请赠送05000000 Tokens

约¥0/ 5百万Tokens
一元试用11000000 Tokens

约¥1/百万Token
默认2request

按量计费

· 首次申请送500万Token

立即使用

客服

使用

使用文档
附件资料
计费明细

使用文档

全部接口

查询单个任务(免费

获取视频无水印链接（VIP版才支持）（废弃，查询接口有返回

获取视频(免费

提交生成视频任务

扩展视频

批量获取任务(免费

生成视频 (兼容版，开发接入请勿对接

错误码

错误码列表

资源下载

使用文档下载

模型信息

模型 ID	luma_video_api	供应商	Luma
输入模态	未注明	输出模态	未注明
分类	未注明	发布时间	未注明

调用接口

分组	接口	渠道	方法	路径
全部接口	查询单个任务(免费	本站 AI 中转站	GET	/luma/generations/{task_id}
全部接口	获取视频无水印链接（VIP版才支持）（废弃，查询接口有返回	本站 AI 中转站	GET	/luma/generations/{task_id}/download_video_url
全部接口	获取视频(免费	本站 AI 中转站	GET	/luma/v1/task
全部接口	提交生成视频任务	本站 AI 中转站	POST	/luma/generations
全部接口	扩展视频	本站 AI 中转站	POST	/luma/generations/{task_id}/extend
全部接口	批量获取任务(免费	本站 AI 中转站	POST	/luma/tasks
全部接口	生成视频 (兼容版，开发接入请勿对接	本站 AI 中转站	POST	/luma/v1/generations

GET /luma/generations/{task_id}

### 查询单个任务(免费
vip 账号的会在 video. download_url 返回无水印地址，有时可能为空，需要另外从无水印接口获取
"state": "completed" 枚举值： "pending", "processing", "completed", "failed"

请求与响应结构

{
    "summary": "查询单个任务(免费",
    "responses": {
        "200": {
            "content": {
                "application/json": {
                    "schema": {
                        "type": "object",
                        "properties": []
                    }
                }
            },
            "description": "成功"
        }
    },
    "parameters": [
        {
            "in": "path",
            "name": "task_id",
            "schema": {
                "type": "string",
                "description": "任务ID"
            },
            "required": true,
            "description": "任务ID"
        }
    ],
    "description": "### 查询单个任务(免费\nvip 账号的会在 video. download_url 返回 无水印地址，有时可能为空，需要另外从 无水印接口获取\n\"state\": \"completed\" 枚举值： \"pending\", \"processing\", \"completed\", \"failed\""
}

GET /luma/generations/{task_id}/download_video_url

### 获取视频无水印链接（VIP版才支持）（废弃，查询接口有返回
废弃，查询接口有返回
需要在视频任务状态返回完成后调用，否则返回400错误
获取到的视频链接请尽快下载，否则账号轮换后，不可再次获取

请求与响应结构

{
    "summary": "获取视频无水印链接（VIP版才支持）（废弃，查询接口有返回",
    "security": [
        {
            "bearerAuth": []
        }
    ],
    "responses": {
        "200": {
            "content": {
                "application/json": {
                    "schema": {
                        "type": "object",
                        "properties": []
                    }
                }
            },
            "description": "成功"
        }
    },
    "parameters": [
        {
            "in": "path",
            "name": "task_id",
            "schema": {
                "type": "string"
            },
            "required": true,
            "description": ""
        }
    ],
    "description": "### 获取视频无水印链接（VIP版才支持）（废弃，查询接口有返回\n废弃，查询接口有返回\n需要在视频任务状态返回完成后调用，否则返回400错误\n获取到的视频链接请尽快下载，否则账号轮换后，不可再次获取",
    "x-security-schemes": {
        "bearerAuth": {
            "type": "http",
            "scheme": "bearer"
        }
    }
}

GET /luma/v1/task

请求与响应结构

{
    "summary": "获取视频(免费",
    "responses": {
        "200": {
            "content": {
                "application/json": {
                    "schema": {
                        "type": "object",
                        "properties": []
                    }
                }
            },
            "description": "成功"
        }
    },
    "parameters": [
        {
            "in": "query",
            "name": "id",
            "schema": {
                "type": "string",
                "example": "2de97e1c-6a60-4770-8418-2d90fb0b2c71"
            },
            "required": false,
            "description": ""
        },
        {
            "in": "query",
            "name": "server_id",
            "schema": {
                "type": "string",
                "example": "af228629-9749-40e6-ae32-84cd03a41010"
            },
            "required": false,
            "description": ""
        }
    ],
    "description": ""
}

POST /luma/generations

请求与响应结构

{
    "summary": "提交生成视频任务",
    "responses": {
        "200": {
            "content": {
                "application/json": {
                    "schema": {
                        "type": "object",
                        "properties": []
                    }
                }
            },
            "description": "成功"
        }
    },
    "parameters": [],
    "description": "",
    "requestBody": {
        "content": {
            "application/json": {
                "schema": {
                    "type": "object",
                    "title": "提交生成视频任务",
                    "$schema": "",
                    "required": [
                        "user_prompt"
                    ],
                    "properties": {
                        "loop": {
                            "type": "boolean",
                            "description": "是否循环 首尾呼应"
                        },
                        "duration": {
                            "type": "string",
                            "description": "时长 5s 或者 10s"
                        },
                        "image_url": {
                            "type": "string",
                            "description": "参考图，支持第三方图片地址、Base64"
                        },
                        "model_name": {
                            "enum": [
                                "ray-v1",
                                "ray-v2",
                                "ray-v3"
                            ],
                            "type": "string"
                        },
                        "resolution": {
                            "type": "string",
                            "description": "720p或者1080p默认720p"
                        },
                        "notify_hook": {
                            "type": "string",
                            "description": "回调地址："
                        },
                        "user_prompt": {
                            "type": "string",
                            "description": "提示词"
                        },
                        "expand_prompt": {
                            "type": "boolean",
                            "description": "是否开启prompt 优化"
                        },
                        "image_end_url": {
                            "type": "string",
                            "description": "关键帧，支持第三方图片地址、Base64"
                        }
                    },
                    "x-apifox-id": "189360757"
                }
            }
        },
        "required": true
    }
}

POST /luma/generations/{task_id}/extend

### 扩展视频
task id 为需要延长的视频任务id

请求与响应结构

{
    "summary": "扩展视频",
    "responses": {
        "200": {
            "content": {
                "application/json": {
                    "schema": {
                        "type": "object",
                        "properties": []
                    }
                }
            },
            "description": "成功"
        }
    },
    "parameters": [
        {
            "in": "path",
            "name": "task_id",
            "schema": {
                "type": "string"
            },
            "required": true,
            "description": ""
        }
    ],
    "description": "### 扩展视频\ntask id 为需要延长的视频任务id",
    "requestBody": {
        "content": {
            "application/json": {
                "schema": {
                    "type": "object",
                    "title": "扩展视频",
                    "$schema": "",
                    "required": [
                        "user_prompt"
                    ],
                    "properties": {
                        "image_url": {
                            "type": "string",
                            "description": "参考图，支持第三方图片地址、Base64"
                        },
                        "notify_hook": {
                            "type": "string",
                            "description": "回调地址："
                        },
                        "user_prompt": {
                            "type": "string"
                        },
                        "expand_prompt": {
                            "type": "boolean",
                            "description": "是否开启prompt 优化"
                        },
                        "image_end_url": {
                            "type": "string",
                            "description": "关键帧，支持第三方图片地址、Base64"
                        }
                    },
                    "x-apifox-id": "191475015"
                }
            }
        },
        "required": true
    }
}

POST /luma/tasks

请求与响应结构

{
    "summary": "批量获取任务(免费",
    "responses": {
        "200": {
            "content": {
                "application/json": {
                    "schema": {
                        "type": "object",
                        "properties": []
                    }
                }
            },
            "description": "成功"
        }
    },
    "parameters": [],
    "description": "",
    "requestBody": {
        "content": {
            "text/plain": {
                "schema": {
                    "type": "object",
                    "title": "批量获取任务(免费",
                    "$schema": "",
                    "x-apifox-id": "189360758"
                }
            }
        },
        "required": true
    }
}

POST /luma/v1/generations

请求与响应结构

{
    "summary": "生成视频 (兼容版，开发接入请勿对接",
    "responses": {
        "200": {
            "content": {
                "application/json": {
                    "schema": {
                        "type": "object",
                        "properties": []
                    }
                }
            },
            "description": "成功"
        }
    },
    "parameters": [],
    "description": "",
    "requestBody": {
        "content": {
            "application/json": {
                "schema": {
                    "type": "object",
                    "title": "生成视频 (兼容版，开发接入请勿对接",
                    "$schema": "",
                    "required": [
                        "user_prompt",
                        "aspect_ratio",
                        "expand_prompt",
                        "image_url",
                        "image_end_url"
                    ],
                    "properties": {
                        "image_url": {
                            "type": "string"
                        },
                        "user_prompt": {
                            "type": "string"
                        },
                        "aspect_ratio": {
                            "type": "string"
                        },
                        "expand_prompt": {
                            "type": "boolean"
                        },
                        "image_end_url": {
                            "type": "string"
                        }
                    },
                    "x-apifox-id": "220409212"
                }
            }
        },
        "required": true
    }
}

价格

价格组	渠道	计费项	价格	单位
default	AI 中转站	request	CNY 2	request

服务级错误码参照(error_code)：

	错误码	说明
	221301	数据源超时
	221303	认证失败认证失败，请稍后重试认证失败,该卡当日连续多次认证不通过被限制校验,次日恢复
	221306	参数错误参数错误：姓名格式不正确参数错误：手机号格式不正确参数错误：身份证格式不正确参数错误：银行卡号格式不正确同一银行卡请求过于频繁

系统级错误码参照：

	错误码	说明
	10001	错误的请求KEY
	10002	该KEY无请求权限
	10003	KEY过期
	10004	错误的OPENID
	10005	应用未审核超时，请提交认证
	10007	未知的请求源
	10008	被禁止的IP
	10009	被禁止的KEY
	10011	当前IP请求超过限制
	10012	请求超过次数限制
	10013	测试KEY超过请求限制
	10014	系统内部异常(调用充值类业务时，请务必联系客服或通过订单查询接口检测订单，避免造成损失)
	10020	接口维护
	10021	接口停用

错误码格式说明（示例：200201）：

	2	002	01
	服务级错误（1为系统级错误）	服务模块代码(即数据ID)	具体错误代码

使用文档下载

	附件标题/下载链接	更新时间
	接口资料：GET /luma/generations/{task_id}（查询单个任务(免费）	2026-09-09 15:29:08
	接口资料：GET /luma/generations/{task_id}/download_video_url（获取视频无水印链接（VIP版才支持）（废弃，查询接口有返回）	2026-09-09 15:29:08
	接口资料：GET /luma/v1/task（获取视频(免费）	2026-09-09 15:29:08
	接口资料：POST /luma/generations（提交生成视频任务）	2026-09-09 15:29:08
	接口资料：POST /luma/generations/{task_id}/extend（扩展视频）	2026-09-09 15:29:08
	接口资料：POST /luma/tasks（批量获取任务(免费）	2026-09-09 15:29:08
	接口资料：POST /luma/v1/generations（生成视频 (兼容版，开发接入请勿对接）	2026-09-09 15:29:08
	价格分组：default（CNY 2/request）	2026-09-09 15:29:08
	供应商令牌分组折扣资料	2026-09-09 15:29:08

常见问题：

	标题	更新时间
	Token 是什么？中文、英文与上下文窗口如何计算	2026-09-18 19:52:51
	LLM API 费用如何计算？如何选择合适的模型	2026-09-18 19:52:54
	Word-to-Token 转换与用量估算指南	2026-09-19 00:49:28

计费项	估算单价	单位	倍率依据
request	⚡2	request	按量计费

扩展计费信息	分组倍率 1
提示	估算费用请使用此分组建立令牌。

luma_video_api

--: 今日调用

--: 成功率

--: 近期调用

帮助求助专属客服

使用

限企业实名用户使用

本接口需提供应用场景审核

个人实名用户无法使用

API资讯

0.多模型路由与故障转移指南

数据驱动未来

Data Drives The Future

立即注册

找API接口，上API数据！

luma_video_api

使用文档

附件资料

计费明细

推荐API

API资讯