Skip to main content
POST
/
v1
/
videos
sora-2 (Image To Video)
curl --request POST \
  --url https://gptproto.com/v1/videos

​
Authentication

  1. Sign up for a GPTProto account at https://gptproto.com
  2. Navigate to the API Keys section in your dashboard
  3. Generate a new API key (sk-xxxxx)
  4. Copy and securely store your API key For authentication details, please refer to the Authentication section.

​
Initiate Request

curl --location 'https://gptproto.com/v1/videos' \
--header 'Authorization: GPTPROTO_API_KEY' \
--form 'model="sora-2"' \
--form 'input_reference=@"/path/to/file"' \
--form 'prompt="Put a hat on the cat"'

​
Query result

​
How to obtain the id

After submitting your video generation request to /v1/videos, the response will contain the id you need for querying results.

​
Query Task Status

Retrieve detailed information about the video generation task, including status, progress, and video URL. 
curl --location --request GET 'https://gptproto.com/v1/videos/{{id}}' \
--header 'Authorization: GPTPROTO_API_KEY'
Query Task Status Response: 
{
    "id": "video_****",
    "size": "720x1280",
    "error": null,
    "model": "sora-2",
    "object": "video",
    "prompt": "Put a hat on the cat",
    "status": "completed",
    "seconds": "4",
    "progress": 100,
    "created_at": "1770098584",
    "expires_at": "1770184984",
    "completed_at": "1770098708",
    "remixed_from_video_id": null
}

​
Query Video Content

Directly output the video content for immediate use or download. 
curl --location --request GET 'https://gptproto.com/v1/videos/{{id}}/content' \
--header 'Authorization: GPTPROTO_API_KEY'

​
Parameters

ParameterTypeRequiredDefaultRangeDescription
promptstring✅ Yes--Text prompt that describes the video to generate.
input_referencefile❌ No--Optional image reference that guides generation.
modelstring❌ Nosora-2sora-2
sora-2-pro		The video generation model to use. Defaults to sora-2.
secondsstring❌ No44
8
12		Clip duration in seconds. Defaults to 4 seconds.
sizestring❌ No720x1280720x1280
1280x720
1024x1792
1792x1024		Output resolution formatted as width x height. Defaults to 720x1280.Note: 1024x1792 and 1792x1024 are only supported by sora2-pro model.

​
Error Codes

​
Common Error Codes

Error CodeError NameDescription
401UnauthorizedAPI key is missing or invalid
403ForbiddenYour API key doesn’t have permission to access this resource, or insufficient balance for the requested operation
429Too Many RequestsYou’ve exceeded your rate limit
500Internal server errorAn internal server error occurred
503Content policy violationContent blocked due to safety concerns (actual status code is 400)