Apa itu API video avatar AI?

API video avatar AI mengubah presenter digital plus teks atau audio rekaman menjadi video lip-sync yang bisa dihasilkan aplikasi secara terprogram. VisionStory menerima request server-side yang terautentikasi, segera mengembalikan ID video, merender job secara asinkron, dan menyediakan URL MP4 saat proses generasi selesai.

Bagaimana cara membuat video avatar AI dengan VisionStory API?

Buat VisionStory API key, verifikasi kredit Anda, ambil ID model, avatar, dan suara terbaru, lalu kirim text_script atau audio_script ke POST /api/v1/video. API akan langsung mengembalikan ID video. Poll job kira-kira setiap lima detik hingga statusnya menjadi created, lalu unduh MP4 dari video_url.

Sebaiknya saya menggunakan REST API, Python SDK, atau CLI?

Gunakan REST saat Anda membutuhkan kontrol yang tidak bergantung pada bahasa, Python SDK saat Anda membangun layanan Python atau notebook, dan CLI untuk otomasi terminal, CI, atau generasi batch. Ketiga interface ini menggunakan resource VisionStory yang sama dan alur kerja video asinkron.

Bisakah Codex, Claude Code, atau Cursor membuat video avatar untuk saya?

Bisa. Instal VisionStory Agent Skill atau hubungkan VisionStory MCP server. Agen coding yang didukung dapat memverifikasi kredit, menampilkan daftar model, avatar, dan suara terbaru, menyiapkan request yang valid, memulai job video, memantaunya, dan mengunduh hasilnya, sementara API key tetap berada di environment Anda atau penyimpanan secret MCP.

Bisakah saya membuat video avatar dari audio, bukan dari teks?

Ya. Kirim audio_script saat Anda ingin avatar berbicara dari audio rekaman, atau kirim text_script dengan ID suara saat VisionStory perlu mensintesis ucapan. Gunakan satu jenis script per request, bukan mengirim keduanya.

Bagaimana integrasi production sebaiknya menangani pembuatan video?

Perlakukan pembuatan video sebagai job asinkron. Simpan ID request klien Anda dan ID video yang dikembalikan, lakukan polling kira-kira setiap lima detik, dan hentikan saat job mencapai status created atau failed. URL video yang selesai akan disimpan selama tujuh hari, jadi salin media yang sudah jadi ke penyimpanan permanen Anda sendiri bila diperlukan.

Di mana saya harus menyimpan VisionStory API key saya?

Simpan VISIONSTORY_API_KEY di environment variable server, CI secret, atau penyimpanan secret klien MCP, lalu kirimkan melalui header request X-API-Key. Jangan pernah menyematkan key di kode browser, bundle aplikasi mobile, repositori publik, tangkapan layar, log, atau pesan chat AI.

Apa yang bisa saya gabungkan dengan API Video Avatar?

Anda bisa menggabungkan video avatar dengan teks ke suara, suara publik atau suara hasil kloning, aset gambar dan audio yang dapat digunakan ulang, transkripsi, pembuatan gambar AI, dan model video frontier. Komponen dasar ini mendukung video penjelasan terlokalisasi, outreach yang dipersonalisasi, konten pembelajaran otomatis, dan workflow media berbasis agen AI.

VisionStory API
dibuat untuk developer

Buat video avatar berbicara dengan lip-sync dari teks atau audio dengan VisionStory REST API atau Python SDK. Temukan model, avatar, dan suara terbaru, kirim job asinkron, lalu unduh MP4 yang sudah jadi—atau otomatisasi alur kerja yang sama dengan CLI, server MCP, atau Agent Skill.

Jelajahi Dokumentasi Developer

POST /api/v1/video

REST API
Python SDK
CLI
MCP
Agent Skill

Siap untuk agent

Berfungsi di Tempat Agent Anda Bekerja.

Salin satu pesan setup untuk agent coding Anda, atau hubungkan server MCP dan jadikan VisionStory sebagai tool yang bisa digunakan ulang.

VisionStory CLI

Instal sekali. Gunakan semua API dari terminal Anda.

Installer akan mengupgrade ke rilis PyPI terbaru dalam environment terisolasi. Proyek Python Anda yang sudah ada tetap tidak tersentuh.

curl -fsSL https://developers.visionstory.ai/cli | bash

macOS · Linux · WSLOpsi instalasi

Kirim prompt setup ini ke Claude Code

Help me set up VisionStory and generate a talking-avatar video.1. Install or update the CLI and Agent Skill:   curl -fsSL https://developers.visionstory.ai/cli | bash   npx skills add visionstory-ai/skills --skill visionstory-api2. Run visionstory doctor. If I need a key, send me to https://developers.visionstory.ai/api-keys, wait while I create one, then ask me to run visionstory login in my terminal. Never ask me to paste the key into chat or expose it.3. Verify access with visionstory credits. Stop and help me if it fails.4. Discover current models, avatars, and voices, then use the CLI and visionstory-api skill to create and download the video. Never delete anything unless I explicitly request and confirm it.

