BaseUrl

购买低价Seedance API联系微信：itlife888
访问https://wellapi.cc 查看更多低价大模型

计费方式

按秒计费，价格在列表中展示。

适用的模型

模型名称如下，调用时也使用这些模型名称
Seedance 2.0模型：
sec-seedance-2.0-1080p
sec-seedance-2.0-480p
sec-seedance-2.0-480p-fast-tj
sec-seedance-2.0-4k
sec-seedance-2.0-720p
sec-seedance-2.0-720p-fast-tj

Seedance 2.5模型：
sec-seedance-2.5-480p
sec-seedance-2.5-720p

说明：tj结尾表示特价模型，价格比较便宜，但稳定性差一些。

重要说明

购买低价Seedance API联系微信：itlife888

该接口面向需要接入 OpenAI / Sora 风格视频协议的平台，例如 NewAPI 等聚合平台。接口使用平台 API Key 鉴权。

当前 OpenAI 兼容接口复用 NewAPI 模型 ID 规则。创建任务时，model 必须使用模型列表接口返回的完整 ID，格式为 {channelCode}:{model}。

/v1/videos 是异步生成入口：传入视频模型时创建视频任务，传入图片模型时创建图片任务。为了兼容已经适配 OpenAI/Sora 视频协议的下游平台，图片生成也通过 /v1/videos 创建和查询，不使用 OpenAI 官方同步图片接口。

通用说明

所有接口均需要通过请求头传递 API Key：

参数名	位置	类型	必填	说明
Authorization	Header	String	Y	固定格式：`Bearer {apiKey}`

API Key 与平台账号绑定，仅能访问该账号下的任务和资源。

模型、线路、价格和能力会随运营策略调整，客户端应通过模型列表接口动态读取，不应写死模型 ID。

OpenAI 兼容视频接口路径为 /v1/videos。

OpenAI 兼容模型列表接口路径为 /v1/models。

返回对象仍保持 OpenAI/Sora 视频对象结构，object 固定为 video。

图片任务完成后的图片 URL 同样放在 metadata.result_url。

任务状态

状态值	说明
queued	已创建，等待执行
in_progress	执行中
completed	任务成功完成
failed	任务执行失败

错误响应

接口失败时返回 OpenAI / NewAPI 兼容错误结构：

{
  "error": {
    "message": "model must be one of /newapi/v1/models response ids",
    "type": "invalid_request_error",
    "param": "model",
    "code": "model_ambiguous"
  }
}

常见错误码：

HTTP 状态码	code	说明
400	invalid_request	请求体缺失或字段格式不合法
400	model_ambiguous	model 未使用模型列表返回的完整 ID，或无法匹配当前可用模型
400	invalid_metadata	metadata 字段格式不合法，或传入不支持的扩展字段
400	unsupported_parameter	当前参数值暂不支持，例如 n 不为 1、variant 不为 video 或 image
400	video_not_completed	内容下载接口请求的任务尚未完成
400	content_not_available	任务已完成但内容地址不可用
401	invalid_api_key	API Key 缺失、格式错误、已禁用或不存在
404	not_found	任务不存在，或不属于当前 API Key 对应账号
500	internal_error	服务内部异常

创建生成任务

作用

创建异步生成任务，并返回 OpenAI 风格视频对象。传入视频模型时生成视频，传入图片模型时生成图片。

提交方式

POST https://wellapi.cc/v1/videos

编码

UTF-8

Content-Type

application/json

输入参数

参数名	类型	必填	说明
model	String	Y	模型列表接口返回的 `data[].id`，必须原样传入
prompt	String	Y	生成提示词
image	String	N	单张参考图片 URL；会作为参考图片列表的第一张
seconds	String	N	视频任务时长，单位：秒；优先级高于 `duration`；图片任务忽略
duration	Integer	N	视频任务时长，单位：秒；未传 `seconds` 时生效；图片任务忽略
size	String	N	画幅比例，如 `16:9`、`9:16`、`1:1`；图片任务直接使用该字段作为图片比例，未传时自动选择默认比例
width	Integer	N	期望宽度；未传 `size` 和 `metadata.size` 时会与 `height` 一起换算画幅比例
height	Integer	N	期望高度；未传 `size` 和 `metadata.size` 时会与 `width` 一起换算画幅比例
n	Integer	N	生成数量；当前仅支持 1
metadata	Object	N	平台扩展参数

metadata 扩展参数

参数名	类型	必填	说明
resolution	String	N	分辨率或质量档位，如 `720p`、`1080p`、`1K`；图片任务未传时自动选择模型默认值
size	String	N	画面比例，如 `16:9`、`9:16`；优先级高于 `width` / `height`
mode_type	String	N	视频生成模式：`text2video`、`image2video`、`frames2video`；图片任务忽略
images	List<String>	N	参考图片 URL 列表；会追加在顶层 `image` 之后
videos	List<String>	N	视频任务参考视频 URL 列表；图片任务忽略
audios	List<String>	N	视频任务参考音频 URL 列表；图片任务忽略

mode_type 规则

模式	说明	素材要求
text2video	文生视频	不允许传入参考图片
image2video	全能参考	至少传入 1 张参考图片；可按线路能力组合参考视频、参考音频
frames2video	首尾帧生视频	必须正好传入 2 张参考图片，顺序为首帧、尾帧

mode_type 必须被所选模型和线路支持。

未显式传入 mode_type 时：存在参考图片则按 image2video（全能参考）处理，否则按 text2video 处理。

部分线路对参考图片、视频、音频数量或组合方式有额外限制，具体以创建接口实时校验为准。

