Dokumentasi Referensi API Referensi SDK Penggunaan Agentik Skill AI

Video

Kirim permintaan pembuatan video

Mengirim job pembuatan video asinkron. Segera mengembalikan 202 dengan id job (awalan vjob_); poll GET /api/v1/videos/{id} hingga status completed, lalu unduh melalui unsigned_urls. Penagihan: kredit dicadangkan saat pengiriman dari duration × resolution, dan diselesaikan berdasarkan detik yang benar-benar dikirim (usage.cost dalam respons poll).

POST/api/v1/videos

Otorisasi

Authorizationwajib

string · header

API key sebagai bearer token di header Authorization.

Body

modelwajib

string

ID model pembuatan video (berawalan penyedia).

Example: "alibaba/wan2.7-t2v"

promptwajib

string

Prompt teks yang menjelaskan video yang akan dibuat.

duration

integer

Durasi video dalam detik. Default 2. Setiap model punya batas lebih ketat — mis. reference-to-video (r2v) mengizinkan 2–10 dtk; nilai di luar rentang mengembalikan 400 sebelum kredit dicadangkan.

1–600 (per-model bounds are tighter; reference-to-video: 2–10)

Example: 5

resolution

string

Tingkat kualitas keluaran, default "720p". Tingkat yang didukung berbeda per model; tingkat yang tidak didukung mengembalikan 400 sebelum kredit dicadangkan, dan pesan error mencantumkan tingkat yang didukung.

480p720p1080p

Example: "720p"

aspect_ratio

string

Rasio aspek. Nilai umum: "16:9", "9:16", "1:1", "4:3", "3:4"; set persisnya tergantung model (beberapa juga menerima rasio lebar seperti "21:9"). Kombinasi yang tidak didukung mengembalikan 400 sebelum kredit dicadangkan; mode dengan frame masukan mengambil rasio dari frame dan mengabaikan field ini.

16:99:161:14:33:43:22:321:99:21

Example: "16:9"

frame_images

array

Gambar keyframe awal/akhir (image-to-video, keyframe-to-video). Menerima string URL, atau objek { type: "image", image_url: { url }, frame_type: "first" | "last" }.

input_references

object[] | string[]

Aset referensi (reference-to-video): memandu pembuatan dengan item referensi — utamakan bentuk objek { type: "image", image_url: { url } } (string URL juga diterima, dianggap referensi gambar). Referensi gambar didukung paling luas; objek referensi audio/video diteruskan apa adanya dan hanya berlaku pada model yang mendukungnya — model lain memakai referensi gambar saja. Hanya model dengan mode r2v yang menerima field ini.

input_video

string | object

Video sumber (khusus model edit video; field ekstensi BazaarLink). Menerima string URL, { video_url: { url } }, atau { url }. Diabaikan oleh model non-edit. Pengeditan ditagih berdasarkan detik sumber + detik keluaran.

generate_audio

boolean

Apakah juga menghasilkan audio. Hanya efektif pada model yang mendukung audio; detik dengan audio ditagih dengan tarif per detik lebih tinggi.

watermark

boolean

Apakah memberi watermark pada keluaran. Default false — BazaarLink secara aktif menonaktifkan watermark bawaan kecuali Anda secara eksplisit mengirim true.

seed

number

Seed pengambilan sampel. Jaminan reproduksibilitas bervariasi per model.

callback_url

string

URL webhook yang dipanggil saat status akhir job tercapai, sehingga Anda tidak perlu polling. Hanya HTTPS, dan diperiksa SSRF (alamat privat/internal ditolak) sebelum kredit dicadangkan. Terpicu tepat satu kali, hanya dari permintaan yang memenangkan penentuan status akhir; pengiriman dicoba ulang saat gagal (2 kali, backoff 2d/8d), dan percobaan ulang yang habis tidak pernah memengaruhi penagihan atau status job yang sebenarnya. Tidak ada tanda tangan di v1 — perlakukan callback sebagai petunjuk, dan konfirmasi status/jumlah dengan memanggil GET /v1/videos/{id} menggunakan API key Anda sebelum bertindak. ⚠️ unsigned_urls pada payload webhook adalah URL absolut, berbeda dari path relatif yang dikembalikan endpoint poll.

https:// only, ≤2048 chars

Panduan mendalam →

POST /api/v1/videos

1
2
3
4
5
6
7
8
9
10
curl https://bazaarlink.ai/api/v1/videos \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan2.7-t2v",
    "prompt": "a corgi surfing a wave at sunset",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

Contoh respons

Job diterima (asinkron). Poll polling_url yang dikembalikan (GET /api/v1/videos/{id}) untuk status; interval ≥5 dtk disarankan.

1
2
3
4
5
{
  "id": "vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk",
  "status": "pending",
  "polling_url": "/api/v1/videos/vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk"
}