TTAPI 中文文档
  • TTAPI 中文文档
  • API能力
    • 🔥Midjourney API
    • Flux API
    • Recraft API
    • 📖LLM API
    • 🔀Midjourney Hold Account
    • 🟢OpenAI Image Models
    • 🔵Luma
    • 🎵Suno
    • 🔗账户体系
    • ⭕状态码详解
  • 企业服务
    • Midjourney离线服务
  • 问答专区
    • Midjourney
      • 常见问题解答
      • 账户托管
      • 科学使用你的Midjourney账户
    • Luma
    • 使用相关
    • 其他杂项
  • 升级日志
Powered by GitBook
On this page
  • 创建视频
  • 视频延伸
  • 查询视频结果
  • 异步回调JSON结构 HookUrl JSON
  • 结果参数详解

Was this helpful?

  1. API能力

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

是

enhancePrompt

boolean

否

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

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

imageUrl

string

否

imageEndUrl

string

否

hookUrl

string

否

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

否

Response

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

视频延伸

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

否

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"
  }
}
{
  "status": "FAILED",
  "message": "error message",
  "data": {}
}

查询视频结果

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 2 months ago

Was this helpful?

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

开始帧图片链接,使用该参数,视频开始的第一帧会以该图片为影像,

结束帧图片链接,使用该参数,视频结束的最后一帧会以该图片为影像, 注意:该参数仅当模型使用 ray-v1 时生效

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

速度模式 支持:fast, relax 默认为relax模式,注意不同模式定价不同,

在上一条视频的基础上延伸生成一条视频,该接口的

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

🔵
通知数据结构
fetch接口
通知数据结构
fetch接口
具体作用详见
具体参考
具体效果详见
具体效果详见
详见