Transept'i API ile Otomatikleştirin

Ayarlar → Geliştirici altından kişisel bir API anahtarı oluşturun. Ücretsiz dahil tüm planlarda mevcuttur; ayrı bir kısıtlama yoktur, kullanımı sınırlayan tek şey kelime bakiyenizdir. Anahtara bir isim verin, isterseniz bir son kullanma tarihi belirleyin ve gösterildiğinde gizli anahtarı kopyalayın: Bu anahtar sadece bir kez gösterilir ve daha sonra tekrar erişilemez. İstediğiniz zaman aynı sayfadan bir anahtarı iptal edebilirsiniz.

İstekler, Authorization: Bearer tsk_live_… başlığındaki (header) anahtar ile doğrulanır; bu anahtar sadece başlıkta kullanılmalı, asla URL içinde gönderilmemelidir.

Altı kısa çağrı, sizi API anahtarından çevrilmiş çıktıya ulaştırır. Sadece çeviri işleminin kendisi kelime harcar; tahminler ücretsizdir ve aynı Idempotency-Key ile tekrarlanan bir çağrı, iki kez ücretlendirilmek yerine orijinal sonucu döndürür.

Aynı çağrıların daha kapsamlı açıklamalarına transept.ai/developers adresinden ulaşabilirsiniz. Yerelleştirme API kılavuzu ise geri kalan her şeyi adım adım anlatır: metin dizisi katalogları, e-posta şablonları, sözlükler, ekipler ve inceleme aşamaları.

export KEY="tsk_live_…"                          # minted under Settings → Developer
BASE="https://app.transept.ai/api/public/v1"

# 1. Check the key: your account, its permissions, your word balance
curl -s $BASE/me -H "Authorization: Bearer $KEY"

# 2. Create a document; Transept creates one language version per target
curl -s -X POST $BASE/documents \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"title": "Welcome email", "content": "# Welcome…", "content_type": "markdown",
       "source_language": "en", "target_languages": ["de", "fr", "uk"]}'

# 3. Estimate: the word cost, free, with no side effects
curl -s -X POST $BASE/group-runs/estimate \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"document_id": "<master>", "template_id": "end_to_end", "target_languages": "all"}'

# 4. Run: the same body starts it
curl -s -X POST $BASE/group-runs \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -H "Idempotency-Key: welcome-1" \
  -d '{"document_id": "<master>", "template_id": "end_to_end", "target_languages": "all"}'

# 5. Wait: poll for per-language progress (or get pushed an event; see below)
curl -s $BASE/group-runs/<group-run-id> -H "Authorization: Bearer $KEY"

# 6. Read each language back in the format you need (the table below lists them)
curl -s "$BASE/documents/<version-id>/content?format=markdown" \
  -H "Authorization: Bearer $KEY"

Ham metin, HTML veya Markdown kullanarak bir belge oluşturun ya da bir dosya yükleyin — uygulama hangi formatları kabul ediyorsa onları kullanabilirsiniz. Ayrıca bir metin dizisi tablosu (.tstrings.json) da içe aktarabilirsiniz: Bu, kullanıcı arayüzü metinleri veya oyun dizeleri için yapılandırılmış bir formattır; burada her dize, sabit bir anahtara ve kendi bağlamına (ne olduğu, nerede göründüğü, karakter sınırı ve yer tutucularının ne anlama geldiğine dair bir not) sahip bir birimdir. Tüm bu bilgiler modele ulaşır; {name} gibi yer tutucular silinmeye veya yeniden adlandırılmaya karşı korunur ve çoğul yapılar dile göre genişletilir (İngilizcedeki tek bir form Almancada ikiye, Ukraynacada ise dörde çıkar). Dosyanın halihazırda içerdiği tüm çeviriler olduğu gibi ve ücretsiz olarak içe aktarılır; üstelik anında çeviri belleğini besler.

Bir grup işlemi (group run), aynı anda birkaç dile çeviri yapılmasını sağlar. Belgeyi, çalıştırılacak iş akışını veya şablonu ve hedef dilleri belirtin; Transept eksik dil sürümlerini oluşturur ve iş akışını her biri için çalıştırır. Tüm süreç tek bir ID üzerinden takip edilir; her dilin ilerleme durumunu ve onay bekleyip beklemediğini bu ID ile sorgulayabilirsiniz.

Tekrarlanan işlemler için bir string tablosunun güncel dosyasını yeniden gönderin; Transept nelerin değiştiğini kendisi tespit eder: Değişmeyen dizeler çevirilerini (ve yapılmış olan incelemeleri) korur, işlem ise yalnızca yeni veya gerçekten değişmiş birimlere uygulanır — bu, Yalnızca değişenleri çalıştır özelliğinin API tarafındaki karşılığıdır. İlk içe aktarmadan delta işlemlerine kadar tüm anahtarlı döngü süreci API üzerinden bir dize kataloğunu yerelleştirin kılavuzunda anlatılmaktadır.