请求示例

{
  "model": "sec-seedance-2.0-720p",
  "prompt": "海边日落，镜头缓慢向前推进",
  "seconds": "10",
  "size": "16:9",
  "n": 1,
  "metadata": {
    "resolution": "720p",
    "mode_type": "image2video",
    "images": [
      "https://example.com/reference.jpg"
    ],
    "audios": [
      "https://example.com/music.mp3"
    ]
  }
}

返回参数

HTTP 200：

属性名	类型	必填	说明
id	String	Y	任务 ID，用于查询任务和获取内容
object	String	Y	固定为 `video`
model	String	N	创建任务时使用的模型
status	String	Y	任务状态，见"任务状态"
progress	Integer	N	任务进度，范围 0-100
seconds	String	N	视频时长，单位：秒；图片任务为空
size	String	N	视频或图片画幅比例
created_at	Long	N	创建时间，Unix 秒
completed_at	Long	N	完成时间，Unix 秒；未完成时为空
metadata	Object	N	扩展元信息，完成后可能包含 `result_url`
error	Object	N	任务失败时的错误信息

返回示例

{
  "id": "task_xxxxx",
  "object": "video",
  "model": "sec-seedance-2.0-720p",
  "status": "queued",
  "progress": 0,
  "seconds": "10",
  "size": "16:9",
  "created_at": 1781539200
}

查询生成任务

作用

查询生成任务状态和结果。

提交方式

GET BaseUrl/v1/videos/{video_id}

编码

UTF-8

输入参数

参数名	位置	类型	必填	说明
video_id	Path	String	Y	创建接口返回的 `id`

返回参数

HTTP 200：同"创建生成任务"的返回结构。

返回示例：处理中

{
  "id": "task_xxxxx",
  "object": "video",
  "model": "example-video-model",
  "status": "in_progress",
  "progress": 45,
  "seconds": "10",
  "size": "16:9",
  "created_at": 1781539200
}

返回示例：已完成

{
  "id": "task_xxxxx",
  "object": "video",
  "model": "example-video-model",
  "status": "completed",
  "progress": 100,
  "seconds": "10",
  "size": "16:9",
  "created_at": 1781539200,
  "completed_at": 1781539260,
  "metadata": {
    "result_url": "https://example.com/result.mp4"
  }
}

返回示例：图片任务已完成

{
  "id": "task_xxxxx",
  "object": "video",
  "model": "example-image-model",
  "status": "completed",
  "progress": 100,
  "size": "1:1",
  "created_at": 1781539200,
  "completed_at": 1781539260,
  "metadata": {
    "result_url": "https://example.com/result.png"
  }
}

返回示例：失败

{
  "id": "task_xxxxx",
  "object": "video",
  "model": "example-video-model",
  "status": "failed",
  "progress": 100,
  "seconds": "10",
  "size": "16:9",
  "created_at": 1781539200,
  "completed_at": 1781539260,
  "error": {
    "code": "task_failed",
    "message": "生成失败，请检查文案或素材"
  }
}

获取生成内容

作用

获取生成完成后的内容地址。接口返回 302 重定向，客户端应跟随 Location 下载或播放真实文件。

提交方式

GET BaseUrl/v1/videos/{video_id}/content

编码

UTF-8

输入参数

参数名	位置	类型	必填	说明
video_id	Path	String	Y	创建接口返回的 `id`
variant	Query	String	N	支持空值、`video`、`image`；图片任务可传 `image`

成功响应

HTTP 302：

Header	说明
Location	真实内容文件 URL

seedance 2.0视频接口文档（按秒计费）

目录

BaseUrl

计费方式

适用的模型

说明：tj结尾表示特价模型，价格比较便宜，但稳定性差一些。

重要说明

通用说明

推荐调用流程

任务状态

错误响应

创建生成任务

作用

提交方式

编码

Content-Type

输入参数

metadata 扩展参数

mode_type 规则

请求示例

返回参数

返回示例

查询生成任务

作用

提交方式

编码

输入参数

返回参数

返回示例：处理中

返回示例：已完成

返回示例：图片任务已完成

返回示例：失败

获取生成内容

作用

提交方式

编码

输入参数

成功响应

请求示例

seedance 2.0视频接口文档（按秒计费）

目录#

BaseUrl#

计费方式#

适用的模型#

说明：tj结尾表示特价模型，价格比较便宜，但稳定性差一些。#

重要说明#

通用说明#

推荐调用流程#

任务状态#

错误响应#

创建生成任务#

作用#

提交方式#

编码#

Content-Type#

输入参数#

metadata 扩展参数#

mode_type 规则#

请求示例#

返回参数#

返回示例#

查询生成任务#

作用#

提交方式#

编码#

输入参数#

返回参数#

返回示例：处理中#

返回示例：已完成#

返回示例：图片任务已完成#

返回示例：失败#

获取生成内容#

作用#

提交方式#

编码#

输入参数#

成功响应#

请求示例#

目录

BaseUrl

计费方式

适用的模型

说明：tj结尾表示特价模型，价格比较便宜，但稳定性差一些。

重要说明

通用说明

推荐调用流程

任务状态

错误响应

创建生成任务

作用

提交方式

编码

Content-Type

输入参数

metadata 扩展参数

mode_type 规则

请求示例

返回参数

返回示例

查询生成任务

作用

提交方式

编码

输入参数

返回参数

返回示例：处理中

返回示例：已完成

返回示例：图片任务已完成

返回示例：失败

获取生成内容

作用

提交方式

编码

输入参数

成功响应

请求示例