Üretim araçları
Görsel, video, seslendirme ve senaryo: teklif ve onay, bütün tarifler, kütüphane, formatlara uyarlama, yayın kalitesi, paylaşım ve karakterler.
Araç adları ve açıklamaları doğrudan sunucu kodundan üretilir; açıklamalar asistanın gördüğü metnin çevirisidir, araç ve parametre adları aynen kalır.
Okuma araçları9 araç
list_productions
Okuma0 krediÜretim kütüphanesi: görseller, videolar, seslendirmeler ve senaryolar (üretilen, yüklenen, formata uyarlanan); durum, hazırsa açılabilir dosya adresi, açılış ve çağrı, bekleme nedeni, süren işin kalan süresi, düşen işin yeniden denenip denenemeyeceği, favori, tarif, varyasyon grubu ve karşılaştırma sonucu, inceleme kararı ve yorum sayısı, kampanyada kullanıldıysa kampanya geneli reklam sonucu. Duruma, türe, metne, favoriye ya da gruba göre süzülür; sayfalanır. Salt okunur, ücretsiz.
| Parametre | Tip | Açıklama |
|---|---|---|
production_idİsteğe bağlı | string | one production with its full details (script, review, results) |
statusİsteğe bağlı | queued | rendering | ready | needs_provider | failed | cancelled | draft | — |
kindİsteğe bağlı | ugc_video | short_video | image | voice | script | — |
searchİsteğe bağlı | string | text in the title or request |
favoriteİsteğe bağlı | boolean | only starred productions |
group_idİsteğe bağlı | string | one variation group (batch.group of an item) |
limitİsteğe bağlı | integer (1–60) | newest first (default 10) |
offsetİsteğe bağlı | integer (0–…) | next_offset of the previous page |
get_production_options
Okuma0 krediÜretim ekranının seçenekleri: açık türler ve tarifler, her türün motoru ve kalite kademesine göre fiyatı (plan kredisi ya da USD bakiye), ücret modu ve kalan miktar, çözünürlük, oran, stil ve diller; topic=characters kayıtlı karakterler, topic=videos dublajlanabilecek videolar, topic=formats reklam yerleşimi formatları. Fiyat tahmin etmeden önce çağırın. Salt okunur, ücretsiz.
| Parametre | Tip | Açıklama |
|---|---|---|
topicİsteğe bağlı | overview | characters | videos | formats | — |
platformİsteğe bağlı | string | topic=formats: meta | google | tiktok | linkedin | … |
typeİsteğe bağlı | image | video | topic=formats |
get_production_quote
Okuma0 krediÜretim teklifini okur: durum (açık, onaylandı, süresi doldu, iptal), fiyat, ne üreteceği, geçerlilik süresi ve başlattığı üretim. Salt okunur, ücretsiz.
| Parametre | Tip | Açıklama |
|---|---|---|
quote_idZorunlu | string | — |
production_preflight
Okuma0 krediHazır dosyanın yayın öncesi denetimi: hedefsiz çağrı denetlenebilecek yerleşimleri ve yayın profillerini listeler; format_id ya da profile ile dosyanın kendisini ölçer (oran, çözünürlük, süre, boyut, ses ve gürlük, ekran yazısı ve güvenli alan, çağrı, açılış, yapay zekâ bildirimi) ve geçti / dikkat / geçmedi döner. Salt okunur, ücretsiz.
| Parametre | Tip | Açıklama |
|---|---|---|
production_idZorunlu | string | production id (from list_productions or quote/start results) |
format_idİsteğe bağlı | integer (1–…) | ad placement to check against |
profileİsteğe bağlı | tv_pal | tv_ntsc | ctv | broadcast profile to check against |
get_production_masters
Okuma0 krediHazır videonun yayın kalitesi ana kopyaları: kullanılabilir profiller (TV PAL 1080p25 −23 LUFS, TV NTSC 1080p29,97 −24 LKFS, bağlantılı TV), kodekler, izin verilen süreler, kaynağın ölçüleri ve teknik raporlarıyla alınmış kopyalar. Salt okunur, ücretsiz.
| Parametre | Tip | Açıklama |
|---|---|---|
production_idZorunlu | string | ready video |
get_production_film
Okuma0 krediMarka filminin sahneleri (saklanan klipler), kurgu seçenekleri ve sürüm bilgisi. Salt okunur, ücretsiz.
| Parametre | Tip | Açıklama |
|---|---|---|
production_idZorunlu | string | brand film |
get_production_share
Okuma0 krediÜretimin inceleme durumu: son inceleme bağlantısı (süre, kapsam), inceleyenlerin kararı (bekliyor, onaylandı, değişiklik istendi) ve yorumları. Salt okunur, ücretsiz.
| Parametre | Tip | Açıklama |
|---|---|---|
production_idZorunlu | string | production id (from list_productions or quote/start results) |
get_production_wallet
Okuma0 krediÜretim ücret modu (plan kredisi ya da USD bakiye), kalan kredi, ayrılan tutarla üretim bakiyesi ve aylık limit, bu ayın harcaması ve sayfalanan bakiye hareketleri. Salt okunur, ücretsiz.
| Parametre | Tip | Açıklama |
|---|---|---|
ledger_limitİsteğe bağlı | integer (1–200) | — |
beforeİsteğe bağlı | integer (1–…) | next_before of the previous page |
get_production_download
Okuma0 krediHazır dosyanın indirme adresi. format verilmezse özgün dosyanın adresi; format ile (yalnız görsel) dakikalar içinde süresi dolan imzalı adreste PNG / JPG / WEBP kopya. Salt okunur, ücretsiz.
| Parametre | Tip | Açıklama |
|---|---|---|
production_idZorunlu | string | ready production |
formatİsteğe bağlı | png | jpg | webp | images: converted copy in this type |
Yazma araçları19 araç
suggest_production_hooks
Yazma1 krediVideonun ilk saniyeleri ya da görselin başlığı için marka profilinden ve istekten 5–8 açılış cümlesi önerisi; metin modeli yoksa kural tabanlı kalıplar döner, uydurma iddia yoktur. Seçilen cümleyi quote_production hook (varyasyonda hooks) alanına verin. Hiçbir şey üretmez.
| Parametre | Tip | Açıklama |
|---|---|---|
kindZorunlu | ugc_video | short_video | image | — |
briefZorunlu | string | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
quote_production
Yazma0 krediÜretimin 1. adımı: Üretim ekranının yaptığı her şey için TEKLİF — görsel, kısa / UGC video, seslendirme, senaryo ve bütün tarifler (ürün fotoğrafı, düzenleme, persona, AI influencer, AI avatar, marka filmi, tek sahne, dublaj, kampanya paketi); kalite kademesi, oran, çözünürlük, kaynak dosya, karakter, açılış cümlesi ve 2–4 varyasyon. Ne üretileceğini, fiyatı (plan kredisi ya da USD bakiye; panelle aynı fiyat) ve geçerlilik süresini döner. Burada HİÇBİR ŞEY üretilmez ve ücret alınmaz: fiyatı kullanıcıya gösterin, açık onayını bekleyin, sonra teklif kimliğiyle start_production çağırın.
| Parametre | Tip | Açıklama |
|---|---|---|
kindİsteğe bağlı | ugc_video | short_video | image | voice | script | what is produced (with like_production_id it may be omitted) |
briefİsteğe bağlı | string | what to produce: product / service, message, audience, style; for recipe=edit the change to make |
titleİsteğe bağlı | string | — |
recipeİsteğe bağlı | product | edit | persona | influencer | avatar | film | scene | dubbing | pack | ready-made flow: product = from a product photo (reference_id, style); edit = new version of a ready file (reference_id, brief = the change); persona = AI portrait to save as a character (kind=image); influencer = with a saved VIRTUAL character (character_id); avatar = with a consented REAL person's character (character_id); film = multi-scene brand film (kind=short_video, scenes, captions, end_card); scene = regenerate one scene of a ready film (reference_id = film, scene = number; only that scene is charged); dubbing = ready video in another language (reference_id, language); pack = campaign content pack (kind=image, formats, video) |
tierİsteğe bağlı | string | quality tier (economy / balanced / premium) or, for videos, a named video engine such as bytedance/seedance-2.0 (see the catalog: tiers with engine_name); changes the price (default: the route's model) |
resolutionİsteğe bağlı | 1K | 2K | 4K | images only |
aspectİsteğe bağlı | 1:1 | 4:5 | 3:4 | 2:3 | 9:16 | 16:9 | 3:2 | 4:3 | images: all; videos: 9:16 / 16:9 |
styleİsteğe bağlı | studio | lifestyle | outdoor | flatlay | hand | recipe=product: scene preset |
reference_idİsteğe bağlı | string | production id of the source file (product photo, file to edit, video to dub, film) |
character_idİsteğe bağlı | string | recipe=influencer / avatar: character id (get_production_options topic=characters) |
scenesİsteğe bağlı | integer (0–12) | film: scene count (0 = default) |
captionsİsteğe bağlı | boolean | film: on-screen captions (default true) |
end_cardİsteğe bağlı | boolean | film: closing card with logo (default true) |
sceneİsteğe bağlı | integer (0–12) | recipe=scene: number of the scene to regenerate (from 1) |
languageİsteğe bağlı | tr | en | de | es | fr | nl | pt | zh | pl | ja | ar | hi | it | ru | ko | bn | ur | id | vi | th | he | recipe=dubbing: target language |
formatsİsteğe bağlı | array<integer> | recipe=pack: ad format ids (get_production_options topic=formats) |
videoİsteğe bağlı | boolean | recipe=pack: also a short video from the main image |
hookİsteğe bağlı | string | opening line (suggest_production_hooks); recipe=scene + scene=1 changes only the film's opening |
angleİsteğe bağlı | problem | moment | detail | direct | creative angle (ignored with variations: each variation gets its own) |
variationsİsteğe bağlı | integer (2–4) | batch: N separate productions from one request, each with another angle; the TOTAL price is returned |
hooksİsteğe bağlı | array<string> | with variations: opening lines given to the variations in order |
campaign_idİsteğe bağlı | string | campaign id or name to link the production to |
like_production_idİsteğe bağlı | string | "more like this": copy the settings (kind, brief, recipe, character, tier, style, aspect, hook, angle) of this production; given arguments override them |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
start_production
YazmaGeri alınamaz0 kredi2. adım: kullanıcının fiyatını görüp ONAYLADIĞI teklifin üretimini başlatır. Tutar bakiyeden ayrılır ya da plan kredisi kullanılır (paneldeki "Onayla ve üret" ile aynı); kredi ya da bakiye yetmezse hiçbir şey başlamaz (gereken miktarla credits_exhausted / insufficient_balance). Yalnız kullanıcı açıkça devam etmek istediğinde çağırın. Aynı teklif iki kez başlamaz. Üretimi döner (kuyrukta / üretiliyor / hazır); dosyalar dakikalar sürer, list_productions ile bakın.
| Parametre | Tip | Açıklama |
|---|---|---|
quote_idİsteğe bağlı | string | — |
quote_idsİsteğe bağlı | array<string> | all quotes of one variation group, started with one confirmation |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
cancel_production
Yazma0 krediSağlayıcıya henüz verilmemiş kuyruktaki üretimi iptal eder; ayrılan tutar geri döner. Sağlayıcının üretmekte olduğu dosya durdurulamaz (rendering hatası).
| Parametre | Tip | Açıklama |
|---|---|---|
production_idZorunlu | string | production id (from list_productions or quote/start results) |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
retry_production
Yazma0 krediDüşen ya da iptal edilen üretim için aynı ayarlarla, bugünün fiyatıyla YENİ teklif. Ücret almaz; kullanıcı fiyatı onaylayınca start_production ile başlatın.
| Parametre | Tip | Açıklama |
|---|---|---|
production_idZorunlu | string | production id (from list_productions or quote/start results) |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
delete_production
YazmaGeri alınamaz0 krediÜretimleri ve dosyalarını (format sürümleriyle) kalıcı olarak siler. Geri alınamaz — yalnız kullanıcı bu dosyaların silinmesini açıkça isterse. Kampanyada kullanılan (in_use) ya da hâlâ üretilen (active) dosya silinmez; sonuç her birini ayrı yazar.
| Parametre | Tip | Açıklama |
|---|---|---|
production_idİsteğe bağlı | string | production id (from list_productions or quote/start results) |
production_idsİsteğe bağlı | array<string> | several productions at once (up to 24) |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
set_production_favorite
Yazma0 krediÜretimi yıldızlar ya da yıldızını kaldırır (list_productions'ın ve panelin favoriler süzgeci).
| Parametre | Tip | Açıklama |
|---|---|---|
production_idZorunlu | string | production id (from list_productions or quote/start results) |
favoriteZorunlu | boolean | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
import_production_from_url
Yazma1 krediÜrün sayfasından başlama: sunucu sayfayı güvenli okur (yalnız http(s), iç ağ kapalı, yönlendirmeler yeniden denetlenir, boyut sınırlı) ve başlık, açıklama ve fiyatı döner; ana görsel kütüphaneye ürün fotoğrafı olarak kaydedilir. Kullanıcı içerik hakkını onaylamalıdır (confirm_rights=true); onay kaydedilir. Görseli quote_production'da reference_id olarak kullanın. 1 kredi.
| Parametre | Tip | Açıklama |
|---|---|---|
urlZorunlu | string | public product page (http / https) |
confirm_rightsZorunlu | boolean | the user confirmed they may use the page's text and image |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
upload_production_image
Yazma1 krediKullanıcının kendi görselini üretim kütüphanesine ekler: tür baytlardan doğrulanır, yeniden kodlanır ve konum bilgisi (EXIF) silinir; PNG, JPEG ya da WEBP, en çok 12 MB. Adresten yalnız herkese açık adresler okunur (iç ağ reddedilir). reference_id olarak ya da adapt_production_formats ile kullanın. 1 kredi.
| Parametre | Tip | Açıklama |
|---|---|---|
image_base64İsteğe bağlı | string | PNG / JPEG / WEBP, optionally a data: URL |
source_urlİsteğe bağlı | string | public http(s) image address to copy instead |
titleİsteğe bağlı | string | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
adapt_production_formats
Yazma0 krediHazır görseli seçilen reklam yerleşimlerinin oranlarına (en çok 12) uyarlar; başlık, çağrı ve logo güvenli alanda kalır. Her sürüm kütüphaneye dosya olarak girer. Ücretsiz, kendi sunucumuzda.
| Parametre | Tip | Açıklama |
|---|---|---|
production_idZorunlu | string | ready image to adapt |
formatsZorunlu | array<integer> | ad format ids (get_production_options topic=formats) |
headlineİsteğe bağlı | string | — |
ctaİsteğe bağlı | string | — |
logoİsteğe bağlı | boolean | brand logo in the safe area (default true) |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_production_master
Yazma0 krediHazır videodan teknik raporlu yayın ana kopyası ister (kendi sunucumuzda kodlanır, ücretsiz, hız sınırlı). Yalnız teknik hazırlıktır: yayıncının kabulünü garanti etmez; geçmeli (interlaced) ve XDCAM MXF üretilmez.
| Parametre | Tip | Açıklama |
|---|---|---|
production_idZorunlu | string | ready video |
profileZorunlu | tv_pal | tv_ntsc | ctv | — |
codecZorunlu | prores | h264 | prores = ProRes 422 HQ .mov · h264 = H.264 High .mp4 |
secondsİsteğe bağlı | integer (0–60) | exact spot length (0 = the source's length) |
pillarboxİsteğe bağlı | boolean | fit a vertical / square source into 16:9 with black side bars |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
delete_production_master
YazmaGeri alınamaz0 krediAna kopyayı ve dosyasını kalıcı olarak siler. Geri alınamaz — yalnız kullanıcı açıkça isterse.
| Parametre | Tip | Açıklama |
|---|---|---|
master_idZorunlu | string | master copy id (get_production_masters) |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
edit_production_film
Yazma0 krediMarka filmini yeniden kurar: sahne sırası, ekran yazıları, kapanış kartı. Ücretsiz, kendi sunucumuzda; yeni sürüm üretir, eskisi kalır. Tek sahneyi yeniden üretmek ücretlidir ve quote_production recipe=scene yolundan geçer.
| Parametre | Tip | Açıklama |
|---|---|---|
production_idZorunlu | string | brand film |
orderİsteğe bağlı | array<integer> | new scene order: every scene number once |
captionsİsteğe bağlı | boolean | — |
end_cardİsteğe bağlı | boolean | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_production_share
Yazma0 krediMüşterinin ya da ekibin hesapsız açtığı süreli (1–90 gün) inceleme bağlantısı oluşturur: yorum yazar, onaylar ya da değişiklik ister. Adres yalnız bir kez döner; üretimin önceki bağlantıları kapanır.
| Parametre | Tip | Açıklama |
|---|---|---|
production_idZorunlu | string | ready image or video |
daysİsteğe bağlı | integer (1–90) | link lifetime in days (default 14) |
scopeİsteğe bağlı | single | group | single = this production · group = its whole variation group |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
revoke_production_share
YazmaGeri alınamaz0 krediÜretimin bütün açık inceleme bağlantılarını birden kapatır; kapanan bağlantı yeniden açılmaz (yenisi oluşturulur). Yalnız kullanıcı açıkça isterse.
| Parametre | Tip | Açıklama |
|---|---|---|
production_idZorunlu | string | production id (from list_productions or quote/start results) |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_production_character
Yazma0 krediHazır bir yüz görselini tutarlı içerik için karakter olarak kaydeder. type=virtual: AI influencer. type=real: gerçek bir kişinin AI avatarı — yalnız KULLANICININ kendi sözleriyle verdiği rıza beyanıyla (kişinin adı, dayanak: kendisi ya da yazılı izin, confirmed=true); asla kullanıcı adına doldurulmaz. Beyan hesap ve zamanla kaydedilir.
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | — |
typeZorunlu | virtual | real | virtual = AI influencer · real = a real person (AI avatar) |
image_idZorunlu | string | ready face image in the library (generated portrait or uploaded photo) |
descriptionİsteğe bağlı | string | — |
consentİsteğe bağlı | object | required for type=real |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
delete_production_character
YazmaGeri alınamaz0 krediKarakteri siler (gerçek kişide rızanın geri alınması). Geri alınamaz — yalnız kullanıcı açıkça isterse; üretilmiş dosyalar kalır.
| Parametre | Tip | Açıklama |
|---|---|---|
character_idZorunlu | string | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
set_production_monthly_limit
Yazma0 krediÜretim bakiyesinin aylık harcama limitini (USD) koyar ya da kaldırır. Limiti aşacak üretimler reddedilir (monthly_limit). Yalnız kullanıcı isterse.
| Parametre | Tip | Açıklama |
|---|---|---|
monthly_limitİsteğe bağlı | number (0–1000000) | USD per month |
clearİsteğe bağlı | boolean | remove the limit |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
add_production_to_campaign
Yazma0 krediÜretimi kampanyanın kreatifi yapar (taslak kreatif kartı). Meta ve Google'da kampanya yayına alınırken bu dosya kullanılır; yayındaki reklam kendiliğinden değişmez. Üretim kartı ardından kampanyanın sonuçlarını gösterir.
| Parametre | Tip | Açıklama |
|---|---|---|
production_idZorunlu | string | ready file (or a script for a text card) |
campaignZorunlu | string | campaign id or name |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.