> ## 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.1 Text-to-Video 文生视频 > - HappyHorse 1.1 文生视频，仅文本提示词输入即可生成视频 - 异步处理模式，使用返回的任务ID [进行查询](/cn/api-manual/task-management/get-task-detail) - 生成的视频链接，有效期为24小时，请尽快保存 ## OpenAPI ````yaml cn/api-manual/video-series/happyhorse1.1/happyhorse-1.1-text-to-video.json POST /v1/videos/generations openapi: 3.1.0 info: title: HappyHorse 1.1 Text-to-Video 接口 description: HappyHorse 1.1 文生视频接口，仅文本提示词输入即可生成视频 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.1 Text-to-Video 文生视频 description: >- - HappyHorse 1.1 文生视频，仅文本提示词输入即可生成视频 - 异步处理模式，使用返回的任务ID [进行查询](/cn/api-manual/task-management/get-task-detail) - 生成的视频链接，有效期为24小时，请尽快保存 operationId: createHappyHorse11TextToVideo requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/VideoGenerationRequest' examples: basic: summary: 基础文生视频 value: model: happyhorse-1.1-text-to-video prompt: 一座由硬纸板和瓶盖搭建的微型城市，在夜晚焕发出生机。一列硬纸板火车缓缓驶过，小灯点缀其间，照亮前路。 quality: 720p aspect_ratio: '16:9' duration: 5 seed: 42 high_quality: summary: 1080P 高清文生视频 value: model: happyhorse-1.1-text-to-video prompt: >- 第 1 个镜头 [0~3 秒] 全景：黄昏的海面上，一艘古帆船破浪前行；第 2 个镜头 [3~6 秒] 中景：船头水手望向远方礁石灯塔。 quality: 1080p aspect_ratio: '16:9' duration: 6 responses: '200': description: 视频生成任务创建成功 content: application/json: schema: $ref: '#/components/schemas/VideoGenerationResponse' '400': description: 请求参数错误 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: invalid_request message: Invalid request parameters 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.1-text-to-video 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 properties: model: type: string description: 视频生成模型名称 enum: - happyhorse-1.1-text-to-video default: happyhorse-1.1-text-to-video example: happyhorse-1.1-text-to-video prompt: type: string description: |- 文本提示词，**必填** **长度限制：** - 中文：最多 `2500` 个字符 - 非中文：最多 `5000` 个字符 - 超长部分将被自动截断 **提示词技巧：** - 鼓励使用详细分镜描述获得更好的多镜头叙事效果 - 例如：`第 1 个镜头 [0~3 秒] 全景：...； 第 2 个镜头 [3~6 秒] 中景：...` example: 一座由硬纸板和瓶盖搭建的微型城市，在夜晚焕发出生机。一列硬纸板火车缓缓驶过，小灯点缀其间，照亮前路。 quality: type: string description: |- 视频分辨率档位，默认为 `720p` **可选值：** - `720p`：标准清晰度，此为默认值 - `1080p`：高清清晰度 **计费提示：** 分辨率档位直接影响计费，详见模型计费规则 enum: - 720p - 1080p default: 720p example: 720p aspect_ratio: type: string description: |- 视频宽高比，默认为 `16:9` **可选值：** - `16:9`（横屏） - `9:16`（竖屏） - `1:1`（方形） - `4:3` - `3:4` - `4:5` - `5:4` - `9:21` - `21:9` enum: - '16:9' - '9:16' - '1:1' - '4:3' - '3:4' - '4:5' - '5:4' - '9:21' - '21:9' default: '16:9' example: '16:9' duration: type: integer description: |- 视频时长（秒），默认为 `5` 秒 **取值范围：** - 整数 `3` ~ `15` - 时长与计费直接相关 default: 5 minimum: 3 maximum: 15 example: 5 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-h1t2vab8 model: type: string description: 实际使用的模型名称 example: happyhorse-1.1-text-to-video 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: 视频时长（秒） example: 5 VideoUsage: type: object description: 使用量和计费信息 properties: billing_rule: type: string description: 计费规则 enum: - per_call - per_token - per_second example: per_second credits_reserved: type: number description: 预估消耗积分数 minimum: 0 example: 607500 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 ``` ````