Model Video Resmi Grok

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Idempotency-Key: 7d0141e4-a19a-4650-a717-dab777b3a330' \
  --data '{
    "model": "grok-imagine-video",
    "prompt": "A cinematic aerial shot of a coastal city at sunrise",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "nsfw_check": true
  }'

const response = await fetch("https://api.apimart.ai/v1/videos/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer <token>",
    "Content-Type": "application/json",
    Accept: "application/json",
    "Idempotency-Key": crypto.randomUUID(),
  },
  body: JSON.stringify({
    model: "grok-imagine-video",
    prompt: "Improve motion consistency and apply cinematic color grading",
    video: { url: "https://cdn.example.com/source-video.mp4" },
  }),
});

console.log(response.status, await response.json());

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

{
  "error": {
    "message": "Invalid request parameters",
    "type": "invalid_request_error",
    "param": "resolution",
    "code": "invalid_request_error"
  }
}

POST

videos

generations

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Idempotency-Key: 7d0141e4-a19a-4650-a717-dab777b3a330' \
  --data '{
    "model": "grok-imagine-video",
    "prompt": "A cinematic aerial shot of a coastal city at sunrise",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "nsfw_check": true
  }'

const response = await fetch("https://api.apimart.ai/v1/videos/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer <token>",
    "Content-Type": "application/json",
    Accept: "application/json",
    "Idempotency-Key": crypto.randomUUID(),
  },
  body: JSON.stringify({
    model: "grok-imagine-video",
    prompt: "Improve motion consistency and apply cinematic color grading",
    video: { url: "https://cdn.example.com/source-video.mp4" },
  }),
});

console.log(response.status, await response.json());

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

{
  "error": {
    "message": "Invalid request parameters",
    "type": "invalid_request_error",
    "param": "resolution",
    "code": "invalid_request_error"
  }
}

Halaman ini untuk model resmi grok-imagine-video dan grok-imagine-video-1.5. Keduanya berbeda dari grok-imagine-1.5-video-ext; jangan campur nama atau parameternya.

Jangan paparkan API Key di browser, variabel publik, LocalStorage, URL, atau log. Panggil APIMart melalui backend atau BFF.

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Idempotency-Key: 7d0141e4-a19a-4650-a717-dab777b3a330' \
  --data '{
    "model": "grok-imagine-video",
    "prompt": "A cinematic aerial shot of a coastal city at sunrise",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "nsfw_check": true
  }'

const response = await fetch("https://api.apimart.ai/v1/videos/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer <token>",
    "Content-Type": "application/json",
    Accept: "application/json",
    "Idempotency-Key": crypto.randomUUID(),
  },
  body: JSON.stringify({
    model: "grok-imagine-video",
    prompt: "Improve motion consistency and apply cinematic color grading",
    video: { url: "https://cdn.example.com/source-video.mp4" },
  }),
});

console.log(response.status, await response.json());

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

{
  "error": {
    "message": "Invalid request parameters",
    "type": "invalid_request_error",
    "param": "resolution",
    "code": "invalid_request_error"
  }
}

Ringkasan integrasi

Semua mode memakai endpoint asinkron yang sama:

POST https://api.apimart.ai/v1/videos/generations

Field permintaan	Mode	Model
Tanpa `image_urls` dan `video`	Teks ke video	Kedua model
`image_urls`	Gambar referensi ke video	Kedua model
`video`	Edit video	Hanya `grok-imagine-video`

Setelah mengirim, simpan data[0].task_id, lalu polling:

GET https://api.apimart.ai/v1/tasks/{task_id}

Jangan kirim X-APIMart-Response-Version; header ini mengaktifkan respons HTTP 202. Halaman ini memakai format asinkron HTTP 200 lama.

Kemampuan model

Kemampuan	`grok-imagine-video`	`grok-imagine-video-1.5`
Teks ke video	✅	✅
Satu atau beberapa gambar referensi	✅	✅
Edit video	✅	❌
`480p`	✅	✅
`720p`	✅	✅
`1080p`	❌	✅
Durasi: 1–15 detik	1–15	1–15
Prompt	1–8000	1–8000

