视频（OpenAI 风格）

创建视频任务

curl --request POST \
  --url https://models.rivus.cn/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form model=sora-2 \
  --form 'prompt=百事可乐宣传片' \
  --form seconds=4 \
  --form size=720x1280

import requests

url = "https://models.rivus.cn/v1/videos"

payload = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"model\"\r\n\r\nsora-2\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\n百事可乐宣传片\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"seconds\"\r\n\r\n4\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"size\"\r\n\r\n720x1280\r\n-----011000010111000001101001--"
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "multipart/form-data"
}

response = requests.post(url, data=payload, headers=headers)

print(response.text)

const form = new FormData();
form.append('model', 'sora-2');
form.append('prompt', '百事可乐宣传片');
form.append('seconds', '4');
form.append('size', '720x1280');

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

options.body = form;

fetch('https://models.rivus.cn/v1/videos', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://models.rivus.cn/v1/videos",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"model\"\r\n\r\nsora-2\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\n百事可乐宣传片\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"seconds\"\r\n\r\n4\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"size\"\r\n\r\n720x1280\r\n-----011000010111000001101001--",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: multipart/form-data"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://models.rivus.cn/v1/videos"

	payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"model\"\r\n\r\nsora-2\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\n百事可乐宣传片\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"seconds\"\r\n\r\n4\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"size\"\r\n\r\n720x1280\r\n-----011000010111000001101001--")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://models.rivus.cn/v1/videos")
  .header("Authorization", "Bearer <token>")
  .body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"model\"\r\n\r\nsora-2\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\n百事可乐宣传片\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"seconds\"\r\n\r\n4\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"size\"\r\n\r\n720x1280\r\n-----011000010111000001101001--")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://models.rivus.cn/v1/videos")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"model\"\r\n\r\nsora-2\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\n百事可乐宣传片\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"seconds\"\r\n\r\n4\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"size\"\r\n\r\n720x1280\r\n-----011000010111000001101001--"

response = http.request(request)
puts response.read_body

{
  "id": "video_691209aab0a08198a4e78870277f7e3d0215e09cec47a737",
  "object": "video",
  "created_at": 1762789802,
  "status": "queued",
  "model": "sora-2",
  "prompt": "百事可乐宣传片",
  "progress": 0,
  "seconds": "4",
  "size": "720x1280"
}

{
  "error": {
    "message": "Invalid request parameters",
    "type": "invalid_request_error",
    "code": "invalid_parameters"
  }
}

{
  "error": {
    "message": "Invalid request parameters",
    "type": "invalid_request_error",
    "code": "invalid_parameters"
  }
}

{
  "error": {
    "message": "Invalid request parameters",
    "type": "invalid_request_error",
    "code": "invalid_parameters"
  }
}

POST

videos

创建视频任务

curl --request POST \
  --url https://models.rivus.cn/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form model=sora-2 \
  --form 'prompt=百事可乐宣传片' \
  --form seconds=4 \
  --form size=720x1280

import requests

url = "https://models.rivus.cn/v1/videos"

payload = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"model\"\r\n\r\nsora-2\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\n百事可乐宣传片\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"seconds\"\r\n\r\n4\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"size\"\r\n\r\n720x1280\r\n-----011000010111000001101001--"
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "multipart/form-data"
}

response = requests.post(url, data=payload, headers=headers)

print(response.text)

const form = new FormData();
form.append('model', 'sora-2');
form.append('prompt', '百事可乐宣传片');
form.append('seconds', '4');
form.append('size', '720x1280');

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

options.body = form;

fetch('https://models.rivus.cn/v1/videos', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://models.rivus.cn/v1/videos",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"model\"\r\n\r\nsora-2\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\n百事可乐宣传片\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"seconds\"\r\n\r\n4\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"size\"\r\n\r\n720x1280\r\n-----011000010111000001101001--",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: multipart/form-data"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://models.rivus.cn/v1/videos"

	payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"model\"\r\n\r\nsora-2\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\n百事可乐宣传片\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"seconds\"\r\n\r\n4\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"size\"\r\n\r\n720x1280\r\n-----011000010111000001101001--")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://models.rivus.cn/v1/videos")
  .header("Authorization", "Bearer <token>")
  .body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"model\"\r\n\r\nsora-2\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\n百事可乐宣传片\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"seconds\"\r\n\r\n4\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"size\"\r\n\r\n720x1280\r\n-----011000010111000001101001--")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://models.rivus.cn/v1/videos")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"model\"\r\n\r\nsora-2\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\n百事可乐宣传片\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"seconds\"\r\n\r\n4\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"size\"\r\n\r\n720x1280\r\n-----011000010111000001101001--"

response = http.request(request)
puts response.read_body

{
  "id": "video_691209aab0a08198a4e78870277f7e3d0215e09cec47a737",
  "object": "video",
  "created_at": 1762789802,
  "status": "queued",
  "model": "sora-2",
  "prompt": "百事可乐宣传片",
  "progress": 0,
  "seconds": "4",
  "size": "720x1280"
}

{
  "error": {
    "message": "Invalid request parameters",
    "type": "invalid_request_error",
    "code": "invalid_parameters"
  }
}

{
  "error": {
    "message": "Invalid request parameters",
    "type": "invalid_request_error",
    "code": "invalid_parameters"
  }
}

{
  "error": {
    "message": "Invalid request parameters",
    "type": "invalid_request_error",
    "code": "invalid_parameters"
  }
}

本文档使用统一的 OpenAI 风格接口，不涉及任何上游供应商信息。你可以直接用 Bearer Token 调用 /v1/videos 创建任务，并用 /v1/videos/{id} 查询进度、/v1/videos/{id}/content 下载成片。

认证

Authorization: Bearer <Token>

