文生视频HR(算法编码：8005100001)

接口信息

API Path
/aipaas/lm/v1/video/texthr

请求协议
HTTPS

请求方法
POST

请求头部：

头部标签	必填	说明	类型	数据字典	限制	头部内容	示例
Content-Type	是	application/json	[string]			application/json	application/json
X-APP-ID	是	买家中心-已购能力-【X-APP-ID】	[string]
Device-Uuid	否	设备管理-设备uuid	[string]
Authorization	是	鉴权信息	[string]

请求参数 Json
Object

参数名	说明	必填	类型	数据字典	限制	示例
seq_id	请求序列号，请求的唯一标识，建议长度不超过256	是	[string]
task_id	能力编号 文生视频-30003	是	[int]
prompt	文本内容，支持中英文，建议不超过256	是	[string]
resolution	[480,480],[720,720]或[1080,1080]，默认值[720,720] （仅适用文生视频HRV1.0.0：该参数表示的是生成视频的分辨率为480p/720p/1080P）	否	[array]
resolution_ratio	视频比例，宽:高，仅支持 [16,9], [9,16], [4,3], [3,4], [2,3], [3,2], [1,1]七种，默认[16,9]	否	[array]
extra_message	算法其他输入，见详细说明5.请求参数示例	否	[array]
callback_url	接收回调结果的url地址，return_mode为0是必传	否	[string]
return_mode	结果返回模式，0:push，1:pull，默认为0。push模式即提供callback_url接收最终结果回调；pull模型即通过大模型异步调用结果回查接口查询最终调用结果，接口文档详见开发指南下的大模型异步调用结果回查。	否	[int]

响应内容：

返回结果

> 成功 (200)
> Json
> Object

参数名	说明	必填	类型	数据字典	限制	示例
msg	调用结果描述。参考错误编码规范	是	[string]
code	状态响应码。参考错误编码规范	是	[string]
requestId	请求ID，用于调用查询大模型生成结果信息接口	是	[string]

成功示例[Mock API]：

{
    "msg": "调用成功",
    "code": "10000",
    "requestId": "tushengshipin"
}

详细说明：

1. 功能简介

文生视频高清版，根据文字提示词生成视频，分辨率最高支持1080p，一段视频时长约5s。

V1.2.0

• 画质修复，速度提升，压缩模型体积40%

V1.0.0

• 首次支持1080p高清视频（分辨率支持：1080p，720p，480p）
• 高清视频快速生成，1080p视频推理耗时2分30秒
• 支持7种尺寸比例：1:1，2:3，3:2，3:4，4:3，9:16，16:9

2. 修订历史

日期	版本	修订内容
2025-10-28	v1.2.0	入参extra_message新增enable_prompt_enhance字段；修改部分入参说明
2025-09-18	v1.0.0	初始化API文档

3. 服务鉴权

服务接口调用时需要严格遵循服务鉴权规则，服务调用鉴权规则请参见：开发指南 - 接口签名认证。

4. 状态码说明

返回编码	返回信息	说明
10000	服务执行成功	服务执行成功
10202	算法推理异常	算法推理失败，生成结果文件失败
10203	文件上传异常	结果文件上传ceph/minIO失败
10301	服务必填参数缺失	服务必填参数缺失或未填写
10304	服务入参错误	部分参数存在限制说明，会针对入参做校验返回
10401	任务繁忙	生成视频任务执行中，请稍后
10406	视频封面图获取异常	视频截取首帧图失败
10903	服务执行失败	服务执行失败(可能存在组件连接异常、算法模型程序运行异常等情况，导致服务无法正常运行)

通用状态码请参考【状态码】中的【网关认证】

5. 请求参数示例

请求入参中extra_message参数说明

extra_message		Array	说明
	"key":"video_seed “	string	视频算法种子
	"value": 100	int	不填默认100
	"key":"negative_prompt“	string	视频生成负向提示词
	"value": ""	string	不填默认""
	"key":"enable_prompt_enhance“	string	是否启用提示词增强，启用后需配置llm
	"value": true	bool	默认true
extra_message入参示例如下：

