curl https://api.pipellm.ai/v1/tasks/gen-1732891234-abc123xyz \
-H "Authorization: Bearer $PIPELLM_API_KEY"
import os, time, requests
headers = {"Authorization": f"Bearer {os.environ['PIPELLM_API_KEY']}"}
while True:
task = requests.get(
f"https://api.pipellm.ai/v1/tasks/{task_id}", headers=headers
).json()
if task["status"] in ("completed", "failed", "cancelled"):
break
time.sleep(3)
print(task["status"], task.get("data"), task.get("error"))
{
"id": "gen-1732891234-abc123xyz",
"status": "processing",
"type": "video_generation",
"model": "seedance-2-0-mini",
"created_at": "2026-09-17T08:14:02Z"
}
查询任务
轮询图像、视频或音频异步任务的状态。
GET
/
v1
/
tasks
/
{task_id}
curl https://api.pipellm.ai/v1/tasks/gen-1732891234-abc123xyz \
-H "Authorization: Bearer $PIPELLM_API_KEY"
import os, time, requests
headers = {"Authorization": f"Bearer {os.environ['PIPELLM_API_KEY']}"}
while True:
task = requests.get(
f"https://api.pipellm.ai/v1/tasks/{task_id}", headers=headers
).json()
if task["status"] in ("completed", "failed", "cancelled"):
break
time.sleep(3)
print(task["status"], task.get("data"), task.get("error"))
{
"id": "gen-1732891234-abc123xyz",
"status": "processing",
"type": "video_generation",
"model": "seedance-2-0-mini",
"created_at": "2026-09-17T08:14:02Z"
}
无法在一次请求内完成的媒体生成会变成一个任务。这个接口返回某个任务的当前状态，
完成后一并返回结果。
通过
POST /v2/videos 创建的视频有自己的任务信封和
轮询路径 GET /v2/videos/{id}。本接口用于 /v1
媒体端点创建的任务。string
必填
任务 ID。由 PipeLLM 托管的任务以
gen- 开头；直接在上游创建的任务，也接受上游自己的
任务 ID。curl https://api.pipellm.ai/v1/tasks/gen-1732891234-abc123xyz \
-H "Authorization: Bearer $PIPELLM_API_KEY"
import os, time, requests
headers = {"Authorization": f"Bearer {os.environ['PIPELLM_API_KEY']}"}
while True:
task = requests.get(
f"https://api.pipellm.ai/v1/tasks/{task_id}", headers=headers
).json()
if task["status"] in ("completed", "failed", "cancelled"):
break
time.sleep(3)
print(task["status"], task.get("data"), task.get("error"))
{
"id": "gen-1732891234-abc123xyz",
"status": "processing",
"type": "video_generation",
"model": "seedance-2-0-mini",
"created_at": "2026-09-17T08:14:02Z"
}
string
pending、processing、completed、failed 或 cancelled 之一。string
image_generation、image_edit、video_generation 或 audio_generation。string
产出结果的模型。
string
任务创建时间。
object
结果。
status 为 completed 后出现，结构随任务 type 而定。string
失败原因。
status 为 failed 时出现。轮询
任务的流转是pending → processing → completed / failed / cancelled 之一。
只有这三个是终态，看到就停止轮询。
每隔几秒轮询一次即可，不要写成紧凑循环——轮询会计入你的
速率限制，而且轮得再快上游也不会更早完成。
错误
错误信封与 错误与排查 一致。ID 不存在返回404；属于其他
账户的任务对你不可见，同样返回 404。此页面对您有帮助吗？