Clipwright

resmi

Film ç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ç NoktaKredi maliyetiNe yapar
GET /healthhayırAPI'nin kendisinin canlılığı. Anahtar olmadan yanıt verir.
GET /v1/voiceshayırvoice veya voice_id içinde adlandırabileceğiniz sesler.
GET /v1/accounthayırAnahtarın arkasındaki hesabın bakiyesi, borcu ve blokajları.
POST /v1/skills/make_ugc/quotehayırBu girdiyle bir make_ugc çağrısını fiyatlandırır. Ücret talep etmez.
GET /v1/runs/{id}hayırHerhangi bir becerinin bir çalıştırmasının durumu, uyarıları ve video url'si.
POST /v1/skills/make_ugc/runevetBir 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/skillshayırBecerilerin ve girdilerinin kataloğu, anahtar olmadan.
GET /v1/actorshayırHesapta kayıtlı aktörler, make_ugc'nin aldığı id ile.
DELETE /v1/actors/{id}hayırKayıtlı bir aktörü unutur. Canlı bir çalıştırma tarafından kullanılan bir aktör saklanır.
GET /v1/actors/{id}/defaultshayırKayıtlı aktörün eklemelerdeki kişiler için varsayılan politikasını okur.
POST /v1/actors/{id}/defaultshayırKayı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/quotehayırBu girdiyle bir create_actor çağrısını fiyatlandırır. Ücret talep etmez.
POST /v1/skills/create_actor/runevetBir 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/uploadshayırGö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).

AlanGerekliNe anlama gelir
scriptisteğ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.
segmentsisteğ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.
insertsisteğ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.
personisteğ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_idisteğ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.
imageisteğ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_genderisteğ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.
nameisteğe bağlıHENÜZ ONURLANDIRILMADI: name henüz onurlandırılmadı: oluşturucuya ulaşmaz
broll_policyisteğ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.
captionsisteğe bağlıHENÜZ ONURLANDIRILMADI: altyazılar istendi ancak bu prototipte (aşama-B) oluşturulmadı
caption_styleisteğe bağlıHENÜZ ONURLANDIRILMADI: caption_style onurlandırılmadı: altyazılar bu prototipte (aşama-B) oluşturulmuyor
lookisteğe bağlıHENÜZ ONURLANDIRILMADI: look henüz onurlandırılmadı: oluşturucuya ulaşmaz
aspect_ratioisteğ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).
resolutionisteğe bağlıÇıktı çözünürlüğü: 720p | 1080p | 4k (kısa kenar 720 / 1080 / 2160 px). Atlanırsa 1080p anlamına gelir.
voiceisteğ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_idisteğ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_modelisteğ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_overlayisteğe bağlıKabul edilen değerler: true | false.
backgroundisteğ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.

AlanZorunluAnlamı
descriptionzorunluKurgusal 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).
genderzorunlufemale | male. Aktörün cinsiyetini ve bu aktöre sahip videoların varsayılan sesini belirler.
approximate_agezorunlu18 ila 90 arasında yaklaşık yaş: aktörler yetişkindir.
namezorunlulist_actors içinde gösterilen ad.
aspect_ratiosisteğ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.
qualityisteğ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:

RetHTTPAynı çağrıyı tekrarla?Ne yapmalı
rate_limited429evet, bekledikten sonraGeri basınç, bir hata değil: yanıt, Retry-After ve gövdede beklenmesi gereken saniyeleri adlandırır.
server_error500, 502, 503evet, bekledikten sonraBaş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_credits402hayır, aynı yanıtı verirDurun ve kişiye bakiyeyi ve fiyatı söyleyin; ikisi de gövdededir. Tekrarlamak ikisini de değiştiremez.
debt_outstanding402hayır, aynı yanıtı verirDurun. Kredi satın almak, bakiyeye herhangi bir şey ulaşmadan önce borcu temizler ve bu engeli kaldırır.
not_admitted403hayır, aynı yanıtı verirDurun. Hesabın beta erişimi yok; ne bir yeniden deneme ne de bir satın alma bunu değiştirir. Operatöre sorun.
client_error400, 401, 404, 409, 413, 415hayır, aynı yanıtı verirDurun. İ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.