MiniMax H3 videosu oluşturma

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
}

Metinden, referans medyadan ya da ilk ve son karelerden bir MiniMax H3 veya H3-Max videosu oluşturun. Görevi sorgulamak ve tamamlanan videoyu indirmek için döndürülen id değerini saklayın. POST /v1/videos multipart/form-data kullanır. Denetimleri form alanları olarak gönderin ve her medya girdisi için her referans alanını bir kez yineleyin.

Model seçin

model değerini aşağıdaki model kimliklerinden biri olarak ayarlayın. Eşleşen model tablosundan bir istek boyutu seçin: Süreyi ve boyutu ayarlama.

Model kimliği	Çözünürlük katmanları
`minimax-h3`	`768P`, `2K`
`minimax-h3-max`	`480P`, `768P`

Girdi modu seçin

Her iki model de aşağıdaki alanları kullanır. model değerini seçtiğiniz model kimliği olarak ayarlayın.

Amaç	Gerekli alanlar	İsteğe bağlı alanlar
Metinden videoya	`model`, `prompt`	`seconds`, `size`
Referans görseller	`model`, `prompt`, bir veya daha fazla `input_reference` URL’si veya dosyası	`seconds`, `size`
Referans video URL’si, data URI’si veya dosyası	`model`, `prompt`, bir veya daha fazla `reference_videos` alanı	`seconds`, `size`
Görselli referans ses	`model`, `prompt`, `input_reference`, bir veya daha fazla `reference_audios` alanı	`seconds`, `size`
İlk ve son kare URL’leri	`model`, `prompt`, `first_frame`	`last_frame`, `seconds`, `size`
Yüklenen ilk ve son kareler	`model`, `prompt`, `first_frame` dosya	`last_frame` dosya, `seconds`, `size`

H3-Max istek örnekleri, her iki çözünürlük katmanında metinden videoya oluşturmayı, referans görselleri, birleştirilmiş görsel/video/ses referanslarını ve ilk ve son kareleri içerir.

Referans görseller kullanın

Referans görselleri, herkese açık HTTPS URL’leri veya yüklenen dosyalar olarak input_reference aracılığıyla gönderin. Birden fazla görsel için alanı görsel sırasına göre yineleyin ve her alan için bir URL veya dosya kullanın. Bu alan içinde tüm URL’leri veya tüm dosyaları kullanın. URL’leri virgülle ayrılmış tek bir değerde birleştirmek yerine her URL’yi ayrı ayrı gönderin. URL’leri veya yüklenen dosyaları kullanmanıza bakılmaksızın en fazla dokuz PNG veya JPEG referans görseli gönderebilirsiniz. Yüklenen her görseli 20 MiB veya altında tutun. Prompt içinde, oluşturulan videonun koruması gereken görsel ayrıntıları açıklayın.

Referans video ve ses kullanma

Aşağıdaki biçimleri kullanarak reference_videos ve reference_audios değerlerini çok parçalı metin değerleri veya yüklenmiş dosyalar olarak gönderin. Her alanı her girdi için bir kez tekrarlayın; o alan içinde yalnızca metin değerleri ya da yalnızca dosyalar kullanın. Girdileri virgülle ayrılmış tek bir değerde birleştirmeyin. Farklı alanlarda, yüklenmiş bir ses dosyasıyla birlikte bir görüntü URL’si gibi farklı girdi türleri kullanılabilir. Görüntü, video ve ses referanslarını birleştirmek için input_reference, reference_videos ve reference_audios değerlerini aynı istekte gönderin.

Alan	Girdi	Biçim
`reference_videos`	Doğrudan, herkese açık erişilebilir bir HTTPS MP4 URL’si veya yüklenmiş bir MP4 dosyası	H.264 video içeren MP4; AAC ses parçası isteğe bağlıdır
`reference_videos`	Metin alanında eksiksiz bir Base64 veri URI’si	`data:video/mp4;base64,<BASE64_MP4>`
`reference_audios`	Doğrudan, herkese açık erişilebilir bir HTTPS MP3 URL’si veya yüklenmiş bir MP3 dosyası	MP3

En fazla üç video ve üç ses klibi olmak üzere, toplamda en fazla 12 referans girdisi gönderin. Her video veya ses klibi 2–15 saniye olmalıdır. Toplam video süresi ve toplam ses süresinin her biri 15 saniye veya altında olmalıdır. Referans sesi, input_reference aracılığıyla en az bir görüntüyle eşleştirin. Oluşturulan videonun izlemesi gereken hareketi, zamanlamayı veya sesi açıklayın. Yüklenen her MP4 dosyasını 50 MiB veya altında, her MP3 dosyasını ise 15 MiB veya altında tutun. Bir MiB, 1024 × 1024 bayttır. Bu sayfanın üst kısmındaki istek örnekleri, bir görüntüyle eşleştirilmiş MP4 URL’lerini, MP4 veri URI’lerini ve MP3 URL’lerini gösterir.

Referans video yükleme

Çekim yapısını ve hareketi yönlendirmek için bir MP4 dosyası yükleyin:

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'

Bir görüntüyle referans ses yükleme

