Video Generation Overview

APIFree provides an asynchronous video generation API for creating, polling, and remixing video tasks through a unified platform interface.

Workflow

Video generation follows a three-step task flow:

1. Call POST /v1/videos to create a new video generation task.
2. Poll GET /v1/videos/{task_id} until the task reaches a terminal status.
3. Optionally call POST /v1/videos/{video_id}/remix to generate a modified version of a completed video.

Available endpoints

Endpoint	Purpose
POST /v1/videos	Create a new asynchronous video generation task
GET /v1/videos/{task_id}	Query the current task status and result metadata
POST /v1/videos/{video_id}/remix	Start a remix task based on an existing completed video

Compatibility routes

The video APIs are also available through OpenAI-style compatibility routes with the same behavior:

• POST /v1/openai/videos
• GET /v1/openai/videos/{task_id}
• POST /v1/openai/videos/{video_id}/remix

Common behavior

• Video generation is asynchronous. The create endpoint returns a task object rather than a finished video file.
• Poll the status endpoint after task creation to monitor progress.
• Remix requests require an existing completed video and a new prompt.
• POST /v1/videos supports both application/json and multipart/form-data.

Authentication

Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY