Clipwright
resmiFilm çekmeden UGC tarzı video reklamları oluşturun. AI asistanınıza videonun ne söylemesi gerektiğini söyleyin; Clipwright, gerçekçi bir aktörün bunu söylediği, TikTok, Reels veya Shorts için hazır dikey bir klip döndürür. Yaratıcıları işe alıp çekim ayarlamak yerine bir öğleden sonra ürününüz için on farklı hook deneyin. Hazır bir aktör seçin veya kendinizinkini tanımlayın, örnekleri dinleyerek bir ses seçin ve hiçbir şey render edilmeden önce fiyatı görün. Claude, Cursor veya herhangi bir MCP istemcisinden çalışır. Video dosyasını siz alırsınız ve nereye gideceğine siz karar verirsiniz.
Clipwright MCP ile neler yapabilirsiniz?
- Betiklerden dudak senkronlu videolar oluşturun — Yapay zekânızdan, yazılı bir betiği seçtiğiniz aktör, ses ve formatla UGC tarzı bir videoya dönüştürmesini isteyin.
- Özel yapay zekâ aktörleri oluşturun — Kurgusal bir yetişkinin görünümünü tanımlayın ve gelecekteki videolar için yeniden kullanılabilir bir aktör oluşturun.
- Oluşturmadan önce fiyat kontrolü yapın — Kredi harcamadan önce bir video veya aktör için ücretsiz maliyet tahmini talep edin.
- Kayıtlı aktörleri yönetin — Mevcut aktörleri listeleyin, varsayılan politikalarını inceleyin veya artık ihtiyaç duyulmayanları silin.
- Video ve aktör çalışmalarını takip edin — Bir oluşturma işinin durumunu başarılı veya başarısız olana kadar sorgulayın ve nihai video URL'sini alın.
Dokümantasyon
Clipwright API
Bir scripti dudak senkronlu UGC videosuna dönüştüren tek bir HTTP API'si. Bir ajan tarafından yönetilmek üzere tasarlanmıştır: her çağrı tek bir JSON isteğidir, her ret bir sonraki adımda ne yapılacağını söyler ve hiçbir şey hiçbir yerde yayınlanmaz. Bu sayfanın her kelimesi aynı zamanda https://clipwright.io/docs.md, adresinde bir markdown dosyası ve https://clipwright.io/llms.txt. adresinde ajanlar için kısa bir sözleşmedir.
Kimlik Doğrulama
Her çağrı https://api.clipwright.io adresine gider ve anahtarı tek bir başlıkta taşır:
Authorization: Bearer cw_your_key_here
- Anahtarlar cw_ ile başlar ve verildiklerinde yalnızca bir kez gösterilir. Yalnızca bir özetini saklarız, bu nedenle kaybolan bir anahtar değiştirilir, asla kurtarılmaz.
- Anahtarları https://app.clipwright.io/api-keys. adresindeki panelde verin ve iptal edin. İptal, bir sonraki istekte geçerli olur.
- @clipwright/cli ve @clipwright/mcp-server anahtarı CLIPWRIGHT_API_KEY ortam değişkeninden okur; @clipwright/sdk bunu bir argüman olarak alır.
- Anahtarsız veya iptal edilmiş bir anahtarla yapılan çağrı, herhangi bir ücret alınmadan önce 401 ile reddedilir.
03
Maliyeti nedir
- Düz bir scriptten make_ugc: bitmiş videonun her saniyesi için 30 kredi, tam saniyeye yuvarlanır.
- Segmentler veya eklemelerle make_ugc: ekranda bir yüzün olduğu her saniye için 10 kredi ve teslim ettiğimiz bir video için en az 400 kredi. Yüzün olmadığı saniyeler ücretsizdir ve dosya teslim etmeyen bir çalıştırma, satıcıya zaten ödeme yapılmış olsa bile hiçbir maliyet getirmez. Yüz süresi tüm video boyunca toplanır ve segment başına değil, bir kez yuvarlanır. Bu alanlar dağıtımda uzun biçimli nitelendirme gerektirir; kapalı olduğu yerlerde herhangi bir ücret alınmadan önce adlarıyla reddedilirler.
- create_actor orta kalitede: portre için 10 kredi ve eklenen her format için 10 kredi.
- create_actor yüksek kalitede: portre için 20 kredi ve eklenen her format için 20 kredi.
- Krediler paketler halinde satın alınır: 1000 kredi 10,00 $, tek ödeme, abonelik yok.
Harcamadan önce sorun: her iki becerinin fiyat teklifi ucu hiçbir ücret talep etmez. Cevabının değeri beceriye göre değişir.
- make_ugc: fiyat teklifi, scriptin sözcüklerinden okunan bir tahmindir. Ücret, bitmiş videoda ölçülen şeye göre uygulanır — düz script sayacında süresi, yüz sayacında yüz saniyeleri — bu nedenle fatura teklifin üstünde veya altında olabilir.
- create_actor: fiyat teklifi, istediğiniz her formatı fiyatlandırır; bu, ödeyebileceğiniz en yüksek tutardır. Portre ve gerçekten yayınlanan varyantlar için ücretlendirilirsiniz; çıkmayan bir format warnings[] içinde adlandırılır ve hiçbir maliyeti yoktur.
Başarısız bir çalıştırmanın maliyeti de beceriye göre değişir:
- Düz bir scriptten make_ugc: teslimat işi satıcıya ulaştıktan sonra başarısız olan bir çalıştırma ücretlendirilir. Ondan önce başarısız olan hiçbir maliyet getirmez ve bizim durdurduğumuz, kaybettiğimiz veya reddettiğimiz bir çalıştırma da, satıcıya zaten ödeme yapılmış olsa bile hiçbir maliyet getirmez. Yüz sayacında hiçbir başarısızlık ücretlendirilmez.
- create_actor: başarısız bir çalıştırma, satıcıya zaten ödeme yapılmış olsa bile hiçbir maliyet getirmez, çünkü size hiçbir aktör ulaşmadı.
04
Uç Noktalar
| Uç Nokta | Kredi maliyeti | Ne yapar |
|---|---|---|
| GET /health | hayır | API'nin kendisinin canlılığı. Anahtar olmadan yanıt verir. |
| GET /v1/voices | hayır | voice veya voice_id içinde adlandırabileceğiniz sesler. |
| GET /v1/account | hayır | Anahtarın arkasındaki hesabın bakiyesi, borcu ve blokajları. |
| POST /v1/skills/make_ugc/quote | hayır | Bu girdiyle bir make_ugc çağrısını fiyatlandırır. Ücret talep etmez. |
| GET /v1/runs/{id} | hayır | Herhangi bir becerinin bir çalıştırmasının durumu, uyarıları ve video url'si. |
| POST /v1/skills/make_ugc/run | evet | Bir video çalıştırması başlatır ve hemen bir run_id ile yanıt verir. Sonuç için çalıştırmayı yoklayın. |
| GET /v1/public/skills | hayır | Becerilerin ve girdilerinin kataloğu, anahtar olmadan. |
| GET /v1/actors | hayır | Hesapta kayıtlı aktörler, make_ugc'nin aldığı id ile. |
| DELETE /v1/actors/{id} | hayır | Kayıtlı bir aktörü unutur. Canlı bir çalıştırma tarafından kullanılan bir aktör saklanır. |
| GET /v1/actors/{id}/defaults | hayır | Kayıtlı aktörün eklemelerdeki kişiler için varsayılan politikasını okur. |
| POST /v1/actors/{id}/defaults | hayır | Kayıtlı aktörün eklemelerdeki kişiler için varsayılan politikasını ayarlar. Bir çalıştırma bunu geçersiz kılabilir. |
| POST /v1/skills/create_actor/quote | hayır | Bu girdiyle bir create_actor çağrısını fiyatlandırır. Ücret talep etmez. |
| POST /v1/skills/create_actor/run | evet | Bir aktör çalıştırması başlatır ve hemen bir run_id ile yanıt verir. Sonuç için çalıştırmayı yoklayın. |
| POST /v1/uploads | hayır | Görüntü baytlarını alır ve make_ugc ile create_actor'ün kabul ettiği https url'sini döndürür. |
Her iki becerinin bir çalıştırması aynı yerden, GET /v1/runs/{id} ile geri okunur ve şu durumlardan geçer: queued, generating, scripting, tts, avatar, compositing, uploading, succeeded, failed.
05
Beceriler ve girdileri
make_ugc. Dudak senkronlu bir UGC videosunun üretimini başlatın. Seçilen konuşma modelinin metin sınırı içinde bir script verin; aktör, actor_id (list_actors'tan kayıtlı bir aktör) veya image'den gelir, aksi takdirde varsayılan aktör kullanılır. Format ve çözünürlük isteği ve kaynağı takip eder, varsayılan 1080x1920'dir. Altyazılar OPSİYONELDİR: önce kullanıcıya sorun. Oluşturucunun henüz onurlandırmadığı alanlar, kendi açıklamalarında HENÜZ ONURLANDIRILMADI notu taşır — tahmin etmek yerine onu okuyun.
Üretmeden önce quote_ugc çağrısı yapın ve maliyeti gösterin. Bu videoyu BEKLEMEZ: çalıştırmayı başlatır ve HEMEN bir run_id döndürür. Ardından, durum 'succeeded' (video_url) veya 'failed' olana kadar o run_id ile get_run'u yoklamanız GEREKİR. Ödenmiş satıcı işini hâlâ elimizde tuttuğumuz 'failed' bir çalıştırma daha sonra 'queued' durumuna dönebilir ve 'succeeded' durumuna ulaşabilir; bu olduğunda warnings[] içinde adlandırılır. Aynı girdi için bilinçli olarak YENİ bir çalıştırma başlatmak için attempt=2,3,… geçirin (bir başarısızlıktan sonra yeniden deneme).
| Alan | Gerekli | Ne anlama gelir |
|---|---|---|
| script | isteğe bağlı | Aktörün söylediği sözcükler; segments konuşulan metni sağlamadıkça gereklidir. Segmentler ve metin bağlantılı eklemeler sunucuda uzun biçimli nitelendirme gerektirir. Konuşma modeline göre script sınırları: eleven_v3: 5000 karakter; eleven_flash_v2_5: 10000 karakter; eleven_turbo_v2_5: 10000 karakter. Sayım boşlukları, ses etiketlerini ve vurgu işaretlerini içerir; emoji iki karakter olarak sayılabilir. Kelime sayısı sınırı yoktur. Süre ve fiyat ölçülene kadar tahmindir. Rusça vurgu: vurgulu sesli harfi küçük bir kelimenin içinde büyük harf olarak yazın ("потОм", "зАмок") ve eleven_v3 bunu U+0301 vurgu işareti olarak alır ("пото́м"); doğrudan yazılan bir işaret korunur. Bir kelimenin başındaki büyük harf büyük kalır ve içinde ikinci bir büyük harf veya büyük bir ünsüz bulunan bir kelime (tümü büyük harf, "ВУЗы") olduğu gibi bırakılır. Bir kelimenin içindeki tek bir büyük sesli harf her zaman vurgu olarak okunur, bu nedenle "Яндекс Еда" yazın, "ЯндексЕда" değil. Rusça yazan kullanıcılara vurguyu bu şekilde işaretleyebileceklerini söyleyin. eleven_flash_v2_5 ve eleven_turbo_v2_5 daha ucuzdur ancak vurgu işaretlerini yanlış okur: büyük harfler onlara değişmeden ulaşır. |
| segments | isteğe bağlı | Sıralı aktör ve görüntü segmentleri; sunucuda uzun biçimli nitelendirme, captions=false ve 1080p gerektirir. Görüntü medyası açık broll_policy=anyone gerektirir. |
| inserts | isteğe bağlı | Tam anlatım üzerine metin bağlantılı görüntü eklemeleri, her biri çapasından cover_words konuşulan sözcüğü kapsar; sunucuda uzun biçimli nitelendirme, captions=false, 1080p ve açık broll_policy=anyone gerektirir. |
| person | isteğe bağlı | HENÜZ ONURLANDIRILMADI: person henüz onurlandırılmadı: bu istek varsayılan aktörü kullanır; farklı bir yüz seçmek için list_actors'tan actor_id seçin veya image sağlayın |
| actor_id | isteğe bağlı | list_actors'tan kayıtlı Clipwright aktör kimliği. actor_id, image veya person seçin; bunları birleştirmeyin. voice veya voice_id olmadan ses, aktörün cinsiyetini takip eder. actor_gender ile birleştirmeyin. |
| image | isteğe bağlı | Aktörün fotoğrafının genel https url'si (PNG, JPEG veya WebP, en fazla 10 MB). Disk üzerindeki bir dosya önce upload_image'dan (POST /v1/uploads) geçer — döndürdüğü url'yi geçirin. Kullanamayacağımız bir kaynak — özel veya geri döngü ana bilgisayarı, http, erişilemez, yönlendiren, 10 MB üzeri veya bu görüntü türlerinden biri değilse — herhangi bir ücret alınmadan önce reddedilir (unusable_source). Yüzün cinsiyetini tespit etmeyiz: actor_gender veya voice geçirin, aksi takdirde varsayılan erkek sesi bir uyarıyla kullanılır. |
| actor_gender | isteğe bağlı | image içindeki yüzün cinsiyeti: female | male. Yalnızca image ile: o cinsiyetin varsayılan sesini seçer (female: sarah, male: george). actor_id ile (cinsiyeti bilinir) ve image olmadan reddedilir. Açık bir voice veya voice_id kazanır ve yanıt, actor_gender'ın hiçbir şeyi değiştirmediği konusunda uyarır. |
| name | isteğe bağlı | HENÜZ ONURLANDIRILMADI: name henüz onurlandırılmadı: oluşturucuya ulaşmaz |
| broll_policy | isteğe bağlı | YALNIZCA SAKLANIR: B-roll için kaydedilmiş politika: anyone, aktör dahil kişilere izin verir; no_actor, aktörü hariç tutar; no_people, eller dahil tüm kişileri hariç tutar. Segmentli medya üretimi kapalıdır. Bu ayar yalnızca saklanır ve yalnızca aktör videoları üzerinde etkisi yoktur. Çalıştırma geçersiz kılması, hesap aktörü varsayılanını kazanır; aksi takdirde no_people. |
| captions | isteğe bağlı | HENÜZ ONURLANDIRILMADI: altyazılar istendi ancak bu prototipte (aşama-B) oluşturulmadı |
| caption_style | isteğe bağlı | HENÜZ ONURLANDIRILMADI: caption_style onurlandırılmadı: altyazılar bu prototipte (aşama-B) oluşturulmuyor |
| look | isteğe bağlı | HENÜZ ONURLANDIRILMADI: look henüz onurlandırılmadı: oluşturucuya ulaşmaz |
| aspect_ratio | isteğe bağlı | Çıktı formatı: 9:16 | 1:1 | 16:9. Atlanırsa 9:16 anlamına gelir ve başka bir şekle sahip bir kaynak bir uyarıyla 9:16'ya sığdırılır — image geçirdiğinizde bunu açıkça geçirin. İstek ile kaynak arasında %15'in üzerinde bir uyumsuzluk, herhangi bir ücret alınmadan önce reddedilir (aspect_conflict). |
| resolution | isteğe bağlı | Çıktı çözünürlüğü: 720p | 1080p | 4k (kısa kenar 720 / 1080 / 2160 px). Atlanırsa 1080p anlamına gelir. |
| voice | isteğe bağlı | list_voices'tan ses adı. Seçilmiş ön ayarlar: owner_ru_clone | sarah | george | eric | daria_ru_female (owner_ru_clone Rusça klonlanmış sestir). API, list_voices'ın döndürmediği bir adı herhangi bir ücret alınmadan önce reddeder. Atlanırsa, aktörün cinsiyeti için varsayılan ses anlamına gelir: actor_id'nin cinsiyeti, image ile actor_gender veya varsayılan aktör ve actor_gender olmadan image için george. voice_id ile karşılıklı olarak özeldir. |
| voice_id | isteğe bağlı | Katalog dışındaki bir ses için ham satıcı ses kimliği (16–32 harf ve rakam). Tembel olarak kontrol edilir: bilinmeyen bir kimlik isteği değil, çalıştırmayı başarısız kılar. voice ile karşılıklı olarak özeldir. |
| tts_model | isteğe bağlı | Konuşma modeli: eleven_v3 | eleven_flash_v2_5 | eleven_turbo_v2_5. Atlanırsa, seçilen ön ayarın modeli anlamına gelir (list_voices gösterir; her ön ayar eleven_v3 konuşur) veya ham bir voice_id için eleven_v3. eleven_v3 en etkileyici olanıdır ve vurgu işaretlerini okuyan tek modeldir (Rusça bir kelimenin içindeki büyük sesli harf, "потОм", bir olur; script'e bakın); eleven_flash_v2_5 ve eleven_turbo_v2_5, Rusça dışındaki diller için daha ucuz alternatiflerdir. Konuşma modeline göre script sınırları: eleven_v3: 5000 karakter; eleven_flash_v2_5: 10000 karakter; eleven_turbo_v2_5: 10000 karakter. Sayım boşlukları, ses etiketlerini ve vurgu işaretlerini içerir; emoji iki karakter olarak sayılabilir. Kelime sayısı sınırı yoktur. Süre ve fiyat ölçülene kadar tahmindir. |
| disclosure_overlay | isteğe bağlı | Kabul edilen değerler: true | false. |
| background | isteğe bağlı | Kabul edilen değerler: white | blur | contain. |
create_actor. Kurgusal bir yetişkini tanımlayan sözcüklerden bu hesap için kişisel bir aktör oluşturun: tam olarak bir yüz içeren 9:16 bir portre, artı ondan düzenlenen diğer istenen formatlar. Hemen bir run_id döndürür; 'succeeded' (created_actor.actor_id, ardından make_ugc'ye actor_id olarak geçirin) veya 'failed' olana kadar get_run'u yoklayın. Yayınlanan her görüntü, fiyat teklifinin gösterdiği fiyattan ücretlendirilir; reddedilen açıklamalar ve kullanılamayan portreler hiçbir maliyet getirmez. Üretim kapatıldığında çağrı actor_generation_disabled ile başarısız olur.
| Alan | Zorunlu | Anlamı |
|---|---|---|
| description | zorunlu | Kurgusal bir yetişkini tanımlayan kelimeler: görünüm, kıyafet, ortam. Gerçek bir kişiyi veya ona benzeyen birini adlandırmak, herhangi bir ücretlendirmeden önce reddedilir (actor_prompt_refused). |
| gender | zorunlu | female | male. Aktörün cinsiyetini ve bu aktöre sahip videoların varsayılan sesini belirler. |
| approximate_age | zorunlu | 18 ila 90 arasında yaklaşık yaş: aktörler yetişkindir. |
| name | zorunlu | list_actors içinde gösterilen ad. |
| aspect_ratios | isteğe bağlı | Oluşturulacak formatlar: 9:16 | 1:1 | 16:9, her zaman 9:16 dahil. Atlanırsa üçü de anlamına gelir. Kimlik kontrolünü geçemeyen formatlar ücretlendirilmez ve uyarılarda adlandırılır. |
| quality | isteğe bağlı | Görüntü kalitesi: medium | high. Atlanırsa medium anlamına gelir. Görüntü başına fiyat buna bağlıdır; teklif, herhangi bir ücretlendirmeden önce bunu gösterir. |
Çıktı formatı, isteği ve kaynağı takip eder. Desteklenen formatlar 9:16, 1:1, 16:9 ve çözünürlükler 720p, 1080p, 4k'dir; sessizlik, 9:16'da 1080p anlamına gelir.
06
Bir çalıştırma başlatma
Ücretli bir çağrı, anahtarın yanında bir başlık taşır: Idempotency-Key. POST /v1/skills/make_ugc/run ve POST /v1/skills/create_actor/run bunu gerektirir ve onsuz bir çağrı, herhangi bir şey ücretlendirilmeden önce 400 idempotency_key_required ile reddedilir.
- Anahtarı siz seçersiniz ve bir yeniden denemeyi ikinci bir siparişten ayıran tek şey budur. Herhangi bir benzersiz dize işe yarar; çağrıyı yeniden gönderebileceğiniz sürece onu saklayın.
- Aynı gövdeyle aynı anahtar, zaten başlattığı çalıştırmayı döndürür ve ikinci kez hiçbir şey ücretlendirmez. Sıradan bir yeniden denemeyi güvenli yapan şey budur.
- Farklı bir gövdeyle aynı anahtar, 409 idempotency_key_reused ile reddedilir. Harcanmış bir anahtar altındaki bir isteği düzenlemek yerine yeni bir istek için yeni bir anahtar alın.
- Aynı girdi üzerinde kasıtlı olarak yeni bir çalıştırma başlatmak için — bir başarısızlıktan sonra yeniden deneme — yeni bir anahtar gönderin. Zaten ödediğiniz çalıştırma olduğu yerde kalır.
- @clipwright/sdk ve @clipwright/mcp-server anahtarı sizin için istemciden ve girdiden oluşturur ve attempt=2, 3 … değerlerini yeni bir anahtara dönüştürür. Düz HTTP üzerinde anahtarı seçmek size kalmıştır.
07
Bir çağrı başarısız olduğunda
Her ret, bir kod ve bir mesaj içeren bir hata nesnesi taşır. Onunla ne yapılacağı, metinden değil, ret türünden çıkar:
| Ret | HTTP | Aynı çağrıyı tekrarla? | Ne yapmalı |
|---|---|---|---|
| rate_limited | 429 | evet, bekledikten sonra | Geri basınç, bir hata değil: yanıt, Retry-After ve gövdede beklenmesi gereken saniyeleri adlandırır. |
| server_error | 500, 502, 503 | evet, bekledikten sonra | Başarısızlık sunucu tarafındadır. Yeni bir idempotency anahtarıyla ikinci bir çalıştırma başlatmayın: aynı çağrı yeniden denemedir. |
| insufficient_credits | 402 | hayır, aynı yanıtı verir | Durun ve kişiye bakiyeyi ve fiyatı söyleyin; ikisi de gövdededir. Tekrarlamak ikisini de değiştiremez. |
| debt_outstanding | 402 | hayır, aynı yanıtı verir | Durun. Kredi satın almak, bakiyeye herhangi bir şey ulaşmadan önce borcu temizler ve bu engeli kaldırır. |
| not_admitted | 403 | hayır, aynı yanıtı verir | Durun. Hesabın beta erişimi yok; ne bir yeniden deneme ne de bir satın alma bunu değiştirir. Operatöre sorun. |
| client_error | 400, 401, 404, 409, 413, 415 | hayır, aynı yanıtı verir | Durun. İsteğin kendisi reddedildi: mesajı okuyun, çağrıyı düzeltin, sonra tekrar gönderin. |
Bunlar, API'nin error.code içine koyduğu tüm kodlardır. Daha önce görmediğiniz bir kod yine de yukarıdaki satırını izler, çünkü satır duruma göre seçilir:
- account_not_admitted
- actor_creation_limited
- actor_format_unavailable
- actor_generation_disabled
- actor_in_use
- actor_storage_unavailable
- actor_unavailable
- aspect_conflict
- debt_outstanding
- idempotency_key_required
- idempotency_key_reused
- insufficient_credits
- internal_error
- invalid_image
- invalid_request
- malformed_body
- not_found
- paid_render_disabled
- payload_too_large
- rate_limited
- rejected_field
- script_encoding_lost
- unauthorized
- unknown_field
- unsupported_media_type
- unusable_source
- upload_cap_exceeded
- upstream_error
08
Sınırlar
- 60 saniyede 60 ücretli istek ve 300 ücretsiz istek. Pencere, anahtar başına değil, hesap başına sayılır, bu nedenle ekstra anahtarlar ekstra verim satın almaz.
- Hesap başına aynı anda 3 render çalışır; geri kalanı kuyruğa girer ve reddedilmez.
- Hız sınırı nedeniyle bir ret, Retry-After ve gövdede beklenmesi gereken saniyeleri adlandırır. İkisinden büyük olanı onurlandırın.
- Klip başına 49 ekleme ve aralarında aktörün en fazla 6 görünümü. Her ikisi de gönderdiğiniz kelime dizinlerinden sayılır, bu nedenle daha fazlasını isteyen bir girdi, herhangi bir şey ödenmeden önce reddedilir.
- cover_words, bir eklemenin kaç konuşulan kelimeyi kapsadığını söyler, çapasının ilk kelimesinden sayılır. Ekleme, kapsanmayan ilk kelimenin başladığı yerde biter, böylece kapsamı buluşan iki ekleme bitişiktir ve aralarında aktör çekimi bırakmaz.
- Kapsamadığınız kelimelerin payı, klibin bir yüz gösteren kısmını belirler ve sesin hızıyla hareket etmez. Kelime uzunluğu değişir: 560 kelimelik bir betikte, %19 istemek, bin simüle edilmiş çalıştırmanın dokuz yüz doksan yedisinde 16 ila 22 teslim etti ve elli binde 15 ila 24 içinde kaldı. Bu sayılar bu profilin sesinde ve bu uzunlukta ölçüldü; daha kısa bir betik daha geniş dağılır ve farklı bir ses onları hareket ettirir.
- İki tek kelimelik seçim, yalnızca görünümü değil, fiyatı da değiştirir. Kelime 0'a çapalanmış bir ekleme, ilk kelimeden önceki sessizliğe sahiptir; kelime 1'e çapalanmışsa, aktörün ekstra bir görünümünü bırakır ve her görünüm ayrı bir ücretli iştir. Son kelimeye ulaşan kapsam, klibi sonuna kadar götürür ve kapanış görünümünü aynı şekilde kaldırır.
- Bir teklif, payı estimatedFaceWordShare olarak bildirir. Bu alanı okuyun; estimatedFaceSeconds'u estimatedTotalDurationSec'e bölmeyin. Bu ikisi farklı soruları yanıtlar — ilki, konuşma aralığının yavaş ucunda tuttuğumuz rezervdir, ikincisi klibin ne kadar sürmesinin beklendiğidir — ve oranları hiçbir şeyin payı değildir.
09
Bu API'nin asla yapmayacağı şeyler
- Hiçbir şey yayınlamak. Bir dosya ve imzalı bir bağlantı döndürürüz; nereye gideceğine karar vermek size kalmıştır.
- Başlatılmış bir çalıştırmayı iptal etmek. Bunun için bir uç nokta yoktur: satıcı işi aldığında, bizim tarafımızdan durdurmak onu harcanmamış hale getirmez.
- Bu alanları kabul etmek: character, broll_url, webhook_url. Herhangi bir ücretlendirmeden önce adlarıyla reddedilirler, kabul edilip sessizce yok sayılmazlar.
- İstediğiniz formatı veya çözünürlüğü söylemeden değiştirmek. Bir uyumsuzluk ya bir uyarıyla düzeltilir ya da ücretli çağrıdan önce reddedilir.
- Sizi geri aramak. Webhook yoktur: çalıştırmayı GET /v1/runs/{id} ile okuyun.
- Bir anahtarı ikinci kez göstermek veya bir yedekten kurtarmak.
10
Ayrıca bilmeye değer
- Uyarılar, sessizlik değil. Onurlandıramadığımız herhangi bir şey, aynı çalıştırmada warnings[] içinde adlandırılmış olarak geri gelir. Bir parametre, onunla ilgili bir satır olmadan asla kaybolmaz.
- Bir MCP sunucusu. @clipwright/mcp-server aynı sözleşmeyi araçlar olarak sunar ve tools/list'i bu sayfanın makine tarafından okunabilir biçimidir.