# Create video

`POST /v1/videos`

OpenAI-compatible video generation endpoint.

Reference: https://platform.openai.com/docs/api-reference/videos/create

## Authorizations

Bearer authentication — send `Authorization: Bearer <token>`.

## Request Body (multipart/form-data)

```json
{
  "type": "object",
  "properties": {
    "model": {
      "description": "Model name",
      "example": "sora-2",
      "type": "string"
    },
    "prompt": {
      "description": "Prompt",
      "example": "cute cat dance",
      "type": "string"
    },
    "seconds": {
      "description": "Duration to generate, in seconds",
      "example": "8",
      "type": "string"
    },
    "input_reference": {
      "format": "binary",
      "type": "string",
      "description": "Reference image file",
      "example": ""
    }
  }
}
```

## Responses

### 200 — Video task created

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Video ID"
    },
    "object": {
      "type": "string",
      "description": "Object type"
    },
    "model": {
      "type": "string",
      "description": "Model used"
    },
    "status": {
      "type": "string",
      "description": "Task status"
    },
    "progress": {
      "type": "integer",
      "description": "Progress percentage"
    },
    "created_at": {
      "type": "integer",
      "description": "Creation timestamp"
    },
    "seconds": {
      "type": "string",
      "description": "Video duration"
    },
    "completed_at": {
      "type": "integer",
      "description": "Completion timestamp"
    },
    "expires_at": {
      "type": "integer",
      "description": "Expiry timestamp"
    },
    "size": {
      "type": "string",
      "description": "Video size"
    },
    "error": {
      "type": "object",
      "description": "OpenAI video error",
      "properties": {
        "message": {
          "type": "string",
          "description": "Error message"
        },
        "code": {
          "type": "string",
          "description": "Error code"
        }
      }
    },
    "metadata": {
      "type": "object",
      "description": "Additional metadata",
      "additionalProperties": true,
      "properties": {}
    }
  },
  "required": [
    "id",
    "object",
    "model",
    "status",
    "progress",
    "created_at",
    "seconds"
  ]
}
```

### 400 — Invalid request parameters

```json
{
  "type": "object",
  "properties": {
    "error": {
      "type": "object",
      "properties": {
        "message": {
          "type": "string",
          "description": "Error message"
        },
        "type": {
          "type": "string",
          "description": "Error type"
        },
        "param": {
          "type": "string",
          "description": "Related parameter",
          "nullable": true
        },
        "code": {
          "type": "string",
          "description": "Error code",
          "nullable": true
        }
      }
    }
  }
}
```