Create Video with Image

POST

/v1/chat/completions

• Call Sora via the Chat Completions format with reference-image guidance
• The user message content is a multimodal array (text + image_url)
• Set stream: true in the request body to stream task progress or results
• Common models include sora-2
• Official docs: Chat Completions

Authorizations

bearer

Type

HTTP (bearer)

Request Body

application/json

object

Sora model ID to use (e.g. sora-2).

object[]

Required

Conversation message list. For image-guided generation, the user message content is a multimodal array (text + image_url).

Sampling temperature between 0 and 2. Higher values (e.g. 0.8) make output more random; lower values (e.g. 0.2) make it more focused. We generally recommend changing this or top_p, but not both.

Nucleus sampling alternative to temperature. The model considers tokens with top_p probability mass (e.g. 0.1 = top 10%). We generally recommend changing this or temperature, but not both.

Default 1.
How many chat completion choices to generate per input message.

Set to true for video generation. When enabled, responses are streamed via SSE and the stream ends at data: [DONE].

Default null. Up to 4 sequences where the API stops generating further tokens.

Default inf.
Maximum tokens to generate in the chat completion.

Total length of input and generated tokens is limited by the model context length.

Number between -2.0 and 2.0. Positive values penalize new tokens based on whether they appear in the text so far, increasing the chance of new topics.

Default 0. Number between -2.0 and 2.0. Positive values penalize new tokens based on their frequency in the text so far, reducing repetition.

Modify the likelihood of specified tokens appearing in the completion. Accepts a JSON object mapping token IDs to bias values from -100 to 100.

Unique identifier for your end user. Helps OpenAI monitor and detect abuse. Learn more.

Object specifying the output format. Set { "type": "json_object" } to enable JSON mode.

Beta feature. When set, the system will try to sample deterministically; refer to system_fingerprint to monitor backend changes.

List of tools the model may call. Currently only functions as tools are supported.

Controls which function the model calls, if any. none / auto / specify a function name.