跳转到主要内容

​
创作流程

由于视频生成耗时较长（通常为 1–5 分钟），接口采用异步模式，大致分为三步：
  1. 创建视频任务：设置视频生成需求，包括视频场景 prompt 要求、时长（5秒/10秒/15秒）、清晰度（标清480P/高清720P/超清1080P）、画面比例（1:1/16:9/9:16）等，提交请求并获取对应的 orderid。
  2. 查看任务状态：根据 orderid 查询视频生成进度与当前状态。
  3. 获取视频结果：当任务完成后，通过返回的 videourl 查看最终视频效果，并进行下载保存。

​
接口说明

基于上文的「创作流程」，文生视频一般分为三个步骤：创建任务 → 等待处理 → 获取结果。

​
步骤一：创建文生视频任务

  • 接口地址：http://gpt.juhe.cn/text2video/generate
  • 请求方式：HTTP POST
  • 返回类型：JSON
  • 接口描述：根据提供的提示词，创建文生视频任务并返回 orderid。

​
请求 Header

名称值
Content-Typeapplication/x-www-form-urlencoded

​
请求参数说明

名称必填类型说明
key是string在个人中心-->数据中心-->我的API中查看，获取当前接口的访问密钥。
prompt是string文本提示词，用来描述期望生成的视频内容与视觉特点，长度不超过 500 字。
negativePrompt否string反向提示词，用来描述不希望在视频画面中看到的内容，可用于限制画面元素，长度不超过 300 字。
resolution否string视频分辨率，默认 480P，仅支持：480P、720P、1080P。分辨率越高，单次调用的消耗也会相应增加。
duration否string视频时长，支持：5、10、15（15 秒暂不支持 480P），默认 5 秒。时长越长，单次调用的消耗越多。
promptExtend否int是否开启 prompt 智能改写，0：关闭；1：开启，默认 1。
notifyUrl否string回调通知 URL，可根据业务需要设定。视频生成完成后会以POST方式将处理结果推送至该地址。
提示词示例（prompt）：
「一幅史诗级可爱的场景。一只小巧可爱的卡通小猫将军，身穿细节精致的金色盔甲，头戴一个稍大的头盔，在大海边捕鱼。」 反向提示词示例（negativePrompt）：
「不要捕到鲨鱼。」

​
计费说明

  • 分辨率基础计费单价：480P = 1 次、720P = 2 次、1080P = 3 次
  • 时长基础计费单价：每 1 秒 = 1 次
  • 总消耗次数 = 分辨率基础计费次数 × 时长秒数
    例如：选择 1080P、10 秒视频，则本次调用约消耗 3 × 10 = 30 次。

​
Curl 请求示例

curl -k -i \
  -d "key=you_key&prompt=一只小巧可爱的卡通小猫将军在海边捕鱼&negativePrompt=&resolution=1080P&duration=10&promptExtend=1&notifyUrl=" \
  "your_notify_url"

​
返回参数说明

名称类型说明
error_codeint状态码
reasonstring状态提示信息。
resultjsonObject返回结果主体。
orderidstring单号（订单 ID）。
orderstatusstring订单状态。
一个典型的 JSON 返回示例为： 
{
  "reason": "成功",
  "result": {
    "orderid": "JH819251208164211x1hC5",
    "orderstatus": "PENDING"
  },
  "error_code": 0
}

​
步骤二：查看任务状态

可基于 orderid 进行状态查询。
  • 接口地址：http://gpt.juhe.cn/text2video/query
  • 请求方式：HTTP POST
  • 返回类型：JSON
  • 接口描述：根据提供的 orderid 查询生成的视频。视频生成过程约需数分钟，建议采用轮询机制，并设置合理的查询间隔（如 15 秒）来获取结果。

​
请求参数说明

名称必填类型说明
key是string在个人中心—>数据中心—>我的API 中查看，对应当前接口的访问密钥
orderId是string在 步骤一：创建文生视频任务 中获得的orderid

​
返回参数说明

名称类型说明
error_codeint状态码
reasonstring状态提示信息
resultjsonObject返回结果主体
codeint生成状态码: 0 — 处理中；1 — 视频生成成功； 2— 视频生成失败
messagestring任务描述
orderidstring单号
orderstatusstring订单状态 , 仅当SUCCEEDED返回videourl
videourlstring生成视频地址, 链接有效期24小时，可通过此URL下载视频。视频格式为MP4（H.264 编码）
任务状态一般会经历如下流转： PENDING（排队中） → RUNNING（处理中） → SUCCEEDED（成功） / FAILED（失败） 一个典型的 JSON 返回示例为： 
{
  "reason": "查询成功",
  "result": {
    "code": 1,
    "message": "视频生成成功",
    "orderid": "JH819251208155619qjWec",
    "orderstatus": "SUCCEEDED",
    "videourl": "https://dashscope-result-bj.oss-accelerate.aliyuncs.com/1d/99/20251208/d9f430f7/fa72c026-1fcc-4935-b50e-96c39db488e9.mp4?Expires=1765267194&OSSAccessKeyId=LTAI5tDUB1cEqFCYhEwWry26&Signature=XKma%2FWR6hARAKpwgxxxxxxxxsA%3D"
  },
  "error_code": 0
}

​
步骤三：获取视频结果

当视频生成完成后，可以通过 步骤二：查看任务状态 中的 orderid 查询获得 videourl 结果。 此外，如果在 步骤一：创建文生视频任务 传入了 notifyUrl参数，系统也会主动向该地址推送。

​
notifyUrl 推送参数示例

参数名示例值说明
code1回调状态码。1 通常表示成功
message视频生成成功回调提示信息
orderidJH82725121516194685EI6下单返回的订单 ID
orderstatusSUCCEEDED订单当前状态
videourlhttps://…/xxx.mp4视频文件的直链地址
前端或服务端在接收到回调后，可根据订单状态与 videourl 完成业务处理，例如记录生成结果、触发下载或通知用户查看生成视频。

​
样例展示

一只小巧可爱的卡通小猫将军在海边捕鱼