---
title: "Create a character"
method: POST
path: "/videos/characters"
tags: ["Videos"]
deprecated: true
---

# Create a character

`POST /videos/characters`

## Request

- Base URL: `https://api.openai.com/v1`
- URL: `https://api.openai.com/v1/videos/characters`
- Auth: HTTP bearer

> **Deprecated.**

Create a character from an uploaded video.

## Request body `multipart/form-data`

- CreateVideoCharacterBody: Parameters for creating a character from an uploaded video.
  - `video` string, binary, required: Video file used to create a character.
  - `name` string, required: Display name for this API character.

## Response `200`

Success

- VideoCharacterResource
  - `id` string, nullable, required: Identifier for the character creation cameo.
  - `name` string, nullable, required: Display name for the character.
  - `created_at` integer, required: Unix timestamp (in seconds) when the character was created.

## Other responses

- `400`: The character request or video upload is invalid, or the organization does not support video generation.
- `404`: The video character endpoint is unavailable.
- `500`: The character could not be created.
- `504`: The character creation request timed out.

## Changes

- **2026-10-06** `487892d3954e`: 4 info
  - added the optional property `error/misalignment/review_target` to the response with the `400` status
  - added the optional property `error/misalignment/review_target` to the response with the `404` status
  - added the optional property `error/misalignment/review_target` to the response with the `500` status
  - added the optional property `error/misalignment/review_target` to the response with the `504` status
- **2026-10-05** `7f654af7f94f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/omnistack-sh/apis/openai-api/changes/videos/characters/post.md)

---

[API](https://skmtc.dev/omnistack-sh/apis/openai-api.md) - [All operations](https://skmtc.dev/omnistack-sh/apis/openai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/omnistack-sh/apis/openai-api/revisions/0a26f104d35f?raw)