Videos
Create a video
Creates a video from the supplied request.
İstek Gövdesi
The multipart request body.
model
OpenAI.CreateVideoMultipartBody
The video generation model to use (allowed values: sora-2, sora-2-pro). Defaults to sora-2.
prompt
string
gerekli
Text prompt that describes the video to generate.
input_reference
any | OpenAI.ImageRefParam
seconds
OpenAI.CreateVideoMultipartBody
Clip duration in seconds (allowed values: 4, 8, 12). Defaults to 4 seconds.
size
OpenAI.CreateVideoMultipartBody
Output resolution formatted as width x height (allowed values: 720x1280, 1280x720, 1024x1792, 1792x1024). Defaults to 720x1280.
Yanıtlar
The request has succeeded.
Gövde
id
string
gerekli
Unique identifier for the video job.
object
enum
gerekli
The object type, which is always video.
model
string | enum
gerekli
enum
status
enum
gerekli
created_at
integer
gerekli
Unix timestamp (seconds) for when the job was created.
completed_at
integer | null
gerekli
Unix timestamp (seconds) for when the job completed, if finished.
expires_at
integer | null
gerekli
Unix timestamp (seconds) for when the downloadable assets expire, if set.
size
enum
gerekli
seconds
string
gerekli
Duration of the generated clip in seconds. For extensions, this is the stitched total duration.
error
OpenAI.Error-2 | null
gerekli
An error that occurred while generating the response.
code
string
gerekli
A machine-readable error code that was returned.
message
string
gerekli
A human-readable description of the error that was returned.
headers
object
The Retry-After and Retry-After-Ms headers returned with the original error, if any.
misalignment
OpenAI.MisalignmentErrorDetailsResource
error_type
string | enum
enum
detailed_explanation
string
The public explanation for this block.
steer
OpenAI._MisalignmentSteer
message
string
gerekli
The public continuation instruction.
İstek
curl https://api.openai.com/v1/videos \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-F "model=sora-2" \
-F "prompt=A calico cat playing a piano on stage"import OpenAI from 'openai';
const openai = new OpenAI();
const video = await openai.videos.create({ prompt: 'A calico cat playing a piano on stage' });
console.log(video.id);import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ.get("OPENAI_API_KEY"), # This is the default and can be omitted
)
video = client.videos.create(
prompt="x",
)
print(video.id)package main
import (
"context"
"fmt"
"github.com/openai/openai-go"
"github.com/openai/openai-go/option"
)
func main() {
client := openai.NewClient(
option.WithAPIKey("My API Key"),
)
video, err := client.Videos.New(context.TODO(), openai.VideoNewParams{
Prompt: "x",
})
if err != nil {
panic(err.Error())
}
fmt.Printf("%+v
", video.ID)
}require "openai"
openai = OpenAI::Client.new(api_key: "My API Key")
video = openai.videos.create(prompt: "x")
puts(video)package com.openai.example;
import com.openai.client.OpenAIClient;
import com.openai.client.okhttp.OpenAIOkHttpClient;
import com.openai.models.videos.Video;
import com.openai.models.videos.VideoCreateParams;
public final class Main {
private Main() {}
public static void main(String[] args) {
OpenAIClient client = OpenAIOkHttpClient.fromEnv();
VideoCreateParams params = VideoCreateParams.builder()
.prompt("x")
.build();
Video video = client.videos().create(params);
}
}import OpenAI from 'openai';
const client = new OpenAI({
apiKey: process.env['OPENAI_API_KEY'], // This is the default and can be omitted
});
const video = await client.videos.create({ prompt: 'x' });
console.log(video.id);Response
{
"id": "video_123",
"object": "video",
"model": "sora-2",
"status": "queued",
"progress": 0,
"created_at": 1712697600,
"size": "1024x1792",
"seconds": "8",
"quality": "standard"
}