Create a remix task from an existing completed video.
Description
This endpoint starts a new video generation task based on an existing completed video. Provide a new prompt describing the modification you want to apply.
This endpoint is also available through the compatibility route POST /v1/openai/videos/{video_id}/remix with identical behavior.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
video_id | string | Yes | Existing completed video task ID. |
Headers
| Name | Type | Required | Description |
|---|---|---|---|
Authorization | string | Yes | Bearer token in the format Bearer YOUR_API_KEY. |
Content-Type | string | Yes | Must be application/json. |
Request body parameters
| Name | Type | Required | Description |
|---|---|---|---|
prompt | string | Yes | Description of the change to apply to the original video. |
model | string | No | Optional model field when required by your client workflow. |
Example request
curl https://api.apifree.ai/v1/videos/video_abc123/remix \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Keep the same camera movement but change the scene to a snowy mountain at dawn"
}'Response schema
A successful response returns the newly created remix task object.
| Field | Type | Description |
|---|---|---|
id | string | New remix task ID. |
object | string | Object type, typically video. |
created_at | integer | Unix timestamp for task creation time. |
status | string | Initial task status such as queued or in_progress. |
model | string | Model used for remix generation. |
Example response:
{
"id": "video_remix_456",
"object": "video",
"created_at": 1758941888,
"status": "queued",
"model": "video-model-id"
}Notes
- The source video should already be in a completed state before remix is requested.
- After remix creation, poll
GET /v1/videos/{task_id}to monitor the new task.
Errors
Typical error cases include:
- Missing
video_id - Missing
prompt - Authentication failure
- Original video not found
- Original video is not yet completed
- Upstream remix task creation failure