duration     = 8
resolution   = 480p
aspect_ratio = auto

Kontrak publik tidak menetapkan batas tetap jumlah gambar. Gunakan array URL valid yang tidak kosong dan pertahankan urutannya; jangan gunakan batas model gambar.

Header permintaan

string

wajib

Bearer <APIMART_API_KEY>

string

wajib

Selalu gunakan application/json.

string

application/json

string

Idempotency-Key opsional dan sangat disarankan untuk permintaan berbayar. Mendukung 1–191 karakter ASCII terlihat; UUID disarankan. Retry jaringan memakai key dan body asli. Jangan ganti key jika hasil belum pasti.Gunakan Key baru untuk operasi logis baru. Percobaan ulang harus memakai Key dan body asli.

Parameter

Field umum

string

wajib

Nama model resmi; edit hanya model dasar

grok-imagine-video
grok-imagine-video-1.5

string

wajib

Instruksi tidak kosong, maksimal 8000 UnicodeArray.from(prompt).length

boolean

default:false

Menentukan apakah moderasi konten dijalankan sebelum tugas video dikirim.

true: Gunakan omni-moderation-latest untuk memeriksa prompt dan gambar masukan
false atau dihilangkan: Tidak meminta moderasi sehingga tidak menambah biaya atau latensi pemeriksaan (default)

Field pembuatan

integer

default:8

Hanya generasi; integer 1–15, default 8

string

default:"480p"

Base: 480p/720p; 1.5: 480p/720p/1080p; default 480p

grok-imagine-video: 480p, 720p
grok-imagine-video-1.5: 480p, 720p, 1080p

string

default:"auto"

Hanya generasi; auto, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, atau 2:3

auto
1:1, 16:9, 9:16
4:3, 3:4, 3:2, 2:3

string[]

Array opsional; setiap item URL HTTPS publik; hilangkan jika kosong

Setiap item harus berupa URL HTTPS publik; URL relatif, Data URL, dan Base64 mentah tidak didukung.
Jangan kirim alias seperti image, images, atau input_reference.
Urutan dipertahankan; URL duplikat memakai beberapa slot dan dapat ditagih lebih dari sekali.

Field pengeditan video

object

Video sumber {url} HTTPS publik; hanya Base

Tampilkan URL

string

wajib

HTTPS

Pengeditan video memerlukan model, prompt, dan video, serta dapat menyertakan nsfw_check secara opsional. Jangan kirim duration, resolution, aspect_ratio, atau image_urls; platform mendeteksi durasi sumber.

Tipe permintaan TypeScript

Gunakan discriminated union agar field pembuatan tidak terkirim ke pengeditan.

type GrokVideoModel =
  | "grok-imagine-video"
  | "grok-imagine-video-1.5";

type GrokVideoResolution = "480p" | "720p" | "1080p";

type GrokVideoAspectRatio =
  | "auto"
  | "1:1"
  | "16:9"
  | "9:16"
  | "4:3"
  | "3:4"
  | "3:2"
  | "2:3";

interface GrokVideoGenerateRequest {
  model: GrokVideoModel;
  prompt: string;
  nsfw_check?: boolean;
  duration?: number;
  resolution?: GrokVideoResolution;
  aspect_ratio?: GrokVideoAspectRatio;
  image_urls?: string[];
}

interface GrokVideoEditRequest {
  model: "grok-imagine-video";
  prompt: string;
  nsfw_check?: boolean;
  video: { url: string };
}

type GrokVideoRequest =
  | GrokVideoGenerateRequest
  | GrokVideoEditRequest;

Contoh

Teks ke video
1.5 · 1080p
Satu atau beberapa gambar referensi
Edit video

{"model":"grok-imagine-video","prompt":"A cinematic aerial shot at sunrise","duration":5,"resolution":"720p","aspect_ratio":"16:9"}

{"model":"grok-imagine-video-1.5","prompt":"A smooth studio product commercial","duration":5,"resolution":"1080p","aspect_ratio":"16:9"}

{
  "model":"grok-imagine-video-1.5",
  "prompt":"Use the first image as subject and the second as style",
  "duration":5,
  "resolution":"720p",
  "aspect_ratio":"16:9",
  "image_urls":[
    "https://cdn.example.com/subject.jpg",
    "https://cdn.example.com/style.jpg"
  ]
}