Baru di sini?

Buat API key, lalu kirim prompt ini ke agent coding Anda. Agent akan memandu Anda untuk login visionstory, memverifikasi kredit, dan membuat video tanpa membocorkan key Anda.

Tool developer VisionStory

Pilih integrasi API untuk stack Anda.

REST, Python SDK, CLI, server MCP, dan Agent Skill semuanya menggunakan VisionStory API terautentikasi dan resource ID yang sama. Mulai dari satu antarmuka, lalu pindahkan alur kerja video avatar yang sama ke backend, pipeline CI, atau coding agent.

01REST

Panggil REST API

Panggil VisionStory dari bahasa backend apa pun. Tampilkan daftar model, avatar, dan suara terbaru; kirim text_script atau audio_script ke POST /api/v1/video; lakukan polling job hingga dibuat; lalu unduh MP4-nya.

Lihat referensi REST API 02PYTHON

Bangun dengan Python SDK

Gunakan klien Python bertipe tanpa dependency untuk autentikasi berbasis environment, penyusunan payload, upload, polling job, dan unduhan. Cocok untuk aplikasi Python, notebook, dan layanan media internal.

Baca quickstart Python SDK 03CLI

Otomatiskan dengan CLI

Jalankan visionstory doctor, verifikasi kredit, temukan resource ID, buat video avatar, periksa tugas, dan unduh hasilnya dari terminal, shell script, atau job CI tanpa perlu membuat aplikasi terlebih dahulu.

Instal dan verifikasi CLI 04MCP / SKILL

Hubungkan AI coding agent

Hubungkan server MCP VisionStory atau instal Agent Skill agar Codex, Claude Code, Cursor, Windsurf, Cline, dan Gemini dapat menemukan resource, menghasilkan media, dan mengunduh hasilnya sementara API key tetap tersimpan di secret storage lokal.

Hubungkan MCP atau Agent Skill

Quickstart API avatar berbicara

Buat video avatar berbicara pertama Anda.

Buat API key untuk sisi server, verifikasi saldo kredit Anda, dan temukan ID model, avatar, serta suara terbaru. Kirim text_script atau audio_script ke POST /api/v1/video, lakukan polling kira-kira setiap lima detik hingga job dibuat, lalu unduh MP4. URL video yang sudah selesai disimpan selama tujuh hari.

create_video.py

from pathlib import Pathfrom visionstory import VisionStoryClient, build_video_payload client = VisionStoryClient.from_env()payload = build_video_payload(    avatar_id="YOUR_AVATAR_ID",    text="Hello from my product.",    voice_id="YOUR_VOICE_ID",)video = client.generate_video(payload)client.download(video["video_url"], Path("result.mp4"))

Katalog model VisionStory

Pilih model untuk output yang Anda butuhkan.

Mulai dari job yang perlu Anda selesaikan, lalu ambil katalog model terbaru saat runtime. Respons API menjadi sumber kebenaran untuk ID yang tersedia, parameter yang diterima, dan batas output.

Avatar berbicaraVisionStory

V-Character 4.0

vs_character_v4

Model karakter native VisionStory mengubah satu potret plus teks atau audio rekaman menjadi performa yang konsisten dengan identitas, dengan gerakan yang ekspresif dan lip-sync yang natural.

Teks atau audio rekaman
720p, 1080p, atau 2K
Hingga 10 menit

Sekuens mobil sinematik yang dibuat dengan model Video AI Seedance

Video AIByteDance

Seedance 2.5

seedance-2.5

Buat video berbasis prompt maupun gambar dengan gerakan yang koheren, pergerakan kamera sinematik, dan klip tunggal yang lebih panjang.

Teks-ke-video
Gambar-ke-video
Klip 4–30 detik

Delima kaca yang detail, dibuat dengan model gambar Nano Banana

Gambar AIGoogle

Nano Banana 2

nano-banana-2

Hasilkan gambar beresolusi tinggi, render teks dengan andal, dan sempurnakan hasil lewat pengeditan percakapan yang dipandu referensi.

Prompt-ke-gambar
Pengeditan berpandu referensi
Output 1K dan 2K

API media AI yang dapat dikomposisikan

Kombinasikan API avatar, suara, dan Video AI.

Gunakan satu API key untuk membuat presenter yang berbicara, menyintesis ujaran natural, memakai ulang avatar kustom, suara, dan aset media, serta menghasilkan klip video pendukung. Buat video penjelasan berbahasa lokal, onboarding yang dipersonalisasi, edukasi, outreach sales, atau media buatan agent tanpa perlu merangkai provider terpisah.

