API Örnekleri

Sürüm

API

API kullanmaya başlayın

API anahtarı oluşturun

Oturum açın, panelinizden bir anahtar oluşturun ve kullanılabilir kredilerinizi kontrol edin.
Yükleyin ve gönderin

V2: yükleme URL’lerini alın, dosyaları yükleyin ve ardından çeviri görevini gönderin.
Görev durumunu kontrol edin

Görüntülerin işlenmesi bitene kadar döndürülen batch_id ile ilerlemeyi kontrol edin.
Çevrilmiş görüntüleri indirin

Başarıyla işlenen görüntüler için döndürülen çeviri URL’lerini kullanın.

Örnek girdiler

API anahtarı

Kaynak dil

Hedef dil

Model

Çevirmen

Yazı tipi

Python 3 · pip install requests

Rota

POST PUT POST

/api/v2/api/translate/uploads
R2 target
/api/v2/api/translate

Parametreler

Parametre	Gerekli	Tür	Açıklama
`image`	Evet	file[]	Bir veya daha fazla görüntü dosyası ya da bir ZIP arşivi
`source_language`	Hayır	string	İsteğe bağlıdır; manga modeli için zorunludur (örn. ja)
`target_language`	Evet	string	Hedef dil kodu (örn. en)
`model`	Hayır	string	Tanıma modeli; API varsayılanını kullanmak için atlayın
`translator`	Hayır	string	Metin çevirmeni; seçilen modelin varsayılan çevirmenini kullanmak için bu alanı atlayın veya auto kullanın. V2: yalnızca son istekte gönderin.
`font`	Hayır	string	Yazı tipi stili; API varsayılanını kullanmak için atlayın
`context`	Hayır	string	İsteğe bağlı hikâye arka planı ve tercih edilen adlar (en fazla 10.000 karakter). Normal çeviri için boş bırakın. V2: yalnızca son çeviri isteğinde gönderin.
`custom_prompt`	Hayır	string	Varsayılan çeviri talimatları için boş bırakın. Seçilen dil ve çıktı biçimi korunur. Ultra bunu modele ek talimat olarak iletir. (1,000)

Parametre	Gerekli	Tür	Açıklama
`Idempotency-Key`	Evet	HTTP header	Hazırlama isteği başlığı: aynı dosya listesini 8 saat boyunca güvenle yeniden denemek için sabit anahtar
`files[]`	Evet	array<object>	Hazırlık isteği: filename, content_type, size ve content_sha256 içeren dosya meta verileri
`upload_id`	Evet	string	Son istek: hazırlık adımının döndürdüğü opak yükleme grubu kimliği
`files[].index files[].upload_intent`	Evet	integer string	Son istek: hazırlık adımının her dosya için döndürdüğü index ve opak upload_intent; yalnızca her R2 yüklemesi tamamlandıktan sonra gönderin
`source_language`	Hayır	string	İsteğe bağlıdır; manga modeli için zorunludur (örn. ja)
`target_language`	Evet	string	Hedef dil kodu (örn. en)
`model`	Hayır	string	Tanıma modeli; API varsayılanını kullanmak için atlayın
`translator`	Hayır	string	Metin çevirmeni; seçilen modelin varsayılan çevirmenini kullanmak için bu alanı atlayın veya auto kullanın. V2: yalnızca son istekte gönderin.
`font`	Hayır	string	Yazı tipi stili; API varsayılanını kullanmak için atlayın
`context`	Hayır	string	İsteğe bağlı hikâye arka planı ve tercih edilen adlar (en fazla 10.000 karakter). Normal çeviri için boş bırakın. V2: yalnızca son çeviri isteğinde gönderin.
`custom_prompt`	Hayır	string	Varsayılan çeviri talimatları için boş bırakın. Seçilen dil ve çıktı biçimi korunur. Ultra bunu modele ek talimat olarak iletir. (1,000)

Parametre	Gerekli	Tür	Açıklama
`batch_id`	Evet	string	Görev durumunu sorgulamak için kullanılan toplu iş kimliği

Parametre	Gerekli	Tür	Açıklama
Parametre yok

Yanıt Parametreleri

Alan	Tür	Açıklama
`task_id`	string	Görev kimliği
`batch_id`	string	Görev durumunu sorgulamak için kullanılan toplu iş kimliği

