跳转到主要内容

​
创作流程

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

​
接口说明

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

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

  • 接口地址：https://gpt.juhe.cn/text2video/baseimg
  • 请求方式：HTTP POST
  • 返回类型：JSON
  • 接口描述：根据提供的首帧图像（可设定配套的音频文件）和文本提示词 prompt，创建图生视频任务并返回 orderid。

​
请求 Header

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

​
请求参数说明

名称必填类型说明
key是string在个人中心-->数据中心-->我的API中查看，获取当前接口的访问密钥。
prompt是string文本提示词，用来描述生成视频中期望包含的元素和视觉特点，长度不超过 500 字。
image是string首帧图像的URL或Base64编码数据。图像格式支持 JPEG、JPG、PNG、BMP、WEBP，base64数据格式：data:{MIME_type};base64,{base64_data}，文件大小不超过5M。
audioUrl否string音频文件的URL，模型将使用该音频生成视频。支持 wav、mp3，时长 3～30 秒，文件大小不超过 10MB。若音频长度超过 duration 值，自动截取；若不足视频时长，超出部分为无声视频。
negativePrompt否string反向提示词，用来描述不希望在视频画面中看到的内容，可用于限制画面元素，长度不超过 300 字。
resolution否string视频分辨率，支持：480P、720P、1080P,默认 480P。分辨率越高，单次调用的消耗也会相应增加。
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=your_key&prompt=镜头向前推进，空间站上的咖啡厅，窗外宇宙飞船驶过&image=xxx&audioUrl=&negativePrompt=&resolution=1080P&duration=5&promptExtend=1&notifyUrl=" \
  "your_notify_url"

​
返回参数说明

名称类型说明
error_codeint状态码（建议超时时长设置在 60s）
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视频文件的直链地址
回调请求说明：
  • 请求方式：POST
  • Content-Type：application/x-www-form-urlencoded
前端或服务端在接收到回调后，可根据订单状态与 videourl 完成业务处理，例如记录生成结果、触发下载或通知用户查看生成视频。

​
样例展示

镜头向前推进，空间站上的咖啡厅，窗外宇宙飞船驶过