跳至正文
EN
获取 API Key
☰

Seedance V1 API 接入文档

使用 VezAPI 密钥接入 Seedance V1。下列操作共用同一个账号余额和鉴权方式。

服务地址： https://api.vezapi.com
请求头使用 Authorization: Bearer YOUR_VEZAPI_KEY。每次提交使用唯一的 Idempotency-Key，查询同一笔提交时才复用。

Bytedance V1 Lite 图生视频

POST/api/v1/jobs/createTask

模型标识： bytedance/v1-lite-image-to-video

参数类型说明与限制
model
必填		string

用于生成任务的模型名称。必填字段。 - 该接口必须使用 `bytedance/v1-lite-image-to-video` 模型

可选值："bytedance/v1-lite-image-to-video"

默认："bytedance/v1-lite-image-to-video"

callBackUrl
可选		string

接收生成任务完成通知的回调 URL。可选配置，生产环境建议使用。 - 任务生成完成后，系统会向该 URL 以 POST 方式推送任务状态和结果 - 回调内容包含生成内容的 URL 及任务相关信息 - 你的回调接口需支持接收 POST 请求及 JSON 格式的请求体 - 也可选择调用任务详情接口，主动轮询任务状态

input
可选		object

生成任务的输入参数

input.prompt
必填		string

用于视频生成的文本提示词（最大长度：10000 字符）

maxLength: 10000

input.image_url
必填		string

用于生成视频的图片 URL（需为上传后的文件 URL，而非文件内容；支持的格式：image/jpeg、image/png、image/webp；最大文件大小：10.0MB）

input.resolution
可选		string

视频分辨率 - 480p 生成速度更快，720p 画质更高

可选值："480p", "720p", "1080p"

默认："720p"

input.duration
可选		string

视频时长（单位：秒）

可选值："5", "10"

默认："5"

input.camera_fixed
可选		boolean

是否固定相机位置（布尔值（true/false））

input.seed
可选		number

用于控制视频生成的随机种子值。设为 -1 时随机生成。（最小值：-1，最大值：2147483647，步长：1）

默认：-1

minimum: -1

maximum: 2147483647

input.enable_safety_checker
可选		boolean

Playground 环境下安全校验始终启用。仅可通过 API 将该参数设为 false 以关闭安全校验。（布尔值（true/false））

input.end_image_url
可选		string

视频结尾画面的图片 URL。默认值为无。（需为上传后的文件 URL，而非文件内容；支持的格式：image/jpeg、image/png、image/webp；最大文件大小：10.0MB）

input.nsfw_checker
可选		boolean

默认 false。为 false 时不额外进行内容过滤，结果由模型直接返回。

请求示例
curl -X POST 'https://api.vezapi.com/api/v1/jobs/createTask' \
  -H 'Authorization: Bearer YOUR_VEZAPI_KEY' \
  -H 'Idempotency-Key: your-unique-request-id' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "bytedance/v1-lite-image-to-video",
  "input": {
    "prompt": "Multiple shots. A traveler crosses an endless desert toward a glowing archway. [Cut to] His cloak whips in the wind as he reaches the massive stone threshold. [Wide shot] He steps through — and vanishes into a burst of light",
    "image_url": "https://example.com/input.png",
    "resolution": "720p",
    "duration": "5"
  }
}'
返回值与错误

HTTP 200

请求成功

参数类型说明与限制
code
可选		integer

Status code of the request. The HTTP status is 200 even when the request fails, so always check this field: 200 means success; any other value means the request failed and msg describes the reason. Common values: 401 invalid or missing API key; 402 insufficient credits; 429 rate limit exceeded; 422 or 500 the request could not be processed (read msg and check your parameters before retrying).

可选值：200, 401, 402, 404, 422, 429, 433, 455, 500, 501, 505

msg
可选		string

Response message, error description upon failure

data
必填		object
data.taskId
必填		string

The task ID can be used with the "Get Task Details" endpoint to query the task status.

Bytedance V1 Lite 文生视频

POST/api/v1/jobs/createTask

模型标识： bytedance/v1-lite-text-to-video

参数类型说明与限制
model
必填		string

用于生成任务的模型名称。必填字段。 - 该接口必须使用 `bytedance/v1-lite-text-to-video` 模型

可选值："bytedance/v1-lite-text-to-video"

默认："bytedance/v1-lite-text-to-video"

callBackUrl
可选		string

