Video Enhancer API

Kirim video yang sudah tersimpan di platform, atau file yang Anda unggah, dan terima versi yang ditingkatkan pada 1080p, 2K, atau 4K. Penajaman teks di layar dapat diaktifkan atau dinonaktifkan. Anda dapat meningkatkan seluruh video atau klip hingga 10 menit.

Sumber video yang didukung

Berikan URL file platform, atau identity yang dikembalikan oleh Upload API. Unggahan lokal memerlukan paket Starter atau lebih tinggi.

Alur

Kirim tugas peningkatan dengan video sumber dan resolusi target
Polling hasil hingga status menjadi DONE atau ERROR
Saat status adalah DONE, baca output_url

Endpoint

Metode	Path	Deskripsi
`POST`	`/api/v2/video-enhancer`	Kirim tugas peningkatan
`GET`	`/api/v2/video-enhancer/results/{id}`	Ambil hasil tugas

Semua permintaan memerlukan:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
x-wayinvideo-api-version: v2

Kirim tugas peningkatan

POST https://wayinvideo-api.wayin.ai/api/v2/video-enhancer

Isi permintaan

Parameter	Tipe	Wajib	Default	Deskripsi
`video_url`	string	Ya	—	URL file platform, atau `identity` yang dikembalikan oleh Upload API.
`target_res`	string	Ya	—	Resolusi keluaran. Nilai yang diizinkan: `1080p`, `2k`, `4k`.
`enable_text_hd`	boolean	Tidak	`true`	Tajamkan teks di layar. Jika bidang ini dihilangkan, nilai default adalah `true`.
`start_ms`	integer	Tidak	—	Awal klip, dalam milidetik. Hilangkan `start_ms` dan `end_ms` untuk memproses seluruh video, tetap dengan batas 10 menit. Mengirim hanya salah satu dari keduanya akan ditolak.
`end_ms`	integer	Tidak	—	Akhir klip, dalam milidetik. Harus lebih besar dari `start_ms` dan tidak boleh melebihi durasi sumber.

Rentang yang diproses tidak boleh lebih dari 10 menit. Penagihan memakai rentang itu, dibulatkan ke atas ke detik penuh berikutnya. Tarif ada di halaman Penagihan.

Contoh permintaan

curl -X POST https://wayinvideo-api.wayin.ai/api/v2/video-enhancer \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -d '{
    "video_url": "EF_up_06wguq1afbwg1",
    "target_res": "1080p",
    "enable_text_hd": true,
    "start_ms": 0,
    "end_ms": 8000
  }'

import requests

requests.post(
    "https://wayinvideo-api.wayin.ai/api/v2/video-enhancer",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "x-wayinvideo-api-version": "v2",
    },
    json={
        "video_url": "EF_up_06wguq1afbwg1",
        "target_res": "1080p",
        "enable_text_hd": True,
        "start_ms": 0,
        "end_ms": 8000,
    },
)

await fetch('https://wayinvideo-api.wayin.ai/api/v2/video-enhancer', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'x-wayinvideo-api-version': 'v2',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    video_url: 'EF_up_06wguq1afbwg1',
    target_res: '1080p',
    enable_text_hd: true,
    start_ms: 0,
    end_ms: 8000,
  }),
});

Respons

Tugas yang baru dikirim biasanya berstatus PENDING (masih antre) atau IN_PROGRESS (sudah berjalan).

{
  "data": {
    "id": "proj_01HQ2X8J3K4L5M6N7O8P9Q0R",
    "status": "IN_PROGRESS"
  }
}

Bidang	Tipe	Deskripsi
`id`	string	Project id. Masukkan di path hasil.
`status`	string	`PENDING` (antre), `IN_PROGRESS` (berjalan), `DONE` (selesai), atau `ERROR` (gagal).
`output_url`	string	URL video yang ditingkatkan. Hanya ada saat `status` adalah `DONE`.

Ambil hasil peningkatan

Polling dengan id dari respons pengiriman hingga status menjadi DONE atau ERROR. Saat status adalah DONE, baca output_url.

GET https://wayinvideo-api.wayin.ai/api/v2/video-enhancer/results/{id}

Contoh permintaan

curl -X GET https://wayinvideo-api.wayin.ai/api/v2/video-enhancer/results/proj_01HQ2X8J3K4L5M6N7O8P9Q0R \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2"

Respons

{
  "data": {
    "id": "proj_01HQ2X8J3K4L5M6N7O8P9Q0R",
    "status": "DONE",
    "output_url": "https://cdn.viralhub.ai/user/video_0_8000_1080p.mp4"
  }
}

Bidang-bidangnya sama dengan respons pengiriman. output_url disertakan saat tugas selesai.

Penagihan

Video Enhancer memakai Unit API untuk rentang yang diproses, dibulatkan ke atas ke detik penuh berikutnya. Kurang dari 1 detik dihitung sebagai 1 detik.

Resolusi target	Unit API
1080p	1 per detik
2K (`2k`)	2 per detik
4K (`4k`)	4 per detik

Jika akun tidak memiliki Unit API yang cukup, tugas tidak dibuat dan tidak ada unit yang dipotong. Lihat Penagihan dan Kode Status.

Kesalahan

Permintaan yang gagal memakai kode status dan format respons standar. Lihat Kode Status.