wellapi2接口文档
    • seedance 2.0视频接口文档(按token计费)
    • seedance 2.0视频接口文档(按秒计费)
    • gpt-image-2/2.5(1k,2k,4k)图片生成API文档
    • Nano Banana Pro 及 Nano Banana 2 API 文档
    • gpt-image-2.5 API文档,支持10万并发

    seedance 2.0视频接口文档(按token计费)

    Seedance 模型分辨率支持对照表#

    名称名称模型调用ID480p720p1080p4K
    seedance 2.5满血版artsdance-2-5-pro-26080❌✅✅❌
    seedance 2.0满血版artsdance-2-0-pro-260801✅✅✅✅
    seedance 2.0 fast版artsdance-2-0-fast-260801✅✅✅❌
    seedance 2.0 mini版artsdance-2-0-mini-260801✅✅✅❌

    1. 提交视频生成任务 (POST)#

    HTTP Method: POST
    请求路径: https://wellapi.cc/v1/video/generations
    鉴权头部: Authorization: Bearer sk-your_token

    A. 经典文生视频#


    B. 单图/首尾帧图生视频#

    通过传入 1 或 2 张图片 URL,网关会自动将第一张图识别为首帧(若传 2 张,则第二张自动识别为尾帧),生成连贯平滑的动态视频。

    C. 多图外观/主体参考生视频(不含视频参考)#

    当您想指定多张图片作为外观参考时,可以使用带有指定角色的对象数组。在没有视频参考时,网关底层的 role 字段(也可以使用 type 字段完全等价替代)应指定为 "reference_image"。

    D. 图像参考 + 视频参考多模态混合生成#

    火山 Seedance 支持「图像参考(控制主体外观)+ 视频参考(控制镜头/运动轨迹)」混合生成。若请求中同时包含 videos,所有 images 均会被自动识别为外观参考(本示例中采用 type 字段演示等价替换 role 的形式)。

    2. 轮询获取任务结果 (GET)#

    请求路径: /v1/video/generations/{task_id}

    3. 完整参数字典说明#

    OpenAI 兼容参数名类型必填默认值描述与限制
    modelstring✅ 是-目标视频生成模型名,传入 doubao-seedance-2-0 等。
    promptstring✅ 是-视频生成画面与动作描述提示词。对中文理解极佳。
    images / image_urlsarray否-图片参考数组。智能模式下:1张为首帧,2张为首尾帧。支持使用对象形式指定 role 或其等价字段 type(如 "first_frame", "last_frame", "reference_image")。
    videosarray否-视频参考链接数组。传入网络直链视频 URL,用于控制视频生成的运动、背景或场景。
    audiosarray否-音频参考链接数组。传入网络直链音频 URL(如音乐或人声),实现视频声画融合。
    resolutionstring否"720p"目标视频清晰度。可选 "720p"、"1080p"。
    ratiostring否"16:9"目标画幅比例。可选 "16:9", "9:16", "4:3", "3:4", "1:1"。
    durationinteger否5视频时长(秒),可选 5 到 15。
    camera_fixedboolean否false是否锁定镜头(不使用镜头运镜,保持静态视角拍摄)。
    generate_audioboolean否false是否同步生成匹配的视频背景环境音效。
    web_searchboolean否false是否启用联网搜索(OpenAI 兼容布尔开关)。网关会自动转换为火山方舟等通道所需格式。
    seedinteger否-随机种子值,用于多次生成时的效果控制。

    4. 返回结果示例 (200 OK)#

    提交任务响应:
    {
      "id": "video_task_abc123",
      "task_id": "video_task_abc123",
      "status": "pending",
      "message": "Task submitted successfully"
    }
    查询结果响应(已完成):
    {
      "id": "video_task_abc123",
      "task_id": "video_task_abc123",
      "status": "completed",
      "data": [
        {
          "url": "https://example.com/output/generated_video.mp4"
        }
      ]
    }

    5. 常见失败返回示例#

    本平台接口遵循标准的 HTTP 状态码与统一的 JSON 错误响应格式,便于您进行异常处理。
    状态码含义常见原因
    400 Bad Request参数错误 / 模型不存在model 拼写错误、JSON 格式不规范、缺少必填字段
    401 UnauthorizedAPI Key 无效 / 未授权Token 错误或已过期
    429 Too Many Requests余额不足 / 频控限制账户余额耗尽或请求过于频繁
    400 错误响应示例:
    {
      "error": {
        "message": "The model does not exist or you do not have access to it.",
        "type": "invalid_request_error",
        "param": "model",
        "code": "model_not_found"
      }
    }
    排查建议:
    检查请求体中的 model 字段值是否正确,参考「开放端点一览表」中的可用模型。
    使用 JSON 校验工具检查请求体格式,确保逗号和括号闭合正确。
    修改于 2026-09-23 13:17:43
    下一页
    seedance 2.0视频接口文档(按秒计费)
    Built with