curl https://api.nodylink.com/v2/videos/generations/6b2f8d1e-3c4a-4e9b-8f70-1a5d9c2e7b36 \
-H "Authorization: Bearer sk-你的密钥"
import requests
resp = requests.get(
"https://api.nodylink.com/v2/videos/generations/6b2f8d1e-3c4a-4e9b-8f70-1a5d9c2e7b36",
headers={"Authorization": "Bearer sk-你的密钥"},
)
print(resp.json())
const resp = await fetch(
"https://api.nodylink.com/v2/videos/generations/6b2f8d1e-3c4a-4e9b-8f70-1a5d9c2e7b36",
{ headers: { Authorization: "Bearer sk-你的密钥" } },
);
console.log(await resp.json());
{
"task_id": "6b2f8d1e-3c4a-4e9b-8f70-1a5d9c2e7b36",
"action": "textGenerate",
"status": "SUCCESS",
"fail_reason": "",
"submit_time": 1792000000,
"start_time": 1792000005,
"finish_time": 1792000180,
"progress": "100%",
"data": {
"task": {
"id": "cgt-20261014144800-x7k2m",
"status": "succeeded",
"model": "doubao-seedance-2-0-260128",
"outputs": [
"https://example.com/generated/6b2f8d1e.mp4"
],
"usage": {
"completion_tokens": 108900,
"total_tokens": 108900
}
}
}
}
{
"task_id": "9c4e2a7b-6d1f-4b38-a5e0-3f8d1c6b2e94",
"action": "textGenerate",
"status": "SUCCESS",
"fail_reason": "",
"submit_time": 1792000000,
"start_time": 1792000004,
"finish_time": 1792000150,
"progress": "100%",
"data": {
"id": "9c4e2a7b-6d1f-4b38-a5e0-3f8d1c6b2e94",
"status": "completed",
"progress": 100,
"result": {
"videos": [
{
"url": ["https://example.com/generated/9c4e2a7b.mp4"],
"expires_at": 1792086550
}
]
}
}
}
{
"task_id": "6b2f8d1e-3c4a-4e9b-8f70-1a5d9c2e7b36",
"action": "textGenerate",
"status": "IN_PROGRESS",
"fail_reason": "",
"submit_time": 1792000000,
"start_time": 1792000005,
"finish_time": 0,
"progress": "50%",
"data": null
}
{
"task_id": "6b2f8d1e-3c4a-4e9b-8f70-1a5d9c2e7b36",
"action": "generate",
"status": "FAILURE",
"fail_reason": "The request failed because the input image may contain real person.",
"submit_time": 1792000000,
"start_time": 1792000005,
"finish_time": 1792000040,
"progress": "100%",
"data": null
}
视频系列
查询视频任务
查询 Seedance、Wan 视频生成任务的状态和结果。
GET
/
v2
/
videos
/
generations
/
{task_id}
curl https://api.nodylink.com/v2/videos/generations/6b2f8d1e-3c4a-4e9b-8f70-1a5d9c2e7b36 \
-H "Authorization: Bearer sk-你的密钥"
import requests
resp = requests.get(
"https://api.nodylink.com/v2/videos/generations/6b2f8d1e-3c4a-4e9b-8f70-1a5d9c2e7b36",
headers={"Authorization": "Bearer sk-你的密钥"},
)
print(resp.json())
const resp = await fetch(
"https://api.nodylink.com/v2/videos/generations/6b2f8d1e-3c4a-4e9b-8f70-1a5d9c2e7b36",
{ headers: { Authorization: "Bearer sk-你的密钥" } },
);
console.log(await resp.json());
{
"task_id": "6b2f8d1e-3c4a-4e9b-8f70-1a5d9c2e7b36",
"action": "textGenerate",
"status": "SUCCESS",
"fail_reason": "",
"submit_time": 1792000000,
"start_time": 1792000005,
"finish_time": 1792000180,
"progress": "100%",
"data": {
"task": {
"id": "cgt-20261014144800-x7k2m",
"status": "succeeded",
"model": "doubao-seedance-2-0-260128",
"outputs": [
"https://example.com/generated/6b2f8d1e.mp4"
],
"usage": {
"completion_tokens": 108900,
"total_tokens": 108900
}
}
}
}
{
"task_id": "9c4e2a7b-6d1f-4b38-a5e0-3f8d1c6b2e94",
"action": "textGenerate",
"status": "SUCCESS",
"fail_reason": "",
"submit_time": 1792000000,
"start_time": 1792000004,
"finish_time": 1792000150,
"progress": "100%",
"data": {
"id": "9c4e2a7b-6d1f-4b38-a5e0-3f8d1c6b2e94",
"status": "completed",
"progress": 100,
"result": {
"videos": [
{
"url": ["https://example.com/generated/9c4e2a7b.mp4"],
"expires_at": 1792086550
}
]
}
}
}
{
"task_id": "6b2f8d1e-3c4a-4e9b-8f70-1a5d9c2e7b36",
"action": "textGenerate",
"status": "IN_PROGRESS",
"fail_reason": "",
"submit_time": 1792000000,
"start_time": 1792000005,
"finish_time": 0,
"progress": "50%",
"data": null
}
{
"task_id": "6b2f8d1e-3c4a-4e9b-8f70-1a5d9c2e7b36",
"action": "generate",
"status": "FAILURE",
"fail_reason": "The request failed because the input image may contain real person.",
"submit_time": 1792000000,
"start_time": 1792000005,
"finish_time": 1792000040,
"progress": "100%",
"data": null
}
视频生成接口提交后返回任务
id，用本接口轮询任务状态。任务成功后，视频链接在 data 中。
- 视频生成通常需要 1～10 分钟，建议每 10 秒左右查询一次。
- 只能查询当前账户提交的任务。
- 视频链接可能会过期，拿到后请及时下载转存。
curl https://api.nodylink.com/v2/videos/generations/6b2f8d1e-3c4a-4e9b-8f70-1a5d9c2e7b36 \
-H "Authorization: Bearer sk-你的密钥"
import requests
resp = requests.get(
"https://api.nodylink.com/v2/videos/generations/6b2f8d1e-3c4a-4e9b-8f70-1a5d9c2e7b36",
headers={"Authorization": "Bearer sk-你的密钥"},
)
print(resp.json())
const resp = await fetch(
"https://api.nodylink.com/v2/videos/generations/6b2f8d1e-3c4a-4e9b-8f70-1a5d9c2e7b36",
{ headers: { Authorization: "Bearer sk-你的密钥" } },
);
console.log(await resp.json());
{
"task_id": "6b2f8d1e-3c4a-4e9b-8f70-1a5d9c2e7b36",
"action": "textGenerate",
"status": "SUCCESS",
"fail_reason": "",
"submit_time": 1792000000,
"start_time": 1792000005,
"finish_time": 1792000180,
"progress": "100%",
"data": {
"task": {
"id": "cgt-20261014144800-x7k2m",
"status": "succeeded",
"model": "doubao-seedance-2-0-260128",
"outputs": [
"https://example.com/generated/6b2f8d1e.mp4"
],
"usage": {
"completion_tokens": 108900,
"total_tokens": 108900
}
}
}
}
{
"task_id": "9c4e2a7b-6d1f-4b38-a5e0-3f8d1c6b2e94",
"action": "textGenerate",
"status": "SUCCESS",
"fail_reason": "",
"submit_time": 1792000000,
"start_time": 1792000004,
"finish_time": 1792000150,
"progress": "100%",
"data": {
"id": "9c4e2a7b-6d1f-4b38-a5e0-3f8d1c6b2e94",
"status": "completed",
"progress": 100,
"result": {
"videos": [
{
"url": ["https://example.com/generated/9c4e2a7b.mp4"],
"expires_at": 1792086550
}
]
}
}
}
{
"task_id": "6b2f8d1e-3c4a-4e9b-8f70-1a5d9c2e7b36",
"action": "textGenerate",
"status": "IN_PROGRESS",
"fail_reason": "",
"submit_time": 1792000000,
"start_time": 1792000005,
"finish_time": 0,
"progress": "50%",
"data": null
}
{
"task_id": "6b2f8d1e-3c4a-4e9b-8f70-1a5d9c2e7b36",
"action": "generate",
"status": "FAILURE",
"fail_reason": "The request failed because the input image may contain real person.",
"submit_time": 1792000000,
"start_time": 1792000005,
"finish_time": 1792000040,
"progress": "100%",
"data": null
}
鉴权
string
必填
Bearer <API Key>。需要与提交任务时属于同一账户。路径参数
string
必填
视频生成接口返回的
id。响应
string
任务 ID。
string
任务类型：
textGenerate 表示纯文生视频，generate 表示包含图片、视频或音频参考。string
任务状态：
| 状态 | 含义 |
|---|---|
NOT_START | 任务已创建，尚未提交到上游 |
SUBMITTED | 已提交到上游 |
QUEUED | 上游排队中 |
IN_PROGRESS | 生成中 |
SUCCESS | 成功，data 中包含视频链接 |
FAILURE | 失败，原因见 fail_reason，费用已自动退回 |
string
失败原因。非失败状态下为空字符串。
integer
提交时间，Unix 时间戳（秒）。
integer
开始生成时间，Unix 时间戳（秒）。未开始时为
0。integer
完成时间，Unix 时间戳（秒）。未完成时为
0。string
任务进度，例如
50%。object | null
上游返回的任务结果，任务完成前可能为
建议按下方示例依次尝试，取第一个非空值。
null。视频链接的位置因模型和线路而异：| 位置 | 适用 | 说明 |
|---|---|---|
data.task.outputs[0] | Seedance | 视频链接，大多数线路使用这种格式 |
data.task.usage | Seedance | token 用量 |
data.task.last_frame_url | Seedance | 尾帧图片，请求时设置了 return_last_frame 才有 |
data.content.video_url | Seedance | 视频链接，火山方舟原始格式 |
data.content.last_frame_url | Seedance | 尾帧图片，火山方舟原始格式 |
data.result.videos[0].url[0] | Wan | 视频链接 |
提取视频链接
def extract_result(data: dict) -> tuple[str | None, str | None]:
"""返回 (视频链接, 尾帧链接)"""
if not data:
return None, None
task = data.get("task") or {}
content = data.get("content") or {}
videos = (data.get("result") or {}).get("videos") or [{}]
video = (
(task.get("outputs") or [None])[0]
or content.get("video_url")
or (videos[0].get("url") or [None])[0]
)
last_frame = task.get("last_frame_url") or content.get("last_frame_url")
return video, last_frame
function extractResult(data) {
const video =
data?.task?.outputs?.[0] ??
data?.content?.video_url ??
data?.result?.videos?.[0]?.url?.[0] ??
null;
const lastFrame = data?.task?.last_frame_url ?? data?.content?.last_frame_url ?? null;
return { video, lastFrame };
}
错误响应
| 状态码 | 说明 |
|---|---|
400 | 任务不存在，或不属于当前账户，响应为 {"code": "task_not_exist", "message": "task_not_exist", "data": null} |
401 | API Key 无效 |