Üretim kullanım kılavuzu: panel, MCP ve API
Üretim ekranındaki her işin panelde, Claude / ChatGPT gibi MCP istemcilerinde ve REST API'de nasıl yapıldığı: teklif → onay → üretim → durum → indirme, tarifler, ücret ve kredi, sınırlar, hata kodları, gerçek kişi avatarında rıza.
Üç yol, tek kural
- Panel: Üretim ekranı (
/uretim). Kartı seçer, formu doldurur, "Fiyatı gör" ve "Onayla ve üret" düğmeleriyle ilerlersiniz. - MCP: Claude, ChatGPT ve diğer asistanlarda bağlayıcı adresi
https://tecrube.com/mcp. Asistana ne istediğinizi yazarsınız; asistan aşağıdaki araçları çağırır. - REST API:
https://tecrube.com/api/v1/production/...uçları,Authorization: Bearer tk_...başlığıyla. Panel de aynı uçları kullanır. - Üçü aynı çekirdek işlevleri çağırır: fiyat, kredi denetimi, bakiye ayırma, aylık limit, hız sınırı ve doğrulamalar aynıdır. MCP ya da API ile daha ucuz ya da kuralsız bir üretim yolu yoktur.
Yetenek envanteri
Üretim ekranındaki her yetenek ve karşılıkları. Araçların parametreleri ve kredileri Üretim araçları sayfasında koddan üretilir; uçların şeması OpenAPI referansındadır.
| Yetenek | Panelde | MCP aracı | REST ucu |
|---|---|---|---|
| Türler, tarifler, kalite kademeleri ve fiyatlar | Yeni üretim formu | get_production_options | GET /production/overview · GET /production/formats |
| Açılış (hook) önerileri | Form › Açılış önerileri | suggest_production_hooks | POST /production/hooks |
| Teklif: ne üretilecek, kaça, ne zamana kadar | Fiyatı gör | quote_production | POST /production/quotes |
| Toplu varyasyon (2–4) | Form › Varyasyon sayısı | quote_production variations | POST /production/quotes/batch |
| Teklifi okuma | Teklif kartı | get_production_quote | GET /production/quotes/{id} |
| Onaylanan teklifi başlatma | Onayla ve üret | start_production | POST /production/jobs · POST /production/jobs/batch |
| Tek adımlı düz üretim (onaysız) | — | generate_content | — |
| Kütüphane: arama, süzgeç, sayfalama | Üretimler sekmesi | list_productions | GET /production/jobs |
| Tek üretimin bütün bilgisi | Üretim kartı | list_productions production_id | GET /production/jobs/{id} |
| Kuyruktaki işi iptal | Kart › İptal et | cancel_production | POST /production/jobs/{id}/cancel |
| Düşen işi aynı ayarlarla yeniden dene | Kart › Yeniden dene | retry_production | POST /production/jobs/{id}/retry |
| Favori | Kart › Yıldız · Yalnız favoriler | set_production_favorite | PUT /production/jobs/{id}/favorite |
| Silme (toplu da) | Kart › Sil · Seç › Seçilenleri sil | delete_production | DELETE /production/jobs/{id} |
| İndirme (PNG / JPG / WEBP) | Kart › İndir | get_production_download | GET /production/jobs/{id}/download |
| Ürün sayfasından başlama | Ürün sayfasından başlayın | import_production_from_url | POST /production/import-url |
| Kendi görselini yükleme | Görsel yükle | upload_production_image | POST /production/assets |
| Reklam formatlarına uyarlama | Kart › Formatlara uyarla | adapt_production_formats | POST /production/jobs/{id}/formats |
| Yayın öncesi denetim | Kart › Yayın öncesi denetim | production_preflight | GET /production/jobs/{id}/preflight |
| TV / bağlantılı TV ana kopya | Kart › Yayın kalitesi | get_production_masters · create_production_master · delete_production_master | GET / POST /production/jobs/{id}/masters · DELETE /production/masters/{id} |
| Marka filmi sahneleri ve yeniden kurgu | Kart › Sahneleri düzenle | get_production_film · edit_production_film | GET /production/jobs/{id}/film · POST /production/jobs/{id}/film/edit |
| Tek sahneyi yeniden üretme | Sahneler › Bu sahneyi yeniden üret | quote_production recipe: scene | POST /production/quotes recipe: scene |
| Bunun gibi daha üret | Reklam sonucu › Bunun gibi daha üret | quote_production like_production_id | GET /production/jobs/{id} → POST /production/quotes (hook, angle) |
| Paylaşım bağlantısı, karar ve yorumlar | Kart › Paylaş | create_production_share · get_production_share · revoke_production_share | POST / GET / DELETE /production/jobs/{id}/share |
| Karakterler (AI influencer, AI avatar) | Karakterler › Yeni karakter | get_production_options topic: characters · create_production_character · delete_production_character | GET / POST /production/characters · DELETE /production/characters/{id} |
| Bakiye, kredi ve hareketler | Bakiye sekmesi | get_production_wallet | GET /production/wallet · GET /production/wallet/ledger |
| Aylık harcama limiti | Bakiye › Aylık harcama limiti | set_production_monthly_limit | PUT /production/wallet/limit |
| Üretimi kampanyaya ekleme | Sohbet · kampanya kreatifleri | add_production_to_campaign | POST /production/jobs/{id}/campaign |
| Reklam sonucu ve en iyi varyasyon | Kart › Reklam sonucu · Varyasyonlar | list_productions (performance, batch_result, review) | GET /production/jobs (performance, batch_result, review) |
Türler ve tarifler
Beş temel tür ve sekiz hazır tarif; hepsi quote_production (MCP) ve POST /production/quotes (REST) ile istenir. Tarif recipe alanıdır.
| Tarif | Ne verir? | Tür (`kind`) | Gerekenler |
|---|---|---|---|
| — | Temel türler: görsel, kısa video, UGC video, seslendirme, senaryo. | image · short_video · ugc_video · voice · script | brief |
product | Ürün fotoğrafından görsel ya da video; fotoğraf korunur, sahne (style) değişir. | image · short_video · ugc_video | reference_id, style |
edit | Hazır içeriğin yeni sürümü; brief yapılacak değişikliktir. | image · short_video · ugc_video | reference_id, brief |
persona | Karakter olarak kaydedilecek yapay zekâ portresi. | image | brief |
influencer | Kayıtlı sanal karakterle tutarlı içerik. | image · short_video · ugc_video | character_id (virtual) |
avatar | Rıza beyanlı gerçek kişi karakteriyle içerik. | image · short_video · ugc_video | character_id (real) |
film | Çok sahneli marka filmi; ekran yazısı ve logolu kapanış kartı. | short_video | scenes, captions, end_card |
scene | Hazır filmin tek sahnesi; yalnız o sahne ücretlenir, scene: 1 + hook yalnız açılışı değiştirir. | short_video | reference_id, scene, hook |
dubbing | Hazır videonun başka dilde sürümü. | short_video · ugc_video | reference_id, language |
pack | Tek ana görselden reklam formatları ve isteğe bağlı kısa video. | image | formats, video |
Uçtan uca: MCP ile
Asistanınıza doğal dille yazmanız yeter; asistan aşağıdaki sırayla çalışır.
- Seçenekler:
get_production_optionstürleri, kademeleri ve fiyatları okur (rakam uydurulmaz). - Teklif:
quote_productionne üretileceğini ve fiyatı döner. Hiçbir şey üretilmez, kredi düşmez. - Onay: asistan fiyatı size gösterir ve onayınızı bekler.
- Başlatma: onay verince
start_productionteklifi başlatır; ücret bu adımda ayrılır. - Durum ve dosya:
list_productionsdurumu ve hazır dosyanın adresini verir;get_production_downloadistenen türde indirme adresi üretir.
Örnek istem: "Kahve dükkânım için 4:5 oranında, sıcak tonlu bir sonbahar afişi hazırla. Önce fiyatını söyle, onaylarsam üret."
// quote_production
{ "kind": "image", "brief": "Autumn coffee campaign poster, warm tones", "aspect": "4:5", "tier": "balanced" }
// result (nothing produced or charged yet)
{ "ok": true, "status": "awaiting_confirmation", "started": false,
"quote": { "quote_id": "6f0c…", "kind": "image", "pricing": "credits", "price": { "credits": 24 },
"credits_remaining": 5810, "enough_credits": true, "expires_at": "2026-11-18T10:30:00+00:00" },
"confirm_with": { "tool": "start_production", "arguments": { "quote_id": "6f0c…" } } }// start_production — only after the user confirmed the price
{ "quote_id": "6f0c…" }
// → { "ok": true, "production_id": "a1b2…", "status": "queued", … }
// list_productions — repeat until status is "ready"
{ "production_id": "a1b2…" }
// → { "items": [ { "id": "a1b2…", "status": "ready", "url": "https://tecrube.com/medya/…", "file": { "width": 1080, "height": 1350 } } ] }
// get_production_download — a JPG copy at a signed address that expires
{ "production_id": "a1b2…", "format": "jpg" }Tarif örnekleri (MCP argümanları)
// From a product page: page facts + the main image into the library
{ "url": "https://shop.example.com/product/123", "confirm_rights": true } // import_production_from_url
// Product video from that photo, three variations (the total price comes back)
{ "kind": "short_video", "recipe": "product", "reference_id": "<image id>", "brief": "…", "variations": 3 } // quote_production
// Dub a ready video into German
{ "kind": "short_video", "recipe": "dubbing", "reference_id": "<video id>", "language": "de" } // quote_production
// "More like this": the winner's settings, a new aspect
{ "like_production_id": "<winner id>", "aspect": "9:16" } // quote_productionUçtan uca: REST API ile
Aynı akış curl ile. Teklif yanıtındaki id teklif kimliğidir; POST /production/jobs yanıtındaki id üretim kimliğidir.
API=https://tecrube.com/api/v1
KEY=tk_your_key
# 1) Quote — nothing is produced or charged (Idempotency-Key returns the same quote on retry)
curl -X POST $API/production/quotes \
-H "Authorization: Bearer $KEY" -H "Content-Type: application/json" -H "Idempotency-Key: autumn-poster-1" \
-d '{"kind":"image","brief":"Autumn coffee campaign poster, warm tones","aspect":"4:5","tier":"balanced"}'
# → {"id":"<quote_id>","mode":"credits","credits":24,"price_usd":0,"expires_at":"…",…}
# 2) Confirm and start (the same quote_id never starts a second production)
curl -X POST $API/production/jobs \
-H "Authorization: Bearer $KEY" -H "Content-Type: application/json" -d '{"quote_id":"<quote_id>"}'
# 3) Status — repeat until "status":"ready" (running jobs carry "eta")
curl $API/production/jobs/<job_id> -H "Authorization: Bearer $KEY"
# 4) Download as JPG (png | jpg | webp; images only)
curl -o poster.jpg "$API/production/jobs/<job_id>/download?format=jpg" -H "Authorization: Bearer $KEY"Diğer uçlardan örnekler
# Library: search, filter, paginate
curl "$API/production/jobs?q=autumn&kind=image&status=ready&favorite=true&limit=20&offset=0" -H "Authorization: Bearer $KEY"
# Variations: 2–4 quotes in one request, then one confirmation
curl -X POST $API/production/quotes/batch -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"kind":"image","brief":"New collection","variations":3,"hooks":["Autumn is here","New season"]}'
curl -X POST $API/production/jobs/batch -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"quote_ids":["<q1>","<q2>","<q3>"]}'
# Adapt a ready image to ad formats (format ids: GET /production/formats?platform=meta&type=image)
curl -X POST $API/production/jobs/<job_id>/formats -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"formats":[12,14],"headline":"New season","cta":"Shop now","logo":true}'
# Review link for 14 days, then read the decision and comments
curl -X POST $API/production/jobs/<job_id>/share -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" -d '{"days":14}'
curl $API/production/jobs/<job_id>/share -H "Authorization: Bearer $KEY"
# TV master copy (ProRes 422 HQ, 30 s, PAL)
curl -X POST $API/production/jobs/<job_id>/masters -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"profile":"tv_pal","codec":"prores","seconds":30}'
# Use it in a campaign
curl -X POST $API/production/jobs/<job_id>/campaign -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"campaign_id":"<campaign_id>"}'Ücret ve kredi
- Ücret modu: üretim ya plan kredisiyle (
pricing: credits) ya da üretim bakiyesiyle (pricing: balance, USD) ödenir; hangisinin geçerli olduğuget_production_optionsveGET /production/overviewyanıtındadır. - Fiyat önce görünür: her teklif ne üretileceğini, tutarı ve geçerlilik süresini (
expires_at) söyler. Süresi dolan teklif başlatılamaz; yenisi bugünün fiyatıyla alınır. - Ne zaman düşer: bakiye modunda tutar başlatırken ayrılır, dosya hazır olunca tahsil edilir; iş düşer ya da iptal edilirse ayrılan tutar geri döner. Kredi modunda başlatırken kalan kredinin işi karşılayıp karşılamadığı denetlenir, kredi dosya üretildiğinde düşer.
- Yetmezse başlamaz: kredi ya da bakiye yetmiyorsa ya da aylık limit aşılacaksa iş hiç başlamaz; yanıtta gereken ve kalan tutar yazar.
- Aynı fiyat her yerde: fiyatlar her işin gideri karşılanacak biçimde belirlenir ve panel, MCP ve API aynı fiyatı uygular.
- MCP araç ücreti: üretim araçlarının çağrısı ayrıca ücretlenmez (0 kredi); yalnız ürün sayfası okuma, adresten görsel yükleme ve açılış önerisi 1 kredidir. Ücretin kendisi teklifte yazan tutardır.
Onay: ne zaman ücret alınır?
quote_productionveretry_productionyalnız teklif üretir; hiçbir şey üretmez ve ücret almaz.start_productionücret ayırır ya da kredi kullanır; asistan onu yalnız siz fiyatı görüp açıkça onayladıktan sonra çağırmalıdır. Araç, istemcilerde onay isteyen (yıkıcı) işaretlidir.- Panel sohbeti aynı turda alınan teklifi başlatmaz (
confirmation_required): fiyatı gördüğünüz mesajdan sonra onay gerekir. - Aynı teklif ikinci kez başlatılırsa ikinci üretim açılmaz, ilk üretim döner. REST'te
Idempotency-Keyaynı teklifi döndürür.
Üretimden sonra
- Formatlara uyarla: hazır görsel en çok 12 yerleşimin oranına çevrilir; başlık, çağrı ve logo güvenli alanda kalır. Ücretsizdir.
- Yayın öncesi denetim: hedefsiz çağrı denetlenebilecek yerleşimleri ve yayın profillerini listeler;
format_idya daprofileile dosyanın kendisi ölçülür ve geçti / dikkat / geçmedi listesi döner. - Yayın kalitesi: hazır videodan TV PAL (1080p25, −23 LUFS), TV NTSC (1080p29,97, −24 LKFS) ya da bağlantılı TV profiline göre ProRes 422 HQ veya H.264 ana kopya ve teknik rapor. Ücretsizdir; yayıncının kabulünü garanti etmez.
- Video motoru: videoda kalite kademesi yerine modeli adıyla seçebilirsiniz (Seedance 2.0 ve 2.5 1080p; 2.5 Flash, 2.0 Fast ve 2.0 Mini 720p, hepsi sesli).
tieralanına model kimliği yazılır, ör.bytedance/seedance-2.0; liste ve fiyatlarget_production_optionsya daGET /production/overview›tiersiçindeengine_nameile gelir. Kapalı bir motor istenirse teklifengine_unavailableile reddedilir, başka modelle fiyatlanmaz. - Marka filmi: sahne sırası, ekran yazısı ve kapanış kartı ücretsiz yeniden kurulur, yeni sürüm açılır ve eskisi kalır. Tek sahneyi yeniden üretmek ücretlidir ve teklif yolundan geçer.
- Paylaşım: oturum gerektirmeyen 1–90 günlük inceleme bağlantısı; adres yalnız oluşturulurken bir kez gösterilir, üretimin önceki bağlantıları kapanır. İnceleyenin kararı ve yorumları
get_production_shareile okunur; bağlantıyı istediğiniz an kapatırsınız. - Kampanyaya ekleme: üretim kampanyanın taslak kreatif kartı olur. Meta ve Google'da kampanya yayına alınırken bu dosya kullanılır; yayındaki reklam kendiliğinden değişmez.
- Reklam sonucu: reklamda kullanılan üretimde kampanya geneli rakamlar (
performance) ve toplu varyasyonda karşılaştırma (batch_result) görünür. "En iyi sonuç" yalnız adil bir karşılaştırmada işaretlenir. - Silme: kalıcıdır ve geri alınamaz. Kampanyada kullanılan (
in_use) ya da hâlâ üretilen (active) içerik silinmez. Asistan silme araçlarını yalnız siz açıkça istediğinizde çağırmalıdır.
Gerçek kişi avatarı ve rıza
- Sanal karakter (AI influencer) için hazır bir yüz görseli yeter.
- Gerçek bir kişinin avatarı yalnız rıza beyanıyla kaydedilir: kişinin adı, dayanak (
self: fotoğraftaki kişi sizsiniz ·written: kişinin yazılı izni var) ve açık onay (confirmed: true). Beyan hesabınız ve zamanıyla kaydedilir. - Beyanı yalnız siz verirsiniz. Asistan bu alanları sizin adınıza dolduramaz; panel sohbeti gerçek kişi karakterini hiç kurmaz, sizi forma yönlendirir.
- Karakteri silmek rızanın geri alınmasıdır; daha önce üretilen dosyalar kütüphanede kalır.
// create_production_character (MCP) · POST /production/characters (REST)
{ "name": "Ayşe", "type": "real", "image_id": "<photo id>",
"consent": { "person_name": "Ayşe Yılmaz", "basis": "self", "confirmed": true } }Sınırlar
| Konu | Sınır |
|---|---|
| Görsel yükleme | PNG, JPEG ya da WEBP; en çok 12 MB; kenarlar 200–4.096 piksel; kütüphanede en çok 500 yükleme |
İstek metni (brief) | En çok 2.000 karakter; açılış cümlesi en çok 160 karakter |
| Toplu varyasyon | 2–4 (üst sınırı platform yönetimi düşürebilir) |
| Açılış önerisi | Çağrı başına 5–8 öneri |
| Format uyarlama | İstek başına en çok 12 format |
| Toplu silme (MCP) | Çağrı başına en çok 24 üretim |
| Paylaşım bağlantısı | 1–90 gün (varsayılan 14) |
| Marka filmi | En çok 12 sahne; üretim başına en çok 12 sürüm |
| Yayın ana kopyası | Spot süresi 10, 15, 20, 30, 45 ya da 60 sn; kaynak en çok 3 sn uzatılır; kaynak video en çok 185 sn; üretim başına en çok 8 kopya |
| Karakter | Hesap başına en çok 50 |
| Hız sınırı (saatte, hesap başına) | Teklif 120 · yükleme 60 · uyarlama 120 · karakter 40 · ana kopya 20 · denetim 180 · yeniden kurgu 30 · açılış önerisi 40 · ürün sayfası 20 · paylaşım 60 · indirme 240 |
Hata kodları
| Kod | REST | Anlamı ve yapılacak |
|---|---|---|
credits_exhausted | 402 | Plan kredisi bu işi karşılamıyor; yanıtta gereken (needed) ve kalan (remaining) yazar. Plan ekranından yükseltin ya da ek kredi alın. |
insufficient_balance | 402 | Üretim bakiyesi yetmiyor; Üretim ekranından bakiye yükleyin. |
monthly_limit | 402 | Koyduğunuz aylık limit aşılacak; limiti değiştirin ya da gelecek ayı bekleyin. |
quote_expired · quote_cancelled | 410 · 409 | Teklifin süresi doldu ya da iptal edildi; yeni teklif alın (fiyat değişmiş olabilir). |
not_found | 404 | Kimlik bu hesapta yok (başka hesabın kaydı da böyle görünür). Kimliği liste aracından ya da ucundan alın. |
read-only · read_only | 403 | Okuma kapsamlı anahtar ya da görüntüleyici rolü yazma işi yapamaz. |
needs_provider | — | Bir üretim durumudur: yapay zekâ sağlayıcısı bağlı değil, yalnız senaryo yazıldı; sağlayıcı bağlanınca yeniden denenebilir. |
rate_limited | 429 | Saatlik sınır doldu; retry_after saniye sonra yeniden deneyin. |
reference_required · reference · character_required · language · formats | 422 | Tarifin istediği kaynak, karakter, dil ya da format eksik veya geçersiz; yanıttaki hint ne yapılacağını söyler. |
rendering · in_use · active · not_ready | 409 | Sağlayıcıda süren iş durdurulamaz; kampanyadaki ya da süren içerik silinmez; hazır olmayan dosya kampanyaya eklenmez. |
consent | 422 | Hak beyanı (ürün sayfası) ya da rıza beyanı (gerçek kişi) eksik. |
unsafe · unsafe_url | 422 | İç ağ ya da yerel adres okunmaz; herkese açık bir http(s) adresi verin. |
Sıradaki adımlar
- Ü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.
- API ve istemcilerEnterprise planında API anahtarıyla kimlik doğrulama, kapsamlar, hız sınırı, OpenAPI referansı, Python ve JavaScript istemcileri, MCP SDK bağlantısı.
- Krediler & KullanımHer araç çağrısı birkaç kredi harcar: okuma ucuz, canlı değişiklik pahalı. Başlangıç planında ömür boyu 100 kredi, ücretli planlarda aylık yenilenen kredi; başarısız çağrının kredisi iade edilir.