"extra_message": [{
	"key": "video_seed",
	"value": 100
}, {
	"key": "negative_prompt",
	"value": ""
}, {
	"key": "enable_prompt_enhance",
	"value": true
}]

请求示例如下：

{
	"seq_id": "seq_id",
	"task_id": 30003,
	"prompt": " she is dancing in the sun",
	"callback_url": "<http://callbackUrl>",
	"extra_message": [{
		"key": "video_seed",
		"value": 42
	}]
}

6. 回告结果

接口回告结果信息详见同级目录下的【回告数据结构】。

7. 调用示例

7.1 Java版本

import cn.hutool.http.HttpRequest;
import cn.hutool.http.HttpResponse;
import cn.hutool.json.JSONUtil;

import java.util.Arrays;
import java.util.HashMap;
import java.util.Map;

/** 主类，用于发起HTTP请求并处理响应 */
public class Example {

    public static void main(String[] args) {
        example();
    }

    /**
     * 方法中使用到的 JSONUtil、HttpRequest、HttpResponse均来自Hutool工具类。
     * 具体maven依赖为：
     * 
     *     cn.hutool
     *     hutool-all
     *     5.8.29
     * 
     */
    public static void example() {
        try {
            String url = "算法调用地址";
            // 设置请求头
            Map headers = new HashMap();
            //调用鉴权
            headers.put("Content-Type", "application/json");
            headers.put("X-APP-ID", "yourAppId");
            headers.put("Authorization", "yourAuthorization");
		
            // 创建请求对象
            Map request = new HashMap();
            request.put("seq_id", "test001");
            request.put("task_id", 30003);
            request.put("prompt", "she is dancing in the sun");
            request.put("callback_url", "<http://callbackUrl>");
            // 将请求对象转换为JsonNode
            String requestString = JSONUtil.toJsonStr(request);

            // 发起HTTP请求
            HttpResponse response =
                    HttpRequest.post(url)
                            .headerMap(headers, true)
                            .body(requestString)
                            .execute();
            // 输出响应结果
            System.out.println(response.body());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

}

7.2 Python版本

import json
import hashlib
import hmac
import time
import re
import urllib.parse
import requests
import warnings
from datetime import datetime
import logging

# 配置日志，设置日志级别为INFO，并指定日志格式
logging.basicConfig(level=logging.INFO, format='%(asctime)s - %(levelname)s - %(message)s')

# 配置环境变量
X_APP_ID = "yourAppId"
AUTHORIZATION = "yourAuthorization"

# URL 和请求数据
url = "算法调用地址"  # 请求的URL
request_data = {
    "seq_id": "test001",
    "task_id": 30003,
    "prompt": "she is dancing in the sun",
    "callback_url": "<http://callbackUrl>"
}

# 构建请求头
headers = {
    "Content-Type": "application/json",
    "X-APP-ID": X_APP_ID,
    "Authorization": AUTHORIZATION
}


def timeSimple(timestamp):
    # 将时间戳转换为HH:MM:SS格式的时间字符串
    dt_object = datetime.fromtimestamp(timestamp)
    formatted_time = dt_object.strftime("%H:%M:%S")
    return formatted_time


def send_request(url):
    try:
        start_time = time.time()
        logging.info(f"请求路径: {url}")
        logging.info(f"开始发送: {timeSimple(start_time)}")

        with requests.post(
            url, json=request_data, headers=headers, stream=True, verify=False
        ) as response:
            first_packet_time = None
            if response.status_code == 200:
                logging.info(f"接受到返回: {timeSimple(time.time())}")

                for chunk in response.iter_content(chunk_size=1024):
                    if chunk:
                        if first_packet_time is None:
                            first_packet_time = time.time()
                        logging.info(
                            f"Received chunk: {timeSimple(time.time())} {chunk.decode('utf-8')}"
                        )

                end_time = time.time()
                logging.info(f"Time to first byte (TTFB): {first_packet_time - start_time:.3f} seconds")
                logging.info(f"Request completed in {end_time - start_time:.3f} seconds")
            else:
                logging.error(f"Request failed with status code {response.status_code}")
    except Exception as e:
        logging.error(f"An error occurred: {e}")


# 发送请求
send_request(url)
logging.info(f"headers = {headers}")