API Dokümantasyonu

Görseldeki metni çevirir ve özgün düzeni koruyarak görselin üzerine yeniden çizer.

Hızlı başlangıç

curl -X POST https://api.imagetranslate.ai/translate/image \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "imageBase64": "iVBORw0KGgoAAAANSUhEUgAA...",
    "sourceLanguage": "ja",
    "targetLanguage": "en",
    "mode": "general",
    "translator": "Grok"
  }'

Kimlik doğrulama

API key'i her istekte Authorization header'ında Bearer token olarak gönderin:

Authorization: Bearer YOUR_KEY

API key, sk_imagetranslate_ ön ekiyle başlayan 32 byte uzunluğunda rastgele bir dizedir. Parola gibi koruyun — sunucu tarafındaki bir secret manager'da saklayın, repoya commit etmeyin ve istemci tarafı koduna asla yerleştirmeyin.

İdempotans

Bir isteği ağ zaman aşımının ardından tekrar denerseniz, kredinin iki kez düşmemesi için aynı Idempotency-Key header'ını gönderin:

Idempotency-Key: <your-uuid>

• Belirli bir key ile yapılan ilk çağrı: normal şekilde işlenir.
• Aynı key ile yapılan sonraki çağrı (API key başına): 409 Conflict ve özgün recordId döner. Yeniden deneme kredi tüketmez.
• Farklı key'ler = farklı çağrılar.

Key'i istemci tarafında üretin (UUIDv4 yeterlidir). Onsuz, her yeniden deneme yeni bir kredi tüketir ve Torii'yi tekrar çalıştırır.

Görsel çevirme

Senkron endpoint. Çevrilmiş görseli base64 formatında (data:image/png;base64, ön ekiyle) döndürür.

Base URL

https://api.imagetranslate.ai

İstek gövdesi

Yanıt

Örnekler

curl -X POST https://api.imagetranslate.ai/translate/image \
  -H "Authorization: Bearer $IMAGETRANSLATE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "imageBase64": "YOUR_BASE64_IMAGE",
    "sourceLanguage": "ja",
    "targetLanguage": "en",
    "mode": "general",
    "translator": "Grok"
  }'

Örnek yanıt

{
  "success": true,
  "recordId": "Z3l4abc...",
  "resultImage": "data:image/png;base64,iVBORw0KGgoAAAANSU...",
  "remainingCredit": 9990
}

Hata kodları

Hata yanıt formatı

• 4xx / 500: { "detail": "<message>" }
• 422: { "detail": [{ "loc": [...], "msg": "...", "type": "..." }] }
• 409: { "error": "idempotency_replay", "recordId": "<id>", "message": "..." }

Hız limitleri

API key başına dakikalık limit, plana göre belirlenir:

Daha yüksek bir limite ihtiyacınız varsa [email protected] adresine yazın.

Fiyatlandırma

Çağrı başına 10 advanced credit. Plan ve kredi paketleri için fiyatlandırma sayfasına bakın.

Ek

Dil kodları

sourceLanguage alanı ISO 639-1 / BCP-47 kodu ya da otomatik algılama için auto değerini kabul eder. targetLanguage aynı kod kümesini destekler (auto hariç).

Sık kullanılan kodlar:

mode değerleri

mode, render stilini belirler. Görselinizin içeriğine en uygun olanı seçin.

translator modelleri

translator, çeviriyi yapacak AI modelini seçer. Tüm modeller çağrı başına 10 kredi tüketir.

• Grok (varsayılan)
• Gemini
• Deepseek
• ChatGPT
• Claude

Başlayın

Entegrasyona hazır mısınız? İlk API key'inizi oluşturun →