> ## Documentation Index
> Fetch the complete documentation index at: https://docs.inputapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Remix video

> Request format, responses, and capability boundaries.

`POST /v1/videos/{video_id}/remix`

Send a `prompt` describing the change and the original public task ID in the path. The original channel and plugin must support Remix. The gateway resolves the model from the original task and pins its channel.

The current result is a new-task submission summary, which need not contain a full Video object's `object` or `progress`. Save the new `id` and retrieve status. This creates a new task; it neither modifies the original task nor uploads an arbitrary video for editing.

[Integration guide and runnable example](/en/guides/video-generation)

[简体中文](/zh/api-reference/videos-remix)


## OpenAPI

````yaml openapi/relay.json POST /v1/videos/{video_id}/remix
openapi: 3.0.3
info:
  title: API — Core inference API
  version: 0.5.0
  description: >-
    面向接入的精选规范，不是全部管理或供应商接口。 / Curated integration specification, not the entire
    management or provider API.
  license:
    name: AGPL-3.0-or-later
servers:
  - url: https://gateway.example.com
    description: >-
      Example only; replace with your gateway origin and optional path prefix,
      without /v1.
security:
  - BearerAuth: []
paths:
  /v1/videos/{video_id}/remix:
    post:
      summary: 重混视频 / Remix video
      description: >-
        常用接入字段；能力取决于模型、渠道与部署。 / Common integration fields; support depends on
        the model, channel, and deployment.
      operationId: POSTVideosRemix
      parameters:
        - name: video_id
          in: path
          required: true
          schema:
            type: string
          description: >-
            同一用户/项目范围内的网关公开 ID / Public gateway ID in the same user/project
            scope
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VideoRemixRequest'
      responses:
        '200':
          description: >-
            新任务的提交摘要；后续用 GET 查询 / Submission summary for a new task; use GET
            afterward
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VideoSubmission'
              example:
                id: task_remix_example
                task_id: task_remix_example
                status: queued
                model: YOUR_MODEL_ID
                created_at: 1700000000
        '400':
          description: 请求参数错误 / Invalid request
        '401':
          description: 身份校验失败 / Authentication failed
        '403':
          description: 访问被拒绝 / Access denied
        '404':
          description: 接口或资源不存在 / Endpoint or resource not found
        '410':
          description: 内容已不可用 / Content no longer available
        '429':
          description: 请求被限流或受配额限制 / Rate or quota restriction
        '500':
          description: 网关或上游错误 / Gateway or upstream error
        '502':
          description: 内容代理或上游失败 / Content proxy or upstream failure
        '503':
          description: 服务暂不可用 / Service unavailable
        default:
          description: 其他网关或上游错误；格式可能不同 / Other gateway or upstream error; shape may vary
components:
  schemas:
    VideoRemixRequest:
      type: object
      properties:
        prompt:
          type: string
          description: >-
            任务描述；遵循模型的长度和内容要求 / Task description; follow model length and
            content requirements
      required:
        - prompt
    VideoSubmission:
      type: object
      properties:
        id:
          type: string
          description: 新任务的网关 ID / Gateway ID for the new task
        task_id:
          type: string
          description: 兼容旧客户端的字段 / Legacy compatibility field
        status:
          type: string
        model:
          type: string
          description: >-
            当前密钥可用且支持此接口的模型 ID / Model ID available to the key and supporting
            this endpoint
          example: YOUR_MODEL_ID
        created_at:
          type: integer
      required:
        - id
        - status
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: 模型调用 API Key，不是控制台登录凭据 / Model API key, not console login credentials

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.