Sürekli sorgulama (polling) yapmak yerine bir URL kaydedin; Transept bir işlem tamamlandığında veya başarısız olduğunda, bir inceleme incelenmeye hazır olduğunda, bir yüklemenin işlenmesi bittiğinde ve bir dışa aktarma hazır olduğunda bir olay bildirimi iletir. Her gönderim, alıcınızın bildirimin gerçekten bizden geldiğini doğrulayabilmesi için bir HMAC-SHA256 X-Transept-Signature: t=…,v1=… üstbilgisi taşır; hata veren uç noktalar ise devre dışı bırakılmadan önce kademeli bekleme süreleriyle tekrar denenir.

# register once; every matching event is POSTed to your URL, signed
curl -s -X POST $BASE/webhooks \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/transept-events",
       "events": ["group_run.completed", "run.gate_ready", "run.failed"]}'
# → the endpoint, including its ONE-TIME secret; verify X-Transept-Signature with it

Bir iş akışı, bir Notion veritabanı otomasyonu üzerinden de kendiliğinden çalışabilir: Otomasyonun webhook'unu tetikleyici URL'sine yönlendirdiğinizde Transept, iş akışını değişen sayfa üzerinde çalıştırır. Buradaki kilit nokta, bir Notion webhook'unun sayfa içeriğini asla taşımamasıdır; sadece hangi sayfanın tetiklendiğini bildirir. Transept bu sayfayı sizin Notion bağlantınız üzerinden okur; bu nedenle şu iki şartın da sağlanması gerekir. Aksi takdirde her tetikleme bir erişim hatasıyla geri çevrilir ve tetikleyici kartında “Notion sayfası okunamadı” notu görünür:

• Notion'ı Transept'e bağlayın — Ayarlar → Entegrasyonlar altından. Bu, Transept'in sizin adınıza okuma yapmasına izin veren tek seferlik OAuth bağlantısıdır.
• Kaynak veritabanını Notion içindeki entegrasyonla paylaşın — veritabanını (veya sayfayı) açın, ••• menüsüne tıklayın, Bağlantılar'ı seçin ve Transept'i ekleyin. Ayarlar'da Notion'ı bağlamak, tek başına belirli bir veritabanına erişim izni vermez; bu adım olmadan bağlantı etkindir ancak sayfa okunamaz kalır.
• Sadece içerik düzenlemesine değil, bir özellik değişikliğine göre tetikleyin. Notion otomasyonları özellik değişikliklerinde (ve sayfa eklemelerinde) tetiklenir; bu nedenle bir sayfanın sadece gövde metnini düzenlemek herhangi bir tetiklemeye yol açmayabilir. Güvenilir yöntem, otomasyonun izlediği bir Durum özelliğidir; bu durumu değiştirdiğinizde (örneğin “Çeviriye hazır” olarak) tetikleyiciyi çağıran şey bu değişiklik olur.

Tüm uç nokta listesi; n8n, Zapier veya bir kod oluşturucuya aktarabileceğiniz bir OpenAPI spesifikasyonu olarak yayınlanmıştır: etkileşimli referansa göz atın veya ham JSON dosyasını indirin. Uygulamalı bir anlatım mı tercih edersiniz? transept.ai/developers adresinde kopyala-yapıştır örnekleri içeren hızlı başlangıç kılavuzu mevcuttur; yerelleştirme API kılavuzu ise tüm süreci derinlemesine ele alır. API üzerinden başlatılan işlemler, tıpkı uygulama içi düzenleyicide olduğu gibi kelime üzerinden ücretlendirilir.

Evet — Transept'in yapay zeka asistanlarının bağlandığı bir MCP uç noktası vardır: https://app.transept.ai/api/public/v1/mcp. Bağlantı için standart OAuth kullanılır: URL'yi Claude Code, Claude Desktop, Cursor veya herhangi bir MCP istemcisine eklediğinizde, bir tarayıcı penceresi erişimi onaylamanızı ister; kopyalanacak bir anahtar yoktur (CI ve arayüzsüz kurulumlar için Bearer üstbilgisi olarak bir API anahtarı hâlâ kullanılabilir). Asistan bu sayede tüm döngü için gerekli araçlara sahip olur: belgeleri içe aktarma, diller arası iş akışlarını çalıştırma, sözlükleri ve stil kılavuzlarını yönetme, çeviri belleğini sorgulama ve sonuçları geri okuma. Sisteme iki koruma mekanizması dahil edilmiştir: Her araç verdiğiniz izinlere sadık kalır ve kelime harcayacak her işlem öncesinde bir kelime tahmini sunar; işlem başlamadan önce asistanın bunu açıkça onaylaması gerekir, böylece bir ajan asla yanlışlıkla size ücret yansıtamaz. Her istemci için hazır kurulum kod parçacıkları uygulamadaki Entegrasyonlar sayfasında yer alır; onay ekranından bağlantıyı kesmeye kadar tüm süreci kapsayan anlatım Yapay zeka asistanınızı bağlayın sayfasındadır.