注册
视频模型 / Luma 视频生成 / 查询任务 / 批量获取任务

Luma 批量任务查询接口 - QuickRouter API 中转接口

POST https://api.quickrouter.ai/luma/tasks 在线调试 →
▼ Authorization

在 Header 添加参数 Authorization，其值为 Bearer 之后拼接 Token

示例： Authorization: Bearer ********************

概述

"state": "completed" 枚举值： "pending", "processing", "completed", "failed"

请求参数

Header 参数
Content-Type string
必需
示例: application/json
Accept string
必需
示例: application/json
Authorization string
必需
示例: Bearer {{YOUR_API_KEY}}
Body 参数 application/json
model string
必需
使用的模型，可选，默认为 kling-image
prompt string
必需
正向提示词，必需，描述你想要生成的图像内容，不能超过500个字符
negative_prompt string
必需
负向提示词，可选，描述你不想在图像中出现的元素，不能超过200个字符
image string
必需
参考图片，可选，支持 Base64 编码或图片 URL，支持 .jpg/.jpeg/.png 格式，大小不能超过 10MB
image_fidelity number
必需
参考图片的影响强度，可选，取值范围：0-1，值越大，生成的图像越接近参考图片
n integer
必需
生成图片的数量，可选，取值范围：1-9
aspect_ratio string
必需
生成图片的纵横比，可选，可选值：16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3
callback_url string
必需
回调通知地址，可选，当任务状态发生变化时，系统会向这个地址发送通知 { "ids": [ "4665a07c-7641-4809-a133-10786201bb56" ] } 请求
示例
{
    "ids": [
        "4665a07c-7641-4809-a133-10786201bb56"
    ]
}

请求示例代码

curl --location --request POST 'https://api.quickrouter.ai/luma/tasks' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
  "ids": [
    "4665a07c-7641-4809-a133-10786201bb56"
  ]
}'

返回响应

