Langsung ke konten utama
POST
/
v1
/
videos
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "wan2.7-videoedit",
    "video_urls": ["https://cdn.example.com/original.mp4"],
    "prompt": "Replace the background with a snowy mountain scene",
    "resolution": "1080P"
  }'

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

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

Use this file to discover all available pages before exploring further.

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "wan2.7-videoedit",
    "video_urls": ["https://cdn.example.com/original.mp4"],
    "prompt": "Replace the background with a snowy mountain scene",
    "resolution": "1080P"
  }'

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

​
Otorisasi

​
Authorization
string
wajib
Semua endpoint API memerlukan autentikasi Bearer TokenDapatkan API Key Anda:Kunjungi Halaman Manajemen API Key untuk mendapatkan API Key AndaTambahkan ke header permintaan:
Authorization: Bearer YOUR_API_KEY

​
Parameter Permintaan

​
model
string
wajib
Nama model pembuatan video, tetap sebagai wan2.7-videoedit
​
video_urls
array<string>
wajib
Array URL video sumber untuk pengeditan
Hanya video ke-1 yang digunakan
Batasan video:
  • Format: mp4, mov
  • Durasi: 2–10 detik
  • Resolusi: lebar dan tinggi dalam rentang [240, 4096] piksel
  • Rasio aspek: 1:8 – 8:1
  • Ukuran file: hingga 100MB
​
prompt
string
Instruksi pengeditan yang menjelaskan perubahan yang diinginkan, hingga 5000 karakter
Jika dihilangkan, model akan melakukan transfer gaya default
Contoh: "Change the character's outfit to a red gown", "Replace the background with a snowy mountain scene"
​
negative_prompt
string
Prompt negatif yang menjelaskan konten yang tidak diinginkan, hingga 500 karakter
​
image_urls
array<string>
Array URL gambar referensi, hingga 4 gambarDigunakan untuk menentukan gaya atau tampilan target (misalnya, gaya referensi untuk transfer gaya)
​
resolution
string
default:"1080P"
Resolusi video outputOpsi:
  • 720P - Standar
  • 1080P - Definisi tinggi (default)
​
duration
integer
default:"0"
Durasi video output (detik)
  • 0 (default): pertahankan durasi penuh video asli
  • Bilangan bulat antara 2-10: ambil durasi yang ditentukan dari awal
Ketika duration=0, penagihan didasarkan pada durasi aktual video outputDurasi yang ditentukan tidak boleh melebihi durasi video video_urls asli
​
size
string
Rasio aspek outputFormat yang didukung:
  • 16:9 - Lanskap layar lebar
  • 9:16 - Potret
  • 1:1 - Persegi
  • 4:3 - Lanskap
  • 3:4 - Potret
Jika dihilangkan, rasio aspek mengikuti video input
​
prompt_extend
boolean
default:"true"
Apakah mengaktifkan penulisan ulang prompt cerdasSecara signifikan meningkatkan hasil untuk prompt pendek, namun menambah waktu pemrosesanDefault: true
​
watermark
boolean
default:"false"
Apakah akan menambahkan watermark “AI Generated” ke video yang dihasilkan
  • true: tambahkan watermark
  • false: tanpa watermark (default)
​
seed
integer
Seed bilangan bulat yang digunakan untuk mengontrol keacakan konten yang dihasilkanRentang nilai: bilangan bulat ≥0
  • Untuk permintaan yang identik, model menghasilkan hasil yang berbeda saat menerima nilai seed yang berbeda (misalnya, menghilangkan seed)
  • Untuk permintaan yang identik, model menghasilkan hasil yang serupa saat menerima nilai seed yang sama, namun konsistensi yang tepat tidak dijamin
​
metadata
object
Objek parameter tambahan

​
Respons

​
code
integer
Kode status respons, 200 jika berhasil
​
data
array
Respons data array

​
Kasus Penggunaan

​
Kasus 1: Pengeditan Video Dasar (Paling Sederhana)

{
  "model": "wan2.7-videoedit",
  "video_urls": ["https://cdn.example.com/original.mp4"],
  "prompt": "Replace the background with a snowy mountain scene"
}

​
Kasus 2: Transfer Gaya (Dengan Gambar Referensi)

{
  "model": "wan2.7-videoedit",
  "prompt": "Transfer the video style to the anime style of the reference image",
  "video_urls": ["https://cdn.example.com/original.mp4"],
  "image_urls": [
    "https://cdn.example.com/anime_style.jpg"
  ],
  "resolution": "1080P",
  "watermark": false
}

​
Kasus 3: Pertahankan Audio Video Asli

Cocok untuk video dengan suara latar atau dialog penting: 
{
  "model": "wan2.7-videoedit",
  "video_urls": ["https://cdn.example.com/speech.mp4"],
  "prompt": "Replace the background with a mountain path",
  "metadata": { "audio_setting": "origin" }
}

​
Kasus 4: Parameter Lengkap

{
  "model": "wan2.7-videoedit",
  "prompt": "Change the character's outfit to a red gown",
  "negative_prompt": "blurry, distorted",
  "video_urls": ["https://cdn.example.com/original.mp4"],
  "image_urls": ["https://cdn.example.com/reference.jpg"],
  "resolution": "1080P",
  "duration": 0,
  "size": "16:9",
  "prompt_extend": true,
  "watermark": false,
  "seed": 888,
  "metadata": {
    "audio_setting": "origin"
  }
}

​
Penanganan Audio

audio_settingDeskripsiSkenario yang Cocok
auto (default)AI membuat ulang audio yang sesuai berdasarkan konten video yang dieditPerubahan gaya visual besar saat Anda ingin audio ikut diperbarui
originPaksa pertahankan trek audio video asliVideo dengan musik latar atau dialog penting
Kueri Hasil TugasPembuatan video adalah tugas asinkron yang mengembalikan task_id saat dikirim. Gunakan endpoint Dapatkan Status Tugas untuk mengueri progres dan hasil pembuatan.