Bir referans görüntüsü URL’sini yüklenmiş bir MP3 dosyasıyla eşleştirin:

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'

İlk ve son kareleri ayarlama

Açılış görüntüsü için first_frame ve isteğe bağlı olarak bitiş görüntüsü için bir last_frame gönderin. Her alan, doğrudan, herkese açık erişilebilir bir HTTPS PNG URL’sini veya yüklenmiş bir PNG dosyasını kabul eder. Yüklenen her PNG dosyasını 20 MiB veya altında tutun (20 × 1024 × 1024 bayt). Kare alanlarını referans görüntü, video veya ses alanlarıyla birleştirmeyin. Kare tabanlı oluşturma için ayrı bir istek kullanın. Kare girdileriyle, size çözünürlük katmanını seçer. Hizmet, sağlanan karelere göre nihai çıktı boyutlarını normalleştirebilir. size değerini WxH biçiminde göndermeye devam edin.

Döndürülen id değerini saklayın. status değeri completed veya failed. Görev tamamlandığında video içeriğini indirin.

Süreyi ve boyutu ayarlayın

Her iki model için de seconds değerini 5 ile 15 arasında bir tam sayı olarak ayarlayın. Varsayılan değer 5 saniyedir. Modeliniz için tablodan bir çözünürlük ve en-boy oranı seçin, ardından karşılık gelen İstek boyutu değerini size içinde WxH biçiminde gönderin. Metin ve referans medya isteklerinde size, çözünürlük katmanını ve kadraj en-boy oranını seçer. Hizmet, istenen boyuta ve sağlanan referans medyaya göre nihai çıktı boyutlarını normalize edebilir.

`minimax-h3` için boyutlar

Bu istek boyutlarını model=minimax-h3 ile kullanın:

Çözünürlük	En-boy oranı	İstek boyutu
`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` için boyutlar

Bu istek boyutlarını model=minimax-h3-max ile kullanın:

Çözünürlük	En-boy oranı	İstek boyutu
`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`

Görev akışı

Görevi oluşturun

Çok parçalı form isteğini gönderin ve döndürülen id değerini saklayın.

Görevi sorgulayın

Şunu MiniMax H3 videosunu alma çağrısını, status değeri completed veya failed olana kadar yapın.

Sonucu indirin

Görev completed olduğunda, MiniMax H3 video içeriğini indirme çağrısını MP4 dosyasını kaydetmek için yapın.

Yetkilendirmeler

Authorization

string

header

gerekli

Bearer authentication. Use your CometAPI API key.

Gövde

multipart/form-data

model

enum<string>

varsayılan:minimax-h3

gerekli

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.

Mevcut seçenekler:

minimax-h3,

minimax-h3-max

prompt

string

varsayılan:A paper boat glides across a still pond, daylight, locked camera, no text.

gerekli

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

Minimum string length: 1

seconds

integer

varsayılan:5

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

Gerekli aralık: 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]*$

Örnekler:

"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,)

Örnek:

"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://

Örnek:

"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://

Örnek:

"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://

Örnek:

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

Yanıt

200 - application/json

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

string

gerekli

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

Örnek:

"<task_id>"

object

string

gerekli

Object type for the asynchronous video task.

Allowed value: "video"

model

enum<string>

gerekli

Model ID that the task uses.

Mevcut seçenekler:

minimax-h3,

minimax-h3-max

status

enum<string>

gerekli

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

Mevcut seçenekler:

queued,

in_progress,

completed,

failed

progress

integer

gerekli

Task progress as a coarse percentage.

Gerekli aralık: 0 <= x <= 100

created_at

integer<int64>

gerekli

Task creation time as a Unix timestamp in seconds.

task_id

string

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

Örnek:

"<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.

Örnek:

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

error

object

Failure details. This field appears when the task fails.

Show child attributes

Son değiştirilme tarihi 14 Eylül 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
}

İçerik moderasyonu

API anahtarları

Model seçin

Girdi modu seçin

Referans görseller kullanın

Referans video ve ses kullanma

Referans video yükleme

Bir görüntüyle referans ses yükleme

İlk ve son kareleri ayarlama

Süreyi ve boyutu ayarlayın

`minimax-h3` için boyutlar

`minimax-h3-max` için boyutlar

Görev akışı

Yetkilendirmeler

Gövde

Yanıt

​Model seçin

​Girdi modu seçin

​Referans görseller kullanın

​Referans video ve ses kullanma

​Referans video yükleme

​Bir görüntüyle referans ses yükleme

​İlk ve son kareleri ayarlama

​Süreyi ve boyutu ayarlayın

​minimax-h3 için boyutlar

​minimax-h3-max için boyutlar

​Görev akışı

Yetkilendirmeler

Gövde

Yanıt

Model seçin

Girdi modu seçin

Referans görseller kullanın

Referans video ve ses kullanma

Referans video yükleme

Bir görüntüyle referans ses yükleme

İlk ve son kareleri ayarlama

Süreyi ve boyutu ayarlayın

`minimax-h3` için boyutlar

`minimax-h3-max` için boyutlar

Görev akışı