Alan	Tür	Açıklama
`status`	integer	Uygulama durum kodu; başarılı olduğunda 200
`cost_ms`	integer	Bu API isteğinin milisaniye cinsinden işlenme süresi
`request_id`	string	Bu API çağrısını izlemek için istek kimliği
`data`	object	İstek kabul edildikten sonra döndürülen çeviri görevi kimlikleri
`message`	string	Başarılı API yanıtında her zaman success; çeviri görevinin tamamlandığı anlamına gelmez
`data.task_id`	string	Görev kimliği
`data.batch_id`	string	Görev durumunu sorgulamak için kullanılan toplu iş kimliği

Alan	Tür	Açıklama
`status_code`	integer	Başarılı bir Task Status yanıtı için her zaman 200
`request_id`	string	Bu API çağrısını izlemek için istek kimliği
`auth_type`	string	PAT ile doğrulanmış bir Task Status isteği için her zaman account
`task_reference`	string	İstek yolundaki batch_id, değiştirilmeden döndürülür
`data`	object	Görüntü başına sonuçlar ve genel görev durumu için kapsayıcı
`data.items`	array<object>	Görüntü başına görev sonuçları dizisi
`data.items[].image_id`	string	Görüntü sonucunun kararlı kimliği
`data.items[].index`	integer	Görüntünün toplu işte sıfırdan başlayan konumu
`data.items[].filename`	string	Orijinal görüntü dosya adı
`data.items[].status`	string	Görüntü sonucu durumu (pending \| processing \| completed \| failed \| canceled)
`data.items[].original_url`	string	Kaynak görüntünün URL’si; API ile oluşturulan güncel görevlerde kullanılabilir.
`data.items[].translated_url`	string	Çevrilmiş görüntünün URL’si; sonuç hazır olana kadar, bekleyen, işlenen veya başarısız görüntüler için boş dizedir.
`data.items[].is_translated`	boolean	Yalnızca tamamlanmış çevrilmiş görüntü URL’si varsa true
`data.items[].output_file_path`	string	translated_url için uyumluluk diğer adı; çevrilmiş görüntü yoksa boş dizedir.
`data.items[].message`	string \| null	İsteğe bağlı bilgi mesajı
`data.items[].error`	string \| null	Görüntü görevi başarısız olduğunda hata ayrıntısı; aksi halde null
`data.items[].inpaint_image_url`	string \| null	Metni silinmiş görüntünün URL’si veya seçilen model ya da yürütme yolu üretmiyorsa null.
`data.items[].block_json`	array<object>	V1 tarafından korunan yapılandırılmış metin blokları; model veya yol blok meta verisi döndürmezse boş dizi olabilir.
`data.task_status`	string	Görevin genel durumu (pending \| processing \| completed \| failed \| canceled)

Alan	Tür	Açıklama
`status`	integer	Uygulama durum kodu; başarılı olduğunda 200
`cost_ms`	integer	Görevin milisaniye cinsinden geçen süresi; geçerli zaman damgaları yoksa 0
`request_id`	string	Bu API çağrısını izlemek için istek kimliği
`data`	array<object>	Görüntü başına özet sonuçlar dizisi
`message`	string	Başarılı API yanıtında her zaman success; çeviri görevinin tamamlandığı anlamına gelmez
`data[].image_id`	string	Görüntü sonucunun kararlı kimliği
`data[].filename`	string	Orijinal görüntü dosya adı
`data[].status`	string	Görüntü sonucu durumu (pending \| processing \| completed \| failed \| canceled)
`data[].original_url`	string	Kaynak görüntünün URL’si; API ile oluşturulan güncel görevlerde kullanılabilir.
`data[].translated_url`	string	Çevrilmiş görüntünün URL’si; sonuç hazır olana kadar, bekleyen, işlenen veya başarısız görüntüler için boş dizedir.
`data[].erased_url`	string	Metni silinmiş görüntünün URL’si; boş dize olabilir. Manga’nın Auto bitmiş görüntü yolu gibi yalnızca bitmiş görüntü döndüren model veya yollar bunu üretmez.
`data[].blocks`	array<object>	Yapılandırılmış çevrilmiş metin blokları; Manga’nın Auto bitmiş görüntü yolu gibi model veya yol blok meta verisi döndürmezse boş dizi olabilir.
`data[].blocks[].angle`	number	Metin bloğunun dönüş açısı
`data[].blocks[].color`	string	Çevrilmiş metin için kullanılan onaltılık renk
`data[].blocks[].handwritten`	boolean	Kaynak metnin el yazısı olarak algılanıp algılanmadığı
`data[].blocks[].location`	object	Metin bloğunun dört köşeli sınırları
`data[].blocks[].location.left_bottom`	array<number>	Belirtilen köşenin koordinat çifti
`data[].blocks[].location.right_bottom`	array<number>	Belirtilen köşenin koordinat çifti
`data[].blocks[].location.left_top`	array<number>	Belirtilen köşenin koordinat çifti
`data[].blocks[].location.right_top`	array<number>	Belirtilen köşenin koordinat çifti
`data[].blocks[].text`	string	Blok için işlenen çevrilmiş metin
`data[].blocks[].direction`	string	Çevrilmiş metnin yazım yönü