接收生成任务完成通知的回调 URL。可选配置，生产环境建议使用。 - 任务生成完成后，系统会向该 URL 以 POST 方式推送任务状态和结果 - 回调内容包含生成内容的 URL 及任务相关信息 - 你的回调接口需支持接收 POST 请求及 JSON 格式的请求体 - 也可选择调用任务详情接口，主动轮询任务状态

input
可选		object

生成任务的输入参数

input.prompt
必填		string

用于视频生成的文本提示词（最大长度：10000 字符）

maxLength: 10000

input.aspect_ratio
可选		string

生成视频的宽高比

可选值："16:9", "4:3", "1:1", "3:4", "9:16", "9:21"

默认："16:9"

input.resolution
可选		string

视频分辨率 - 480p 生成速度更快，720p 画质更高

可选值："480p", "720p", "1080p"

默认："720p"

input.duration
可选		string

视频时长（单位：秒）

可选值："5", "10"

默认："5"

input.camera_fixed
可选		boolean

是否固定相机位置（布尔值（true/false））

input.seed
可选		integer

用于控制视频生成的随机种子值。设为 -1 时随机生成。

input.enable_safety_checker
可选		boolean

Playground 环境下安全校验始终启用。仅可通过 API 将该参数设为 false 以关闭安全校验。（布尔值（true/false））

input.nsfw_checker
可选		boolean

默认 false。为 false 时不额外进行内容过滤，结果由模型直接返回。

请求示例
curl -X POST 'https://api.vezapi.com/api/v1/jobs/createTask' \
  -H 'Authorization: Bearer YOUR_VEZAPI_KEY' \
  -H 'Idempotency-Key: your-unique-request-id' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "bytedance/v1-lite-text-to-video",
  "input": {
    "prompt": "Wide-angle shot: A serene sailing boat gently sways in the harbor at dawn, surrounded by soft Impressionist hues of pink and orange with ivory accents. The camera slowly pans across the scene, capturing the delicate reflections on the water and the intricate details of the boat'\''s sails as the light gradually brightens.",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": "5"
  }
}'
返回值与错误

HTTP 200

请求成功

参数类型说明与限制
code
可选		integer

Status code of the request. The HTTP status is 200 even when the request fails, so always check this field: 200 means success; any other value means the request failed and msg describes the reason. Common values: 401 invalid or missing API key; 402 insufficient credits; 429 rate limit exceeded; 422 or 500 the request could not be processed (read msg and check your parameters before retrying).

可选值：200, 401, 402, 404, 422, 429, 433, 455, 500, 501, 505

msg
可选		string

Response message, error description upon failure

data
必填		object
data.taskId
必填		string

The task ID can be used with the "Get Task Details" endpoint to query the task status.

Bytedance V1 Pro Fast 图生视频

POST/api/v1/jobs/createTask

模型标识： bytedance/v1-pro-fast-image-to-video

参数类型说明与限制
model
必填		string

用于生成任务的模型名称。必填字段。 - 该端点必须使用 `bytedance/v1-pro-fast-image-to-video` 模型

可选值："bytedance/v1-pro-fast-image-to-video"

默认："bytedance/v1-pro-fast-image-to-video"

callBackUrl
可选		string

接收生成任务完成通知的回调 URL。可选配置，建议在生产环境中使用。 - 任务生成完成后，系统会向该 URL POST 任务状态与结果 - 回调内容包含生成的资源 URL 与任务相关信息 - 您的回调端点需要支持接收带 JSON 负载的 POST 请求 - 也可以选择调用任务详情端点，主动轮询任务状态

input
可选		object

生成任务的输入参数

input.prompt
必填		string

用于生成视频的文本提示词（最大长度：10000 字符）

maxLength: 10000

input.image_url
必填		string

用于生成视频的图像 URL。（为上传后的文件 URL，非文件内容；支持的类型：image/jpeg、image/png、image/webp；最大文件大小：10.0MB）

input.resolution
可选		string

输出分辨率：720p 或 1080p。

可选值："720p", "1080p"

默认："720p"

input.duration
可选		string

视频时长（单位：秒）

可选值："5", "10"

默认："5"

input.nsfw_checker
可选		boolean

默认 false。为 false 时不额外进行内容过滤，结果由模型直接返回。

