🔵Luma

TTAPI Luma接口服务

创建视频

Luma视频fast模式一般来说将会在300s内返回，具体时效取决于prompt的复杂度 relax模式一般会在1分钟至30分钟之间内返回，具体时效取决于官方的算力紧张程度

POST https://api.ttapi.io/luma/v1/generations

通过文字&图片生成视频

Headers

Name	Value
Content-Type	application/json
TT-API-KEY	用于请求授权 TT-API 的API密钥

Body

参数	类型	是否必须	描述
userPrompt	string	是	生成视频的文字提示，例：a red car driving on a road，具体参考 注意：luma官方支持多语言，但是经尝试还是英文的生成效果最佳，使用时请自行斟酌
imageUrl	string	否	开始帧图片链接，使用该参数，视频开始的第一帧会以该图片为影像，具体效果详见
imageEndUrl	string	否	结束帧图片链接，使用该参数，视频结束的最后一帧会以该图片为影像，具体效果详见 注意：该参数仅当模型使用 ray-v1 时生效
hookUrl	string	否	回调地址，任务完成或失败将通过请地址进行通知，通知数据结构与fetch结构一致。如果未设置，则需要请求fetch接口进行查询。
loop	boolean	否	是否生成无限循环的视频，可选值为false或者true。默认false PS：无限循环可以理解为开始的第一帧与结束帧相同
aspectRatio	string	否	视频比例 支持：9:16 3:4 1:1 4:3 16:9 21:9，默认9:16
modelName	string	否	使用模型 支持： ray-v1 ray-v2 ray-v2-flash ray-v3 ray-v3-reasoning 默认 ray-v3
duration	string	否	视频时长 支持: 5s 10s 默认5s，注意：10s的视频仅在720p的清晰度下生效
resolution	string	否	清晰度 支持：720p 1080p 默认720p
useMode	string	否	速度模式 支持：fast， relax 默认为relax模式，注意不同模式定价不同，详见

Response

200

{
  "status": "SUCCESS",
  "message": "",
  "data": {
    "jobId": "ed1a1b01-7d64-4c8a-acaa-71185d23a2f3"
  }
}

400

视频延伸

POST https://api.ttapi.io/luma/v1/extend

在上一条视频的基础上延伸生成一条视频，该接口的具体作用详见

Headers

Name	Value
Content-Type	application/json
TT-API-KEY	用于请求授权 TT-API 的API密钥

Body

参数	类型	是否必须	描述
jobId	string	是	上一个生成的视频的jobId
userPrompt	string	是	生成视频的文字提示，例：a red car driving on a road 注意：luma官方支持多语言，但是经尝试还是英文的生成效果最佳，使用时请自行斟酌
hookUrl	string	否	回调地址，任务完成或失败将通过请地址进行通知，通知数据结构与fetch结构一致。如果未设置，则需要请求fetch接口进行查询。
modelName	string	否	使用模型 支持： ray-v1 ray-v2 ray-v2-flash ray-v3 ray-v3-reasoning 默认 ray-v3

Response

200

{
  "status": "SUCCESS",
  "message": "",
  "data": {
    "jobId": "ed1a1b01-7d64-4c8a-acaa-71185d23a2f3"
  }
}

400

查询视频结果

GET https://api.ttapi.io/luma/v1/fetch

通过jobId查询当前视频生成结果

Headers

Name	Value
Content-Type	application/json
TT-API-KEY	用于请求授权 TT-API 的API密钥

Query参数

参数	类型	是否必须	描述
jobId	String	是	生成的视频的jobId

Response

200

{
    "status": "SUCCESS",
    "message": "success",
    "jobId": "6eb34b44-64c8-4629-a0a1-608737de9583",
    "data": {
        "jobId": "6eb34b44-64c8-4629-a0a1-608737de9583",
        "userPrompt": "Sanrio style illustration of Hello Kitty dressed ",
        "width": "512",
        "height": "512",
        "imageUrl": null,
        "imageEndUrl": null,
        "videoFirstFrame": "",
        "videoLastFrame": "",
        "hookUrl": "https://webhook-test.com/72b9baa490830671b5cd068815788b7e",
        "videoUrl": "https://storage.cdn-luma.com/lit_lite_inference_im2vid_v1.0/11be9408-f349-46df-a43e-a3b57002c1cd/watermarked_video09312742f491e41c19974b52babdba615.mp4"
    }
}

异步回调JSON结构 HookUrl JSON

异步回调josn结构与fetch接口查询返回结构一致

{
    "status": "SUCCESS",
    "message": "success",
    "jobId": "6eb34b44-64c8-4629-a0a1-608737de9583",
    "data": {
        "jobId": "6eb34b44-64c8-4629-a0a1-608737de9583",
        "userPrompt": "Sanrio style illustration of Hello Kitty dressed ",
        "width": "512",
        "height": "512",
        "imageUrl": null,
        "imageEndUrl": null,
        "videoFirstFrame": "",
        "videoLastFrame": "",
        "hookUrl": "https://webhook-test.com/72b9baa490830671b5cd068815788b7e",
        "videoUrl": "https://storage.cdn-luma.com/lit_lite_inference_im2vid_v1.0/11be9408-f349-46df-a43e-a3b57002c1cd/watermarked_video09312742f491e41c19974b52babdba615.mp4",
        "quota": 3
    }
}

结果参数详解

参数	详解
status	结果状态， ON_QUEUE：执行中 SUCCESS：成功 FAILED：失败
videoUrl	视频地址，国内可直接访问
quota	实际消耗额度
imageUrl	用户上传开始帧图片地址
imageEndUrl	用户上传结束帧图片地址
videoFirstFrame	Luma返回视频开始封面图片
videoLastFrame	Luma返回视频结尾封面图片