Alan	Tür	Açıklama
`subscription_credits`	integer	Belirtilen kategorinin kredi bakiyesi
`subscription_credits_expires_at`	string \| null	Abonelik kredilerinin ISO 8601 biçimindeki sona erme zamanı veya null
`one_time_credits`	integer	Belirtilen kategorinin kredi bakiyesi
`one_time_credits_expires_at`	string \| null	Tek seferlik kredilerin ISO 8601 biçimindeki sona erme zamanı veya null
`free_credits`	integer	Belirtilen kategorinin kredi bakiyesi
`total_credits`	integer	Kullanılabilir tüm kredi bakiyelerinin toplamı
`is_temporary`	boolean	Bakiyenin geçici bir hesaba ait olup olmadığı

Alan	Tür	Açıklama
`status`	integer	Uygulama durum kodu; başarılı olduğunda 200
`cost_ms`	integer	Bu API isteğinin milisaniye cinsinden işlenme süresi
`request_id`	string	Bu API çağrısını izlemek için istek kimliği
`data`	object	Geçerli kredi bakiyelerinin kapsayıcısı
`message`	string	Başarılı API yanıtında her zaman success; çeviri görevinin tamamlandığı anlamına gelmez
`data.total_credits`	integer	Kullanılabilir tüm kredi bakiyelerinin toplamı
`data.is_temporary`	boolean	Bakiyenin geçici bir hesaba ait olup olmadığı
`data.detail`	object	Kullanılabilir kredilerin kategoriye göre dökümü
`data.detail.subscription`	object	Belirtilen kategorinin kredi bakiyesi ve sona erme zamanı
`data.detail.subscription.credits`	integer	Belirtilen kategorinin kredi bakiyesi
`data.detail.subscription.expires_at`	string \| null	Kredinin ISO 8601 biçimindeki sona erme zamanı veya null
`data.detail.one_time`	object	Belirtilen kategorinin kredi bakiyesi ve sona erme zamanı
`data.detail.one_time.credits`	integer	Belirtilen kategorinin kredi bakiyesi
`data.detail.one_time.expires_at`	string \| null	Kredinin ISO 8601 biçimindeki sona erme zamanı veya null
`data.detail.free`	object	Belirtilen kategorinin kredi bakiyesi ve sona erme zamanı
`data.detail.free.credits`	integer	Belirtilen kategorinin kredi bakiyesi
`data.detail.free.expires_at`	null	Bu toplu endpoint ücretsiz krediler için tek bir sona erme zamanı sağlamadığından her zaman null

Örnek Yanıt (JSON)

{
  "task_id": "00000000-0000-4000-8000-000000000001",
  "batch_id": "00000000-0000-4000-8000-000000000001"
}

Örnek Yanıt (JSON)

{
  "status": 200,
  "cost_ms": 125,
  "request_id": "4b7370383cacccc7",
  "data": {
    "task_id": "00000000-0000-4000-8000-000000000001",
    "batch_id": "00000000-0000-4000-8000-000000000001"
  },
  "message": "success"
}

Örnek Yanıt (JSON)