响应参数 🟢 200 OK · application/json
artifact object
可选
created_at string
必需
last_frame object
必需
thumbnail object
必需
video object
必需
video_raw object
必需
created_at string
可选
id string
可选
last_frame object
可选
height integer
必需
media_type string
必需
palette null
必需
url string
必需
width integer
必需
request object
可选
aspect_ratio string
必需
prompt string
必需
state string
可选
thumbnail object
可选
height integer
必需
media_type string
必需
palette object
必需
url string
必需
width integer
必需
video object
可选
download_url string
必需
height integer
必需
url string
必需
width integer
必需
video_raw object
可选
duration number
必需
height integer
必需
media_type string
必需
url string
必需
width integer
必需
[ { "artifact": { "created_at": "0001-01-01T00:00:00Z", "last_frame": { "height": 752, "media_type": "image", "palette": null, "url": "https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/606108d9-9daf-4265-84fb-595f18240ac5/video_0_last_frame.jpg", "width": 1360 }, "thumbnail": { "height": 752, "media_type": "image", "palette": { "grid": "em9csKqXYUgqdHVmmqeZLB8YaFpLjVw2bmFTTElBHhMNTzgodD8eVzUeTDorRSkYYEQymV80e1M0ck0ugWVRwKCApWk0hF1BgmVP" }, "url": "https://imagedelivery.net/1KomXrSWiTojGGip43n0SQ/e4268de5-4a74-45ff-67b8-dc46df12de00/public", "width": 1360 }, "video": { "download_url": "https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/35049450-c008-4607-b1d0-0b025599f15d/video0b6619468da8e409da860706bbf26bbad.mp4", "height": 752, "url": "https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/35049450-c008-4607-b1d0-0b025599f15d/video0b6619468da8e409da860706bbf26bbad.mp4", "width": 1360 }, "video_raw": { "duration": 5.041667, "height": 752, "media_type": "video", "url": "https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/35049450-c008-4607-b1d0-0b025599f15d/video0b6619468da8e409da860706bbf26bbad.mp4", "width": 1360 } }, "created_at": "2024-12-22T13:38:40.139Z", "id": "4665a07c-7641-4809-a133-10786201bb56", "last_frame": { "height": 752, "media_type": "image", "palette": null, "url": "https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/606108d9-9daf-4265-84fb-595f18240ac5/video_0_last_frame.jpg", "width": 1360 }, "request": { "aspect_ratio": "16:9", "prompt": "cat dance" }, "state": "completed", "thumbnail": { "height": 752, "media_type": "image", "palette": { "grid": "em9csKqXYUgqdHVmmqeZLB8YaFpLjVw2bmFTTElBHhMNTzgodD8eVzUeTDorRSkYYEQymV80e1M0ck0ugWVRwKCApWk0hF1BgmVP" }, "url": "https://imagedelivery.net/1KomXrSWiTojGGip43n0SQ/e4268de5-4a74-45ff-67b8-dc46df12de00/public", "width": 1360 }, "video": { "download_url": "https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/35049450-c008-4607-b1d0-0b025599f15d/video0b6619468da8e409da860706bbf26bbad.mp4", "height": 752, "url": "https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/35049450-c008-4607-b1d0-0b025599f15d/video0b6619468da8e409da860706bbf26bbad.mp4", "width": 1360 }, "video_raw": { "duration": 5.041667, "height": 752, "media_type": "video", "url": "https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/35049450-c008-4607-b1d0-0b025599f15d/video0b6619468da8e409da860706bbf26bbad.mp4", "width": 1360 } } ]
示例
[
    {
        "artifact": {
            "created_at": "0001-01-01T00:00:00Z",
            "last_frame": {
                "height": 752,
                "media_type": "image",
                "palette": null,
                "url": "https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/606108d9-9daf-4265-84fb-595f18240ac5/video_0_last_frame.jpg",
                "width": 1360
            },
            "thumbnail": {
                "height": 752,
                "media_type": "image",
                "palette": {
                    "grid": "em9csKqXYUgqdHVmmqeZLB8YaFpLjVw2bmFTTElBHhMNTzgodD8eVzUeTDorRSkYYEQymV80e1M0ck0ugWVRwKCApWk0hF1BgmVP"
                },
                "url": "https://imagedelivery.net/1KomXrSWiTojGGip43n0SQ/e4268de5-4a74-45ff-67b8-dc46df12de00/public",
                "width": 1360
            },
            "video": {
                "download_url": "https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/35049450-c008-4607-b1d0-0b025599f15d/video0b6619468da8e409da860706bbf26bbad.mp4",
                "height": 752,
                "url": "https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/35049450-c008-4607-b1d0-0b025599f15d/video0b6619468da8e409da860706bbf26bbad.mp4",
                "width": 1360
            },
            "video_raw": {
                "duration": 5.041667,
                "height": 752,
                "media_type": "video",
                "url": "https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/35049450-c008-4607-b1d0-0b025599f15d/video0b6619468da8e409da860706bbf26bbad.mp4",
                "width": 1360
            }
        },
        "created_at": "2024-12-22T13:38:40.139Z",
        "id": "4665a07c-7641-4809-a133-10786201bb56",
        "last_frame": {
            "height": 752,
            "media_type": "image",
            "palette": null,
            "url": "https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/606108d9-9daf-4265-84fb-595f18240ac5/video_0_last_frame.jpg",
            "width": 1360
        },
        "request": {
            "aspect_ratio": "16:9",
            "prompt": "cat dance"
        },
        "state": "completed",
        "thumbnail": {
            "height": 752,
            "media_type": "image",
            "palette": {
                "grid": "em9csKqXYUgqdHVmmqeZLB8YaFpLjVw2bmFTTElBHhMNTzgodD8eVzUeTDorRSkYYEQymV80e1M0ck0ugWVRwKCApWk0hF1BgmVP"
            },
            "url": "https://imagedelivery.net/1KomXrSWiTojGGip43n0SQ/e4268de5-4a74-45ff-67b8-dc46df12de00/public",
            "width": 1360
        },
        "video": {
            "download_url": "https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/35049450-c008-4607-b1d0-0b025599f15d/video0b6619468da8e409da860706bbf26bbad.mp4",
            "height": 752,
            "url": "https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/35049450-c008-4607-b1d0-0b025599f15d/video0b6619468da8e409da860706bbf26bbad.mp4",
            "width": 1360
        },
        "video_raw": {
            "duration": 5.041667,
            "height": 752,
            "media_type": "video",
            "url": "https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/35049450-c008-4607-b1d0-0b025599f15d/video0b6619468da8e409da860706bbf26bbad.mp4",
            "width": 1360
        }
    }
]

常见错误

  • 401 认证失败：检查 API Key 是否正确
  • 429 请求限流：降低调用频率或升级套餐
  • 500 服务器错误：稍后重试

注意事项

  • 请确保 API Key 有足够的余额
  • 请求频率受 API 限制，请参考价格页面

相关文档

← 查询单个任务 状态码 →