İçeriğe geç
Tecrübetecrube.com
İlk adımlar

Ü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.

YetenekPaneldeMCP aracıREST ucu
Türler, tarifler, kalite kademeleri ve fiyatlarYeni üretim formuget_production_optionsGET /production/overview · GET /production/formats
Açılış (hook) önerileriForm › Açılış önerilerisuggest_production_hooksPOST /production/hooks
Teklif: ne üretilecek, kaça, ne zamana kadarFiyatı görquote_productionPOST /production/quotes
Toplu varyasyon (2–4)Form › Varyasyon sayısıquote_production variationsPOST /production/quotes/batch
Teklifi okumaTeklif kartıget_production_quoteGET /production/quotes/{id}
Onaylanan teklifi başlatmaOnayla ve üretstart_productionPOST /production/jobs · POST /production/jobs/batch
Tek adımlı düz üretim (onaysız)—generate_content—
Kütüphane: arama, süzgeç, sayfalamaÜretimler sekmesilist_productionsGET /production/jobs
Tek üretimin bütün bilgisiÜretim kartılist_productions production_idGET /production/jobs/{id}
Kuyruktaki işi iptalKart › İptal etcancel_productionPOST /production/jobs/{id}/cancel
Düşen işi aynı ayarlarla yeniden deneKart › Yeniden deneretry_productionPOST /production/jobs/{id}/retry
FavoriKart › Yıldız · Yalnız favorilerset_production_favoritePUT /production/jobs/{id}/favorite
Silme (toplu da)Kart › Sil · Seç › Seçilenleri sildelete_productionDELETE /production/jobs/{id}
İndirme (PNG / JPG / WEBP)Kart › İndirget_production_downloadGET /production/jobs/{id}/download
Ürün sayfasından başlamaÜrün sayfasından başlayınimport_production_from_urlPOST /production/import-url
Kendi görselini yüklemeGörsel yükleupload_production_imagePOST /production/assets
Reklam formatlarına uyarlamaKart › Formatlara uyarlaadapt_production_formatsPOST /production/jobs/{id}/formats
Yayın öncesi denetimKart › Yayın öncesi denetimproduction_preflightGET /production/jobs/{id}/preflight
TV / bağlantılı TV ana kopyaKart › Yayın kalitesiget_production_masters · create_production_master · delete_production_masterGET / POST /production/jobs/{id}/masters · DELETE /production/masters/{id}
Marka filmi sahneleri ve yeniden kurguKart › Sahneleri düzenleget_production_film · edit_production_filmGET /production/jobs/{id}/film · POST /production/jobs/{id}/film/edit
Tek sahneyi yeniden üretmeSahneler › Bu sahneyi yeniden üretquote_production recipe: scenePOST /production/quotes recipe: scene
Bunun gibi daha üretReklam sonucu › Bunun gibi daha üretquote_production like_production_idGET /production/jobs/{id} → POST /production/quotes (hook, angle)
Paylaşım bağlantısı, karar ve yorumlarKart › Paylaşcreate_production_share · get_production_share · revoke_production_sharePOST / GET / DELETE /production/jobs/{id}/share
Karakterler (AI influencer, AI avatar)Karakterler › Yeni karakterget_production_options topic: characters · create_production_character · delete_production_characterGET / POST /production/characters · DELETE /production/characters/{id}
Bakiye, kredi ve hareketlerBakiye sekmesiget_production_walletGET /production/wallet · GET /production/wallet/ledger
Aylık harcama limitiBakiye › Aylık harcama limitiset_production_monthly_limitPUT /production/wallet/limit
Üretimi kampanyaya eklemeSohbet · kampanya kreatifleriadd_production_to_campaignPOST /production/jobs/{id}/campaign
Reklam sonucu ve en iyi varyasyonKart › Reklam sonucu · Varyasyonlarlist_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.

TarifNe verir?Tür (`kind`)Gerekenler
—Temel türler: görsel, kısa video, UGC video, seslendirme, senaryo.image · short_video · ugc_video · voice · scriptbrief
productÜrün fotoğrafından görsel ya da video; fotoğraf korunur, sahne (style) değişir.image · short_video · ugc_videoreference_id, style
editHazır içeriğin yeni sürümü; brief yapılacak değişikliktir.image · short_video · ugc_videoreference_id, brief
personaKarakter olarak kaydedilecek yapay zekâ portresi.imagebrief
influencerKayıtlı sanal karakterle tutarlı içerik.image · short_video · ugc_videocharacter_id (virtual)
avatarRıza beyanlı gerçek kişi karakteriyle içerik.image · short_video · ugc_videocharacter_id (real)
filmÇok sahneli marka filmi; ekran yazısı ve logolu kapanış kartı.short_videoscenes, captions, end_card
sceneHazır filmin tek sahnesi; yalnız o sahne ücretlenir, scene: 1 + hook yalnız açılışı değiştirir.short_videoreference_id, scene, hook
dubbingHazır videonun başka dilde sürümü.short_video · ugc_videoreference_id, language
packTek ana görselden reklam formatları ve isteğe bağlı kısa video.imageformats, video

Uçtan uca: MCP ile

Asistanınıza doğal dille yazmanız yeter; asistan aşağıdaki sırayla çalışır.

  1. Seçenekler: get_production_options türleri, kademeleri ve fiyatları okur (rakam uydurulmaz).
  2. Teklif: quote_production ne üretileceğini ve fiyatı döner. Hiçbir şey üretilmez, kredi düşmez.
  3. Onay: asistan fiyatı size gösterir ve onayınızı bekler.
  4. Başlatma: onay verince start_production teklifi başlatır; ücret bu adımda ayrılır.
  5. Durum ve dosya: list_productions durumu ve hazır dosyanın adresini verir; get_production_download istenen 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
// 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 · list_productions · get_production_download
// 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ı)

json
// 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_production

Uç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.

bash
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

bash
# 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ğu get_production_options ve GET /production/overview yanı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_production ve retry_production yalnı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-Key aynı 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_id ya da profile ile 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). tier alanına model kimliği yazılır, ör. bytedance/seedance-2.0; liste ve fiyatlar get_production_options ya da GET /production/overview › tiers içinde engine_name ile gelir. Kapalı bir motor istenirse teklif engine_unavailable ile 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_share ile 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.
json
// 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

KonuSınır
Görsel yüklemePNG, 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 varyasyon2–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 filmiEn ç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
KarakterHesap 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ı

KodRESTAnlamı ve yapılacak
credits_exhausted402Plan 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_balance402Üretim bakiyesi yetmiyor; Üretim ekranından bakiye yükleyin.
monthly_limit402Koyduğunuz aylık limit aşılacak; limiti değiştirin ya da gelecek ayı bekleyin.
quote_expired · quote_cancelled410 · 409Teklifin süresi doldu ya da iptal edildi; yeni teklif alın (fiyat değişmiş olabilir).
not_found404Kimlik 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_only403Okuma 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_limited429Saatlik sınır doldu; retry_after saniye sonra yeniden deneyin.
reference_required · reference · character_required · language · formats422Tarifin 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_ready409Sağlayıcıda süren iş durdurulamaz; kampanyadaki ya da süren içerik silinmez; hazır olmayan dosya kampanyaya eklenmez.
consent422Hak beyanı (ürün sayfası) ya da rıza beyanı (gerçek kişi) eksik.
unsafe · unsafe_url422İç ağ ya da yerel adres okunmaz; herkese açık bir http(s) adresi verin.

Sıradaki adımlar