POST/video/upload

上传图片

上传参考图片，获取 file_id 用于后续创建视频任务。支持 JPG、PNG 格式，最大 25MB。

Request Params

file*File

图片文件，支持 JPG、PNG 格式，最大 25MB

model*string

模型名称（必填）

filenamestring

文件名（可选）

providerstring

指定厂商（可选）

Response Params

file_idstring

文件唯一标识，后续创建视频时使用

media_idstring

媒体ID

providerstring

实际使用的厂商

filenamestring

文件名

urlstring

文件访问地址

thumbnail_urlstring

缩略图地址

file_sizeint

文件大小（字节）

widthint

图片宽度

heightint

图片高度

n_framesint

帧数（视频）

durationnumber

时长（秒，视频）

mime_typestring

MIME类型

extensionstring

文件扩展名

created_atint

创建时间戳

Authorization*

Header

{YOUR-API-KEY}

请求示例

Response

200401429

200 成功响应

{
  "status": 200,
  "message": "success",
  "data": {
    "file_id": "abc123xyz",
    "media_id": "media_456",
    "provider": "sora",
    "filename": "image.jpg",
    "url": "https://cdn.example.com/image.jpg",
    "thumbnail_url": "https://cdn.example.com/thumb.jpg",
    "file_size": 2048576,
    "width": 1920,
    "height": 1080,
    "n_frames": 0,
    "duration": 0,
    "mime_type": "image/jpeg",
    "extension": "jpg",
    "created_at": 1704067200
  }
}