{
  "status_code": 200,
  "request_id": "4b7370383cacccc7",
  "auth_type": "account",
  "task_reference": "00000000-0000-4000-8000-000000000001",
  "data": {
    "items": [
      {
        "image_id": "00000000-0000-4000-8000-000000000001_0",
        "index": 0,
        "filename": "007.jpg",
        "status": "completed",
        "original_url": "https://storage.example.com/manga-demo/input/00000000-0000-4000-8000-000000000001/007.jpg",
        "translated_url": "https://storage.example.com/manga-demo/output/00000000-0000-4000-8000-000000000001/007.jpg",
        "is_translated": true,
        "output_file_path": "https://storage.example.com/manga-demo/output/00000000-0000-4000-8000-000000000001/007.jpg",
        "message": "ok",
        "error": null,
        "inpaint_image_url": "https://storage.example.com/manga-demo/output/00000000-0000-4000-8000-000000000001/007-erased.jpg",
        "block_json": []
      }
    ],
    "task_status": "completed"
  }
}

Örnek Yanıt (JSON)

{
  "status": 200,
  "cost_ms": 5300,
  "request_id": "4b7370383cacccc7",
  "data": [
    {
      "image_id": "00000000-0000-4000-8000-000000000001_0",
      "filename": "007.jpg",
      "status": "completed",
      "original_url": "https://storage.example.com/manga-demo/input/00000000-0000-4000-8000-000000000001/007.jpg",
      "translated_url": "https://storage.example.com/manga-demo/output/00000000-0000-4000-8000-000000000001/007.jpg",
      "erased_url": "https://storage.example.com/manga-demo/output/00000000-0000-4000-8000-000000000001/007-erased.jpg",
      "blocks": [
        {
          "angle": 0,
          "color": "#484848",
          "handwritten": false,
          "location": {
            "left_bottom": [1685, 293],
            "right_bottom": [1786, 293],
            "left_top": [1685, 264],
            "right_top": [1786, 264]
          },
          "text": "OOOUGH!",
          "direction": "horizontal"
        }
      ]
    }
  ],
  "message": "success"
}

Örnek Yanıt (JSON)

{
  "subscription_credits": 0,
  "subscription_credits_expires_at": null,
  "one_time_credits": 0,
  "one_time_credits_expires_at": null,
  "free_credits": 10,
  "total_credits": 10,
  "is_temporary": true
}

Örnek Yanıt (JSON)

{
  "status": 200,
  "cost_ms": 4,
  "request_id": "4b7370383cacccc7",
  "data": {
    "total_credits": 10,
    "is_temporary": true,
    "detail": {
      "subscription": {
        "credits": 0,
        "expires_at": null
      },
      "one_time": {
        "credits": 0,
        "expires_at": null
      },
      "free": {
        "credits": 10,
        "expires_at": null
      }
    }
  },
  "message": "success"
}

Hata Yanıtı Parametreleri

V2 başarısız olduğunda HTTP durumu korunur ve aynı beş alanlı yanıt zarfı döndürülür.

Alan	Tür	Açıklama
`status`	integer	Gerçek HTTP hata durum kodu
`cost_ms`	integer	Bu API isteğinin milisaniye cinsinden işlenme süresi
`request_id`	string	Bu API çağrısını izlemek için istek kimliği
`data`	object	Yalnızca kararlı, makine tarafından okunabilir kodu içeren hata verisi kapsayıcısı
`message`	string	Genel hata mesajı; dahili tanılama ayrıntıları açıklanmaz
`data.code`	string	Kararlı, makine tarafından okunabilir hata kodu

Hata Yanıtı Örneği (JSON)

{
  "status": 400,
  "cost_ms": 1,
  "request_id": "4b7370383cacccc7",
  "data": {
    "code": "PZ_API_ACCESS_BAD_REQUEST"
  },
  "message": "Invalid target language"
}

API kullanmaya başlayın

API anahtarı oluşturun

Yükleyin ve gönderin

Görev durumunu kontrol edin

Çevrilmiş görüntüleri indirin

Örnek girdiler

Rota

Parametreler

Yanıt Parametreleri

Örnek Yanıt (JSON)

Örnek Yanıt (JSON)

Örnek Yanıt (JSON)

Örnek Yanıt (JSON)

Örnek Yanıt (JSON)

Örnek Yanıt (JSON)

Hata Yanıtı Parametreleri

Hata Yanıtı Örneği (JSON)

Çerez Tercihleri