{
  "model":"grok-imagine-video",
  "prompt":"Improve motion consistency and apply cinematic color grading",
  "video":{"url":"https://cdn.example.com/source.mp4"}
}

Tugas asinkron

Berhasil membuat

Pembuatan berhasil mengembalikan HTTP 200. Simpan data[0].task_id; pengiriman belum berarti video selesai. ID tugas berarti terkirim, bukan selesai.

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

Periksa tugas

GET https://api.apimart.ai/v1/tasks/{task_id}
Authorization: Bearer <APIMART_API_KEY>
Accept: application/json

Poll GET /v1/tasks/{task_id} tiap 3–5 detik. Setelah reload, lanjutkan dengan ID tersimpan.

`data.status`	Arti	Tindakan
`pending`	Dalam antrean	Lanjut polling
`processing`	Sedang dibuat	Tampilkan progres
`completed`	Selesai	Baca hasil dan berhenti
`failed`	Gagal dan direfund	Tampilkan error dan berhenti
`unknown`	Sementara tidak diketahui	Kurangi frekuensi dan coba nanti

Respons selesai

{
  "code":200,
  "data":{
    "id":"task_xxx",
    "status":"completed",
    "progress":100,
    "created":1787040038,
    "completed":1787040081,
    "actual_time":43,
    "estimated_time":100,
    "cost":0.072,
    "credits_cost":0.72,
    "result":{"videos":[{"url":["https://cdn.example.com/result.mp4"],"expires_at":1787126481}]}
  }
}

result.videos[0].url adalah array string, bukan string tunggal. Validasi setiap nilai sebagai URL HTTPS. Validasi runtime disarankan:

function extractVideoURLs(payload: unknown): string[] {
  const groups = (payload as any)?.data?.result?.videos;
  if (!Array.isArray(groups)) return [];

  return groups.flatMap((group: any) =>
    Array.isArray(group?.url)
      ? group.url.filter(
          (url: unknown): url is string =>
            typeof url === "string" && /^https:///i.test(url),
        )
      : [],
  );
}

Gunakan expires_at untuk masa berlaku. Jangan hard-code durasi; minta pengguna mengunduh atau menyimpan.

Respons gagal

{
  "code":200,
  "data":{
    "id":"task_xxx",
    "status":"failed",
    "progress":100,
    "cost":0,
    "credits_cost":0,
    "error":{"message":"Task failed.","type":"task_failed","param":"","code":"task_failed"}
  }
}

Kueri dapat memberi HTTP 200 saat data.status=failed. Tentukan hasil dari data.status; tugas gagal memiliki cost=0.

Katalog harga

GET https://api.apimart.ai/api/pricing/models/all

Baca GET /api/pricing/models/all dan cari id di data.models.video. Harga hanya estimasi; jumlah final adalah data.cost.

Harga video keluaran

{
  "fixed_prices":{
    "unit":"usd_per_second",
    "dimension":"resolution",
    "items":[
      {"key":"480P","original_price":0.05,"after_discount":0.04},
      {"key":"720P","original_price":0.07,"after_discount":0.056}
    ]
  }
}

Key harga memakai 480P/720P/1080P, sedangkan nilai permintaan huruf kecil; normalkan saat mencari.
default adalah metadata kompatibilitas, bukan resolusi pilihan.
Gunakan after_discount langsung; jangan terapkan diskon lagi.

Harga material masukan

{"unit":"usd_per_image","original_price":0.002,"after_discount":0.0016}

{"unit":"usd_per_second","original_price":0.01,"after_discount":0.008}

Harga input video berupa objek skalar. Jangan wajibkan items, billing_mode, atau max_billable_seconds. Model 1.5 tidak memiliki harga input video.

Rumus estimasi

Generasi = harga output/detik × durasi + harga gambar × jumlah
Edit = harga 720P/detik × detik sumber + harga input video × detik sumber

Harga khusus dan pembulatan server dapat berbeda. Nilai akhir selalu data.cost.

Aturan frontend

Peralihan model

