Referensi · Videos — text-to-video terjaga dan asinkron. Anda mendapat penawaran harga, mengirim job, memantau statusnya, lalu mengunduh file.

Ikhtisar

Cara kerja job video

GET /v1/videos/models menampilkan model yang bisa Anda pakai sekarang, masing-masing dengan from_price (klip termurah yang bisa dibuat).
POST /v1/videos/quote menghitung harga permintaan Anda tanpa menahan saldo.
POST /v1/videos mengembalikan 202 berisi job. Harga yang ditawarkan ditahan dari saldo prabayar Anda dan hanya ditagih saat video terkirim. Job yang gagal, diblokir, atau kedaluwarsa dikembalikan.
Pantau GET /v1/videos/{id} sampai status bernilai completed, lalu GET /v1/videos/{id}/content mengalihkan (302) ke URL unduhan berumur pendek.

Harga adalah harga penyedia untuk klip tersebut ditambah margin kami, dalam dolar AS (quote_usd) dan, jika kurs tersedia, dalam Rupiah (quote_idr). Kredit pendaftaran dan pass tidak bisa dipakai untuk video; video memerlukan saldo isi ulang.

Draf gratis: setiap akun dengan email terverifikasi bisa membuat satu draf gratis selama anggaran draf gratis bulanan masih tersedia ("free_draft": true: Veo 3.1 Lite, 4 detik, 720p, tanpa audio).

Request

Body

curl https://api.anoman.io/v1/videos \
  -H "Authorization: Bearer anm-sk-..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 6f1c2b9e-launch-001" \
  -d '{
    "model": "veo-3.1-lite",
    "prompt": "A calm lake at sunrise, slow aerial push-in",
    "seconds": 4,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "audio": false
  }'

Field	Deskripsi
`model`	Id model dari `GET /v1/videos/models`, atau `auto` (default) agar gateway memilih berdasarkan `quality`.
`prompt`	Teks prompt, maksimal 2.000 karakter. Wajib.
`seconds`	Durasi klip. Setiap model mencantumkan durasi yang didukung. Wajib.
`resolution`	mis. `720p` (default) atau `1080p`, sesuai daftar model.
`aspect_ratio`	`16:9` (default), `9:16` atau `1:1`, sesuai daftar model.
`audio`	Minta trek audio jika model menyediakannya sebagai opsi.
`quality`	Untuk `auto`: `draft`, `standard` (default) atau `high`.
`negative_prompt`, `seed`	Opsional, jika model mendukung.
`max_price_usd` / `max_price_idr`	Tolak (`409 price_changed`) jika harga kini di atas yang Anda tampilkan ke pengguna.
`free_draft`	`true` untuk satu draf gratis (menimpa model, durasi, resolusi, dan audio).

Kirim header Idempotency-Key agar percobaan ulang mengembalikan job yang sama, bukan penahanan saldo kedua. Image-to-video belum tersedia.

Batas & guard

Penjaga prompt. Keselamatan anak, ekstremisme kekerasan, NSFW, dan moderasi konten (Inggris + Bahasa Indonesia) berjalan sebelum saldo ditahan; data pribadi yang tervalidasi disamarkan sebelum prompt dikirim.
Pemeriksaan hasil. Frame setiap hasil diperiksa untuk ketelanjangan sebelum dikirim; hasil yang diblokir dikembalikan dananya.
Label. File bernama …-ai-generated.mp4 dan membawa manifest C2PA yang ditandatangani Anoman (self-signed).
Lokasi pemrosesan. Pembuatan berjalan di fal.ai, di luar Indonesia (fal tidak memublikasikan wilayahnya), sesuai ketentuan pemilik model (terms pada setiap model).
Batas. Batas belanja harian dan batas job berjalan per workspace; antrean yang penuh mengembalikan 503 tanpa menahan saldo.

Error

Status	`error`	Arti
402	`insufficient_balance`	Saldo isi ulang tidak cukup untuk penawaran ini.
409	`price_changed`	Harga di atas `max_price_*` Anda.
409	`free_draft_unavailable`	Draf gratis sudah dipakai atau tidak tersedia.
429	`video_daily_cap_reached` / `concurrent_limit`	Batas workspace tercapai.
503	`capacity` / `video_temporarily_unavailable`	Coba lagi nanti; tidak ada biaya.

Response

Contoh ilustratif — angkanya bukan daftar harga; penawaran harga terkini berasal dari API (POST /v1/videos/quote).

{
  "id": "vid_1a2b3c4d5e6f7a8b9c0d1e2f",
  "object": "video",
  "status": "queued",
  "model": "veo-3.1-lite",
  "seconds": 4,
  "_anoman": {
    "quote_usd": "0.1500",
    "quote_idr": 2775,
    "held": true,
    "poll_url": "/v1/videos/vid_1a2b3c4d5e6f7a8b9c0d1e2f",
    "label": "AI-generated"
  }
}

POST /v1/videos