Pembuatan Video Omni-Flash-Ext

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "Omni-Flash-Ext",
    "prompt": "a girl is dancing happily in a sunny garden",
    "duration": 10,
    "resolution": "1080p",
    "aspect_ratio": "9:16"
  }'

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

POST

videos

generations

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "Omni-Flash-Ext",
    "prompt": "a girl is dancing happily in a sunny garden",
    "duration": 10,
    "resolution": "1080p",
    "aspect_ratio": "9:16"
  }'

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

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "Omni-Flash-Ext",
    "prompt": "a girl is dancing happily in a sunny garden",
    "duration": 10,
    "resolution": "1080p",
    "aspect_ratio": "9:16"
  }'

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

Autentikasi

Authorization

string

wajib

Semua permintaan memerlukan autentikasi Bearer Token.Dapatkan API Key:Kunjungi halaman manajemen API Key untuk mendapatkan API Key Anda.Tambahkan header berikut saat membuat permintaan:

Authorization: Bearer YOUR_API_KEY

Parameter Permintaan

model

string

wajib

Nama model pembuatan video. Harus Omni-Flash-Ext.

prompt

string

wajib

Deskripsi konten video. Kami menyarankan untuk menjelaskan adegan, subjek, aksi, lingkungan, gerakan kamera, gaya visual, dan petunjuk audio secara detail.Contoh: "a girl is dancing happily in a sunny garden"

duration

integer

default:"6"

Durasi video dalam detik.Nilai yang didukung: 4, 6, 8, 10.

Nilai lain seperti 5 atau 7 akan mengembalikan error invalid_duration error.

Jangan kirim duration saat mengunggah video referensi. duration dan video_urls tidak dapat dikirim bersamaan.

resolution

string

default:"720p"

Resolusi video. Nilai tidak peka huruf besar/kecil.Nilai yang didukung:

720p
1080p
4k

Other resolutions akan mengembalikan error invalid_resolution error.

aspect_ratio

string

default:"16:9"

Rasio aspek video. Gunakan untuk mengontrol output lanskap atau potret.Nilai umum:

16:9 - landscape
9:16 - potret

Default: 16:9

size

string

Field kompatibilitas. Artinya sama dengan aspect_ratio. Jika keduanya disediakan, pastikan nilainya konsisten.

image_urls

array<url>

Array URL gambar referensi. Anda dapat menghilangkannya, menyediakan 1 gambar, atau menyediakan 3 gambar:

Dihilangkan atau array kosong: Teks-ke-Video
1 gambar: Gambar-ke-Video satu gambar
3 gambar: fusi gambar referensi

Hanya URL gambar yang dapat diakses publik yang didukung.

Mode frame pertama plus frame terakhir dengan 2 gambar tidak didukung. Mengirim 2 gambar mengembalikan error unsupported_image_count error. 4 gambar atau lebih belum sepenuhnya diverifikasi dan tidak direkomendasikan.

video_urls

array<url>

Array URL video referensi. Anda dapat menghilangkannya atau menyediakan 1 video referensi.Hanya URL video HTTP/HTTPS yang dapat diakses publik yang didukung. Anda dapat mengirimkannya bersama image_urls: gambar digunakan sebagai referensi identitas atau komposisi, sedangkan video digunakan sebagai referensi gerakan.

Omni-Flash-Ext hanya mendukung 0 atau 1 video referensi. Mengirim 2 video atau lebih akan mengembalikan error unsupported_video_count.

Jangan kirim duration saat mengirim video_urls. video_urls dan duration tidak dapat dikirim bersamaan.

Respons

code

integer

Respons status code. Successful requests mengembalikan 200.

data

array

Array tugas yang dikembalikan.

Tampilkan Array item

status

string

Status tugas awal. Nilainya submitted setelah pengiriman berhasil.

task_id

string

ID tugas unik untuk mengueri status dan hasil tugas.

Kueri Hasil Tugas

Pembuatan video bersifat asinkron. Setelah pengiriman, API mengembalikan task_id. Gunakan endpoint Dapatkan status tugas untuk mengueri progres dan hasil.

cURL

curl --request GET \
  --url https://api.apimart.ai/v1/tasks/task_01KS1H7ZYSJWH1N779S2FSHTKA \
  --header 'Authorization: Bearer <token>'

Kami menyarankan menunggu 5-10 detik setelah pengiriman sebelum kueri pertama, lalu melakukan polling setiap 5-10 detik. Satu tugas biasanya selesai dalam sekitar 3-5 menit.

Contoh Hasil Berhasil

