Bina video avatar bercakap yang diselaraskan bibir daripada teks atau audio dengan VisionStory REST API atau Python SDK. Temui model, avatar dan suara semasa, hantar tugasan tak segerak, dan muat turun MP4 yang siap—atau automasikan aliran kerja yang sama dengan CLI, pelayan MCP, atau Agent Skill.
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 | bashnpx 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.
Baharu di sini?
Cipta kunci API, kemudian hantar prompt ini kepada ejen pengekodan anda. Ia akan membimbing anda melalui log masuk VisionStory, mengesahkan kredit, dan mencipta video tanpa mendedahkan kunci anda.
Alat pembangun VisionStory
Pilih integrasi API untuk stack anda.
REST, Python SDK, CLI, pelayan MCP dan Agent Skill semuanya menggunakan API VisionStory yang sama dengan pengesahan serta ID sumber yang sama. Mulakan dengan satu antara muka, kemudian pindahkan aliran kerja video avatar yang sama ke dalam backend, saluran paip CI, atau ejen pengekodan.
Cipta kunci API di sisi pelayan, sahkan baki Kredit anda, dan temui ID model, avatar dan suara semasa. Hantar satu text_script atau audio_script ke POST /api/v1/video, poll kira-kira setiap lima saat sehingga tugasan dicipta, kemudian muat turun MP4. URL video yang siap disimpan selama tujuh hari.
create_video.py
from pathlib import Pathfrom visionstory import VisionStoryClient, build_video_payloadclient = 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 perlukan.
Mulakan dengan tugasan yang anda perlu siapkan, kemudian dapatkan katalog model semasa ketika runtime. Respons API ialah sumber kebenaran untuk ID yang tersedia, parameter yang diterima, dan had output.
Gunakan satu kunci API untuk mencipta penyampai bercakap, mensintesis pertuturan semula jadi, guna semula avatar tersuai, suara dan aset media, serta menjana klip video sokongan. Bina video penerangan setempat, onboarding diperibadikan, pendidikan, outreach jualan, atau media yang dicipta ejen tanpa perlu menggabungkan penyedia berasingan.
Jawapan terus tentang pengesahan, permintaan, tugasan tak segerak, SDK, automasi CLI, MCP, dan penggunaan produksi.
API video avatar AI menukar penyampai digital bersama teks atau audio rakaman kepada video segerak bibir yang boleh dijana secara programatik oleh aplikasi. VisionStory menerima permintaan sisi pelayan yang disahkan, mengembalikan ID video serta-merta, merender tugasan secara tak segerak, dan menyediakan URL MP4 apabila penjanaan selesai.
Cipta kunci API VisionStory, sahkan kredit anda, dapatkan ID model, avatar dan suara semasa, kemudian hantar sama ada text_script atau audio_script ke POST /api/v1/video. API mengembalikan ID video serta-merta. Poll tugasan kira-kira setiap lima saat sehingga statusnya created, kemudian muat turun MP4 daripada video_url.
Gunakan REST apabila anda perlukan kawalan yang tidak bergantung pada bahasa, Python SDK apabila anda membina perkhidmatan atau notebook Python, dan CLI untuk automasi terminal, CI, atau penjanaan batch. Ketiga-tiga antara muka menggunakan sumber VisionStory yang sama serta aliran kerja video tak segerak.
Ya. Pasang VisionStory Agent Skill atau sambungkan pelayan VisionStory MCP. Ejen pengekodan yang disokong boleh mengesahkan kredit, menyenaraikan model, avatar, dan suara semasa, menyediakan permintaan yang sah, memulakan tugasan video, memantaunya, dan memuat turun hasilnya sementara kunci API kekal dalam persekitaran anda atau stor rahsia MCP.
Ya. Hantar audio_script apabila anda mahu avatar bercakap daripada audio rakaman, atau hantar text_script bersama ID suara apabila VisionStory perlu mensintesis pertuturan. Gunakan satu jenis skrip bagi setiap permintaan, bukannya menghantar kedua-duanya.
Anggap penciptaan video sebagai tugasan tak segerak. Simpan ID permintaan klien anda dan ID video yang dikembalikan, poll kira-kira setiap lima saat, dan hentikan apabila tugasan mencapai created atau failed. URL video yang siap disimpan selama tujuh hari, jadi salin media yang telah siap ke storan kekal anda sendiri apabila diperlukan.
Simpan VISIONSTORY_API_KEY dalam pembolehubah persekitaran pelayan, rahsia CI, atau stor rahsia klien MCP dan hantarkannya melalui header permintaan X-API-Key. Jangan sekali-kali benamkan kunci dalam kod pelayar, bundle aplikasi mudah alih, repositori awam, tangkapan skrin, log, atau mesej sembang AI.
Anda boleh menggabungkan video avatar dengan Teks ke Pertuturan, suara awam atau suara klon, aset imej dan audio yang boleh diguna semula, transkripsi, penjanaan imej AI, dan model video termaju. Komponen asas ini menyokong video penerangan setempat, outreach diperibadikan, kandungan pembelajaran automatik, dan aliran kerja media ejen AI.
Mulakan dengan satu permintaan yang disahkan
Bina integrasi video avatar AI pertama anda.
Cipta kunci API, sahkan kredit anda, dan jalankan quickstart avatar bercakap 5 langkah. Mulakan dengan REST atau Python, kemudian tambah automasi CLI, alat MCP, atau Agent Skill apabila aliran kerja anda berkembang. Buat pertanyaan pada endpoint sumber langsung dan bukannya hard-code ID model, avatar, atau suara.
