Luma 单任务查询接口 - apizt API 中转接口
型号与创建入口核对日期：2026-10-08。来源：apizt 当前模型目录。目录收录不等于你的令牌已开通权限，提交前核对账户模型与价格。
请求参数
| 参数 | 说明 |
|---|---|
task_id | 路径参数；填入创建接口返回的完整任务 ID。 |
GET 请求不发送 body。路径中的任务 ID 和 URL 查询参数须替换为自己的值。
请求示例代码
先设置 tokenba_API_KEY；Python 安装 requests，JavaScript 使用 Node.js 20+。示例未进行付费生成实测。
curl --fail-with-body --request GET "https://api.apizt.com/luma/generations/YOUR_TASK_ID" \
--header "Authorization: Bearer $tokenba_API_KEY"import os
import requests
headers = {"Authorization": f"Bearer {os.environ['tokenba_API_KEY']}"}
response = requests.get('https://api.apizt.com/luma/generations/YOUR_TASK_ID', headers=headers, timeout=60)
response.raise_for_status()
print(response.json())(async () => {
const headers = { Authorization: `Bearer ${process.env.tokenba_API_KEY}` };
const response = await fetch("https://api.apizt.com/luma/generations/YOUR_TASK_ID", { method: "GET", headers });
if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
console.log(await response.json());
})().catch(console.error);返回响应
响应参数 🟢 200 OK · application/json
id
string
必需
state
string
必需
video
object
必需
url
string
必需
width
integer
必需
height
integer
必需
download_url
string
必需
request
object
必需
prompt
string
必需
aspect_ratio
string
必需
artifact
object
必需
video
object
必需
thumbnail
object
必需
video_raw
object
必需
created_at
string
必需
last_frame
object
必需
thumbnail
object
必需
url
string
必需
width
integer
必需
height
integer
必需
palette
object
必需
media_type
string
必需
video_raw
object
必需
url
string
必需
width
integer
必需
height
integer
必需
duration
number
必需
media_type
string
必需
created_at
string
必需
last_frame
object
必需
url
string
必需
width
integer
必需
height
integer
必需
palette
null
必需
media_type
string
必需
{"id": "4665a07c-7641-4809-a133-10786201bb56", "state": "completed", "video": {"url": "https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/35049450-c008-4607-b1d0-0b025599f15d/video0b6619468da8e409da860706bbf26bbad.mp4", "width": 1360, "height": 752, "download_url": "https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/35049450-c008-4607-b1d0-0b025599f15d/video0b6619468da8e409da860706bbf26bbad.mp4"}, "request": {"prompt": "cat dance", "aspect_ratio": "16:9"}, "artifact": {"video": {"url": "https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/35049450-c008-4607-b1d0-0b025599f15d/video0b6619468da8e409da860706bbf26bbad.mp4", "width": 1360, "height": 752, "download_url": "https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/35049450-c008-4607-b1d0-0b025599f15d/video0b6619468da8e409da860706bbf26bbad.mp4"}, "thumbnail": {"url": "https://imagedelivery.net/1KomXrSWiTojGGip43n0SQ/e4268de5-4a74-45ff-67b8-dc46df12de00/public", "width": 1360, "height": 752, "palette": {"grid": "em9csKqXYUgqdHVmmqeZLB8YaFpLjVw2bmFTTElBHhMNTzgodD8eVzUeTDorRSkYYEQymV80e1M0ck0ugWVRwKCApWk0hF1BgmVP"}, "media_type": "image"}, "video_raw": {"url": "https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/35049450-c008-4607-b1d0-0b025599f15d/video0b6619468da8e409da860706bbf26bbad.mp4", "width": 1360, "height": 752, "duration": 5.041667, "media_type": "video"}, "created_at": "0001-01-01T00:00:00Z", "last_frame": {"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, "height": 752, "palette": null, "media_type": "image"}}, "thumbnail": {"url": "https://imagedelivery.net/1KomXrSWiTojGGip43n0SQ/e4268de5-4a74-45ff-67b8-dc46df12de00/public", "width": 1360, "height": 752, "palette": {"grid": "em9csKqXYUgqdHVmmqeZLB8YaFpLjVw2bmFTTElBHhMNTzgodD8eVzUeTDorRSkYYEQymV80e1M0ck0ugWVRwKCApWk0hF1BgmVP"}, "media_type": "image"}, "video_raw": {"url": "https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/35049450-c008-4607-b1d0-0b025599f15d/video0b6619468da8e409da860706bbf26bbad.mp4", "width": 1360, "height": 752, "duration": 5.041667, "media_type": "video"}, "created_at": "2024-12-22T13:38:40.139Z", "last_frame": {"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, "height": 752, "palette": null, "media_type": "image"}}
常见错误
- 401 认证失败：检查 API Key 是否正确
- 429 请求限流：降低调用频率或升级套餐
- 500 服务器错误：稍后重试
注意事项
- 请确保 API Key 有足够的余额
- 请求频率受 API 限制，请参考价格页面