请求示例
curl -X POST 'https://api.vezapi.com/api/v1/jobs/createTask' \
  -H 'Authorization: Bearer YOUR_VEZAPI_KEY' \
  -H 'Idempotency-Key: your-unique-request-id' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "bytedance/v1-pro-fast-image-to-video",
  "input": {
    "prompt": "A cinematic close-up sequence of a single elegant ceramic coffee cup with saucer on a rustic wooden table near a sunlit window, hot rich espresso poured in a thin golden stream from above, gradually filling the cup in distinct stages: empty with faint steam, 1/4 filled with dark crema, half-filled with swirling coffee and rising steam, 3/4 filled nearing the rim, perfectly full just below overflow with glossy surface and soft bokeh highlights; ultra-realistic, warm golden-hour light, shallow depth of field, photorealism, detailed textures, subtle steam wisps, serene inviting atmosphere --ar 16:9 --q 2 --style raw",
    "image_url": "https://example.com/input.png",
    "resolution": "720p",
    "duration": "5"
  }
}'
返回值与错误

HTTP 200

请求成功

参数类型说明与限制
code
可选		integer

Status code of the request. The HTTP status is 200 even when the request fails, so always check this field: 200 means success; any other value means the request failed and msg describes the reason. Common values: 401 invalid or missing API key; 402 insufficient credits; 429 rate limit exceeded; 422 or 500 the request could not be processed (read msg and check your parameters before retrying).

可选值：200, 401, 402, 404, 422, 429, 433, 455, 500, 501, 505

msg
可选		string

Response message, error description upon failure

data
必填		object
data.taskId
必填		string

The task ID can be used with the "Get Task Details" endpoint to query the task status.

Bytedance V1 Pro 图生视频

POST/api/v1/jobs/createTask

模型标识： bytedance/v1-pro-image-to-video

参数类型说明与限制
model
必填		string

用于生成任务的模型名称。必填字段。 - 该接口必须使用 `bytedance/v1-pro-image-to-video` 模型

可选值："bytedance/v1-pro-image-to-video"

默认："bytedance/v1-pro-image-to-video"

callBackUrl
可选		string

接收生成任务完成通知的回调 URL。可选配置，生产环境建议使用。 - 任务生成完成后，系统会向该 URL 以 POST 方式推送任务状态和结果 - 回调内容包含生成内容的 URL 及任务相关信息 - 你的回调接口需支持接收 POST 请求及 JSON 格式的请求体 - 也可选择调用任务详情接口，主动轮询任务状态

input
可选		object

生成任务的输入参数

input.prompt
必填		string

用于视频生成的文本提示词（最大长度：10000 字符）

maxLength: 10000

input.image_url
必填		string

用于生成视频的图片 URL（需为上传后的文件 URL，而非文件内容；支持的格式：image/jpeg、image/png、image/webp；最大文件大小：10.0MB）

input.resolution
可选		string

视频分辨率 - 480p 生成速度更快，720p 兼顾速度与画质，1080p 画质更高

可选值："480p", "720p", "1080p"

默认："720p"

input.duration
可选		string

视频时长（单位：秒）

可选值："5", "10"

默认："5"

input.camera_fixed
可选		boolean

是否固定相机位置（布尔值（true/false））

input.seed
可选		number

用于控制视频生成的随机种子值。设为 -1 时随机生成。（最小值：-1，最大值：2147483647，步长：1）

默认：-1

minimum: -1

maximum: 2147483647

input.enable_safety_checker
可选		boolean

Playground 环境下安全校验始终启用。仅可通过 API 将该参数设为 false 以关闭安全校验。（布尔值（true/false））

input.nsfw_checker
可选		boolean

默认 false。为 false 时不额外进行内容过滤，结果由模型直接返回。

请求示例
curl -X POST 'https://api.vezapi.com/api/v1/jobs/createTask' \
  -H 'Authorization: Bearer YOUR_VEZAPI_KEY' \
  -H 'Idempotency-Key: your-unique-request-id' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "bytedance/v1-pro-image-to-video",
  "input": {
    "prompt": "A golden retriever dashing through shallow surf at the beach, back angle camera low near waterline, splashes frozen in time, blur trails in waves and paws, afternoon sun glinting off wet fur, overcast day, dramatic clouds",
    "image_url": "https://example.com/input.png",
    "resolution": "720p",
    "duration": "5"
  }
}'
返回值与错误

HTTP 200

请求成功

参数类型说明与限制
code
可选		integer

Status code of the request. The HTTP status is 200 even when the request fails, so always check this field: 200 means success; any other value means the request failed and msg describes the reason. Common values: 401 invalid or missing API key; 402 insufficient credits; 429 rate limit exceeded; 422 or 500 the request could not be processed (read msg and check your parameters before retrying).

