Grok Imagine Video 1.5 API

Referensi API lengkap untuk model generasi Grok Imagine Video 1.5 oleh xAI.

Varian Model

API ini mendukung satu varian model:

Model	ID	Deskripsi
Grok Imagine 1.5 Image to Video	`grok-imagine-v1.5-image-to-video`	Animasi video yang dipandu gambar referensi

Rasio Aspek yang Didukung

Rasio	Deskripsi
`2:3`	Potret
`3:2`	Lanskap
`1:1`	Persegi
`16:9`	Lanskap (layar lebar)
`9:16`	Potret (vertikal)
`3:4`	Potret standar
`4:3`	Lanskap standar

Opsi Resolusi

Resolusi	Deskripsi
`480p`	Definisi standar, pemrosesan lebih cepat
`720p`	Definisi tinggi, kualitas dan kecepatan seimbang

Grok Imagine 1.5 Image to Video

Endpoint

POST /api/v1/video/task

Parameter Permintaan

Wajib

Parameter	Tipe	Deskripsi
`model_name`	string	Harus berupa `"grok-imagine-v1.5-image-to-video"`
`image_url`	string	URL gambar referensi untuk input animasi
`prompt`	string	Prompt generasi video
`duration`	number	Durasi video dalam detik (1-15)
`resolution`	string	Resolusi penagihan: `"480p"` atau `"720p"`

Opsional

Parameter	Tipe	Deskripsi
`aspect_ratio`	string	Rasio aspek video: `"2:3"`, `"3:2"`, `"1:1"`, `"16:9"`, `"9:16"`, `"3:4"`, atau `"4:3"` (default ke `"16:9"`)

Contoh Permintaan

javascript
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'grok-imagine-v1.5-image-to-video',
    image_url: 'https://example.com/reference.jpg',
    prompt: 'Subtle camera motion, subject holds pose',
    aspect_ratio: '16:9',
    duration: 10,
    resolution: '720p'
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Contoh hanya body:

javascript
{
  model_name: 'grok-imagine-v1.5-image-to-video',
  image_url: 'https://example.com/reference.jpg',
  prompt: 'Subtle camera motion, subject holds pose',
  aspect_ratio: '16:9',
  duration: 10,
  resolution: '720p'
}

Format Respons

Respons Awal

Mengembalikan task_id untuk polling:

json
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}

Respons Polling

Polling GET /api/v1/video/{taskId} untuk memeriksa status:

json
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "task_result": {
      "videos": [
        {
          "url": "https://example.com/generated-video.mp4"
        }
      ]
    }
  }
}

Nilai Status

submitted: Tugas diterima dan menunggu untuk diproses
processing: Generasi video sedang berlangsung
succeed: Generasi video selesai
failed: Generasi video gagal

Waktu Pemrosesan

Waktu pemrosesan tipikal: 2-5 menit.

Praktik Terbaik

Deskripsi Gerakan: Sertakan gerakan kamera dan gerakan subjek dalam prompt
Kualitas Gambar: Gunakan gambar input berkualitas tinggi untuk hasil animasi yang lebih baik
Rasio Aspek: Sesuaikan aspect_ratio dengan format output target sebelum mengirim