Skip to main content
POST
/
v1
/
videos
cURL
curl -s 'https://api.deerapi.com/v1/videos' \
  -H "Authorization: Bearer $DEERAPI_KEY" \
  -F 'prompt=cat' \
  -F 'model=sora-2'
{
  "id": "<string>",
  "object": "<string>",
  "created_at": 123,
  "status": "<string>",
  "completed_at": null,
  "error": null,
  "expires_at": null,
  "model": "<string>",
  "progress": 123,
  "remixed_from_video_id": null,
  "seconds": "<string>",
  "size": "<string>"
}

​
Overview

Use this endpoint to call the Sora 2 Create Video workflow through DeerAPI. The API reference on this page shows the request schema, response schema, authentication requirements, and runnable examples for the configured endpoint.

​
Before you start

Use the DeerAPI base URL and pass your API Key in the Authorization header: 
https://api.deerapi.com

Authorization: Bearer $DEERAPI_KEY

​
Model selection

Choose a current model ID from the live pricing page. Model availability changes over time, so avoid copying a model ID from an old project without checking the live list first.

​
Implementation notes

  • Use the OpenAPI playground for the exact request fields accepted by this endpoint.
  • Keep API Keys on the server side when you build production applications.
  • Log the request ID from failed calls so support can investigate the request.
  • Retry 429, 500, and 503 responses with exponential backoff.

Authorizations

​
Authorization
string
header
required

Use a DeerAPI API Key as a Bearer token.

Body

multipart/form-data
​
prompt
string
required

Use this field according to the endpoint schema.

Example:

"cat"

​
model
enum<string>

Use this field according to the endpoint schema.

Available options:
sora-2-pro,
sora-2
Example:

"sora-2"

​
seconds
enum<string>

Use this field according to the endpoint schema.

Available options:
4,
8,
12
Example:

"4"

​
size
enum<string>

Use this field according to the endpoint schema.

Available options:
720x1280,
1280x720,
1024x1792,
1792x1024
Example:

"1024x1792"

​
input_reference
file

Use this field according to the endpoint schema.

Response

200 - application/json

Successful Response

​
id
string
required

Use this field according to the endpoint schema.

​
object
string
required

Use this field according to the endpoint schema.

​
created_at
integer
required

Use this field according to the endpoint schema.

​
status
string
required

Use this field according to the endpoint schema.

​
completed_at
null
required

Use this field according to the endpoint schema.

​
error
null
required

Use this field according to the endpoint schema.

​
expires_at
null
required

Use this field according to the endpoint schema.

​
model
string
required

Use this field according to the endpoint schema.

​
progress
integer
required

Use this field according to the endpoint schema.

​
remixed_from_video_id
null
required

Use this field according to the endpoint schema.

​
seconds
string
required

Use this field according to the endpoint schema.

​
size
string
required

Use this field according to the endpoint schema.