创建视频

curl https://api.pipellm.ai/v2/videos \
  -H "Authorization: Bearer $PIPELLM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0-mini",
    "prompt": "一只猫走过洒满阳光的厨房地板",
    "duration": 4,
    "aspect_ratio": "16:9",
    "resolution": "480p",
    "audio": false
  }'

import os
import requests

response = requests.post(
    "https://api.pipellm.ai/v2/videos",
    headers={
        "Authorization": f"Bearer {os.environ['PIPELLM_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "model": "seedance-2-0-mini",
        "prompt": "一只猫走过洒满阳光的厨房地板",
        "duration": 4,
        "aspect_ratio": "16:9",
        "resolution": "480p",
        "audio": False,
    },
)
print(response.json())

{
  "id": "gen-xxxxxxxx",
  "object": "video",
  "model": "seedance-2-0-mini",
  "provider": "volcengine",
  "status": "queued",
  "progress": 0,
  "created_at": 1726400000,
  "updated_at": 1726400000
}

POST

videos

curl https://api.pipellm.ai/v2/videos \
  -H "Authorization: Bearer $PIPELLM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0-mini",
    "prompt": "一只猫走过洒满阳光的厨房地板",
    "duration": 4,
    "aspect_ratio": "16:9",
    "resolution": "480p",
    "audio": false
  }'

import os
import requests

response = requests.post(
    "https://api.pipellm.ai/v2/videos",
    headers={
        "Authorization": f"Bearer {os.environ['PIPELLM_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "model": "seedance-2-0-mini",
        "prompt": "一只猫走过洒满阳光的厨房地板",
        "duration": 4,
        "aspect_ratio": "16:9",
        "resolution": "480p",
        "audio": False,
    },
)
print(response.json())

{
  "id": "gen-xxxxxxxx",
  "object": "video",
  "model": "seedance-2-0-mini",
  "provider": "volcengine",
  "status": "queued",
  "progress": 0,
  "created_at": 1726400000,
  "updated_at": 1726400000
}

创建视频任务，返回平台无关的任务信封。用 GET /v2/videos/{id} 轮询直到完成。 Mini、标准版 2.0、Fast 和 2.5 的支持范围、计费规则及轮询示例见视频生成。

string

必填

使用 doubao-seedance-2-0-mini-260615、seedance-2.0、doubao-seedance-2-0-fast-260128 或 doubao-seedance-2-5-260628。Mini 也接受 seedance-2-0-mini、seedance-2.0-mini。

string

必填

视频生成提示词。

array

可选媒体输入。每项需要 type 和 url。Mini 最多 9 张图、3 个视频、3 个音频。参考视频合计时长必须 ≤ 15 秒。标准版、Fast 和 2.5 仅接受最多 9 张图片。

显示 inputs[]

string

必填

image_url、video_url 或 audio_url。

string

必填

媒体的 HTTPS URL。

string

协议取值：first_frame、last_frame、reference_image、reference_video、reference_audio。Mini 的图片必须是 reference_image。Mini 的视频/音频用 reference_video / reference_audio，或不填 role。

integer

输出秒数：Mini、标准版和 Fast 为 4–15；2.5 为 4–30。默认 5。

string

adaptive、16:9、9:16、1:1、4:3、3:4 或 21:9。Mini 默认 16:9。

string

480p、720p 或 1080p。仅 2.5 额外接受 1080p；其他模型接受 480p 和 720p。默认 480p。

boolean

是否生成音频。Mini 默认 false。

object

按 Provider 隔离的原生参数。这四款模型均不支持。

curl https://api.pipellm.ai/v2/videos \
  -H "Authorization: Bearer $PIPELLM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0-mini",
    "prompt": "一只猫走过洒满阳光的厨房地板",
    "duration": 4,
    "aspect_ratio": "16:9",
    "resolution": "480p",
    "audio": false
  }'

import os
import requests

response = requests.post(
    "https://api.pipellm.ai/v2/videos",
    headers={
        "Authorization": f"Bearer {os.environ['PIPELLM_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "model": "seedance-2-0-mini",
        "prompt": "一只猫走过洒满阳光的厨房地板",
        "duration": 4,
        "aspect_ratio": "16:9",
        "resolution": "480p",
        "audio": False,
    },
)
print(response.json())

{
  "id": "gen-xxxxxxxx",
  "object": "video",
  "model": "seedance-2-0-mini",
  "provider": "volcengine",
  "status": "queued",
  "progress": 0,
  "created_at": 1726400000,
  "updated_at": 1726400000
}

未知字段会被拒绝。时长在完成后出现在 outputs[] 上，不在任务顶层。

string

公开任务 ID（gen-...）。GET 和 DELETE 使用这个值。上游 ID 只在网关内部使用。

string

固定为 video。

string

请求中的模型名。

string

接受该任务的上游，例如 volcengine。

string

queued、in_progress、completed、failed、cancelled 或 expired。

integer

可选的 0–100 进度。

array

completed 之后出现。时长在每个产物上，不在任务顶层。

显示 outputs[]

string

video、image 或 audio。

string

result、last_frame、cover 或 watermarked。

string

产物下载 URL。

string

例如 video/mp4。

number

该视频或音频产物的时长，单位秒。

object

status 为 failed 时出现，包含 code 和 message。

错误

Mini 和标准版 2.0 在成功接受任务后计费；Fast 和 2.5 完成后按实际视频 Token 结算。校验失败返回 400，不计费。错误信封与错误相同。未知 JSON 字段会被拒绝。

400 invalid_request_error

缺少 model / prompt、Mini 不支持的时长或分辨率、错误的 input role、参考素材过多，或 Mini 上传了 provider_options。

{
  "error": {
    "type": "invalid_request_error",
    "code": "400",
    "message": "Mini image inputs require role=reference_image"
  }
}

401 authentication_error

{
  "error": {
    "type": "authentication_error",
    "code": "401",
    "message": "Incorrect API key provided. Please visit https://console.pipellm.ai/account/api-keys to find your API key."
  }
}

402 insufficient_balance

报价在创建时确定。余额不足会在创建任务前拒绝请求。

{
  "error": {
    "type": "insufficient_balance",
    "code": "402",
    "message": "Insufficient balance. Please recharge your account at https://console.pipellm.ai/billing."
  }
}

429 rate_limit_error

见速率限制。

{
  "error": {
    "type": "rate_limit_error",
    "code": "429",
    "message": "Rate limit exceeded. Your current limit is 120 requests per minute (approximately 2.00 requests per second). Please visit https://console.pipellm.ai/billing to upgrade your plan for higher limits."
  }
}

API 指南

API 参考

错误

​错误

错误