Sora2 VVIP 视频生成

使用 DragonAPI 密钥和本站接口。示例中的 your-media.example 是占位地址，需替换为你自己的可访问素材或回调地址。协议、可用性与价格以当前模型说明和控制台为准。

使用 sora-2-vvip 模型生成高质量视频

sora-2-vvip 视频生成模型
支持文本到视频、图生视频、角色引用
异步任务管理，通过任务 ID 查询结果

重要变更 ：为了更稳定的调用体验，我们不再支持在 image_urls 中直接传入 base64 图片数据。请先将素材保存到可公开访问的 HTTPS 地址，再调用本接口。

Authorizations

Authorization

string · 必填

所有接口均需要使用 Bearer Token 进行认证

获取 DragonAPI API Key：访问 DragonAPI 密钥管理页面获取您的 API Key

使用时在请求头中添加：

text

Authorization: Bearer YOUR_DRAGONAPI_KEY

Body

model

string · 必填 · 默认 sora-2-vvip

视频生成模型名称

支持的模型：sora-2-vvip - VVIP版，仅支持固定时长档位

示例："sora-2-vvip"

prompt

string · 必填

视频生成的文本描述

duration

integer · 可选

视频时长（秒）

仅支持 4、8 或 12 秒

示例：4

aspect_ratio

string · 可选

视频宽高比

支持的格式：

16:9 (横屏)
9:16 (竖屏)

image_urls

string[] · 可选

用于图生视频的参考图像 URL 数组

⚠️ 仅支持 URL 格式（不再支持 base64）

公开可访问的图像 URL（http\😕/ 或 https\😕/）
请先将本地素材保存到可公开访问的 HTTPS 地址

thumbnail

boolean · 可选

是否生成视频缩略图

true - 生成视频缩略图用于预览和展示

如果不需要缩略图，可以省略此参数

metadata.n

integer · 可选 · 默认 1

生成不同变体的数量

取值范围：1-4

默认值：1

metadata.watermark

boolean · 可选 · 默认 false

是否为生成的视频添加水印

false - 无水印
true - 为视频添加 Sora 官方水印

默认值：false

metadata.private

boolean · 可选 · 默认 false

是否启用隐私模式

true - 视频不会被发布，且无法被 remix（重新编辑）
false - 视频可以被发布和 remix

默认值：false

metadata.style

string · 可选

视频风格

支持的值：

thanksgiving - 感恩节风格
comic - 漫画风格
news - 新闻风格
selfie - 自拍风格
nostalgic - 怀旧/复古风格
anime - 动漫风格

示例："anime"

metadata.storyboard

boolean · 可选

是否使用故事板功能，更精细地控制视频生成细节

true - 启用故事板功能
false - 不使用故事板

示例：true

metadata.character_url

string · 可选

用于角色提取的参考视频 URL

用于在生成的视频中重用参考视频中的角色

示例："https://your-media.example/reference-video.mp4"

⚠️ 注意： 使用此参数时，生成的视频时长会减少 1 秒

metadata.character_timestamps

string · 可选

角色出现的时间戳

指定参考视频中角色出现的时间范围，仅支持 2 秒片段

格式："起始秒,结束秒"

示例："1,3" 表示参考视频中第 1 秒到第 3 秒的角色

⚠️ 注意： 使用此参数时，生成的视频时长会减少 1 秒

metadata.character_create

boolean · 可选 · 默认 false

创建视频完成后，自动根据生成的视频创建角色

true - 自动创建角色
false - 不创建角色

默认值：false

metadata.character_from_task

string · 可选

根据已经生成的任务 ID 来创建角色

可以引用之前生成的视频任务 ID，从该视频中提取角色

示例："video_01K8SGYNNNVBQTXNR4MM964S7K"

Response

id

string · 可选

任务唯一标识符，用于查询任务状态

object

string · 可选

对象类型，固定为 generation.task

model

string · 可选

使用的模型名称

status

string · 可选

任务状态

queued - 排队等待处理
in_progress - 处理中
completed - 成功完成
failed - 失败

progress

integer · 可选

任务进度百分比（0-100）

created_at

integer · 可选

