Roko API
控制台

已上线

Vidu Q3 Pro 开发指南

更新于 2026-09-02

Vidu Q3 Pro 当前状态为“已上线”。本页提供开发接入所需的模型 ID、定价快照与可复制示例；产品介绍与实时价格见 Vidu Q3 Pro 模型页。

简介

  • 供应商：Vidu
  • 类型：视频生成
  • 档位数：1
  • 端点标签：openai, video-task

此视频模型使用异步任务接口：提交 `POST /v1/videos/tasks` 后，通过 `GET /v1/tasks/{task_id}` 查询进度和结果。

可用档位与价格

请求里的 model 必须使用下表中的模型 ID（区分大小写）。

档位 模型 ID 输入 输出 上下文
Vidu Q3 Pro viduq3-pro $0.044154–$0.117744 / 秒 总价 = 输出时长（秒） × 对应档位单价 —

价格为构建时快照；以控制台与 定价页 实时数据为准。

组合计费规则

viduq3-pro

按生成时长和所选参数计费总价 = 输出时长（秒） × 对应档位单价
分辨率: 540p$0.0442 / 秒
分辨率: 720p$0.0981 / 秒
分辨率: 1080p$0.1177 / 秒
  • 提交时按公开参数预估；完成后可能按供应商返回的实际用量结算
查看高级计费表达式v2:provider_credits > 0 ? tier("vidu_actual_credits_plus_10pct_2026_08_30", units(provider_credits, 0.004906)) : tier("vidu_q3_pro_fallback_plus_10pct_2026_08_30", units((seconds > 0 ? seconds : 5) * (resolution == "1080p" ? 24 : resolution == "540p" ? 9 : 20), 0.004906))

Base URL 与认证

export OPENAI_BASE_URL="https://api.rokoapi.com/v1"
export OPENAI_API_KEY="sk-..."

所有请求携带 Authorization: Bearer $OPENAI_API_KEY。密钥在 控制台密钥页 创建。

快速开始

cURL

curl https://api.rokoapi.com/v1/videos/tasks \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
  -d '{
  "model": "viduq3-pro",
  "prompt": "A cinematic product shot with natural camera movement",
  "generation_type": "text",
  "duration": 5,
  "quality": "720p",
  "aspect_ratio": "16:9",
  "generate_audio": true
}'

Python（requests）

import json
import requests

base_url = "https://api.rokoapi.com/v1"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Idempotency-Key": "YOUR_UNIQUE_REQUEST_ID",
}
payload = json.loads(r'''{
  "model": "viduq3-pro",
  "prompt": "A cinematic product shot with natural camera movement",
  "generation_type": "text",
  "duration": 5,
  "quality": "720p",
  "aspect_ratio": "16:9",
  "generate_audio": true
}''')
task = requests.post(
    f"{base_url}/videos/tasks",
    headers=headers,
    json=payload,
).json()
result = requests.get(
    f"{base_url}/tasks/{task['task_id']}",
    headers=headers,
).json()
print(result)

常用参数

参数说明
model上表中的 EvoLink 视频模型 ID
prompt视频生成或编辑指令；Kling O3 自定义多镜头可改用 model_params.multi_prompt
duration输出秒数；各模型范围不同，Gemini Omni 还支持 auto，视频编辑路由可能不接收此字段
quality模型支持时可选 480p、720p、768p、1080p、2k 或 4k；Sora 2 不接收此字段
aspect_ratio画幅白名单随模型变化；Grok 1.5 Fast 非官转支持 2:3、3:2、1:1、9:16、16:9，部分视频编辑路由不接收此字段
image_urls / video_urls / audio_urls图生、参考生与编辑模式的素材 URL；数量上限由具体模型决定
callback_url可选公开 HTTPS 回调地址，不得使用 localhost 或内网 IP

提交成功会同时返回值相同的 id 和 task_id；新代码应保存 task_id。生产调用建议携带唯一的 Idempotency-Key。请定期请求 GET /v1/tasks/{task_id} ，直到状态变为 completed 或 failed；不要使用聊天或流式端点调用异步生成模型。 完整字段矩阵见视频生成任务。

注意事项

  • 请使用本页列出的已上线模型 ID；未开通或已下线的名称会返回模型不可用类错误。
  • 余额不足、分组无权限时通常表现为 403；请检查账户额度与密钥所属分组。
  • 多模态、工具调用、缓存计费等能力因上游与渠道配置而异，以实际响应与控制台说明为准。