Bỏ qua để đến nội dung
Trang chính Tin tức Bảng điều khiển

OpenAI 视频格式

Nội dung này hiện chưa có sẵn bằng ngôn ngữ của bạn.

本页总览

调用OpenAI视频生成接口生成视频,支持 Sora 等模型,也支持使用 OpenAI 视频格式调用可灵,即梦和 vidu。

POST /v1/videos
参数类型必填描述
Authorizationstring是用户认证令牌 (Bearer: sk-xxxx)
Content-Typestring是本地文件使用 multipart/form-data;URL/Base64 JSON 使用 application/json
参数类型必填描述
promptstring是描述要生成视频的文本提示词
modelstring否视频生成模型,默认为 sora-2
secondsstring否视频时长(秒),默认为 4 秒
sizestring否输出分辨率,格式为宽度x高度,默认为 720x1280
input_referencefile否可选图片参考,用于指导生成
durationinteger否Grok 视频时长,1–15 秒
resolutionstring否Grok 输出档位,例如 480p、720p
Terminal window
curl https://你的4All API服务器地址/v1/videos \
-H "Authorization: Bearer sk-xxxx" \
-F "model=sora-2" \
-F "prompt=A calico cat playing a piano on stage"

本站入口保持 OpenAI Videos API 的 /v1/videos 路径,并在内部转换成 xAI 原生 JSON。两种格式的请求头和字段不要混用。

本地文件使用 OpenAI 的 input_reference 字段。不要手动设置 Content-Type,curl 会自动生成包含正确 boundary 的 multipart 请求头。

Terminal window
curl https://api.4allapi.com/v1/videos \
-H "Authorization: Bearer $API_KEY" \
-F "model=grok-imagine-video-1.5" \
-F "prompt=女孩在暖色书吧中寻找一本书,电影 MV 镜头" \
-F "duration=15" \
-F "resolution=480p" \
-F "input_reference=@girl.png;type=image/png"

实际请求头形态:

Authorization: Bearer YOUR_API_KEY
Content-Type: multipart/form-data; boundary=<由客户端自动生成>

URL 和 data URI 使用 JSON:

Terminal window
curl https://api.4allapi.com/v1/videos \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine-video-1.5",
"prompt": "让瀑布奔流,镜头缓慢拉远",
"duration": 12,
"resolution": "720p",
"image": {"url": "https://example.com/waterfall.png"}
}'

image.url 支持公网 HTTPS URL 或 data:image/png;base64,...。本站还接受 OpenAI 兼容对象 input_reference.image_url,并转换为 xAI 的 image.url。

xAI 原生提交端点为 POST https://api.x.ai/v1/videos/generations,请求头为:

Authorization: Bearer XAI_API_KEY
Content-Type: application/json

首帧字段必须是 "image":{"url":"..."};多张非首帧参考图片使用 reference_images。xAI 原生端点不接收 OpenAI 的 multipart 文件字段,因此 本站会把上传文件编码为 image.url=data:<mime>;base64,... 后再转发。

不要发送“JSON 内容 + multipart 请求头”。本站兼容层会纠正历史请求中的这种 错配,但新接入必须让 Content-Type 与真实请求体一致。

规范来源:OpenAI Videos API、 xAI Image-to-Video、 xAI Reference-to-Video。

{
"id": "video_123",
"object": "video",
"model": "sora-2",
"status": "queued",
"progress": 0,
"created_at": 1712697600,
"size": "1024x1808",
"seconds": "8",
"quality": "standard"
}
字段类型描述
idstring视频任务ID
objectstring对象类型,固定为 “video”
modelstring使用的模型名称
statusstring任务状态(queued: 排队中, processing: 处理中, completed: 完成, failed: 失败)
progressinteger处理进度(0-100)
created_atinteger创建时间戳
sizestring视频分辨率
secondsstring视频时长(秒)
qualitystring视频质量

根据任务ID查询视频生成任务的状态和结果

GET /v1/videos/{video_id}
参数类型必填描述
video_idstring是视频任务ID
Terminal window
curl 'https://你的4All API服务器地址/v1/videos/video_123' \
-H "Authorization: Bearer sk-xxxx"
{
"id": "video_123",
"object": "video",
"model": "sora-2",
"status": "completed",
"progress": 100,
"created_at": 1712697600,
"size": "1024x1808",
"seconds": "8",
"quality": "standard",
"url": "https://example.com/video.mp4"
}
字段类型描述
idstring视频任务ID
objectstring对象类型,固定为 “video”
modelstring使用的模型名称
statusstring任务状态(queued: 排队中, processing: 处理中, completed: 完成, failed: 失败)
progressinteger处理进度(0-100)
created_atinteger创建时间戳
sizestring视频分辨率
secondsstring视频时长(秒)
qualitystring视频质量
urlstring视频下载链接(完成时)

根据任务ID获取视频生成任务的详细信息

GET /v1/videos/{video_id}
参数类型必填描述
video_idstring是要获取的视频任务标识符
Terminal window
curl 'https://你的4All API服务器地址/v1/videos/video_123' \
-H "Authorization: Bearer sk-xxxx"
{
"id": "video_123",
"object": "video",
"model": "sora-2",
"status": "completed",
"progress": 100,
"created_at": 1712697600,
"completed_at": 1712698000,
"expires_at": 1712784400,
"size": "1024x1808",
"seconds": "8",
"quality": "standard",
"remixed_from_video_id": null,
"error": null
}
字段类型描述
idstring视频任务的唯一标识符
objectstring对象类型,固定为 “video”
modelstring生成视频的模型名称
statusstring视频任务的当前生命周期状态
progressinteger生成任务的近似完成百分比
created_atinteger任务创建时的Unix时间戳(秒)
completed_atinteger任务完成时的Unix时间戳(秒),如果已完成
expires_atinteger可下载资源过期时的Unix时间戳(秒),如果已设置
sizestring生成视频的分辨率
secondsstring生成视频片段的时长(秒)
qualitystring视频质量
remixed_from_video_idstring如果此视频是混音,则为源视频的标识符
errorobject如果生成失败,则包含错误信息的对象

下载已完成的视频内容

GET /v1/videos/{video_id}/content
参数类型必填描述
video_idstring是要下载的视频标识符
参数类型必填描述
variantstring否要返回的可下载资源类型,默认为MP4视频
Terminal window
curl 'https://你的4All API服务器地址/v1/videos/video_123/content' \
-H "Authorization: Bearer sk-xxxx" \
-o "video.mp4"

直接返回视频文件流,Content-Type为 video/mp4

字段类型描述
Content-Typestring视频文件类型,通常为 video/mp4
Content-Lengthstring视频文件大小(字节)
Content-Dispositionstring文件下载信息
{
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error",
"code": "invalid_parameter"
}
}
{
"error": {
"message": "Invalid API key",
"type": "authentication_error",
"code": "invalid_api_key"
}
}
{
"error": {
"message": "Insufficient permissions",
"type": "permission_error",
"code": "insufficient_permissions"
}
}
{
"error": {
"message": "Rate limit exceeded",
"type": "rate_limit_error",
"code": "rate_limit_exceeded"
}
}
{
"error": {
"message": "Internal server error",
"type": "server_error",
"code": "internal_error"
}
}