VisionStory REST API veya Python SDK ile metin ya da sesten dudak senkronlu konuşan avatar videoları oluşturun. Güncel modelleri, avatarları ve sesleri keşfedin; asenkron bir iş gönderin ve tamamlanan MP4’ü indirin—ya da aynı iş akışını CLI, MCP sunucusu veya Agent Skill ile otomatikleştirin.
Kodlama agent’ınız için tek bir kurulum mesajını kopyalayın veya MCP sunucusunu bağlayıp VisionStory’yi yeniden kullanılabilir bir araç olarak kullanıma açın.
VisionStory CLI
Bir kez kurun. Her API’yi terminalinizden kullanın.
Yükleyici, izole bir ortamda en son PyPI sürümüne yükseltir. Mevcut Python projeleriniz etkilenmez.
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.
Yeni misiniz?
Bir API anahtarı oluşturun, ardından bu prompt’u kodlama agent’ınıza gönderin. Anahtarınızı açığa çıkarmadan visionstory girişinde size rehberlik eder, kredileri doğrular ve videoyu oluşturur.
VisionStory geliştirici araçları
Teknoloji yığınınız için API entegrasyonunu seçin.
REST, Python SDK, CLI, MCP sunucusu ve Agent Skill; aynı kimlik doğrulamalı VisionStory API’sini ve kaynak ID’lerini kullanır. Tek bir arayüzle başlayın, sonra aynı avatar-video iş akışını bir backend’e, CI pipeline’ına veya kodlama ajanına taşıyın.
Sunucu tarafı bir API anahtarı oluşturun, Kredi bakiyenizi doğrulayın ve güncel model, avatar ve Ses ID’lerini keşfedin. POST /api/v1/video uç noktasına bir text_script veya audio_script gönderin; iş oluşturulana kadar yaklaşık her beş saniyede bir sorgulayın, ardından MP4’ü indirin. Tamamlanan video URL’leri 7 gün boyunca saklanır.
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"))
VisionStory model kataloğu
İhtiyacınız olan çıktı için modeli seçin.
Tamamlamanız gereken işle başlayın, ardından çalışma anında güncel model kataloğunu çekin. API yanıtı; mevcut ID’ler, kabul edilen parametreler ve çıktı limitleri için tek doğru kaynaktır.
Avatar, Ses ve Yapay Zeka Video API’lerini birleştirin.
Tek bir API anahtarıyla konuşan sunucular oluşturun, doğal konuşma sentezleyin, özel avatarları, sesleri ve medya varlıklarını yeniden kullanın ve destekleyici video klipleri üretin. Ayrı sağlayıcıları bir araya getirmeden yerelleştirilmiş anlatım videoları, kişiselleştirilmiş onboarding, eğitim, satış iletişimi veya ajan tarafından üretilen medya oluşturun.
Kimlik doğrulama, istekler, asenkron işler, SDK’lar, CLI otomasyonu, MCP ve prodüksiyon kullanımı hakkında doğrudan yanıtlar.
AI avatar video API, dijital bir sunucu ile metni veya kaydedilmiş sesi, bir uygulamanın programatik olarak üretebileceği dudak senkronlu bir videoya dönüştürür. VisionStory kimliği doğrulanmış sunucu tarafı istekleri kabul eder, anında bir video ID döndürür, işi asenkron olarak işler ve üretim tamamlandığında bir MP4 URL’si sağlar.
Bir VisionStory API anahtarı oluşturun, Kredilerinizi doğrulayın, güncel model, avatar ve ses ID’lerini alın; ardından POST /api/v1/video uç noktasına text_script veya audio_script gönderin. API anında bir video ID döndürür. Durumu created olana kadar işi yaklaşık her beş saniyede bir sorgulayın; ardından MP4’ü video_url üzerinden indirin.
Dilden bağımsız kontrol gerektiğinde REST’i; bir Python servisi veya notebook geliştirirken Python SDK’yı; terminal otomasyonu, CI veya toplu üretim içinse CLI’ı kullanın. Üç arayüzün tamamı aynı VisionStory kaynaklarını ve asenkron video iş akışını kullanır.
Evet. VisionStory Agent Skill’i kurun veya VisionStory MCP sunucusuna bağlanın. Desteklenen bir kodlama ajanı; Kredileri doğrulayabilir, güncel modelleri/avatarlari/sesleri listeleyebilir, geçerli bir istek hazırlayabilir, video işini başlatabilir, izleyebilir ve API anahtarı ortamınızda veya MCP gizli depolamasında kalırken sonucu indirebilir.
Evet. Avatarın kaydedilmiş sesten konuşmasını istediğinizde audio_script gönderin; VisionStory’nin konuşmayı sentezlemesi gerektiğinde ise bir ses ID’si ile text_script gönderin. Her istekte ikisini birden göndermek yerine tek bir script türü kullanın.
Video oluşturmayı asenkron bir iş olarak ele alın. İstemci istek ID’nizi ve dönen video ID’yi saklayın, yaklaşık her beş saniyede bir sorgulayın ve iş created veya failed durumuna ulaştığında durun. Tamamlanan video URL’leri yedi gün boyunca tutulur; bu nedenle gerektiğinde bitmiş medyayı kendi kalıcı depolamanıza kopyalayın.
VISIONSTORY_API_KEY’i bir sunucu ortam değişkeninde, CI secret’ında veya MCP istemci gizli deposunda tutun ve X-API-Key istek başlığı üzerinden gönderin. Anahtarı asla tarayıcı koduna, bir mobil uygulama paketine, herkese açık bir repoya, ekran görüntülerine, loglara veya bir yapay zekâ sohbet mesajına gömmeyin.
Avatar videoyu; Metinden Konuşmaya, herkese açık veya klonlanmış sesler, yeniden kullanılabilir görsel ve ses varlıkları, transkripsiyon, yapay zekâ görsel üretimi ve öncü video modelleriyle birleştirebilirsiniz. Bu temel bileşenler; yerelleştirilmiş anlatım videolarını, kişiselleştirilmiş erişimi, otomatik öğrenme içeriklerini ve yapay zekâ ajanlı medya iş akışlarını destekler.
Tek bir kimliği doğrulanmış istekle başlayın
İlk AI avatar video entegrasyonunuzu oluşturun.
Bir API anahtarı oluşturun, Kredilerinizi doğrulayın ve 5 adımlı konuşan avatar hızlı başlangıcını çalıştırın. REST veya Python ile başlayın; ardından iş akışınız büyüdükçe CLI otomasyonu, MCP araçları veya Agent Skill ekleyin. Model, avatar veya ses ID’lerini hard-code etmek yerine canlı kaynak uç noktalarını sorgulayın.
