创建视频

OpenAI 兼容的视频生成接口。

参考文档: https://platform.openai.com/docs/api-reference/videos/create

OpenAI 视频调用

该通用入口当前用于 sora-2、sora-2-pro。创建后使用 GET /v1/videos/{task_id} 查询，视频文件代理地址为 GET /v1/videos/{task_id}/content。

curl "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $NODEKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2",
    "prompt": "手持镜头穿过清晨的咖啡店，阳光从窗边扫过桌面",
    "seconds": "5",
    "size": "1280x720"
  }'

curl "$BASE_URL/v1/videos/task_xxx" \
  -H "Authorization: Bearer $NODEKEY_API_KEY"

也支持表单上传参考输入；参考图使用 input_reference。sora-2 支持 720x1280、1280x720，sora-2-pro 额外支持 1792x1024、1024x1792。

Authorization

BearerAuth

AuthorizationBearer <token>

使用 Bearer Token 认证。格式: Authorization: Bearer sk-xxxxxx

In: header

Request Body

multipart/form-data

model?string

模型/风格 ID

prompt?string

文本描述提示词

image?string

图片输入 (URL 或 Base64)

duration?number

视频时长（秒）

width?integer

视频宽度

height?integer

视频高度

fps?integer

视频帧率

seed?integer

随机种子

n?integer

生成视频数量

response_format?string

响应格式

user?string

用户标识

metadata?

扩展参数 (如 negative_prompt, style, quality_level 等)

Response Body

application/json

curl -X POST "https://nodekey.xinghanyun.cn/v1/videos" \
  -F model="kling-v1" \
  -F prompt="宇航员站起身走了" \
  -F image="https://example.com/image.jpg" \
  -F duration="5" \
  -F width="1280" \
  -F height="720" \
  -F fps="30" \
  -F seed="20231234" \
  -F n="1" \
  -F response_format="url" \
  -F user="user-1234" \
  -F metadata="{}"

curl -X POST "https://nodekey.xinghanyun.cn/v1/videos" \  -F model="kling-v1" \  -F prompt="宇航员站起身走了" \  -F image="https://example.com/image.jpg" \  -F duration="5" \  -F width="1280" \  -F height="720" \  -F fps="30" \  -F seed="20231234" \  -F n="1" \  -F response_format="url" \  -F user="user-1234" \  -F metadata="{}"

{
  "id": "string",
  "object": "string",
  "model": "string",
  "status": "string",
  "progress": 0,
  "created_at": 0,
  "seconds": "string",
  "completed_at": 0,
  "expires_at": 0,
  "size": "string",
  "error": {
    "message": "string",
    "code": "string"
  },
  "metadata": {}
}

{
  "error": {
    "message": "string",
    "type": "string",
    "param": "string",
    "code": "string"
  }
}

OpenAI 视频调用

Authorization

Request Body

Response Body

200application/json

400application/json

application/json

application/json