OpenAI

OpenAI Videos API

The Videos API from OpenAI — 8 operation(s) for videos.

GitHub OpenAPI

Operations 10

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /videos Generate a new video from a prompt · Create a video #
Ask an LLM
“How do I generate a video from a text prompt?”
“Can I set the length and resolution of a generated video?”
Tell an agent
Generate a video of {prompt}.
Make a {seconds}-second {size} video of {prompt}.
GET /videos List recently generated videos · List videos #
Ask an LLM
“Which videos have I generated recently in this project?”
“Can I list my generated videos oldest first?”
Tell an agent
List my recently generated videos.
Show {limit} generated videos ordered {order}.
POST /videos/characters Create a reusable character from a video · Create a character #
Ask an LLM
“Can I turn someone in an uploaded video into a character I can reuse?”
“What do I need to provide to create a video character?”
Tell an agent
Create a character named {name} from video {video}.
Save the person in {video} as a reusable character called {name}.
GET /videos/characters/{character_id} Get a saved video character · Retrieve a character #
Ask an LLM
“What details are stored for a video character I created?”
“Can I fetch a character by its ID?”
Tell an agent
Show video character {character_id}.
Fetch the details of character {character_id}.
POST /videos/edits Edit a video with a prompt · Create a video edit #
Ask an LLM
“How do I change something in an existing video using a prompt?”
“Can I edit a video I uploaded, not just one I generated?”
Tell an agent
Edit video {video} so that {prompt}.
Apply the edit {prompt} to source video {video}.
POST /videos/extensions Extend a completed video · Create a video extension #
Ask an LLM
“Can I make a finished video longer by continuing it?”
“How many extra seconds can I add when extending a video?”
Tell an agent
Extend video {video} by {seconds} seconds with {prompt}.
Continue {video} for another {seconds} seconds showing {prompt}.
GET /videos/{video_id} Check a video generation job's status · Retrieve a video #
Ask an LLM
“Is my video still rendering or has it completed?”
“What is the latest metadata for a video I generated?”
Tell an agent
Show video {video_id}.
Check whether video {video_id} has finished rendering.
DELETE /videos/{video_id} Delete a video and its stored assets · Delete a video #
Ask an LLM
“How do I permanently delete a generated video?”
“Can I delete a video generation that failed?”
Tell an agent destructive · confirm first
Delete video {video_id}.
Permanently remove video {video_id} and its stored assets.
GET /videos/{video_id}/content Download a generated video file · Download video content #
Ask an LLM
“How do I download the finished video file?”
“Can I get a thumbnail or preview instead of the full video?”
Tell an agent
Download the rendered video {video_id}.
Download the {variant} for video {video_id}.
POST /videos/{video_id}/remix Remix a completed video with a new prompt · Create a video remix #
Ask an LLM
“Can I remix a video I already generated with a different prompt?”
“What's the way to rework a finished video with a refreshed prompt?”
Tell an agent
Remix video {video_id} with the prompt {prompt}.
Make a remix of {video_id} where {prompt}.

Documentation

📖
Documentation
https://platform.openai.com/docs/assistants/overview
📖
Documentation
https://platform.openai.com/docs/api-reference/assistants
📖
Documentation
https://platform.openai.com/docs/guides/text-to-speech
📖
Documentation
https://platform.openai.com/docs/api-reference/audio
📖
Documentation
https://platform.openai.com/docs/guides/speech-to-text
📖
Documentation
https://developers.openai.com/api/docs/guides/audio/
📖
Documentation
https://developers.openai.com/api/docs/guides/voice-agents/
📖
Documentation
https://platform.openai.com/docs/api-reference/chat
📖
Documentation
https://platform.openai.com/docs/guides/embeddings
📖
Documentation
https://platform.openai.com/docs/api-reference/embeddings
📖
Documentation
https://platform.openai.com/docs/api-reference/files
📖
Documentation
https://platform.openai.com/docs/guides/fine-tuning
📖
Documentation
https://platform.openai.com/docs/api-reference/fine-tuning
📖
Documentation
https://platform.openai.com/docs/guides/images
📖
Documentation
https://platform.openai.com/docs/api-reference/images
📖
Documentation
https://platform.openai.com/docs/guides/image-generation
📖
Documentation
https://platform.openai.com/docs/guides/images-vision
📖
Documentation
https://platform.openai.com/docs/models
📖
Documentation
https://platform.openai.com/docs/api-reference/models
📖
Documentation
https://platform.openai.com/docs/assistants/how-it-works/managing-threads-and-messages
📖
Documentation
https://platform.openai.com/docs/api-reference/threads
📖
Documentation
https://platform.openai.com/docs/api-reference/completions

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/openai/refs/heads/main/openapi/openai-videos-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/openai/refs/heads/main/json-schema/openai-chat-completion-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/openai/refs/heads/main/json-schema/openai-embedding-schema.json

Other Resources

🔗
JSONLD
https://raw.githubusercontent.com/api-evangelist/openai/refs/heads/main/json-ld/openai-context.jsonld

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/openai:openai-videos-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openai-videos-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: OpenAI Videos API
  description: The OpenAI REST API. Please see https://platform.openai.com/docs/api-reference for more details.
  version: 2.3.0
  termsOfService: https://openai.com/policies/terms-of-use
  contact:
    name: OpenAI Support
    url: https://help.openai.com/
  license:
    name: MIT
    identifier: MIT
servers:
- url: https://api.openai.com/v1
security:
- ApiKeyAuth: []
tags:


# --- truncated at 32 KB (67 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/openai/refs/heads/main/openapi/openai-videos-api-openapi.yml