Base hanya 480p/720p; 1.5 juga 1080p.
Dari 1.5 1080p ke Base kembali ke 480p.
Mode edit mengunci grok-imagine-video.

Peralihan mode

Mode	Kontrol yang tampil	Field terkirim	Harus dihapus
Pembuatan	`prompt/duration/resolution/aspect_ratio/nsfw_check`	Field pembuatan	`image_urls/video`
Gambar referensi	Field pembuatan + `image_urls`	Field pembuatan + `image_urls`	`video`
Pengeditan video	`prompt/video/nsfw_check`	`model/prompt/video/nsfw_check`	`duration/resolution/aspect_ratio/image_urls`

nsfw_check bersifat opsional di semua mode. Kirim true saat moderasi aktif; hilangkan atau kirim false saat nonaktif. Nonaktifkan tombol jika salah satu kondisi berikut terpenuhi:

Mode teks menghilangkan image_urls dan video.
Mode referensi mengirim image_urls tanpa video.
Mode edit membersihkan field generasi.
Nonaktifkan untuk prompt, durasi, resolusi, URL tidak valid, upload aktif, atau kiriman duplikat.
Prompt ≤8000 Unicode dan durasi integer 1–15.
Hanya URL HTTPS publik; hilangkan image_urls kosong.

Error umum

HTTP / Status	Penyebab	Penanganan
`400`	Parameter, prompt, atau enum tidak valid	Tampilkan pesan dan field
`401`	API Key tidak ada/tidak valid	Jangan retry; periksa server
`402`	Saldo kurang	Minta top up
`403`	Izin model tidak ada	Jangan retry otomatis
`409`	Konflik idempoten/permintaan aktif	Pertahankan key dan coba nanti
`429`	Rate limit	Ikuti `Retry-After`
`500/502/503`	Gangguan sementara	Retry terbatas dengan key asli
`failed`	Tugas asinkron gagal	Hentikan polling; biaya nol

Checklist frontend

API Key hanya di backend atau BFF.
Jangan campur model resmi dengan grok-imagine-1.5-video-ext.
Prompt ≤8000 Unicode dan durasi integer 1–15.
Hanya URL HTTPS publik; hilangkan image_urls kosong.
Untuk pengeditan, kirim hanya model/prompt/video ditambah nsfw_check opsional dan gunakan model Base.
Baca data[0].task_id dan akhir dari data.status.
Baca result.videos[].url[] dan patuhi expires_at.
Tampilkan katalog dan gunakan data.cost final.

Ikhtisar

Model

Seri Teks

Seri Gambar

Seri Video

Seri Audio

Seri Moderasi

Manajemen Unggahan

Manajemen Tugas

Manajemen Akun

Model Video Resmi Grok

Ringkasan integrasi

Kemampuan model

Header permintaan

Parameter

Field umum

Field pembuatan

Field pengeditan video

Tipe permintaan TypeScript

Contoh

Tugas asinkron

Berhasil membuat

Periksa tugas

Respons selesai

Respons gagal

Katalog harga

Harga video keluaran

Harga material masukan

Rumus estimasi

Aturan frontend

Peralihan model

Peralihan mode

Error umum

Checklist frontend

​Ringkasan integrasi

​Kemampuan model

​Header permintaan

​Parameter

​Field umum

​Field pembuatan

​Field pengeditan video

​Tipe permintaan TypeScript

​Contoh

​Tugas asinkron

​Berhasil membuat

​Periksa tugas

​Respons selesai

​Respons gagal

​Katalog harga

​Harga video keluaran

​Harga material masukan

​Rumus estimasi

​Aturan frontend

​Peralihan model

​Peralihan mode

​Error umum

​Checklist frontend

Ringkasan integrasi

Kemampuan model

Header permintaan

Parameter

Field umum

Field pembuatan

Field pengeditan video

Tipe permintaan TypeScript

Contoh

Tugas asinkron

Berhasil membuat

Periksa tugas

Respons selesai

Respons gagal

Katalog harga

Harga video keluaran

Harga material masukan

Rumus estimasi

Aturan frontend

Peralihan model

Peralihan mode

Error umum

Checklist frontend