{
  "code": 200,
  "data": {
    "id": "task_01KS1H7ZYSJWH1N779S2FSHTKA",
    "status": "completed",
    "progress": 100,
    "created": 1779246294,
    "completed": 1779246534,
    "actual_time": 240,
    "estimated_time": 600,
    "cost": 0.4,
    "result": {
      "videos": [
        {
          "url": ["https://cdn.example.com/videos/abc.mp4"],
          "expires_at": 1779332760
        }
      ]
    }
  }
}

Gagal Hasil Example

{
  "code": 200,
  "data": {
    "id": "task_01KS1H7ZYSJWH1N779S2FSHTKA",
    "status": "failed",
    "progress": 100,
    "created": 1779246294,
    "completed": 1779246534,
    "actual_time": 240,
    "estimated_time": 600,
    "cost": 0,
    "error": {
      "message": "invalid duration 7, must be one of 4/6/8/10",
      "code": "task_failed"
    }
  }
}

Kasus Penggunaan

Skenario 1: Teks-ke-Video

{
  "model": "Omni-Flash-Ext",
  "prompt": "a beautiful sunset over the ocean with seagulls flying",
  "duration": 6,
  "resolution": "720p",
  "aspect_ratio": "16:9"
}

Skenario 2: Video Satu Gambar

{
  "model": "Omni-Flash-Ext",
  "prompt": "make the character smile and slowly turn around, cinematic camera motion",
  "duration": 6,
  "resolution": "1080p",
  "aspect_ratio": "9:16",
  "image_urls": ["https://example.com/character.jpg"]
}

Skenario 3: Fusi 3 Gambar Referensi

{
  "model": "Omni-Flash-Ext",
  "prompt": "a creative scene combining these elements with smooth camera motion",
  "duration": 10,
  "resolution": "1080p",
  "aspect_ratio": "9:16",
  "image_urls": [
    "https://example.com/scene.jpg",
    "https://example.com/character.jpg",
    "https://example.com/product.jpg"
  ]
}

Skenario 4: Video Pendek 4K

{
  "model": "Omni-Flash-Ext",
  "prompt": "close-up of a hummingbird hovering in front of a red flower",
  "duration": 4,
  "resolution": "4k",
  "aspect_ratio": "16:9"
}

Skenario 5: Pembuatan dengan Video Referensi

{
  "model": "Omni-Flash-Ext",
  "prompt": "the same scene but at night with neon lights",
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "video_urls": ["https://example.com/reference.mp4"]
}

Kode Error

HTTP	Tipe error	Arti	Tindakan yang disarankan
400	`invalid_request_error`	`model` bukan `Omni-Flash-Ext`, `prompt` kosong, atau format JSON tidak valid	Periksa body permintaan
400	`invalid_duration`	`duration` bukan `4`, `6`, `8`, atau `10`	Gunakan durasi yang didukung
400	`invalid_resolution`	`resolution` bukan `720p`, `1080p`, atau `4k`	Gunakan resolusi yang didukung
400	`unsupported_image_count`	Jumlah `image_urls` tidak didukung, biasanya karena mengirim 2 gambar	Gunakan 0, 1, atau 3 gambar
400	`unsupported_video_count`	Jumlah `video_urls` tidak didukung, biasanya karena mengirim 2 video atau lebih	Gunakan 0 atau 1 video referensi
401	`authentication_error`	Token tidak valid	Periksa Bearer Token
402	`payment_required`	Saldo tidak mencukupi	Isi ulang dan coba lagi
429	`rate_limit_error`	Batas laju terlampaui	Kurangi konkurensi atau coba lagi nanti

Saat tugas gagal, API status tugas mengembalikan alasan kegagalan di data.error. Penyebab umum meliputi kuota upstream yang sementara habis, kegagalan moderasi konten, atau timeout upstream.

Pembuatan Video Grok Imagine 1.0 Transkripsi Audio Whisper-1

Documentation Index

​Autentikasi

​Parameter Permintaan

​Respons

​Kueri Hasil Tugas

​Contoh Hasil Berhasil

​Gagal Hasil Example

​Kasus Penggunaan

​Skenario 1: Teks-ke-Video

​Skenario 2: Video Satu Gambar

​Skenario 3: Fusi 3 Gambar Referensi

​Skenario 4: Video Pendek 4K

​Skenario 5: Pembuatan dengan Video Referensi

​Kode Error

Autentikasi

Parameter Permintaan

Respons

Kueri Hasil Tugas

Contoh Hasil Berhasil

Gagal Hasil Example

Kasus Penggunaan

Skenario 1: Teks-ke-Video

Skenario 2: Video Satu Gambar

Skenario 3: Fusi 3 Gambar Referensi

Skenario 4: Video Pendek 4K

Skenario 5: Pembuatan dengan Video Referensi

Kode Error