export BASE_URL="https://models.rivus.cn/v1"
export TOKEN="oh-xxxxxxxxxxxxxxxx"

可用模型

veo-3.1-fast-generate-preview（快速出片）
veo-3.1-generate-preview（标准质量）

后续如有新增型号，可在“可用模型”接口或控制台查看，无需改动调用方式。

文生视频（JSON）

注意：seconds 需以字符串提交（JSON 标签为 ,string）。

curl -X POST "$BASE_URL/videos" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1-fast-generate-preview",
    "prompt": "a cinematic lion at sunset",
    "seconds": "6",
    "size": "1280x720"
  }'

成功时返回：

{
  "id": "video_xxx",
  "object": "video",
  "model": "veo-3.1-fast-generate-preview",
  "status": "queued",
  "progress": 0,
  "created_at": 1761234567,
  "seconds": "6",
  "size": "1280x720"
}

图生视频（multipart）

通过 input_reference 字段上传 1–3 张参考图（可重复多次）：

curl -X POST "$BASE_URL/videos" \
  -H "Authorization: Bearer $TOKEN" \
  -F "model=veo-3.1-fast-generate-preview" \
  -F "prompt=Neon rain street, cinematic" \
  -F "seconds=6" \
  -F "size=1280x720" \
  -F "input_reference=@tmp/veo_refs/ref1_1280x720.jpg" \
  -F "input_reference=@tmp/veo_refs/ref2_720x1280.jpg"

查询任务

curl "$BASE_URL/videos/{video_id}" \
  -H "Authorization: Bearer $TOKEN"

完成后响应会包含直链：video_url（或 result.video_url）。

下载视频

curl -L "$BASE_URL/videos/{video_id}/content" \
  -H "Authorization: Bearer $TOKEN" \
  --output out.mp4

网关会统一代理视频直链，保证下载稳定性与安全性；无需关心实际存储来源。

API 调试面板（可直接试用）

本页已嵌入 POST /v1/videos 的调试面板（见页首）。你可以：

选择模型与参数，发起创建请求；
复制返回的 id，再用 cURL 调用查询/下载接口；
若你使用 SDK，也可直接复用同样的请求体结构。

参数说明

model：视频生成模型（必填）
prompt：文本提示词（建议英文或中英混合）
seconds：视频时长（秒，JSON 需以字符串提交）
size：分辨率（如 1280x720、720x1280、1920x1080、1080x1920）
input_reference：参考图（multipart 下可重复 1–3 次）
extend_from：基于历史成片续写（部分型号/时长可能受限）

最佳实践

1080p 场景建议配合 8 秒时长；其余尺寸常用 4/6/8 秒。
图生视频优先提供与目标画幅一致的参考图（横版/竖版）。
轮询查询时使用 6–10 秒退避，避免过于频繁的请求。

计费

按视频时长（秒）计费。若响应无法解析到时长，可在查询时追加 ?duration=6 明确计费秒数。

Authorizations

Authorization

string

header

required

使用 API Key 作为 Bearer Token

Body

multipart/form-data

model

enum<string>

required

模型名称

Available options:

sora-2,

sora-2-pro

Example:

"sora-2"

prompt

string

required

视频生成的文本描述，最多 1000 个字符

Maximum string length: 1000

Example:

"百事可乐宣传片"

seconds

enum<integer>

视频时长（秒）。sora-2 支持 4、8、10、12、15 秒，默认 10；sora-2-pro 支持 4、8、12、15、25 秒，默认 15

Available options:

4,

8,

10,

12,

15,

25

Example:

4

size

enum<string>

default:1280x720

视频分辨率

Available options:

1280x720,

1920x1080,

720x1280,

1080x1920

Example:

"720x1280"

Response

任务创建成功

string

视频任务的唯一标识符

Example:

"video_691209aab0a08198a4e78870277f7e3d0215e09cec47a737"

object

enum<string>

对象类型

Available options:

video

Example:

"video"

created_at

integer

创建时间戳（Unix 时间）

Example:

1762789802

completed_at

integer

任务完成时间戳（仅在 completed 状态下存在）

Example:

1762789891

expires_at

integer

视频过期时间戳（仅在 completed 状态下存在）

Example:

1762793491

model

string

使用的模型名称

Example:

"sora-2"

status

enum<string>

任务状态

Available options:

queued,

processing,

completed,

failed

Example:

"queued"

prompt

string

生成视频的文本描述

Example:

"一个无人机从海滩升空拍摄夕阳"

progress

integer

处理进度（0-100）

Required range: 0 <= x <= 100

Example:

0

seconds

string

视频时长（字符串格式）

Example:

"10"

size

string

视频分辨率

Example:

"1280x720"

assets

object[]

生成的视频资源数组，仅在 completed 状态下存在（部分供应商可能不返回此字段，需通过 /content 端点下载）

Show child attributes

parent_video_id

string

父视频 ID（仅 Remix 任务返回）

Example:

"video_691209aab0a08198a4e78870277f7e3d0215e09cec47a737"

error

object

错误信息，仅在 failed 状态下存在

Show child attributes

图像生成 (原生 API)查询视频（OpenAI 风格）

概述

核心功能

图像生成

OpenAI 风格 API

Gemini 原生 API

其他

认证

可用模型

文生视频（JSON）

图生视频（multipart）

查询任务

下载视频

API 调试面板（可直接试用）

参数说明

最佳实践

计费

Authorizations

Body

Response

​认证

​可用模型

​文生视频（JSON）

​图生视频（multipart）

​查询任务

​下载视频

​API 调试面板（可直接试用）

​参数说明

​最佳实践

​计费

Authorizations

Body

Response

认证

可用模型

文生视频（JSON）

图生视频（multipart）

查询任务

下载视频

API 调试面板（可直接试用）

参数说明

最佳实践

计费