🔵Luma

TTAPI Luma接口服务

创建视频

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

通过文字&图片生成视频

Headers

NameValue

Content-Type

application/json

TT-API-KEY

用于请求授权 TT-API 的API密钥

Body

参数类型是否必须描述

userPrompt

string

生成视频的文字提示,例:a red car driving on a road,具体参考 注意:luma官方支持多语言,但是经尝试还是英文的生成效果最佳,使用时请自行斟酌

enhancePrompt

boolean

增强提示:如果您不太确定如何编写提示,请使用“增强提示”功能让 AI 将您的简单概念转化为详细提示。

可选值为false或者true。默认ture

imageUrl

string

开始帧图片链接,使用该参数,视频开始的第一帧会以该图片为影像,具体效果详见

imageEndUrl

string

结束帧图片链接,使用该参数,视频结束的最后一帧会以该图片为影像,具体效果详见

hookUrl

string

回调地址,任务完成或失败将通过请地址进行通知,通知数据结构与fetch结构一致。如果未设置,则需要请求fetch接口进行查询。

loop

boolean

是否生成无限循环的视频,可选值为false或者true。默认false PS:无限循环可以理解为开始的第一帧与结束帧相同

Response

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

视频延伸

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

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

Headers

NameValue

Content-Type

application/json

TT-API-KEY

用于请求授权 TT-API 的API密钥

Body

参数类型是否必须描述

jobId

jobId

上一个生成的视频的jobId

userPrompt

string

生成视频的文字提示,例:a red car driving on a road 注意:luma官方支持多语言,但是经尝试还是英文的生成效果最佳,使用时请自行斟酌

enhancePrompt

boolean

增强提示:如果您不太确定如何编写提示,请使用“增强提示”功能让 AI 将您的简单概念转化为详细提示。

可选值为false或者true。默认 ture

lastVideoImage

boolean

当前视频的是否引用上一视频最后一帧画面 可选值为false或者true。默认ture

hookUrl

string

回调地址,任务完成或失败将通过请地址进行通知,通知数据结构与fetch结构一致。如果未设置,则需要请求fetch接口进行查询。

loop

boolean

是否生成无限循环的视频,可选值为false或者true。默认false PS:无限循环可以理解为开始的第一帧与结束帧相同

Response

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

查询视频结果

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

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

Headers

NameValue

Content-Type

application/json

TT-API-KEY

用于请求授权 TT-API 的API密钥

Query参数

参数类型是否必须描述

jobId

jobId

生成的视频的jobId

Response

{
    "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返回视频结尾封面图片

Last updated