🔵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官方支持多语言，但是经尝试还是英文的生成效果最佳，使用时请自行斟酌

enhancePrompt

boolean

否

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

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

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-v2

duration

string

否

视频时长 支持: 5s 10s 默认5s，注意：10s的视频仅在720p的清晰度下生效

resolution

string

否

清晰度 支持：720p 1080p 默认720p

useMode

string

否

速度模式 支持：fast， relax 默认为relax模式，注意不同模式定价不同，详见

Response

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

视频延伸

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官方支持多语言，但是经尝试还是英文的生成效果最佳，使用时请自行斟酌

enhancePrompt

boolean

否

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

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

lastVideoImage

boolean

否

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

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

Response

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

查询视频结果

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

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

PreviousOpenAI Image ModelsNextSuno

Last updated

Was this helpful?