Skip to main content

​
Video APIs

​
Overview

Video generation is asynchronous. Use this lifecycle:
  1. Submit a job (POST /v1/videos)
  2. Poll status (GET /v1/videos/{id})
  3. Download output (GET /v1/videos/{id}/content)

​
Base URL

https://api.sciforium.com/v1

​
Authentication

Include your API token in the headers:
  • Authorization: Bearer <TOKEN>
  • x-api-key: <TOKEN>

​
Supported Endpoints

​
1) Create Video Job

Method: POST
Endpoint: https://api.sciforium.com/v1/videos
Content-Type: multipart/form-data
Success Status: 201 Created

​
Request fields

​
Example cURL (text-to-video)

​
2. Check the Status: GET /v1/videos/

Since you don’t know exactly when the video will be finished, you “poll” this endpoint (requesting it every 5–10 seconds) or wait for a Webhook notification if you have one configured.

​
The Response

The status field is the most important part of this response. Example of a completed status:
Note: Most completed videos are only stored on OpenAI’s servers for 24 hours before they are deleted for privacy and storage reasons.

​
3. Retrieve the File: GET /v1/videos//content

Once the status is completed, you call this final endpoint to get the actual media.

​
The Response

Unlike the other two endpoints which return JSON, this endpoint returns the binary data of the video file (usually an .mp4). Content-Type: video/mp4 Behavior: In a browser or code, this will trigger a download or allow you to stream the bytes directly into a file buffer.