Alur kerja avatar inti

API video avatar berbicara

Hasilkan video presenter dengan lip-sync dari teks atau audio rekaman. Pilih avatar publik atau buat avatar kustom yang bisa dipakai ulang dari satu potret, pilih suara publik atau suara hasil kloning, lalu terima MP4 yang bisa diunduh saat job asinkron selesai.

Naskah yang berubah menjadi gelombang audio melalui API teks-ke-suara VisionStory

Lapisan suara dan ucapan

API teks-ke-suara dan suara

Ubah teks menjadi ucapan MP3 yang natural dengan suara publik atau suara hasil kloning, lalu gunakan kembali suara yang sama di berbagai video avatar dan konten terlokalisasi. Query katalog suara saat runtime alih-alih hard-code ID suara.

Prompt yang berubah menjadi video hasil generasi melalui VisionStory API Video AI

Pembuatan yang diarahkan agen

API pembuatan Video AI

Buat klip teks-ke-video, gambar-ke-video, dan klip berbasis referensi dengan model yang dipilih dari katalog live. Agen AI dapat menyiapkan prompt dan aset, memperkirakan kredit, mengirim job, dan menggabungkan hasilnya dengan presenter avatar.

FAQ API Video Avatar AI

Jawaban langsung tentang autentikasi, request, job asinkron, SDK, otomasi CLI, MCP, dan penggunaan production.

API video avatar AI mengubah presenter digital plus teks atau audio rekaman menjadi video lip-sync yang bisa dihasilkan aplikasi secara terprogram. VisionStory menerima request server-side yang terautentikasi, segera mengembalikan ID video, merender job secara asinkron, dan menyediakan URL MP4 saat proses generasi selesai.
Buat VisionStory API key, verifikasi kredit Anda, ambil ID model, avatar, dan suara terbaru, lalu kirim text_script atau audio_script ke POST /api/v1/video. API akan langsung mengembalikan ID video. Poll job kira-kira setiap lima detik hingga statusnya menjadi created, lalu unduh MP4 dari video_url.
Gunakan REST saat Anda membutuhkan kontrol yang tidak bergantung pada bahasa, Python SDK saat Anda membangun layanan Python atau notebook, dan CLI untuk otomasi terminal, CI, atau generasi batch. Ketiga interface ini menggunakan resource VisionStory yang sama dan alur kerja video asinkron.
Bisa. Instal VisionStory Agent Skill atau hubungkan VisionStory MCP server. Agen coding yang didukung dapat memverifikasi kredit, menampilkan daftar model, avatar, dan suara terbaru, menyiapkan request yang valid, memulai job video, memantaunya, dan mengunduh hasilnya, sementara API key tetap berada di environment Anda atau penyimpanan secret MCP.
Ya. Kirim audio_script saat Anda ingin avatar berbicara dari audio rekaman, atau kirim text_script dengan ID suara saat VisionStory perlu mensintesis ucapan. Gunakan satu jenis script per request, bukan mengirim keduanya.
Perlakukan pembuatan video sebagai job asinkron. Simpan ID request klien Anda dan ID video yang dikembalikan, lakukan polling kira-kira setiap lima detik, dan hentikan saat job mencapai status created atau failed. URL video yang selesai akan disimpan selama tujuh hari, jadi salin media yang sudah jadi ke penyimpanan permanen Anda sendiri bila diperlukan.
Simpan VISIONSTORY_API_KEY di environment variable server, CI secret, atau penyimpanan secret klien MCP, lalu kirimkan melalui header request X-API-Key. Jangan pernah menyematkan key di kode browser, bundle aplikasi mobile, repositori publik, tangkapan layar, log, atau pesan chat AI.
Anda bisa menggabungkan video avatar dengan teks ke suara, suara publik atau suara hasil kloning, aset gambar dan audio yang dapat digunakan ulang, transkripsi, pembuatan gambar AI, dan model video frontier. Komponen dasar ini mendukung video penjelasan terlokalisasi, outreach yang dipersonalisasi, konten pembelajaran otomatis, dan workflow media berbasis agen AI.

Mulai dengan satu request terautentikasi

Bangun integrasi video avatar AI pertama Anda.

Buat API key, verifikasi kredit Anda, dan jalankan quickstart talking-avatar dalam lima langkah. Mulai dengan REST atau Python, lalu tambahkan otomasi CLI, tools MCP, atau Agent Skill seiring workflow Anda berkembang. Query endpoint resource live alih-alih hard-code ID model, avatar, atau suara.

Buat VisionStory API key Jelajahi docs developer