> ## Documentation Index > Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # HappyHorse 1.0 Video-Edit 视频编辑 > - HappyHorse 1.0 视频编辑，输入 1 个源视频 + 文本指令完成风格变换、局部替换等 - 可选传入 0~5 张参考图，用于风格 / 主体引导 - **不支持** `duration`：输出视频时长 = `min(输入视频时长, 15)`，由模型决定 - **不支持** `aspect_ratio`：输出宽高比与源视频一致 - **计费规则特殊**：`(输入视频时长 + 输出视频时长) × 分辨率单价`；模型会对超过 15 秒的输入截断按 15 秒计算 - 异步处理模式，使用返回的任务ID [进行查询](/cn/api-manual/task-management/get-task-detail) - 生成的视频链接，有效期为24小时，请尽快保存 ## OpenAPI ````yaml cn/api-manual/video-series/happyhorse1.0/happyhorse-1.0-video-edit.json POST /v1/videos/generations openapi: 3.1.0 info: title: HappyHorse 1.0 Video-Edit 接口 description: HappyHorse 1.0 视频编辑接口，基于源视频 + 文本指令完成风格变换、局部替换等 license: name: MIT version: 1.0.0 servers: - url: https://api.evolink.ai description: 生产环境 security: - bearerAuth: [] tags: - name: 视频生成 description: AI视频生成相关接口 paths: /v1/videos/generations: post: tags: - 视频生成 summary: HappyHorse 1.0 Video-Edit 视频编辑 description: >- - HappyHorse 1.0 视频编辑，输入 1 个源视频 + 文本指令完成风格变换、局部替换等 - 可选传入 0~5 张参考图，用于风格 / 主体引导 - **不支持** `duration`：输出视频时长 = `min(输入视频时长, 15)`，由模型决定 - **不支持** `aspect_ratio`：输出宽高比与源视频一致 - **计费规则特殊**：`(输入视频时长 + 输出视频时长) × 分辨率单价`；模型会对超过 15 秒的输入截断按 15 秒计算 - 异步处理模式，使用返回的任务ID [进行查询](/cn/api-manual/task-management/get-task-detail) - 生成的视频链接，有效期为24小时，请尽快保存 operationId: createHappyHorse10VideoEdit requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/VideoGenerationRequest' examples: with_reference: summary: 带参考图的视频编辑 value: model: happyhorse-1.0-video-edit prompt: 让视频中的角色穿上图片中的条纹毛衣 video_urls: - https://cdn.example.com/source.mp4 image_urls: - https://cdn.example.com/sweater.jpg quality: 720p keep_original_sound: true style_transfer: summary: 风格变换（无参考图） value: model: happyhorse-1.0-video-edit prompt: 把视频背景换成雪山 video_urls: - https://cdn.example.com/source.mp4 quality: 1080p keep_original_sound: false responses: '200': description: 视频生成任务创建成功 content: application/json: schema: $ref: '#/components/schemas/VideoGenerationResponse' '400': description: 请求参数错误 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: missing_video_urls message: happyhorse-1.0-video-edit requires video_urls or video_url type: invalid_request_error '401': description: 未认证、Token无效或过期 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: unauthorized message: Invalid or expired token type: authentication_error '402': description: 配额不足、需要充值 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: insufficient_quota message: Insufficient quota. Please top up your account. type: insufficient_quota '403': description: 无权限访问 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: model_access_denied message: >- Token does not have access to model: happyhorse-1.0-video-edit type: invalid_request_error '429': description: 请求频率超限 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: rate_limit_exceeded message: Too many requests, please try again later type: rate_limit_error '500': description: 服务器内部错误 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: internal_error message: Internal server error type: api_error components: schemas: VideoGenerationRequest: type: object required: - model - prompt - video_urls properties: model: type: string description: 视频生成模型名称 enum: - happyhorse-1.0-video-edit default: happyhorse-1.0-video-edit example: happyhorse-1.0-video-edit prompt: type: string description: |- 编辑指令文本，**必填** **长度限制：** - 中文：最多 `2500` 个字符 - 非中文：最多 `5000` 个字符 - 超长部分将被自动截断 **提示词技巧：** - 使用编辑指令而非创作描述 - 例如：`将主角的衣服换成图片中的条纹毛衣`、`把视频背景换成雪山` example: 让视频中的角色穿上图片中的条纹毛衣 video_urls: type: array description: |- 待编辑的源视频 URL，**必填**，**仅 1 个**（取数组第 1 个） **输入视频要求：** - 支持格式：MP4、MOV（建议 H.264 编码） - 时长：`3` ~ `60` 秒 - 模型会对超过 `15` 秒的输入自动截取前 `15` 秒 - 分辨率：长边 ≤ `2160` 像素，短边 ≥ `320` 像素 - 宽高比：`1:2.5` ~ `2.5:1` - 文件大小：≤ `100MB` - 帧率：> `8` fps - 视频 URL 必须**公网可访问（HTTP 或 HTTPS）**，不支持私有 OSS、内网或需要鉴权的链接 **兼容字段：** 也接受 `video_url` / `video`（优先级低于 `video_urls`） items: type: string format: uri minItems: 1 maxItems: 1 example: - https://cdn.example.com/source.mp4 image_urls: type: array description: |- 参考图像 URL 数组，**可选**，**0 ~ 5 张** 用于风格 / 主体引导。 **输入图片要求：** - 支持格式：JPEG、JPG、PNG、WEBP - 分辨率：宽高均 ≥ `300` 像素 - 宽高比：`1:2.5` ~ `2.5:1` - 单张大小：≤ `10MB` - 图像 URL 必须**公网可访问（HTTP 或 HTTPS）** items: type: string format: uri maxItems: 5 example: - https://cdn.example.com/sweater.jpg keep_original_sound: type: boolean description: |- 是否保留输入视频的原始声音，默认为 `false` **可选值：** - `true`：保留输入视频的原始声音 - `false`：不保留原始声音，由模型生成新声音 default: false example: false quality: type: string description: |- 视频分辨率档位，默认为 `720p` **可选值：** - `720p`：标准清晰度，此为默认值 - `1080p`：高清清晰度 **计费提示：** 分辨率档位直接影响计费，详见模型计费规则 enum: - 720p - 1080p default: 720p example: 720p seed: type: integer description: |- 随机种子，默认随机 **说明：** - 取值范围：`1` ~ `2147483647` - 固定 seed 可在调试 prompt 时降低参数变化的干扰，提升结果可复现性 minimum: 1 maximum: 2147483647 example: 42 callback_url: type: string description: |- 任务完成后的 HTTPS 回调地址 **回调时机：** - 任务完成（completed）、失败（failed）或取消（cancelled）时触发 - 在计费确认完成后发送 **安全限制：** - 仅支持 HTTPS 协议 - 禁止回调到内网 IP 地址（127.0.0.1、10.x.x.x、172.16-31.x.x、192.168.x.x 等） - URL 长度不超过 `2048` 字符 **回调机制：** - 超时时间：`10` 秒 - 失败后最多重试 `3` 次（分别在失败后 `1`/`2`/`4` 秒重试） - 回调响应体格式与任务查询接口返回格式一致 - 返回 2xx 状态码视为成功，其他状态码触发重试 format: uri example: https://your-domain.com/webhooks/video-task-completed VideoGenerationResponse: type: object properties: created: type: integer description: 任务创建时间戳 example: 1761313744 id: type: string description: 任务ID example: task-unified-1761313744-h1edgh12 model: type: string description: 实际使用的模型名称 example: happyhorse-1.0-video-edit object: type: string enum: - video.generation.task description: 任务的具体类型 progress: type: integer description: 任务进度百分比 (0-100) minimum: 0 maximum: 100 example: 0 status: type: string description: 任务状态 enum: - pending - processing - completed - failed - cancelled example: pending task_info: $ref: '#/components/schemas/VideoTaskInfo' description: 视频任务详细信息 type: type: string enum: - text - image - audio - video description: 任务的输出类型 example: video usage: $ref: '#/components/schemas/VideoUsage' description: 使用量和计费信息 ErrorResponse: type: object properties: error: type: object properties: code: type: string description: 错误代码标识符 message: type: string description: 错误描述信息 type: type: string description: 错误类型 VideoTaskInfo: type: object properties: can_cancel: type: boolean description: 任务是否可以取消 example: true estimated_time: type: integer description: 预估完成时间（秒） minimum: 0 example: 2400 video_duration: type: integer description: 输出视频时长（秒），等于 min(输入视频时长, 15) example: 6 VideoUsage: type: object description: >- 使用量和计费信息。EDIT 计费 = (输入视频时长 + 输出视频时长) × 分辨率单价；预扣费基于本地探测到的输入时长 × 2 估算，实扣费以模型返回的 usage 字段为准修正 properties: billing_rule: type: string description: 计费规则 enum: - per_call - per_token - per_second example: per_second credits_reserved: type: number description: 预估消耗积分数（基于输入时长 × 2 预扣） minimum: 0 example: 1608660 user_group: type: string description: 用户组类别 example: default securitySchemes: bearerAuth: type: http scheme: bearer description: |- ##所有接口均需要使用Bearer Token进行认证## **获取 API Key：** 访问 [API Key 管理页面](https://evolink.ai/dashboard/keys) 获取您的 API Key **使用时在请求头中添加：** ``` Authorization: Bearer YOUR_API_KEY ``` ````