Langsung ke konten utama
POST
/
v1
/
videos
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "MiniMax-Hailuo-2.3",
    "prompt": "A cute kitten running on the grass",
    "duration": 6,
    "resolution": "768p",
    "prompt_optimizer": true,
    "fast_pretreatment": false,
    "watermark": false
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01J9HA7JPQ9A0Z6JZ3V8M9W6PZ"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

Use this file to discover all available pages before exploring further.

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "MiniMax-Hailuo-2.3",
    "prompt": "A cute kitten running on the grass",
    "duration": 6,
    "resolution": "768p",
    "prompt_optimizer": true,
    "fast_pretreatment": false,
    "watermark": false
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01J9HA7JPQ9A0Z6JZ3V8M9W6PZ"
    }
  ]
}

​
Otorisasi

​
Authorization
string
wajib
Semua endpoint API memerlukan autentikasi Bearer TokenDapatkan API Key Anda:Kunjungi Halaman Manajemen API Key untuk mendapatkan API Key AndaTambahkan ke header permintaan:
Authorization: Bearer YOUR_API_KEY

​
Parameter Request

​
model
string
wajib
Model yang didukung:
  • MiniMax-Hailuo-2.3 - Hailuo 2.3
  • MiniMax-Hailuo-2.3-Fast - Hailuo 2.3 Fast (latensi lebih rendah)
MiniMax-Hailuo-2.3-Fast:
Dengan model ini, first_frame_image wajib disertakan.
​
prompt
string
wajib
Deskripsi konten video (maks. 2000 karakter)Jelaskan adegan, aksi, dan gaya secara detail untuk hasil pembuatan yang lebih baik. Mendukung perintah gerakan kamera (lihat Perintah Gerakan Kamera di bawah).Contoh: "A cute kitten running on the grass"
​
duration
integer
default:"6"
Durasi video (detik)Opsi:
  • 6 - Video 6 detik
  • 10 - Video 10 detik
Default: 6
Batasan 1080p: Saat menggunakan resolusi 1080p, hanya durasi 6 detik yang didukung
​
resolution
string
default:"768p"
Resolusi videoOpsi:
  • 768p - Definisi tinggi
  • 1080p - Full HD (hanya mendukung durasi 6 detik)
Default: 768p
​
first_frame_image
string
Gambar frame pertama untuk videoMendukung dua format:
  • Public URL: https://example.com/start.jpg
  • Base64 encoded: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
Saat diberikan, gambar ini akan digunakan sebagai bingkai awal video
MiniMax-Hailuo-2.3-Fast:
Dengan model ini, first_frame_image wajib disertakan.
​
prompt_optimizer
boolean
default:"true"
Apakah mengoptimalkan prompt secara otomatisSaat diaktifkan, sistem akan mengoptimalkan prompt Anda secara otomatis untuk hasil pembuatan yang lebih baikDefault: true
​
fast_pretreatment
boolean
default:"false"
Apakah mempersingkat waktu optimisasi promptSaat diaktifkan, kecepatan pemrosesan lebih cepat tetapi kualitas optimisasi mungkin sedikit terpengaruhDefault: false
​
watermark
boolean
default:"false"
Apakah menambahkan watermarkDefault: false

​
Kombinasi Resolusi dan Durasi

ResolusiDurasi yang DidukungCatatan
768p6s, 10sSemua didukung
1080p6s10 dtk tidak didukung

​
Perintah Gerakan Kamera

Gunakan sintaks [command] di dalam prompt untuk mengontrol gerakan kamera. Ada 15 perintah yang didukung:
KategoriPerintah
Pan[左移] (pan left) [右移] (pan right)
Rotasi Horizontal[左摇] (rotate left) [右摇] (rotate right)
Dorong/Tarik[推进] (push in) [拉远] (pull out)
Gerakan Vertikal[上升] (rise) [下降] (descend)
Rotasi Vertikal[上摇] (tilt up) [下摇] (tilt down)
Zoom[变焦推近] (zoom in) [变焦拉远] (zoom out)
Lainnya[晃动] (shake) [跟随] (follow) [固定] (static)
Usage example: 
{
  "model": "MiniMax-Hailuo-2.3",
  "prompt": "[推进]A cat running in the garden, camera slowly pushing in for a close-up"
}

​
Respons

​
code
integer
Kode status respons, 200 jika berhasil
​
data
array
Array data respons

​
Kasus Penggunaan

​
Kasus 1: Teks-ke-Video Cepat

{
  "model": "MiniMax-Hailuo-2.3",
  "prompt": "A cute kitten running on the grass, sunny day"
}

​
Kasus 2: Video 1080p Berkualitas Tinggi

{
  "model": "MiniMax-Hailuo-2.3",
  "prompt": "City nightscape, neon lights flickering, traffic flowing",
  "duration": 6,
  "resolution": "1080p",
  "prompt_optimizer": true,
  "watermark": false
}

​
Kasus 3: Gambar-ke-Video dengan Frame Pertama

{
  "model": "MiniMax-Hailuo-2.3",
  "prompt": "Kitten running towards camera, smiling and blinking",
  "first_frame_image": "https://example.com/cat.jpg",
  "duration": 6,
  "resolution": "1080p"
}

​
Kasus 4: Perintah Gerakan Kamera

{
  "model": "MiniMax-Hailuo-2.3",
  "prompt": "[推进]A cat running in the garden, camera slowly pushing in for a close-up",
  "duration": 6,
  "resolution": "768p"
}

​
Kasus 5: Mode Pretreatment Cepat

{
  "model": "MiniMax-Hailuo-2.3",
  "prompt": "Waves crashing on the beach at sunset",
  "duration": 10,
  "resolution": "768p",
  "prompt_optimizer": true,
  "fast_pretreatment": true
}
Kueri Hasil TugasPembuatan video adalah tugas asinkron yang mengembalikan task_id saat dikirim. Gunakan endpoint Dapatkan Status Tugas untuk mengueri progres dan hasil pembuatan.