Створення відео MiniMax H3

POST

videos

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=minimax-h3' \
  --form-string 'prompt=A paper boat glides across a still pond, daylight, locked camera, no text.' \
  --form-string 'seconds=5' \
  --form-string 'size=2544x1456'

{
  "id": "<task_id>",
  "task_id": "<task_id>",
  "object": "video",
  "model": "minimax-h3",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

Створіть відео MiniMax H3 або H3-Max із тексту, еталонних медіафайлів або першого й останнього кадрів. Збережіть повернений id, щоб перевіряти стан завдання та завантажити готове відео. POST /v1/videos використовує multipart/form-data. Надсилайте параметри керування як поля форми та повторюйте кожне поле еталонних даних один раз для кожного медіавводу.

Виберіть модель

Установіть для model один із наведених ідентифікаторів моделей. Виберіть розмір запиту з таблиці відповідної моделі в Установіть тривалість і розмір.

Ідентифікатор моделі	Рівні роздільної здатності
`minimax-h3`	`768P`, `2K`
`minimax-h3-max`	`480P`, `768P`

Виберіть режим введення

Обидві моделі використовують наведені нижче поля. Установіть для model ідентифікатор вибраної моделі.

Мета	Обов’язкові поля	Необов’язкові поля
Текст у відео	`model`, `prompt`	`seconds`, `size`
Еталонні зображення	`model`, `prompt`, одну або кілька URL-адрес або файлів `input_reference`	`seconds`, `size`
URL-адреса еталонного відео, URI даних або файл	`model`, `prompt`, одне або кілька полів `reference_videos`	`seconds`, `size`
Еталонний аудіозапис із зображенням	`model`, `prompt`, `input_reference`, одне або кілька полів `reference_audios`	`seconds`, `size`
URL-адреси першого й останнього кадрів	`model`, `prompt`, `first_frame`	`last_frame`, `seconds`, `size`
Завантажені перший і останній кадри	`model`, `prompt`, `first_frame` файл	`last_frame` файл, `seconds`, `size`

Приклади запитів H3-Max містять перетворення тексту у відео на обох рівнях роздільної здатності, еталонні зображення, комбіновані еталонні зображення, відео й аудіо, а також перший і останній кадри.

Використання еталонних зображень

Надсилайте еталонні зображення через input_reference як загальнодоступні HTTPS URL-адреси або завантажені файли. Для кількох зображень повторюйте поле в порядку зображень, указуючи одну URL-адресу або один файл у кожному полі. Використовуйте в цьому полі або лише URL-адреси, або лише файли. Надсилайте кожну URL-адресу окремо, а не об’єднуйте URL-адреси в значення, розділене комами. Можна надіслати до дев’яти еталонних зображень PNG або JPEG, незалежно від того, чи використовуєте ви URL-адреси або завантажені файли. Розмір кожного завантаженого зображення не має перевищувати 20 MiB. У Prompt опишіть візуальні деталі, які має зберегти згенероване відео.

Використання еталонних відео та аудіо

Надсилайте reference_videos і reference_audios як текстові значення multipart або завантажені файли, використовуючи наведені нижче формати. Повторюйте кожне поле один раз для кожного вхідного значення, використовуючи в межах цього поля лише текстові значення або лише файли. Не об’єднуйте вхідні значення в значення, розділене комами. Для різних полів можна використовувати різні типи вхідних даних, наприклад URL-адресу зображення із завантаженим аудіофайлом. Щоб поєднати еталонні зображення, відео й аудіо, надішліть input_reference, reference_videos і reference_audios в одному запиті.

Поле	Вхідні дані	Формат
`reference_videos`	Пряма загальнодоступна HTTPS URL-адреса MP4 або завантажений файл MP4	MP4 з відео H.264; аудіодоріжка AAC необов’язкова
`reference_videos`	Повний URI даних Base64 у текстовому полі	`data:video/mp4;base64,<BASE64_MP4>`
`reference_audios`	Пряма загальнодоступна HTTPS URL-адреса MP3 або завантажений файл MP3	MP3

Надсилайте загалом не більше 12 еталонних вхідних даних, зокрема не більше трьох відео та трьох аудіокліпів. Кожен відео- або аудіокліп має тривати 2–15 секунд. Загальна тривалість відео та загальна тривалість аудіо окремо не мають перевищувати 15 секунд. Поєднуйте еталонне аудіо принаймні з одним зображенням через input_reference. Опишіть рух, таймінг або звук, яким має відповідати згенероване відео. Розмір кожного завантаженого MP4 не має перевищувати 50 MiB, а кожного завантаженого MP3 — 15 MiB. Один MiB дорівнює 1024 × 1024 байтам. Приклади запитів у верхній частині цієї сторінки показують URL-адреси MP4, URI даних MP4 і URL-адреси MP3 у парі із зображенням.

Завантаження еталонного відео

Завантажте файл MP4, щоб визначити структуру кадру та рух:

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=minimax-h3' \
  --form-string 'prompt=Follow the uploaded reference video shot structure and motion. No text.' \
  --form-string 'seconds=5' \
  --form-string 'size=1344x768' \
  --form 'reference_videos=@/path/to/reference.mp4;type=video/mp4'

Завантаження еталонного аудіо із зображенням

Поєднайте URL-адресу еталонного зображення із завантаженим файлом MP3:

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=minimax-h3' \
  --form-string 'prompt=Animate the reference image and synchronize the motion with the uploaded reference audio. No text.' \
  --form-string 'seconds=5' \
  --form-string 'size=1344x768' \
  --form-string 'input_reference=https://your-image-host/reference.png' \
  --form 'reference_audios=@/path/to/reference.mp3;type=audio/mpeg'

Встановлення першого та останнього кадрів

Надішліть first_frame для початкового зображення та, за потреби, один last_frame для кінцевого зображення. Кожне поле приймає одну пряму загальнодоступну HTTPS URL-адресу PNG або один завантажений файл PNG. Розмір кожного завантаженого PNG не має перевищувати 20 MiB (20 × 1024 × 1024 байтів). Не поєднуйте поля кадрів із полями еталонних зображень, відео чи аудіо. Для генерації на основі кадрів використовуйте окремий запит. Для вхідних кадрів size визначає рівень роздільної здатності. Сервіс може нормалізувати кінцеві розміри виводу на основі наданих кадрів. Продовжуйте надсилати size у формі WxH.

Збережіть повернений id. Опитуйте завдання, доки status не матиме значення completed або failed. Коли завдання буде завершено, завантажте відеовміст.

Установлення тривалості та розміру

Для обох моделей установіть seconds як ціле число від 5 до 15. За замовчуванням установлено 5 секунд. Виберіть роздільну здатність і співвідношення сторін із таблиці для вашої моделі, а потім надішліть відповідне Розмір запиту значення як size у форматі WxH. Для запитів із текстом і довідковими медіафайлами size визначає рівень роздільної здатності та співвідношення сторін кадру. Сервіс може нормалізувати остаточні розміри виводу на основі запитаного розміру та наданих довідкових медіафайлів.

Розміри для `minimax-h3`

Використовуйте ці розміри запиту з model=minimax-h3:

Роздільна здатність	Співвідношення сторін	Розмір запиту
`768P`	`21:9`	`1536x672`
`768P`	`16:9`	`1344x768`
`768P`	`4:3`	`1024x768`
`768P`	`1:1`	`768x768`
`768P`	`3:4`	`768x1024`
`768P`	`9:16`	`768x1344`
`2K`	`21:9`	`2912x1280`
`2K`	`16:9`	`2544x1456`
`2K`	`4:3`	`1920x1440`
`2K`	`1:1`	`1440x1440`
`2K`	`3:4`	`1440x1920`
`2K`	`9:16`	`1440x2560`

Розміри для `minimax-h3-max`

Використовуйте ці розміри запиту з model=minimax-h3-max:

Роздільна здатність	Співвідношення сторін	Розмір запиту
`480P`	`21:9`	`1120x480`
`480P`	`16:9`	`864x480`
`480P`	`4:3`	`640x480`
`480P`	`1:1`	`480x480`
`480P`	`3:4`	`480x640`
`480P`	`9:16`	`480x864`
`768P`	`21:9`	`1792x768`
`768P`	`16:9`	`1360x768`
`768P`	`4:3`	`1024x768`
`768P`	`1:1`	`768x768`
`768P`	`3:4`	`768x1024`
`768P`	`9:16`	`768x1360`

Потік завдання

Створення завдання

Надішліть multipart form-запит і збережіть повернений id.

Опитування завдання

Викликайте Отримання відео MiniMax H3 доки status не набуде значення completed або failed.

Завантаження результату

Коли завдання має стан completed, викликайте Завантаження відеовмісту MiniMax H3 щоб зберегти файл MP4.

Авторизації

Authorization

string

header

обов'язково

Bearer authentication. Use your CometAPI API key.

Тіло

multipart/form-data

model

enum<string>

за замовчуванням:minimax-h3

обов'язково

Model ID for the video task. Use minimax-h3 for 768P or 2K, or minimax-h3-max for 480P or 768P. Choose size from the matching model table.

Доступні опції:

minimax-h3,

minimax-h3-max

prompt

string

за замовчуванням:A paper boat glides across a still pond, daylight, locked camera, no text.

обов'язково

Text that describes the scene, motion, camera behavior, and visual details that the video should preserve.

Minimum string length: 1

seconds

integer

за замовчуванням:5

Requested clip duration in whole seconds. Use an integer from 5 through 15. The default is 5.

Необхідний діапазон: 5 <= x <= 15

size

string

Requested size in WxH form. For text and reference-media requests, size selects the resolution tier and framing aspect ratio. With first or last frames, size selects the resolution tier. Use the matching model table: minimax-h3 uses 768P or 2K; minimax-h3-max uses 480P or 768P. For example, use 1344x768 for H3 at 768P, 864x480 for H3-Max at 480P, or 1360x768 for H3-Max at 768P. The service can normalize the final output dimensions.

Pattern: ^[1-9][0-9]*x[1-9][0-9]*$

Приклади:

"1536x672"

"1344x768"

"1024x768"

"768x768"

"768x1024"

"768x1344"

"2912x1280"

"2544x1456"

"1920x1440"

"1440x1440"

"1440x1920"

"1440x2560"

"1120x480"

"864x480"

"640x480"

"480x480"

"480x640"

"480x864"

"1792x768"

"1360x768"

"768x1360"

input_reference

PNG or JPEG reference images. Repeat input_reference with one publicly accessible HTTPS image URL or uploaded image file per field. Send up to nine reference images, whether you use URLs or uploaded files. Use all URLs or all files within this field. Do not combine URLs into a comma-separated value. Keep each uploaded image at or below 20 MiB. Do not combine this field with first_frame or last_frame. Across images, videos, and audio, send at most 12 reference inputs. Each reference video or audio clip must be 2–15 seconds; keep the combined video duration and combined audio duration at or below 15 seconds each. Submit images in the order you want to reference them in the prompt.

Pattern: ^https://

reference_videos

(string<uri> | file)[]

Reference video inputs. Repeat reference_videos with a direct publicly accessible HTTPS MP4 URL or an uploaded MP4 file. Use only text values or only files within this field. Each uploaded file can be up to 50 MiB. Send no more than three video inputs. A complete data:video/mp4;base64,... URI is also accepted as a text value. Use MP4 with H.264 video; an AAC audio track is optional. Do not combine this field with first_frame or last_frame. Across images, videos, and audio, send at most 12 reference inputs. Each reference video or audio clip must be 2–15 seconds; keep the combined video duration and combined audio duration at or below 15 seconds each.

Required array length: 1 - 3 elements

Pattern: ^(https://|data:video/mp4;base64,)

Приклад:

"https://your-media-host/reference.mp4"

reference_audios

(string<uri> | file)[]

Reference audio inputs. Repeat reference_audios with a direct publicly accessible HTTPS MP3 URL or an uploaded MP3 file. Use only text values or only files within this field. Each uploaded file can be up to 15 MiB. Send no more than three audio inputs. Pair reference audio with at least one reference image. Do not combine this field with first_frame or last_frame. Across images, videos, and audio, send at most 12 reference inputs. Each reference video or audio clip must be 2–15 seconds; keep the combined video duration and combined audio duration at or below 15 seconds each.

Required array length: 1 - 3 elements

Pattern: ^https://

Приклад:

"https://your-media-host/reference.mp3"

first_frame

Opening frame input as one direct publicly accessible HTTPS PNG URL or one uploaded PNG file at or below 20 MiB (20 x 1024 x 1024 bytes). Do not combine frame fields with reference media fields.

Pattern: ^https://

Приклад:

"https://your-image-host/first-frame.png"

last_frame

Optional ending frame input, used with first_frame, as one direct publicly accessible HTTPS PNG URL or one uploaded PNG file at or below 20 MiB (20 x 1024 x 1024 bytes). Do not combine frame fields with reference media fields.

Pattern: ^https://

Приклад:

"https://your-image-host/last-frame.png"

Відповідь

200 - application/json

Task created. Store the returned id and use it in retrieve and content requests.

string

обов'язково

Task ID. Use this value as task_id in retrieve and content requests.

Приклад:

"<task_id>"

object

string

обов'язково

Object type for the asynchronous video task.

Allowed value: "video"

model

enum<string>

обов'язково

Model ID that the task uses.

Доступні опції:

minimax-h3,

minimax-h3-max

status

enum<string>

обов'язково

Task lifecycle status. Poll until the value is completed or failed.

Доступні опції:

queued,

in_progress,

completed,

failed

progress

integer

обов'язково

Task progress as a coarse percentage.

Необхідний діапазон: 0 <= x <= 100

created_at

integer<int64>

обов'язково

Task creation time as a Unix timestamp in seconds.

task_id

string

Compatibility alias for id. This field can be omitted from retrieve responses.

Приклад:

"<task_id>"

completed_at

integer<int64>

Unix timestamp returned by the platform. Use status, not this field, to decide when polling can stop.

expires_at

integer<int64>

Result expiration time as a Unix timestamp in seconds when the task provides one.

video_url

string<uri>

Video delivery URL. This field appears on completed tasks.

Приклад:

"https://your-media-host/result.mp4"

error

object

Failure details. This field appears when the task fails.

Show child attributes

Останнє оновлення 14 вересня 2026 р.

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=minimax-h3' \
  --form-string 'prompt=A paper boat glides across a still pond, daylight, locked camera, no text.' \
  --form-string 'seconds=5' \
  --form-string 'size=2544x1456'

{
  "id": "<task_id>",
  "task_id": "<task_id>",
  "object": "video",
  "model": "minimax-h3",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

Модерація контенту

API-ключі

Створення відео MiniMax H3

Виберіть модель

Виберіть режим введення

Використання еталонних зображень

Використання еталонних відео та аудіо

Завантаження еталонного відео

Завантаження еталонного аудіо із зображенням

Встановлення першого та останнього кадрів

Установлення тривалості та розміру

Розміри для `minimax-h3`

Розміри для `minimax-h3-max`

Потік завдання

Авторизації

Тіло

Відповідь

​Виберіть модель

​Виберіть режим введення

​Використання еталонних зображень

​Використання еталонних відео та аудіо

​Завантаження еталонного відео

​Завантаження еталонного аудіо із зображенням

​Встановлення першого та останнього кадрів

​Установлення тривалості та розміру

​Розміри для minimax-h3

​Розміри для minimax-h3-max

​Потік завдання

Авторизації

Тіло

Відповідь

Виберіть модель

Виберіть режим введення

Використання еталонних зображень

Використання еталонних відео та аудіо

Завантаження еталонного відео

Завантаження еталонного аудіо із зображенням

Встановлення першого та останнього кадрів

Установлення тривалості та розміру

Розміри для `minimax-h3`

Розміри для `minimax-h3-max`

Потік завдання