可选值：200, 401, 402, 404, 422, 429, 433, 455, 500, 501, 505

msg
可选		string

Response message, error description upon failure

data
必填		object
data.taskId
必填		string

The task ID can be used with the "Get Task Details" endpoint to query the task status.

Bytedance V1 Pro 文生视频

POST/api/v1/jobs/createTask

模型标识： bytedance/v1-pro-text-to-video

参数类型说明与限制
model
必填		string

用于生成任务的模型名称。必填字段。 - 该接口必须使用 `bytedance/v1-pro-text-to-video` 模型

可选值："bytedance/v1-pro-text-to-video"

默认："bytedance/v1-pro-text-to-video"

callBackUrl
可选		string

接收生成任务完成通知的回调 URL。可选配置，生产环境建议使用。 - 任务生成完成后，系统会向该 URL 以 POST 方式推送任务状态和结果 - 回调内容包含生成内容的 URL 及任务相关信息 - 你的回调接口需支持接收 POST 请求及 JSON 格式的请求体 - 也可选择调用任务详情接口，主动轮询任务状态

input
可选		object

生成任务的输入参数

input.prompt
必填		string

用于视频生成的文本提示词（最大长度：10000 字符）

maxLength: 10000

input.aspect_ratio
可选		string

生成视频的宽高比

可选值："21:9", "16:9", "4:3", "1:1", "3:4", "9:16"

默认："16:9"

input.resolution
可选		string

视频分辨率 - 480p 生成速度更快，720p 兼顾速度与画质，1080p 画质更高

可选值："480p", "720p", "1080p"

默认："720p"

input.duration
可选		string

视频时长（单位：秒）

可选值："5", "10"

默认："5"

input.camera_fixed
可选		boolean

是否固定相机位置（布尔值（true/false））

input.seed
可选		number

用于控制视频生成的随机种子值。设为 -1 时随机生成。（最小值：-1，最大值：2147483647，步长：1）

默认：-1

minimum: -1

maximum: 2147483647

input.enable_safety_checker
可选		boolean

Playground 环境下安全校验始终启用。仅可通过 API 将该参数设为 false 以关闭安全校验。（布尔值（true/false））

input.nsfw_checker
可选		boolean

默认 false。为 false 时不额外进行内容过滤，结果由模型直接返回。

请求示例
curl -X POST 'https://api.vezapi.com/api/v1/jobs/createTask' \
  -H 'Authorization: Bearer YOUR_VEZAPI_KEY' \
  -H 'Idempotency-Key: your-unique-request-id' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "bytedance/v1-pro-text-to-video",
  "input": {
    "prompt": "A boy with curly hair and a backpack rides a bike down a golden-lit rural road at sunset.\n[Cut to] He slows down and looks toward a field of tall grass.\n[Wide shot] His silhouette halts in the orange haze.",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": "5"
  }
}'
返回值与错误

HTTP 200

请求成功

参数类型说明与限制
code
可选		integer

Status code of the request. The HTTP status is 200 even when the request fails, so always check this field: 200 means success; any other value means the request failed and msg describes the reason. Common values: 401 invalid or missing API key; 402 insufficient credits; 429 rate limit exceeded; 422 or 500 the request could not be processed (read msg and check your parameters before retrying).

可选值：200, 401, 402, 404, 422, 429, 433, 455, 500, 501, 505

msg
可选		string

Response message, error description upon failure

data
必填		object
data.taskId
必填		string

The task ID can be used with the "Get Task Details" endpoint to query the task status.

任务状态与回调

异步任务请保存返回的 taskId。调用 GET /api/v1/jobs/recordInfo?taskId=... 查询，或在创建时设置 callBackUrl。只有任务所属账号可以查询任务或基于任务创建派生资源。

超时可能表示请求已经受理。请在控制台查看原请求，不要自动新建任务。回调可能重试并重复到达，请使用 X-VezAPI-Event-Id 去重。

文件、日志与计费

生成媒体通常随上游保留 14 天，上传文件在 24 小时后失效。请在过期前保存所需文件。VezAPI 仅流式转发已登记资源，不提供永久作品库。请求日志保留两个自然月。

调用前预留积分，最终按实际优惠扣分 1:1 结算。用量不明时暂停新付费请求。若保护其他任务预留后余额不足以结算，会保留待结算记录，补足余额后再扣费；模型用量不会将钱包扣成负数。按时长计价的输入文件由服务端读取时长，读取失败时不提交模型任务。