Motion Control API
Bir performansı bir karaktere aktarın: bu modellere bir karakter görseli ve bir sürücü video verin; hareket — çoğu zaman yüz ifadesi de — sizin öznenize kopyalansın. Çıktı saniyesi başına fiyatlandırılır, yani kısa bir klip sent mertebesinde tutar ve buradaki her modelde aynı istek şekli çalışır.
Şu anda 4 motion control modeli kullanılabilir — hepsi ücretsiz Playground’da, REST API ve JavaScript SDK üzerinden ya da MCP ile bir yapay zekâ asistanından çalıştırılabilir.
Motion Control modelleri ve fiyatlandırma
| Model | Uç nokta | Fiyat |
|---|---|---|
| Kling 3.0 Motion Control | kuaishou/kling-video/v3/motion-control | $0.168 per second of video |
| Wan 2.2 Animate Move | wan-video/wan-animate/move | from $0.075 per second of video |
| Wan VACE Video Edit | wan-video/wan-vace/video-edit | from $0.05 per second of video |
| OmniHuman 1.5 | bytedance/omnihuman/v1.5 | $0.16 per second of video |
Kataloğun tamamı modeller sayfasında; yapılandırma başına güncel maliyetler ise fiyatlandırma sayfasında.
Tek istekle bir motion control modeli çağırın
Her model aynı istek yaşam döngüsünü paylaşır: kuyruğa gönderin, durum adresini polling ile sorun, sonucu alın. Model değiştirmek için endpoint’i değiştirmeniz yeterli — başka hiçbir şey değişmez.
cURL
curl -X POST https://queue.modelrunner.run/kuaishou/kling-video/v3/motion-control \
-H "Authorization: Key $MRUN_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "prompt": "..." }'
# → { "request_id": "...", "status_url": "...", "response_url": "..." }motion control modellerini Claude ve Cursor’dan kullanın
Bir kez ModelRunner MCP sunucusunu bağlayın; yapay zekâ asistanınız bu tablodaki her motion control modelini bir araç olarak çalıştırabilir — OAuth ile yetkilendirilir, sonuçlar sohbete barındırılan adresler olarak döner.
Claude Code
claude mcp add --transport http modelrunner https://mcp.modelrunner.run/mcpSıkça sorulan sorular
Motion control API’si ne kadar tutar?
Motion control modelleri üretilen video saniyesi başına fiyatlandırılır; model başına tam ücret yukarıdaki tabloda gösterilir — açık ağırlıklı seçenekler premium kademelerin çok altında kalır ve bazıları çözünürlük kademeli olduğundan düşük çözünürlük saniye başına daha ucuzdur. Çıktı uzunluğu sürücü klibinizi izler, yani 6 saniyelik bir referans kabaca 6 saniyelik video üretir. Abonelik ve alt ücret yoktur: ön ödemeli kredinizden üretim başına ödersiniz.
Motion transfer için ne sağlamam gerekiyor?
İki girdi: bir karakter görseli (canlandırılacak özne) ve bir sürücü video (kopyalanacak hareket). İkisi de URL olarak verilir — yerel dosyaları Storage API ile ya da JavaScript SDK’sinin storage.upload() yardımcısıyla yükleyin ve dönen medya URL’sini verin. Bazı modeller ek yönlendirme için isteğe bağlı bir metin prompt’u kabul eder; bazılarıysa hiçbirine gerek duymaz ve performansın tamamını videodan alır.
Motion control ile image-to-video arasındaki fark nedir?
image-to-video modeli hareketi bir metin prompt’undan uydurur; yani ne olacağını siz anlatırsınız ve elinize geçeni kabul edersiniz. Motion control (ya da motion transfer) modeli ise hareketi sizin verdiğiniz bir referans videodan kopyalar; böylece zamanlama, jest ve çoğu zaman yüz ifadesi, tam olarak çektiğiniz performans olur — kontrol, kelimelerden değil görüntüden gelir.
motion control modelini API ile nasıl çağırırım?
Her model aynı istek şeklini paylaşır: https://queue.modelrunner.run/<owner>/<alias> adresine Authorization: Key başlığıyla POST atın ve girdi alanlarını doğrudan JSON gövdesinin en üst düzeyine koyun (ek bir sarmalama yok), sonra dönen status_url adresini polling ile sorup sonucu response_url adresinden alın. JavaScript SDK’si (@modelrunner/client) bunu tek bir subscribe() çağrısında toplar; { input } nesnesinin kullanıldığı tek yer orasıdır. Her model sayfasında o modelin gerçek girdileriyle kopyala-yapıştır cURL, JavaScript ve Python örnekleri bulunur.
motion control modellerini Claude veya Cursor’dan çalıştırabilir miyim?
Evet. ModelRunner MCP sunucusunu (https://mcp.modelrunner.run/mcp) bir kez bağladığınızda katalogdaki her motion control modeli, yapay zekâ asistanınızın run_model aracıyla çağırabileceği bir araca dönüşür — OAuth ile yetkilendirilir, config’e API anahtarı yapıştırmanız gerekmez.