任务创建时间戳（Unix 时间戳）

metadata

object · 可选

任务元数据

curl --request POST \
  --url https://newapi.dragon3api.com/v1/videos \
  --header 'Authorization: Bearer YOUR_DRAGONAPI_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "sora-2-vvip",
    "prompt": "一只金毛犬在草地上奔跑，阳光明媚",
    "duration": 4,
    "aspect_ratio": "16:9"
  }'

curl --request POST \
  --url https://newapi.dragon3api.com/v1/videos \
  --header 'Authorization: Bearer YOUR_DRAGONAPI_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "sora-2-vvip",
    "prompt": "让这只狗动起来，在草地上奔跑",
    "image_urls": ["https://your-media.example/dog.jpg"],
    "duration": 4,
    "aspect_ratio": "16:9"
  }'

curl --request POST \
  --url https://newapi.dragon3api.com/v1/videos \
  --header 'Authorization: Bearer YOUR_DRAGONAPI_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "sora-2-vvip",
    "prompt": "一只可爱的卡通大象",
    "aspect_ratio": "16:9",
    "duration": 4,
    "metadata": {
      "style": "anime",
      "watermark": false
    }
  }'

curl --request POST \
  --url https://newapi.dragon3api.com/v1/videos \
  --header 'Authorization: Bearer YOUR_DRAGONAPI_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "sora-2-vvip",
    "prompt": "一只小青蛙在舞台上跳舞，灯光明亮",
    "duration": 4,
    "aspect_ratio": "16:9"
  }'

curl --request POST \
  --url https://newapi.dragon3api.com/v1/videos \
  --header 'Authorization: Bearer YOUR_DRAGONAPI_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "sora-2-vvip",
    "prompt": "一只猫和一只狗一起开车 @duksvfkf.cruisingki @zdqwahgj.baronbarki",
    "duration": 4,
    "aspect_ratio": "16:9"
  }'

import requests

response = requests.post(
    "https://newapi.dragon3api.com/v1/videos",
    headers={
        "Authorization": "Bearer YOUR_DRAGONAPI_KEY",
        "Content-Type": "application/json"
    },
    json={
        "model": "sora-2-vvip",
        "prompt": "一只金毛犬在草地上奔跑，阳光明媚",
        "duration": 4,
        "aspect_ratio": "16:9",
        "metadata": {
            "style": "anime",
            "watermark": False,
            "n": 2
        }
    }
)

task = response.json()
print(f"任务 ID: {task['id']}")
print(f"状态: {task['status']}")

const response = await fetch('https://newapi.dragon3api.com/v1/videos', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_DRAGONAPI_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'sora-2-vvip',
    prompt: '一只金毛犬在草地上奔跑，阳光明媚',
    duration: 4,
    aspect_ratio: '16:9',
    metadata: {
      style: 'anime',
      watermark: false,
      n: 2
    }
  })
});

const task = await response.json();
console.log(`任务 ID: ${task.id}`);
console.log(`状态: ${task.status}`);

{
  "id": "video_01K8SGYNNNVBQTXNR4MM964S7K",
  "object": "generation.task",
  "model": "sora-2-vvip",
  "status": "queued",
  "progress": 0,
  "created_at": 1768380224,
  "metadata": {
    "size": "720x720"
  }
}

Sora2 VVIP 视频生成 ​

Authorizations ​

Authorization ​

Body ​

model ​

prompt ​

duration ​

aspect_ratio ​

image_urls ​

thumbnail ​

metadata.n ​

metadata.watermark ​

metadata.private ​

metadata.style ​

metadata.storyboard ​

metadata.character_url ​

metadata.character_timestamps ​

metadata.character_create ​

metadata.character_from_task ​

Response ​

id ​

object ​

model ​

status ​

progress ​

created_at ​

metadata ​

Sora2 VVIP 视频生成

Authorizations

Authorization

Body

model

prompt

duration

aspect_ratio

image_urls

thumbnail

metadata.n

metadata.watermark

metadata.private

metadata.style

metadata.storyboard

metadata.character_url

metadata.character_timestamps

metadata.character_create

metadata.character_from_task

Response

id

object

model

status

progress

created_at

metadata