Skip to main content
POST
Create video
Use this format with an existing OpenAI SDK client.videos integration. It supports text or one first-frame image at 720p. Use Ark / Seedance for reference audio, multiple reference images and video editing.

Setup

Set the OpenAI SDK base URL to https://api.aiohub.org/v1 and supply your full AIOHub sk- API key. This is the video API, not Chat Completions or Responses.

Example request

Replace <AIOHUB_API_KEY> with your full API key. Its group must include the Seedance model used here.
The creation response includes these fields. Save id; do not submit another creation request to check progress.
After saving the task identifier, poll the task.

Parameter limits

Use application/json for JSON requests and multipart/form-data with the input_reference field for file uploads. Crop or resize an image to match size before submitting.
Install the openai SDK and set AIOHUB_API_KEY in your environment. These examples download only after generation succeeds.
If creation times out without a task identifier, check the usage log before resubmitting to avoid duplicate generation and charges. Correct parameters after a 400 and check the API key after a 401. See Authentication for access and quota requirements.

Authorizations

Authorization
string
header
required

API key (sk-xxx)

Body

model
string
required

Model name

Example:

"doubao-seedance-2-5-260628"

prompt
string
required

Prompt

Example:

"A blue ceramic cup on a wooden table in daylight, slow camera push-in."

seconds
string

Duration in seconds

Example:

"4"

size
string

Video size

Example:

"1280x720"

input_reference
string

First-frame image as an HTTPS URL or data URL

Example:

"https://example.com/first.png"

Response

Video task created successfully

id
string
required

Video ID

object
string
required

Object type

model
string
required

Model used

status
string
required

Task status

progress
integer
required

Progress percentage

created_at
integer
required

Creation timestamp

seconds
string
required

Video duration

completed_at
integer

Completion timestamp

expires_at
integer

Expiration timestamp

size
string

Video size

error
object

OpenAI video error information

metadata
object

Additional metadata