theGlitch API'sine hoş geldin
theGlitch, geliştiriciler ve içerik üreticileri için tek bir platformdan 19 görsel işleme aracı sunar. Hızlı düzenlemelerden (boyutlandırma, format, filigran, SVG'ye dönüştürme) yapay zekâ destekli dönüşümlere (arka plan kaldırma, büyütme, renklendirme, görselden metin, ürün sahnesi, ilan metni) kadar her şey aynı API ile.
Hangi kanaldan kullanırsan kullan, sonuç ve fiyat aynı:
Hızlı Başlangıç
Hesap oluştur, anahtar al, ilk isteği gönder — toplam 60 saniye.
- API anahtarı al
Panel → API Anahtarları → Yeni anahtar. Üretilen erişim anahtarı 32 karakterlik benzersiz bir dizedir.
- İlk isteği gönder
Bir görseli 800px genişliğe boyutlandır:
curl "https://theglitch.app/api/v1/resize?url=https://theglitch.app/showcase/resize-before.webp&width=800" \ -H "X-Api-Key: YOUR_API_KEY" \ -o result.webp
- Yanıtı al
Yanıt 200 OK + işlenmiş görsel (binary). result.webp dosyasına yazılır.
- Daha fazlasını dene
19 işleme endpoint'inin tamamı aşağıda: API Referans.
Kimlik Doğrulama
Tüm işleme istekleri X-Api-Key header'ı ile doğrulanır. Erişim anahtarlarını panelden görüntüleyip kopyalayabilirsin. Aynı anda tutabileceğin anahtar sayısı plana bağlıdır: Free ve Starter 1, Pro 5, Business 20. Birden fazla anahtar tutabildiğin planlarda yeni bir anahtar oluşturup eskisini iptal ederek kesintisiz rotasyon yaparsın; tek anahtarlı planlarda önce iptal, sonra oluştur gerekir ve aradaki sürede istekler 401 alır.
curl "https://theglitch.app/api/v1/resize?width=800" \ -H "X-Api-Key: YOUR_API_KEY" \ -F "file=@photo.jpg" -o result.webp
Girdi Yöntemleri
API'ye görsel göndermenin 4 yolu vardır. Tüm işleme endpoint'leri dördünü de kabul eder. Birden fazlasını aynı anda gönderirsen şu sıra uygulanır: form dosyası → url → image → binary gövde; form yüklemesinde yalnızca ilk dosya okunur.
- 1 · URL
url query parametresiyle herkese açık bir http(s) adresi ver. Yerel ağ, localhost ve iç ağ adresleri reddedilir; en fazla 5 yönlendirme izlenir; kaynak 2xx dışı yanıt verirse 400 INVALID_INPUT döner. İndirme 10 sn / 25 MB ile sınırlıdır ve isteklerimiz TheGlitch/1.0 User-Agent'ı ile gelir. URL girdileri 60 dakika önbelleğe alınır.
- 2 · Base64
JSON gövdede image alanı (data-URI destekli): Content-Type: application/json.
- 3 · Binary gövde
Ham byte'ları image/* Content-Type'ı ile doğrudan gövdede gönder.
- 4 · Form upload
Multipart form'da file alanıyla dosya yükle.
# 1) URL
curl "https://theglitch.app/api/v1/resize?url=https://theglitch.app/showcase/resize-before.webp&width=800" -H "X-Api-Key: KEY" -o out.webp
# 2) Base64 (JSON body)
curl -X POST "https://theglitch.app/api/v1/resize?width=800" -H "X-Api-Key: KEY" \
-H "Content-Type: application/json" -d '{"image":"data:image/jpeg;base64,/9j/4AAQ..."}' -o out.webp
# 3) Binary body
curl -X POST "https://theglitch.app/api/v1/resize?width=800" -H "X-Api-Key: KEY" \
-H "Content-Type: image/jpeg" --data-binary @photo.jpg -o out.webp
# 4) Form upload
curl -X POST "https://theglitch.app/api/v1/resize?width=800" -H "X-Api-Key: KEY" -F "file=@photo.jpg" -o out.webpTüm İşlemler
19 işleme endpoint'i (artı salt okunur /v1/info). Hepsi aynı kimlik doğrulamayı kullanır. /v1/image-info ve /v1/listing-copy JSON, /v1/ocr varsayılan olarak JSON, /v1/vectorize SVG döner; diğerleri binary görsel döner.
| Method | Endpoint | Açıklama |
|---|---|---|
| GET POST | /v1/process | Tüm işlemler tek istekte (ana endpoint) |
| GET POST | /v1/resize | Yeniden boyutlandır |
| GET POST | /v1/convert | Format dönüştür |
| GET POST | /v1/effects | Parlaklık, kontrast, doygunluk, bulanıklık |
| GET POST | /v1/watermark | Filigran ekle |
| GET POST | /v1/optimize | Web için optimize et |
| GET POST | /v1/preset/{name} | Sosyal medya hazır boyutlar |
| GET POST | /v1/image-info | Görsel meta verisi (JSON yanıt) |
| GET POST | /v1/vectorize | Logo ve ikonu SVG'ye dönüştür (SVG yanıt) |
| GET POST | /v1/remove-bg | Arka plan kaldır (AI) |
| GET POST | /v1/upscale | AI ile 2x / 4x büyüt |
| GET POST | /v1/colorize | Siyah-beyaz görseli renklendir |
| GET POST | /v1/face-restore | Yüz restorasyonu |
| GET POST | /v1/restore | Eski fotoğraf restorasyonu |
| GET POST | /v1/remove-object | Nesne sil (AI) |
| GET POST | /v1/headshot | Profesyonel portre (AI) |
| GET POST | /v1/ocr | Görselden metin — OCR (AI) |
| GET POST | /v1/listing-copy | Fotoğraftan pazaryeri ilan taslağı — JSON (AI) |
| GET POST | /v1/product-scene | Ürün sahnesi: ek ürün görseli (AI) |
| GET | /v1/info | API yetenekleri ve sürüm bilgisi |
GET POST /v1/process
Tüm işlemleri tek istekte birleştiren ana endpoint: boyutlandırma, efektler, döndürme, filigran, format dönüşümü ve preset birlikte kullanılabilir. Kombinasyon ne olursa olsun 1 istek sayılır.
Parametreler
| İsim | Tip | Zorunlu | Varsayılan · Aralık | Açıklama |
|---|---|---|---|---|
| url | string | Opsiyonel | — | İşlenecek görselin herkese açık http(s) adresi. Yanıt 60 dakika önbelleğe alınır; adresin arkasındaki görsel değişirse yeni sonuç için bir parametre değiştir (ör. &v=2). |
| image | string | Opsiyonel | — | Base64 kodlu görsel (data-URI destekli). JSON gövdede gönderilir. |
| file | file | Opsiyonel | — | Multipart form dosyası (alan adı: file). Diğer parametreler query string'de kalmalı. |
| width | int | Opsiyonel | 1 … 8000 | Hedef genişlik (px). Tek başına verilirse en-boy oranı korunur. |
| height | int | Opsiyonel | 1 … 8000 | Hedef yükseklik (px). Tek başına verilirse en-boy oranı korunur. |
| mode | string | Opsiyonel | fit (fit · fill · pad · stretch (contain=fit, cover=fill)) | Boyutlandırma davranışı: fit sığdırır, fill ortadan kırparak doldurur, pad boşluk bırakarak sığdırır, stretch oranı bozar. contain=fit, cover=fill eşanlamlıdır. |
| padColor | string | Opsiyonel | #FFFFFF (#RRGGBB) | mode=pad'de kenarlarda kalan boşluğun rengi. GET'te # işaretini %23 olarak kodla. |
| quality | int | Opsiyonel | 85 (1 … 100) | Kayıplı formatlarda (JPEG, WebP) sıkıştırma kalitesi. PNG'de etkisizdir. |
| format | string | Opsiyonel | auto (auto · jpeg · png · webp · tiff · avif · gif) | Çıkış formatı. auto: Accept header'a göre seçilir, varsayılan WebP. |
| brightness | int | Opsiyonel | 0 (-100 … 100) | Parlaklık. -100 tamamen siyah, +100 iki kat parlak. |
| contrast | int | Opsiyonel | 0 (-100 … 100) | Kontrast. Negatif soluklaştırır, pozitif derinleştirir. |
| saturation | int | Opsiyonel | 0 (-100 … 100) | Doygunluk. -100 gri tonlamayla aynı sonucu verir. |
| blur | int | Opsiyonel | 0 (0 … 100) | Gaussian bulanıklaştırma şiddeti. |
| sharpen | int | Opsiyonel | 0 (0 … 100) | Keskinleştirme şiddeti. Düşük değerlerle başla (10–30); yüksek değerler artefakt üretebilir. |
| grayscale | bool | Opsiyonel | false | Gri tonlamaya çevirir. |
| sepia | bool | Opsiyonel | false | Sıcak sepya tonu uygular. |
| rotate | int | Opsiyonel | 0 (0 · 90 · 180 · 270) | Saat yönünde döndürme. Yalnızca 90° katları. |
| flipH | bool | Opsiyonel | false | Yatay aynalama (sol-sağ). |
| flipV | bool | Opsiyonel | false | Dikey aynalama (üst-alt). |
| preset | string | Opsiyonel | 14 preset adı | Sosyal medya preset'i uygular (boyut + kırpma). İsimler için Preset bölümüne bak. |
Girdi olarak url, image (base64), file (form) veya ham binary gövde kullanılabilir — bkz. Girdi Yöntemleri.
Örnek
curl "https://theglitch.app/api/v1/process?url=https://theglitch.app/showcase/resize-before.webp&width=800&format=webp&brightness=10&sharpen=20" \ -H "X-Api-Key: YOUR_API_KEY" \ -o result.webp
- removeBackground, upscale, colorize gibi AI bayrakları da kabul edilir — ayrıntılar ilgili AI endpoint bölümlerinde. Tek istekte yalnızca BİR AI bayrağı kullanılabilir; birden fazlası 400 MULTIPLE_AI_OPERATIONS döner, AI işlemlerini ayrı isteklerle zincirle. AI bayrağı düz query parametresi ya da UTF-8 JSON gövdenin üst düzey alanı olmalıdır. AI bayrağı kullanılan istek AI kredisinden düşer.
- POST + JSON gövde desteklenir; query string'deki değerler url/image/width/height için önceliklidir.
Başarılı her çağrı aylık kotandan 1 işlem düşer (efekt + boyut + format kombinasyonu dahil tek istek = 1).
GET POST /v1/resize
Görseli hedef boyuta getirir. width/height'tan en az birini ver; mode kırpma davranışını belirler.
Parametreler
| İsim | Tip | Zorunlu | Varsayılan · Aralık | Açıklama |
|---|---|---|---|---|
| url | string | Opsiyonel | — | İşlenecek görselin herkese açık http(s) adresi. Yanıt 60 dakika önbelleğe alınır; adresin arkasındaki görsel değişirse yeni sonuç için bir parametre değiştir (ör. &v=2). |
| image | string | Opsiyonel | — | Base64 kodlu görsel (data-URI destekli). JSON gövdede gönderilir. |
| file | file | Opsiyonel | — | Multipart form dosyası (alan adı: file). Diğer parametreler query string'de kalmalı. |
| width | int | Opsiyonel | 1 … 8000 | Hedef genişlik (px). Tek başına verilirse en-boy oranı korunur. |
| height | int | Opsiyonel | 1 … 8000 | Hedef yükseklik (px). Tek başına verilirse en-boy oranı korunur. |
| mode | string | Opsiyonel | fit (fit · fill · pad · stretch (contain=fit, cover=fill)) | Boyutlandırma davranışı: fit sığdırır, fill ortadan kırparak doldurur, pad boşluk bırakarak sığdırır, stretch oranı bozar. contain=fit, cover=fill eşanlamlıdır. |
| padColor | string | Opsiyonel | #FFFFFF (#RRGGBB) | mode=pad'de kenarlarda kalan boşluğun rengi. GET'te # işaretini %23 olarak kodla. |
| quality | int | Opsiyonel | 85 (1 … 100) | Kayıplı formatlarda (JPEG, WebP) sıkıştırma kalitesi. PNG'de etkisizdir. |
| format | string | Opsiyonel | auto (auto · jpeg · png · webp · tiff · avif · gif) | Çıkış formatı. auto: Accept header'a göre seçilir, varsayılan WebP. |
Girdi olarak url, image (base64), file (form) veya ham binary gövde kullanılabilir — bkz. Girdi Yöntemleri.
Örnek
curl "https://theglitch.app/api/v1/resize?url=https://theglitch.app/showcase/resize-before.webp&width=800&height=600&mode=fill" \ -H "X-Api-Key: YOUR_API_KEY" \ -o result.webp
- Çıkış çözünürlüğü plan limitine tabidir (Free 2048px, Starter 4000px, Pro+ 8000px). Limitin üstünde açıkça width/height istersen VALIDATION_ERROR döner. Boyutlandırma istemez ve kaynak limitin üstündeyse çıktı, en-boy oranı korunarak limite küçültülür.
Başarılı her çağrı aylık kotandan 1 işlem düşer (efekt + boyut + format kombinasyonu dahil tek istek = 1).
GET POST /v1/convert
Görseli başka bir formata dönüştürür. format verilmezse auto davranışı geçerlidir (Accept header → varsayılan WebP).
Parametreler
| İsim | Tip | Zorunlu | Varsayılan · Aralık | Açıklama |
|---|---|---|---|---|
| url | string | Opsiyonel | — | İşlenecek görselin herkese açık http(s) adresi. Yanıt 60 dakika önbelleğe alınır; adresin arkasındaki görsel değişirse yeni sonuç için bir parametre değiştir (ör. &v=2). |
| image | string | Opsiyonel | — | Base64 kodlu görsel (data-URI destekli). JSON gövdede gönderilir. |
| file | file | Opsiyonel | — | Multipart form dosyası (alan adı: file). Diğer parametreler query string'de kalmalı. |
| format | string | Opsiyonel | auto (auto · jpeg · png · webp · tiff · avif · gif) | Çıkış formatı. auto: Accept header'a göre seçilir, varsayılan WebP. |
| quality | int | Opsiyonel | 85 (1 … 100) | Kayıplı formatlarda (JPEG, WebP) sıkıştırma kalitesi. PNG'de etkisizdir. |
Girdi olarak url, image (base64), file (form) veya ham binary gövde kullanılabilir — bkz. Girdi Yöntemleri.
Örnek
curl "https://theglitch.app/api/v1/convert?url=https://theglitch.app/showcase/resize-before.webp&format=webp&quality=80" \ -H "X-Api-Key: YOUR_API_KEY" \ -o result.webp
- GIF çıkışı PNG olarak servis edilir. TIFF ve AVIF ücretli planlara özeldir — bkz. Dosya Formatları.
Başarılı her çağrı aylık kotandan 1 işlem düşer (efekt + boyut + format kombinasyonu dahil tek istek = 1).
GET POST /v1/effects
Parlaklık, kontrast, doygunluk, bulanıklaştırma, keskinleştirme, gri tonlama, sepya ve döndürme/aynalama. Tüm efektler tek istekte birleştirilebilir.
Parametreler
| İsim | Tip | Zorunlu | Varsayılan · Aralık | Açıklama |
|---|---|---|---|---|
| url | string | Opsiyonel | — | İşlenecek görselin herkese açık http(s) adresi. Yanıt 60 dakika önbelleğe alınır; adresin arkasındaki görsel değişirse yeni sonuç için bir parametre değiştir (ör. &v=2). |
| image | string | Opsiyonel | — | Base64 kodlu görsel (data-URI destekli). JSON gövdede gönderilir. |
| file | file | Opsiyonel | — | Multipart form dosyası (alan adı: file). Diğer parametreler query string'de kalmalı. |
| brightness | int | Opsiyonel | 0 (-100 … 100) | Parlaklık. -100 tamamen siyah, +100 iki kat parlak. |
| contrast | int | Opsiyonel | 0 (-100 … 100) | Kontrast. Negatif soluklaştırır, pozitif derinleştirir. |
| saturation | int | Opsiyonel | 0 (-100 … 100) | Doygunluk. -100 gri tonlamayla aynı sonucu verir. |
| blur | int | Opsiyonel | 0 (0 … 100) | Gaussian bulanıklaştırma şiddeti. |
| sharpen | int | Opsiyonel | 0 (0 … 100) | Keskinleştirme şiddeti. Düşük değerlerle başla (10–30); yüksek değerler artefakt üretebilir. |
| grayscale | bool | Opsiyonel | false | Gri tonlamaya çevirir. |
| sepia | bool | Opsiyonel | false | Sıcak sepya tonu uygular. |
| rotate | int | Opsiyonel | 0 (0 · 90 · 180 · 270) | Saat yönünde döndürme. Yalnızca 90° katları. |
| flipH | bool | Opsiyonel | false | Yatay aynalama (sol-sağ). |
| flipV | bool | Opsiyonel | false | Dikey aynalama (üst-alt). |
| quality | int | Opsiyonel | 85 (1 … 100) | Kayıplı formatlarda (JPEG, WebP) sıkıştırma kalitesi. PNG'de etkisizdir. |
| format | string | Opsiyonel | auto (auto · jpeg · png · webp · tiff · avif · gif) | Çıkış formatı. auto: Accept header'a göre seçilir, varsayılan WebP. |
Girdi olarak url, image (base64), file (form) veya ham binary gövde kullanılabilir — bkz. Girdi Yöntemleri.
Örnek
curl "https://theglitch.app/api/v1/effects?url=https://theglitch.app/showcase/resize-before.webp&brightness=15&contrast=20&sharpen=25" \ -H "X-Api-Key: YOUR_API_KEY" \ -o result.webp
- Döndürme ve aynalama, efektlerden ve boyutlandırmadan önce uygulanır.
- grayscale ve sepia birlikte verilirse grayscale uygulanır.
Başarılı her çağrı aylık kotandan 1 işlem düşer (efekt + boyut + format kombinasyonu dahil tek istek = 1).
GET POST /v1/watermark
Görsele metin filigranı ekler. 5 konum, özel renk, boyut ve saydamlık.
Parametreler
| İsim | Tip | Zorunlu | Varsayılan · Aralık | Açıklama |
|---|---|---|---|---|
| url | string | Opsiyonel | — | İşlenecek görselin herkese açık http(s) adresi. Yanıt 60 dakika önbelleğe alınır; adresin arkasındaki görsel değişirse yeni sonuç için bir parametre değiştir (ör. &v=2). |
| image | string | Opsiyonel | — | Base64 kodlu görsel (data-URI destekli). JSON gövdede gönderilir. |
| file | file | Opsiyonel | — | Multipart form dosyası (alan adı: file). Diğer parametreler query string'de kalmalı. |
| watermarkText | string | Zorunlu | — | Filigran metni (Unicode destekli). GET isteklerinde özel karakterleri URL-encode et. |
| watermarkPosition | string | Opsiyonel | bottom-right (top-left · top-right · bottom-left · bottom-right · center) | Filigranın konumu. |
| watermarkOpacity | int | Opsiyonel | 50 (0 … 100) | Saydamlık: 0 görünmez, 100 opak. |
| watermarkFontSize | int | Opsiyonel | 24 (12 … 120 px) | Yazı boyutu (px). |
| watermarkColor | string | Opsiyonel | #FFFFFF (#RRGGBB) | Metin rengi. GET'te # işaretini %23 olarak gönder. |
| quality | int | Opsiyonel | 85 (1 … 100) | Kayıplı formatlarda (JPEG, WebP) sıkıştırma kalitesi. PNG'de etkisizdir. |
| format | string | Opsiyonel | auto (auto · jpeg · png · webp · tiff · avif · gif) | Çıkış formatı. auto: Accept header'a göre seçilir, varsayılan WebP. |
Girdi olarak url, image (base64), file (form) veya ham binary gövde kullanılabilir — bkz. Girdi Yöntemleri.
Örnek
curl "https://theglitch.app/api/v1/watermark?url=https://theglitch.app/showcase/resize-before.webp&watermarkText=theGlitch.app&watermarkPosition=center&watermarkOpacity=40" \ -H "X-Api-Key: YOUR_API_KEY" \ -o result.webp
- watermarkText zorunludur ve query string'de gönderilmelidir; boşsa MISSING_WATERMARK döner.
- Filigran, boyutlandırmadan önce uygulanır; /process ile diğer işlemlerle birleştirilebilir.
Başarılı her çağrı aylık kotandan 1 işlem düşer (efekt + boyut + format kombinasyonu dahil tek istek = 1).
GET POST /v1/optimize
Web için otomatik optimizasyon: format belirtilmezse çıkış WebP'dir, kalite varsayılanı 85.
Parametreler
| İsim | Tip | Zorunlu | Varsayılan · Aralık | Açıklama |
|---|---|---|---|---|
| url | string | Opsiyonel | — | İşlenecek görselin herkese açık http(s) adresi. Yanıt 60 dakika önbelleğe alınır; adresin arkasındaki görsel değişirse yeni sonuç için bir parametre değiştir (ör. &v=2). |
| image | string | Opsiyonel | — | Base64 kodlu görsel (data-URI destekli). JSON gövdede gönderilir. |
| file | file | Opsiyonel | — | Multipart form dosyası (alan adı: file). Diğer parametreler query string'de kalmalı. |
| quality | int | Opsiyonel | 85 (1 … 100) | Kayıplı formatlarda (JPEG, WebP) sıkıştırma kalitesi. PNG'de etkisizdir. |
Girdi olarak url, image (base64), file (form) veya ham binary gövde kullanılabilir — bkz. Girdi Yöntemleri.
Örnek
curl "https://theglitch.app/api/v1/optimize?url=https://theglitch.app/showcase/resize-before.webp&quality=80" \ -H "X-Api-Key: YOUR_API_KEY" \ -o result.webp
- format parametresi verilirse WebP zorlaması yerine o format kullanılır.
Başarılı her çağrı aylık kotandan 1 işlem düşer (efekt + boyut + format kombinasyonu dahil tek istek = 1).
GET POST /v1/preset/{name}
Sosyal medya boyut preset'i uygular. name path parametresidir (büyük/küçük harf duyarsız, alt çizgili yazım). Tüm preset'ler mode=fill (ortadan kırpma) kullanır.
Parametreler
| İsim | Tip | Zorunlu | Varsayılan · Aralık | Açıklama |
|---|---|---|---|---|
| url | string | Opsiyonel | — | İşlenecek görselin herkese açık http(s) adresi. Yanıt 60 dakika önbelleğe alınır; adresin arkasındaki görsel değişirse yeni sonuç için bir parametre değiştir (ör. &v=2). |
| image | string | Opsiyonel | — | Base64 kodlu görsel (data-URI destekli). JSON gövdede gönderilir. |
| file | file | Opsiyonel | — | Multipart form dosyası (alan adı: file). Diğer parametreler query string'de kalmalı. |
| quality | int | Opsiyonel | 85 (1 … 100) | Kayıplı formatlarda (JPEG, WebP) sıkıştırma kalitesi. PNG'de etkisizdir. |
| format | string | Opsiyonel | auto (auto · jpeg · png · webp · tiff · avif · gif) | Çıkış formatı. auto: Accept header'a göre seçilir, varsayılan WebP. |
Girdi olarak url, image (base64), file (form) veya ham binary gövde kullanılabilir — bkz. Girdi Yöntemleri.
Kullanılabilir preset'ler
| name | px | Açıklama |
|---|---|---|
| instagram_square | 1080 × 1080 | Akış gönderisi (1:1) |
| instagram_story | 1080 × 1920 | Story / Reels (9:16) |
| instagram_post | 1080 × 1350 | Dikey gönderi (4:5) |
| facebook_cover | 820 × 312 | Sayfa kapak fotoğrafı |
| facebook_post | 1200 × 630 | Akış gönderisi / link paylaşımı |
| twitter_header | 1500 × 500 | Profil başlığı |
| twitter_post | 1200 × 675 | Tweet görseli (16:9) |
| linkedin_banner | 1584 × 396 | Şirket banner'ı |
| linkedin_post | 1200 × 627 | Akış gönderisi |
| youtube_thumbnail | 1280 × 720 | Video küçük resmi (16:9) |
| youtube_banner | 2560 × 1440 | Kanal banner'ı |
| og_image | 1200 × 630 | Open Graph / SEO önizleme |
| whatsapp_status | 1080 × 1920 | Durum görseli (9:16) |
| tiktok_video | 1080 × 1920 | Video kapağı (9:16) |
Örnek
curl "https://theglitch.app/api/v1/preset/og_image?url=https://theglitch.app/showcase/resize-before.webp" \ -H "X-Api-Key: YOUR_API_KEY" \ -o og.webp
- Bilinmeyen isim INVALID_PRESET hatası ve geçerli preset listesini döner.
- Efekt/format parametreleriyle birleştirilebilir: /preset/og_image?url=…&brightness=10&format=jpeg
Başarılı her çağrı aylık kotandan 1 işlem düşer (efekt + boyut + format kombinasyonu dahil tek istek = 1).
GET POST /v1/image-infoJSON yanıt
Görselin meta verisini döner. Diğer tüm endpoint'lerin aksine yanıt binary değil JSON'dur (Content-Type: application/json).
Parametreler
| İsim | Tip | Zorunlu | Varsayılan · Aralık | Açıklama |
|---|---|---|---|---|
| url | string | Opsiyonel | — | İşlenecek görselin herkese açık http(s) adresi. Yanıt 60 dakika önbelleğe alınır; adresin arkasındaki görsel değişirse yeni sonuç için bir parametre değiştir (ör. &v=2). |
| image | string | Opsiyonel | — | Base64 kodlu görsel (data-URI destekli). JSON gövdede gönderilir. |
| file | file | Opsiyonel | — | Multipart form dosyası (alan adı: file). Diğer parametreler query string'de kalmalı. |
Girdi olarak url, image (base64), file (form) veya ham binary gövde kullanılabilir — bkz. Girdi Yöntemleri.
Yanıt alanları
| İsim | Tip | Açıklama |
|---|---|---|
| width | int | Genişlik (px) |
| height | int | Yükseklik (px) |
| format | string | Algılanan format: jpeg, png, webp, gif, tiff, avif |
| colorType | string | Renk modeli: rgb, rgba, grayscale veya cmyk. Bu dört değerin dışında bir şey dönmez. |
| hasAlpha | bool | Şeffaflık kanalı var mı |
| orientation | int | Ham EXIF yönelim etiketi (1-8). width ve height zaten bu yönelim uygulanmış ölçüyü bildirir; bu alan yalnızca kaynaktaki etiketin ne olduğunu söyler. |
| fileSize | int | Dosya boyutu (byte) |
| fileSizeHuman | string | Okunabilir dosya boyutu (örn. "240.0 KB") |
{
"width": 1920,
"height": 1080,
"format": "jpeg",
"colorType": "rgb",
"hasAlpha": false,
"orientation": 1,
"fileSize": 245760,
"fileSizeHuman": "240.0 KB"
}Örnek
curl "https://theglitch.app/api/v1/image-info?url=https://theglitch.app/showcase/resize-before.webp" \ -H "X-Api-Key: YOUR_API_KEY"
- Bu endpoint görseli işlemez; yalnızca decode edip bilgi çıkarır. 1 işlem sayılır.
Başarılı her çağrı aylık kotandan 1 işlem düşer (efekt + boyut + format kombinasyonu dahil tek istek = 1).
GET POST /v1/vectorizeSVG yanıt
Düz renkli bir logo ya da ikonu ölçeklenebilir SVG vektöre çevirir. Kendi sunucumuzda çalışır: AI kredisi değil, işlem kotasından 1 istek düşer. Yanıt image/svg+xml'dir.
Parametreler
| İsim | Tip | Zorunlu | Varsayılan · Aralık | Açıklama |
|---|---|---|---|---|
| url | string | Opsiyonel | — | İşlenecek görselin herkese açık http(s) adresi. Yanıt 60 dakika önbelleğe alınır; adresin arkasındaki görsel değişirse yeni sonuç için bir parametre değiştir (ör. &v=2). |
| image | string | Opsiyonel | — | Base64 kodlu görsel (data-URI destekli). JSON gövdede gönderilir. |
| file | file | Opsiyonel | — | Multipart form dosyası (alan adı: file). Diğer parametreler query string'de kalmalı. |
| colors | int | Opsiyonel | 8 (2 … 16) | Paletteki renk sayısı, 2–16 (varsayılan 8). Az renk daha sade bir çıktı verir. |
| curves | string | Opsiyonel | spline (spline · polygon) | spline (varsayılan): yumuşak eğriler · polygon: köşeli, düz kenarlar. |
Girdi olarak url, image (base64), file (form) veya ham binary gövde kullanılabilir — bkz. Girdi Yöntemleri.
Yanıt başlıkları
| Header | Örnek | Açıklama |
|---|---|---|
| Content-Type | image/svg+xml; charset=utf-8 | Gövde UTF-8 SVG metnidir. |
| Content-Security-Policy | default-src 'none'; style-src 'unsafe-inline' | SVG bir tarayıcıda doğrudan açılsa bile betik çalışmaz ve dış kaynak yüklenmez. |
| X-Content-Type-Options | nosniff | Tarayıcı içerik türünü tahmin etmez; dosya her zaman SVG olarak işlenir. |
Örnek
curl "https://theglitch.app/api/v1/vectorize?url=https://theglitch.app/logo-512.png&colors=4&curves=polygon" \ -H "X-Api-Key: YOUR_API_KEY" \ -o logo.svg
- Düz renkli logo ve ikonlarda en iyi sonucu verir; yoğun degradede sonuç sadeleştirilmiş olur. Fotoğrafı vektöre çevirmek için değildir: fotoğraf benzeri, çok ayrıntılı bir görsel 400 VALIDATION_ERROR ile reddedilir.
- Logodaki Türkçe harfler (Ç, Ğ, İ, Ö, Ş, Ü) noktası ve çengeliyle korunur; yazı, düzenlenebilir metin olarak değil şekil (path) olarak gelir.
- Girdi PNG, JPEG ya da WebP; en fazla 4 megapiksel, en uzun kenar 4096 px. Fotoğraf benzeri bir görsel vektörleştirme başlamadan reddedilir ve kotandan düşmez; vektörleştirme çalıştıktan sonra çıktı sunulamayacak kadar ayrıntılı çıkarsa da 400 VALIDATION_ERROR döner ve bu istek işlem kotandan 1 istek düşer.
- Çıktı temizlenir: DTD, betik, olay öznitelikleri ve dış bağlantılar çıkarılır, yalnızca temel şekil öğeleri kalır; id'lere istek başına önek eklenir ve kök öğede her zaman viewBox bulunur.
- Görsel kalıcı depolamaya yazılmaz: geçici dosyalar yalnızca bellekte tutulur ve işlem biter bitmez silinir.
Başarılı her çağrı aylık kotandan 1 işlem düşer (efekt + boyut + format kombinasyonu dahil tek istek = 1).
GET POST /v1/remove-bgAI · 1 kredi
Yapay zekâ ile arka planı kaldırır; sonuç şeffaf arka planlıdır.
Parametreler
| İsim | Tip | Zorunlu | Varsayılan · Aralık | Açıklama |
|---|---|---|---|---|
| url | string | Opsiyonel | — | İşlenecek görselin herkese açık http(s) adresi. Yanıt 60 dakika önbelleğe alınır; adresin arkasındaki görsel değişirse yeni sonuç için bir parametre değiştir (ör. &v=2). |
| image | string | Opsiyonel | — | Base64 kodlu görsel (data-URI destekli). JSON gövdede gönderilir. |
| file | file | Opsiyonel | — | Multipart form dosyası (alan adı: file). Diğer parametreler query string'de kalmalı. |
| format | string | Opsiyonel | auto (auto · jpeg · png · webp · tiff · avif · gif) | Çıkış formatı. auto: Accept header'a göre seçilir, varsayılan WebP. |
| quality | int | Opsiyonel | 85 (1 … 100) | Kayıplı formatlarda (JPEG, WebP) sıkıştırma kalitesi. PNG'de etkisizdir. |
Girdi olarak url, image (base64), file (form) veya ham binary gövde kullanılabilir — bkz. Girdi Yöntemleri.
Örnek
curl "https://theglitch.app/api/v1/remove-bg?url=https://theglitch.app/showcase/bg-before.webp" \ -H "X-Api-Key: YOUR_API_KEY" \ -o result.png
- format=auto iken çıktı, şeffaflık korunsun diye PNG'ye zorlanır. Açıkça format verirsen o kullanılır.
Başarılı çağrı yalnızca aylık AI kredinden düşer; işlem kotasına sayılmaz. Maliyet işleme göredir: remove-bg, upscale, colorize, remove-object, ocr (görsel başına) ve listing-copy 1 kredi; product-scene türe göre studio 2, relight 6, lifestyle 7 kredi; face-restore, restore ve headshot 9 kredi. Hangi başarısız isteklerin düştüğü Kotalar & Limitler bölümünde. (İşlem kotan tükenmişse AI çağrıları da 429 REQUEST_QUOTA_EXCEEDED alır.)
GET POST /v1/upscaleAI · 1 kredi
Yapay zekâ ile çözünürlüğü 2x veya 4x büyütür; düşük çözünürlüklü görselleri netleştirir.
Parametreler
| İsim | Tip | Zorunlu | Varsayılan · Aralık | Açıklama |
|---|---|---|---|---|
| url | string | Opsiyonel | — | İşlenecek görselin herkese açık http(s) adresi. Yanıt 60 dakika önbelleğe alınır; adresin arkasındaki görsel değişirse yeni sonuç için bir parametre değiştir (ör. &v=2). |
| image | string | Opsiyonel | — | Base64 kodlu görsel (data-URI destekli). JSON gövdede gönderilir. |
| file | file | Opsiyonel | — | Multipart form dosyası (alan adı: file). Diğer parametreler query string'de kalmalı. |
| upscaleScale | int | Opsiyonel | 4 (2 · 4) | Büyütme çarpanı: 2x veya 4x. Başka değer INVALID_SCALE hatası döner. |
| format | string | Opsiyonel | auto (auto · jpeg · png · webp · tiff · avif · gif) | Çıkış formatı. auto: Accept header'a göre seçilir, varsayılan WebP. |
| quality | int | Opsiyonel | 85 (1 … 100) | Kayıplı formatlarda (JPEG, WebP) sıkıştırma kalitesi. PNG'de etkisizdir. |
Girdi olarak url, image (base64), file (form) veya ham binary gövde kullanılabilir — bkz. Girdi Yöntemleri.
Örnek
curl "https://theglitch.app/api/v1/upscale?url=https://theglitch.app/showcase/up-before.webp&upscaleScale=4" \ -H "X-Api-Key: YOUR_API_KEY" \ -o result.webp
- Efekt, filigran veya format parametreleriyle birleştirilebilir: /upscale?url=…&upscaleScale=2&sharpen=20&format=webp
- İki ayrı sınır birden geçerlidir: (1) kaynak görsel 2,1 megapikseli (1448×1448) aşamaz — bu sınır ölçek çarpanından bağımsızdır; (2) büyütülmüş boyut (kaynak × çarpan) plan çözünürlük limitini aşamaz — Free planda (2048px) bu, 4x için en fazla 512px, 2x için en fazla 1024px kaynak demektir. İkisinden biri aşılırsa AI hiç çalışmadan VALIDATION_ERROR döner ve AI kredinden düşmez.
Başarılı çağrı yalnızca aylık AI kredinden düşer; işlem kotasına sayılmaz. Maliyet işleme göredir: remove-bg, upscale, colorize, remove-object, ocr (görsel başına) ve listing-copy 1 kredi; product-scene türe göre studio 2, relight 6, lifestyle 7 kredi; face-restore, restore ve headshot 9 kredi. Hangi başarısız isteklerin düştüğü Kotalar & Limitler bölümünde. (İşlem kotan tükenmişse AI çağrıları da 429 REQUEST_QUOTA_EXCEEDED alır.)
GET POST /v1/colorizeAI · 1 kredi
Siyah-beyaz veya soluk fotoğrafları yapay zekâ ile doğal renklere kavuşturur.
Parametreler
| İsim | Tip | Zorunlu | Varsayılan · Aralık | Açıklama |
|---|---|---|---|---|
| url | string | Opsiyonel | — | İşlenecek görselin herkese açık http(s) adresi. Yanıt 60 dakika önbelleğe alınır; adresin arkasındaki görsel değişirse yeni sonuç için bir parametre değiştir (ör. &v=2). |
| image | string | Opsiyonel | — | Base64 kodlu görsel (data-URI destekli). JSON gövdede gönderilir. |
| file | file | Opsiyonel | — | Multipart form dosyası (alan adı: file). Diğer parametreler query string'de kalmalı. |
| format | string | Opsiyonel | auto (auto · jpeg · png · webp · tiff · avif · gif) | Çıkış formatı. auto: Accept header'a göre seçilir, varsayılan WebP. |
| quality | int | Opsiyonel | 85 (1 … 100) | Kayıplı formatlarda (JPEG, WebP) sıkıştırma kalitesi. PNG'de etkisizdir. |
Girdi olarak url, image (base64), file (form) veya ham binary gövde kullanılabilir — bkz. Girdi Yöntemleri.
Örnek
curl "https://theglitch.app/api/v1/colorize?url=https://theglitch.app/showcase/color-before.webp" \ -H "X-Api-Key: YOUR_API_KEY" \ -o result.webp
Başarılı çağrı yalnızca aylık AI kredinden düşer; işlem kotasına sayılmaz. Maliyet işleme göredir: remove-bg, upscale, colorize, remove-object, ocr (görsel başına) ve listing-copy 1 kredi; product-scene türe göre studio 2, relight 6, lifestyle 7 kredi; face-restore, restore ve headshot 9 kredi. Hangi başarısız isteklerin düştüğü Kotalar & Limitler bölümünde. (İşlem kotan tükenmişse AI çağrıları da 429 REQUEST_QUOTA_EXCEEDED alır.)
GET POST /v1/face-restoreAI · 9 kredi
Bulanık, düşük çözünürlüklü veya bozulmuş yüzleri yapay zekâ ile restore eder.
Parametreler
| İsim | Tip | Zorunlu | Varsayılan · Aralık | Açıklama |
|---|---|---|---|---|
| url | string | Opsiyonel | — | İşlenecek görselin herkese açık http(s) adresi. Yanıt 60 dakika önbelleğe alınır; adresin arkasındaki görsel değişirse yeni sonuç için bir parametre değiştir (ör. &v=2). |
| image | string | Opsiyonel | — | Base64 kodlu görsel (data-URI destekli). JSON gövdede gönderilir. |
| file | file | Opsiyonel | — | Multipart form dosyası (alan adı: file). Diğer parametreler query string'de kalmalı. |
| format | string | Opsiyonel | auto (auto · jpeg · png · webp · tiff · avif · gif) | Çıkış formatı. auto: Accept header'a göre seçilir, varsayılan WebP. |
| quality | int | Opsiyonel | 85 (1 … 100) | Kayıplı formatlarda (JPEG, WebP) sıkıştırma kalitesi. PNG'de etkisizdir. |
Girdi olarak url, image (base64), file (form) veya ham binary gövde kullanılabilir — bkz. Girdi Yöntemleri.
Örnek
curl "https://theglitch.app/api/v1/face-restore?url=https://theglitch.app/showcase/face-before.webp" \ -H "X-Api-Key: YOUR_API_KEY" \ -o result.webp
- Çıktı, girdinin ölçüsünden bağımsız olarak yaklaşık 1 megapiksele normalize edilir; en-boy oranı ve yönelim yaklaşık korunur. Daha büyük bir kaynak göndermek daha büyük bir sonuç vermez — orijinali sakla. Çok geniş veya çok dar görsellerde (örneğin panorama) oran belirgin biçimde değişebilir.
Başarılı çağrı yalnızca aylık AI kredinden düşer; işlem kotasına sayılmaz. Maliyet işleme göredir: remove-bg, upscale, colorize, remove-object, ocr (görsel başına) ve listing-copy 1 kredi; product-scene türe göre studio 2, relight 6, lifestyle 7 kredi; face-restore, restore ve headshot 9 kredi. Hangi başarısız isteklerin düştüğü Kotalar & Limitler bölümünde. (İşlem kotan tükenmişse AI çağrıları da 429 REQUEST_QUOTA_EXCEEDED alır.)
GET POST /v1/restoreAI · 9 kredi
Eski, hasarlı veya solmuş fotoğrafları yapay zekâ ile onarır; yaşa bağlı bozulmaları otomatik giderir.
Parametreler
| İsim | Tip | Zorunlu | Varsayılan · Aralık | Açıklama |
|---|---|---|---|---|
| url | string | Opsiyonel | — | İşlenecek görselin herkese açık http(s) adresi. Yanıt 60 dakika önbelleğe alınır; adresin arkasındaki görsel değişirse yeni sonuç için bir parametre değiştir (ör. &v=2). |
| image | string | Opsiyonel | — | Base64 kodlu görsel (data-URI destekli). JSON gövdede gönderilir. |
| file | file | Opsiyonel | — | Multipart form dosyası (alan adı: file). Diğer parametreler query string'de kalmalı. |
| format | string | Opsiyonel | auto (auto · jpeg · png · webp · tiff · avif · gif) | Çıkış formatı. auto: Accept header'a göre seçilir, varsayılan WebP. |
| quality | int | Opsiyonel | 85 (1 … 100) | Kayıplı formatlarda (JPEG, WebP) sıkıştırma kalitesi. PNG'de etkisizdir. |
Girdi olarak url, image (base64), file (form) veya ham binary gövde kullanılabilir — bkz. Girdi Yöntemleri.
Örnek
curl "https://theglitch.app/api/v1/restore?url=https://theglitch.app/showcase/feat-photo-before.webp" \ -H "X-Api-Key: YOUR_API_KEY" \ -o result.webp
- Çizik, yırtık ve leke onarımı otomatiktir; bunun için ayrı bir parametre gerekmez.
- Çıktı, girdinin ölçüsünden bağımsız olarak yaklaşık 1 megapiksele normalize edilir; en-boy oranı ve yönelim yaklaşık korunur. Daha büyük bir kaynak göndermek daha büyük bir sonuç vermez — orijinali sakla. Çok geniş veya çok dar görsellerde (örneğin panorama) oran belirgin biçimde değişebilir.
Başarılı çağrı yalnızca aylık AI kredinden düşer; işlem kotasına sayılmaz. Maliyet işleme göredir: remove-bg, upscale, colorize, remove-object, ocr (görsel başına) ve listing-copy 1 kredi; product-scene türe göre studio 2, relight 6, lifestyle 7 kredi; face-restore, restore ve headshot 9 kredi. Hangi başarısız isteklerin düştüğü Kotalar & Limitler bölümünde. (İşlem kotan tükenmişse AI çağrıları da 429 REQUEST_QUOTA_EXCEEDED alır.)
GET POST /v1/remove-objectAI · 1 kredi
Maske ile işaretlenen nesneleri yapay zekâ ile kaldırır ve arka planı doğal şekilde doldurur.
Parametreler
| İsim | Tip | Zorunlu | Varsayılan · Aralık | Açıklama |
|---|---|---|---|---|
| url | string | Opsiyonel | — | İşlenecek görselin herkese açık http(s) adresi. Yanıt 60 dakika önbelleğe alınır; adresin arkasındaki görsel değişirse yeni sonuç için bir parametre değiştir (ör. &v=2). |
| image | string | Opsiyonel | — | Base64 kodlu görsel (data-URI destekli). JSON gövdede gönderilir. |
| file | file | Opsiyonel | — | Multipart form dosyası (alan adı: file). Diğer parametreler query string'de kalmalı. |
| mask | string | Zorunlu | — | Maske görseli: query string'de URL ya da JSON gövdede base64. Kaynakla aynı boyutta olmalı; beyaz alanlar silinecek nesneyi gösterir, siyah alanlar korunur. |
| format | string | Opsiyonel | auto (auto · jpeg · png · webp · tiff · avif · gif) | Çıkış formatı. auto: Accept header'a göre seçilir, varsayılan WebP. |
| quality | int | Opsiyonel | 85 (1 … 100) | Kayıplı formatlarda (JPEG, WebP) sıkıştırma kalitesi. PNG'de etkisizdir. |
Girdi olarak url, image (base64), file (form) veya ham binary gövde kullanılabilir — bkz. Girdi Yöntemleri.
Örnek
curl "https://theglitch.app/api/v1/remove-object?url=https://theglitch.app/showcase/obj-before.webp&mask=YOUR_MASK_URL" \ -H "X-Api-Key: YOUR_API_KEY" \ -o result.webp
- mask zorunludur. URL'yi query string'de, base64 veriyi JSON gövdedeki mask alanında (POST) gönder; eksikse MISSING_MASK döner.
- Maskeyi hazırlamak için herhangi bir görsel editörde silinecek alanları beyaza boya, kaynakla aynı boyutta PNG olarak kaydet.
Başarılı çağrı yalnızca aylık AI kredinden düşer; işlem kotasına sayılmaz. Maliyet işleme göredir: remove-bg, upscale, colorize, remove-object, ocr (görsel başına) ve listing-copy 1 kredi; product-scene türe göre studio 2, relight 6, lifestyle 7 kredi; face-restore, restore ve headshot 9 kredi. Hangi başarısız isteklerin düştüğü Kotalar & Limitler bölümünde. (İşlem kotan tükenmişse AI çağrıları da 429 REQUEST_QUOTA_EXCEEDED alır.)
GET POST /v1/headshotAI · 9 kredi
Bir portre fotoğrafından yapay zekâ ile stüdyo görünümlü profesyonel portre üretir — CV, LinkedIn ve kurumsal ekip sayfaları için. Sonuç görseldir; format ve quality diğer AI uçlarındaki gibi uygulanır.
Parametreler
| İsim | Tip | Zorunlu | Varsayılan · Aralık | Açıklama |
|---|---|---|---|---|
| url | string | Opsiyonel | — | İşlenecek görselin herkese açık http(s) adresi. Yanıt 60 dakika önbelleğe alınır; adresin arkasındaki görsel değişirse yeni sonuç için bir parametre değiştir (ör. &v=2). |
| image | string | Opsiyonel | — | Base64 kodlu görsel (data-URI destekli). JSON gövdede gönderilir. |
| file | file | Opsiyonel | — | Multipart form dosyası (alan adı: file). Diğer parametreler query string'de kalmalı. |
| background | string | Opsiyonel | neutral (neutral · white · gray · black · office) | Portrenin arka planı: neutral (nötr, varsayılan), white (beyaz), gray (gri), black (siyah) ya da office (ofis). |
| aspectRatio | string | Opsiyonel | 3:4 (3:4 · 1:1 · 4:5 · 2:3) | Çıktının en-boy oranı: 3:4 (varsayılan), 1:1, 4:5 ya da 2:3. |
| format | string | Opsiyonel | auto (auto · jpeg · png · webp · tiff · avif · gif) | Çıkış formatı. auto: Accept header'a göre seçilir, varsayılan WebP. |
| quality | int | Opsiyonel | 85 (1 … 100) | Kayıplı formatlarda (JPEG, WebP) sıkıştırma kalitesi. PNG'de etkisizdir. |
Girdi olarak url, image (base64), file (form) veya ham binary gövde kullanılabilir — bkz. Girdi Yöntemleri.
Örnek
curl "https://theglitch.app/api/v1/headshot?url=https://theglitch.app/showcase/det-face-s3-before.webp&background=office&aspectRatio=3:4" \ -H "X-Api-Key: YOUR_API_KEY" \ -o headshot.webp
- Biyometrik vesikalık DEĞİLDİR: pasaport, kimlik kartı, ehliyet, ÖSYM ya da e-Devlet başvurularında kullanılamaz.
- Yalnızca kendi fotoğrafını ya da izni olan kişinin fotoğrafını gönder (kullanım şartları).
- Cinsiyet gibi bir bilgi istenmez; portre yüklenen fotoğraftan üretilir.
Başarılı çağrı yalnızca aylık AI kredinden düşer; işlem kotasına sayılmaz. Maliyet işleme göredir: remove-bg, upscale, colorize, remove-object, ocr (görsel başına) ve listing-copy 1 kredi; product-scene türe göre studio 2, relight 6, lifestyle 7 kredi; face-restore, restore ve headshot 9 kredi. Hangi başarısız isteklerin düştüğü Kotalar & Limitler bölümünde. (İşlem kotan tükenmişse AI çağrıları da 429 REQUEST_QUOTA_EXCEEDED alır.)
GET POST /v1/ocrAI · 1 krediJSON yanıt
Görseldeki metni yapay zekâ ile okur: fiş, fatura, menü, kartvizit, eski belge. Varsayılan yanıt JSON'dur (text, markdown, blocks, warnings); output ile düz metin, Markdown, HTML, CSV, Word (DOCX) ya da PDF alınır.
Parametreler
| İsim | Tip | Zorunlu | Varsayılan · Aralık | Açıklama |
|---|---|---|---|---|
| url | string | Opsiyonel | — | İşlenecek görselin herkese açık http(s) adresi. Yanıt 60 dakika önbelleğe alınır; adresin arkasındaki görsel değişirse yeni sonuç için bir parametre değiştir (ör. &v=2). |
| image | string | Opsiyonel | — | Base64 kodlu görsel (data-URI destekli). JSON gövdede gönderilir. |
| file | file | Opsiyonel | — | Multipart form dosyası (alan adı: file). Diğer parametreler query string'de kalmalı. |
| output | string | Opsiyonel | json (json · txt · md · html · csv · docx · pdf) | Çıktı biçimi. json (varsayılan) yapılandırılmış sonuç; txt, md, html ve csv metin; docx ve pdf indirilecek belge döner. Content-Type'lar aşağıdaki tabloda. |
| csvDelimiter | string | Opsiyonel | ; (; · , · tab) | Yalnızca output=csv için ayırıcı: ; (varsayılan, Türkçe Excel), , ya da tab (sekme). |
Girdi olarak url, image (base64), file (form) veya ham binary gövde kullanılabilir — bkz. Girdi Yöntemleri.
Çıktı biçimleri
| output | Content-Type | Açıklama |
|---|---|---|
| json | application/json; charset=utf-8 | Varsayılan. Yapılandırılmış sonuç; alanlar aşağıda. |
| txt | text/plain; charset=utf-8 | Düz metin; tablo hücreleri sekmeyle ayrılır. |
| md | text/markdown; charset=utf-8 | Markdown (GFM); tablolar Markdown tablosu olarak. |
| html | text/html; charset=utf-8 | HTML belgesi (lang="tr"). Görseldeki metin işaretleme olarak işlenmez; ham HTML üretilmez. |
| csv | text/csv; charset=utf-8 | Görselde kendi başlık satırı basılı tablolar; yoksa her metin satırı tek sütunda (text). Fiş ve fiyat listeleri tablo değil, düz satır olarak gelir. BOM'lu UTF-8, ayırıcı csvDelimiter ile. |
| docx | application/vnd.openxmlformats-officedocument.wordprocessingml.document | Word belgesi; attachment, filename="ocr.docx". |
| application/pdf | Yeniden dizilmiş metin PDF'i, Türkçe karakterler gömülü; attachment, filename="ocr.pdf". |
JSON alanları (output=json)
| İsim | Tip | Açıklama |
|---|---|---|
| text | string | Okunan metnin tamamı, düz metin olarak. |
| markdown | string | Aynı içerik Markdown (GFM) olarak. |
| blocks | array | Belgenin yapısı, sırayla: her blokta type (heading, paragraph, list, table) ve türüne göre level, text, items ya da rows bulunur. |
| warnings | string[] | Sabit uyarı anahtarları (ör. truncated, low_confidence, fallback_used); boşsa uyarı yoktur. |
Örnek: kendi başlık satırı (Ürün, Tutar) basılı bir tablo içeren görsel. Tablo yalnızca görselde başlık satırı basılıysa tablo olarak döner; fiş kalemleri ve fiyat listeleri düz satır olarak gelir.
{
"text": "KAHVE EVİ\n\nFiş No: 0042\n\nÜrün\tTutar\nTürk kahvesi\t60,00\nSu\t15,00\n",
"markdown": "# KAHVE EVİ\n\nFiş No: 0042\n\n| Ürün | Tutar |\n|---|---|\n| Türk kahvesi | 60,00 |\n| Su | 15,00 |\n",
"blocks": [
{ "type": "heading", "level": 1, "text": "KAHVE EVİ" },
{ "type": "paragraph", "text": "Fiş No: 0042" },
{ "type": "table", "rows": [["Ürün", "Tutar"], ["Türk kahvesi", "60,00"], ["Su", "15,00"]] }
],
"warnings": []
}Örnek
curl "https://theglitch.app/api/v1/ocr?url=https://theglitch.app/showcase/det-ocr-hero-before.webp&output=json" \ -H "X-Api-Key: YOUR_API_KEY"
- Çıktı bir taslaktır: kullanmadan önce orijinal görselle doğrula, özellikle sayıları, adları ve tabloları.
- Girdi tek bir görseldir; PDF girdisi kabul edilmez. Çok sayfalı bir belgeyi sayfa sayfa görsel olarak gönder — her görsel ayrı bir istektir ve ayrı kredi düşer.
- csv: yalnızca görselde kendi başlık satırı basılı tablolar tablo olarak satır satır yazılır. Fiş ve fiyat listeleri tablo sayılmaz, düz satır olarak kalır; tablo yoksa hata dönmez, her metin satırı tek sütunlu (text) bir satır olur. Dosya BOM'lu UTF-8'dir; Türkçe Excel için varsayılan ayırıcı noktalı virgüldür (csvDelimiter).
- docx ve pdf indirilecek dosya döner (Content-Disposition: attachment; filename="ocr.docx" / "ocr.pdf"). PDF, okunan metnin yeniden dizilmiş hâlidir; Türkçe karakterler gömülü yazı tipiyle görünür, orijinal görsel PDF'e girmez.
- warnings sabit anahtarlar taşır: truncated (çıktı kesik ya da tekrara düşmüş görünüyor; metin eksik veya yinelenmiş olabilir), fallback_used (ilk okuma kullanılamaz göründü, görsel yeniden okundu), low_confidence (metin bulunamadı ya da güvenilir okunamadı). Boş dizi uyarı olmadığını gösterir. Aynı anahtarlar her çıktı biçiminde X-Glitch-Warnings yanıt başlığında virgülle ayrılmış olarak da gelir; uyarı yoksa başlık gönderilmez.
Başarılı çağrı yalnızca aylık AI kredinden düşer; işlem kotasına sayılmaz. Maliyet işleme göredir: remove-bg, upscale, colorize, remove-object, ocr (görsel başına) ve listing-copy 1 kredi; product-scene türe göre studio 2, relight 6, lifestyle 7 kredi; face-restore, restore ve headshot 9 kredi. Hangi başarısız isteklerin düştüğü Kotalar & Limitler bölümünde. (İşlem kotan tükenmişse AI çağrıları da 429 REQUEST_QUOTA_EXCEEDED alır.)
GET POST /v1/listing-copyAI · 1 krediJSON yanıt
Bir ürün fotoğrafından Türkçe pazaryeri ilan taslağı yazar (Trendyol, Hepsiburada, n11 kalıbı). Yanıt JSON'dur: title, description, features, color, material, keywords, altText ve warnings.
Parametreler
| İsim | Tip | Zorunlu | Varsayılan · Aralık | Açıklama |
|---|---|---|---|---|
| url | string | Opsiyonel | — | İşlenecek görselin herkese açık http(s) adresi. Yanıt 60 dakika önbelleğe alınır; adresin arkasındaki görsel değişirse yeni sonuç için bir parametre değiştir (ör. &v=2). |
| image | string | Opsiyonel | — | Base64 kodlu görsel (data-URI destekli). JSON gövdede gönderilir. |
| file | file | Opsiyonel | — | Multipart form dosyası (alan adı: file). Diğer parametreler query string'de kalmalı. |
| brand | string | Opsiyonel | ≤ 60 | Marka adı, en fazla 60 karakter. Verilirse başlıkta kullanılır; verilmezse marka yalnızca ürünün üzerinde okunuyorsa yazılır. Modele talimat olarak değil veri olarak gider. |
| category | string | Opsiyonel | ≤ 60 | Kategori ipucu (ör. sneaker), en fazla 60 karakter. Modele veri olarak gider. |
Girdi olarak url, image (base64), file (form) veya ham binary gövde kullanılabilir — bkz. Girdi Yöntemleri.
JSON alanları
| İsim | Tip | Açıklama |
|---|---|---|
| title | string | Başlık: marka + ürün türü + öne çıkan özellik kalıbında, en fazla 100 karakter. Marka yalnızca verilmişse ya da ürünün üzerinde okunuyorsa yer alır. |
| description | string | Ürün açıklaması; paragraflar boş satırla ayrılır. |
| features | string[] | Görselde görülebilen özellik maddeleri. |
| color | string | null | Baskın renk; görselde belirlenemiyorsa null. |
| material | string | null | Malzeme; görselden belirlenemiyorsa null (tahmin yazılmaz). |
| keywords | string[] | Arama için küçük harfli Türkçe anahtar kelimeler. |
| altText | string | Görme engelli kullanıcılar için nesnel görsel açıklaması, en fazla 125 karakter. |
| warnings | string[] | Uyarı anahtarları: fallback_used (ilk taslak şemaya uymadı, yedek modelle yeniden yazıldı), truncated (başlık ya da alt metin sınırı aştığı için kısaltıldı), wording_review (metinde yayımlamadan önce gözden geçirilmesi gereken bir abartı, sağlık ya da doğrulanamaz performans ifadesi var; metin değiştirilmez, yalnızca işaretlenir). Boş dizi uyarı olmadığını gösterir. |
Örnek: yukarıdaki istekteki beyaz ayakkabı fotoğrafı için category=sneaker ile alınmış gerçek bir yanıt. Metin her çağrıda değişebilir ve bir taslaktır.
{
"title": "Beyaz Kanvas Dokulu Bağcıklı Sneaker Ayakkabı",
"description": "Bu beyaz sneaker, sade ve yalın tasarımıyla günlük stilinizin temel parçalarından biri olmaya adaydır. Kanvas dokulu dış yüzeyi ve aynı tondaki dikiş detaylarıyla temiz bir görünüm sunan bu ayakkabı, her türlü kıyafetle kolayca uyum sağlar. Bağcıklı kapanış sistemi, ayak yapınıza göre ayarlanabilen bir yapı sunarken, ayakkabının genelindeki beyaz renk bütünlüğü modern bir estetik yaratır. Metal halkalı bağcık delikleri ve tonal bağcıklarıyla bütünüyle beyaz bir görünüm sergiler.\n\nGündelik kombinlerinizde kot pantolonlar, şortlar veya keten pantolonlarla bir araya getirerek zahmetsiz bir şıklık yakalayabilirsiniz. Sade tasarımı sayesinde hem spor hem de yarı resmi kıyafetlerle birlikte kullanılabilir. Ürünün burun kısmındaki dokulu kauçuk detay, tasarıma hareket katarken yan panellerdeki dikişler belirgin bir görünüm sergiler. Gardırobunuzdaki farklı renk ve desenlerle rahatça eşleştirebileceğiniz bu çok yönlü model, stilinize ferah bir dokunuş ekler.\n\nŞehir hayatının hareketli temposuna uyum sağlayan bu model, düşük bilekli yapısı ve klasik silüetiyle dikkat çeker. Taban kenarlarındaki ince çizgisel detaylar ve burun bölümündeki pütürlü doku, tasarımın yalınlığını destekleyen estetik unsurlardır. Farklı mekanlarda kullanıma uygun olan bu tasarım, nötr rengi sayesinde mevsim geçişlerinde de kurtarıcı bir parça rolü üstlenir. Minimalist detayları ve beyazın zamansız etkisini birleştiren bu ürünü, çeşitli aksesuarlarınızla kolayca tamamlayarak kendi tarzınızı yansıtabilirsiniz.",
"features": ["Bağcıklı kapanış sistemi", "Kanvas dokulu dış yüzey", "Düşük bilekli tasarım", "Beyaz metal kuşgözü detayları", "Tonal dikiş özellikleri", "Dokulu burun koruması"],
"color": "beyaz",
"material": null,
"keywords": ["beyaz sneaker", "kanvas ayakkabı", "bağcıklı sneaker", "günlük ayakkabı", "düz taban sneaker", "beyaz ayakkabı", "spor ayakkabı", "bez ayakkabı"],
"altText": "Yan profilden görünen, beyaz renkli, kanvas dokulu ve beyaz bağcıklı düşük bilekli sneaker ayakkabı.",
"warnings": []
}Örnek
curl "https://theglitch.app/api/v1/listing-copy?url=https://theglitch.app/showcase/feat-bgrm-shoe-before.webp&category=sneaker" \ -H "X-Api-Key: YOUR_API_KEY"
- Çıktı bir taslaktır: marka, ölçü, malzeme gibi bilgileri yayımlamadan önce kontrol et. Sağlık iddiaları ve "en iyi", "kusursuz" gibi üstünlük iddiaları istemle yasaklanır; bu bir yasal uygunluk garantisi değildir.
- brand ve category isteğe bağlıdır (en fazla 60 karakter) ve modele talimat olarak değil veri olarak gider; kontrol karakterleri temizlenir.
- color ve material görselde görünmüyorsa null döner (uydurma yok). Başlık en fazla 100, alt metin en fazla 125 karakterdir.
- Şimdilik yalnızca Türkçe yazar.
- Model şemaya uyan bir sonuç üretemezse yedek bir modelle bir kez yeniden denenir; yine olmazsa 503 GPU_ERROR döner (Retry-After: 30) ve kredi düşmez.
Başarılı çağrı yalnızca aylık AI kredinden düşer; işlem kotasına sayılmaz. Maliyet işleme göredir: remove-bg, upscale, colorize, remove-object, ocr (görsel başına) ve listing-copy 1 kredi; product-scene türe göre studio 2, relight 6, lifestyle 7 kredi; face-restore, restore ve headshot 9 kredi. Hangi başarısız isteklerin düştüğü Kotalar & Limitler bölümünde. (İşlem kotan tükenmişse AI çağrıları da 429 REQUEST_QUOTA_EXCEEDED alır.)
GET POST /v1/product-sceneAI · 2–7 kredi
Ürün fotoğrafından pazaryeri ilanı için ek görsel üretir: beyaz fon ve yumuşak gölge (studio), seçilen yaşam alanı sahnesi (lifestyle) ya da fon korunarak stüdyo ışığı (relight). Sonuç görseldir.
Parametreler
| İsim | Tip | Zorunlu | Varsayılan · Aralık | Açıklama |
|---|---|---|---|---|
| url | string | Opsiyonel | — | İşlenecek görselin herkese açık http(s) adresi. Yanıt 60 dakika önbelleğe alınır; adresin arkasındaki görsel değişirse yeni sonuç için bir parametre değiştir (ör. &v=2). |
| image | string | Opsiyonel | — | Base64 kodlu görsel (data-URI destekli). JSON gövdede gönderilir. |
| file | file | Opsiyonel | — | Multipart form dosyası (alan adı: file). Diğer parametreler query string'de kalmalı. |
| sceneType | string | Opsiyonel | studio (studio · lifestyle · relight) | studio (varsayılan): beyaz fon ve yumuşak gölge · lifestyle: seçilen yaşam alanı sahnesi · relight: fon korunarak stüdyo ışığı. Düşen kredi türe göre değişir. |
| scenePreset | string | Opsiyonel | oak_living (oak_living · marble_bath · kitchen_counter · concrete_minimal) | Yalnızca sceneType=lifestyle: oak_living (varsayılan; açık meşe masa, İskandinav salon), marble_bath (mermer banyo tezgâhı), kitchen_counter (mutfak tezgâhı) ya da concrete_minimal (sade beton). |
| aspectRatio | string | Opsiyonel | 2:3 (2:3 · 1:1 · 3:4 · 4:5) | Çıktının en-boy oranı: 2:3 (varsayılan, pazaryeri), 1:1, 3:4 ya da 4:5. |
| format | string | Opsiyonel | auto (auto · jpeg · png · webp · tiff · avif · gif) | Çıkış formatı. auto: Accept header'a göre seçilir, varsayılan WebP. |
| quality | int | Opsiyonel | 85 (1 … 100) | Kayıplı formatlarda (JPEG, WebP) sıkıştırma kalitesi. PNG'de etkisizdir. |
Girdi olarak url, image (base64), file (form) veya ham binary gövde kullanılabilir — bkz. Girdi Yöntemleri.
Yanıt
| Header | Örnek | Açıklama |
|---|---|---|
| Content-Type | image/webp | Sonuç görseldir; format ve quality diğer AI uçlarındaki gibi uygulanır (varsayılan WebP). |
| X-Glitch-Notice | product-redrawn | Yalnız ürün sahnesi (product-scene) ucunda: product-redrawn, ürünün AI ile yeniden çizildiğini (orijinal piksellerin geri yapıştırılmadığını) bildirir; bu görsel ana görsel olarak kullanılmamalı. relight türünde ürün her zaman yeniden çizilir. |
Örnek
curl "https://theglitch.app/api/v1/product-scene?url=https://theglitch.app/showcase/feat-bgrm-shoe-before.webp&sceneType=studio&aspectRatio=2:3" \ -H "X-Api-Key: YOUR_API_KEY" \ -o scene.webp
- Kredi türe göre düşer: studio 2, lifestyle 7, relight 6 AI kredisi. sceneType verilmezse studio sayılır.
- Ek görsel içindir: pazaryerinin ana görseli beyaz fonlu orijinal fotoğraf kalmalı.
- studio ve lifestyle türlerinde ürünün orijinal pikselleri, yerleştirme denetimi tutarsa sonuca geri yapıştırılır. Denetim tutmazsa lifestyle yedek bir modelle yeniden dener; studio ise ham çıktıyı X-Glitch-Notice: product-redrawn başlığıyla döner. Yedekte de denetim tutmazsa lifestyle sonucu da aynı başlıkla gelir.
- relight türünde geri yapıştırma yapılmaz: ürün AI ile yeniden çizilir; yazı, logo ve doku değişebilir. Bu türün çıktısı ana görsel olarak kullanılmamalı.
- Serbest metin istemi (prompt) kabul edilmez; sahne yalnızca sceneType ve scenePreset ile seçilir. Tercihen tek ürünlü bir fotoğraf gönder: fotoğrafta arka plandan ayrılabilen bir ürün bulunamazsa 422 GPU_INPUT_REJECTED döner ve kredi düşmez.
- Geçersiz bir sceneType, scenePreset ya da aspectRatio değeri AI çağrılmadan 400 VALIDATION_ERROR ile reddedilir; kredi düşmez. scenePreset yalnızca lifestyle türünde kullanılır, diğer türlerde yok sayılır.
Başarılı çağrı yalnızca aylık AI kredinden düşer; işlem kotasına sayılmaz. Maliyet işleme göredir: remove-bg, upscale, colorize, remove-object, ocr (görsel başına) ve listing-copy 1 kredi; product-scene türe göre studio 2, relight 6, lifestyle 7 kredi; face-restore, restore ve headshot 9 kredi. Hangi başarısız isteklerin düştüğü Kotalar & Limitler bölümünde. (İşlem kotan tükenmişse AI çağrıları da 429 REQUEST_QUOTA_EXCEEDED alır.)
Kotalar & Limitler
Aylık istek kotaları plana bağlıdır. AI istekleri ayrı bir AI kredisinden düşer; her AI işleminin sabit bir kredi maliyeti vardır. Dakika bazlı bir hız sınırı yoktur. Kota dönemi ücretli planlarda fatura dönemidir, ücretsiz planda UTC takvim ayıdır (her ayın 1'inde sıfırlanır).
| Plan | İşlem / ay | AI kredisi / ay | Maks. çözünürlük |
|---|---|---|---|
| Free | 500 | 10 | 2048 × 2048 |
| Starter | 15.000 | 200 | 4000 × 4000 |
| Pro | 75.000 | 2.000 | 8000 × 8000 |
| Business | 300.000 | 10.000 | 8000 × 8000 |
| Scale | 1.000.000 | 30.000 | 8000 × 8000 |
- Boyutlandırma + 5 efekt + format dönüşümü içeren tek istek = 1 işlem.
- AI uçları yalnızca AI kredisinden düşer, işlem kotasına sayılmaz. Kredi maliyeti işleme göredir: remove-bg, upscale, colorize, remove-object, ocr (görsel başına) ve listing-copy 1 kredi; product-scene türe göre studio 2, relight 6, lifestyle 7 kredi; face-restore, restore ve headshot 9 kredi. vectorize (SVG) AI işlemi değildir, işlem kotasından düşer. Güncel ağırlıklar /api/v1/info yanıtının aiUnits alanında, bir çağrıda düşen kredi X-Glitch-AI-Units başlığında (yalnızca kredi düştüğünde gönderilir). Kalan kredin işlemin maliyetinden azsa istek çalışmadan 429 GPU_QUOTA_EXCEEDED alır; gövde required, limit, used ve resetsAt alanlarını taşır.
- İşlem kotasından yalnızca başarılı yanıtlar düşer; tek istisna vectorize: vektörleştirme çalıştıktan sonra çıktı sunulamayacak kadar ayrıntılı diye reddedilen istek de 1 istek düşer. AI kredisinde başarılı çağrı ağırlığı kadar düşer; AI işi sağlayıcıya gönderildikten sonra bağlantısı kesilen ya da AI adımından sonra bizden kaynaklanmayan bir nedenle başarısız olan istek de düşer. AI servisindeki arıza, geçici kısıtlama (GPU_BUSY), modelin görseli reddetmesi (GPU_INPUT_REJECTED), 4xx doğrulama hataları ve bizim zaman aşımımız (408) düşmez.
- URL girdileri 60 dakika önbelleğe alınır (süre her erişimde yenilenir); birebir aynı istek yeniden işlenmeden anında döner. Önbellekten dönen yanıtlar kotandan düşmez ve X-Glitch-Processing-Time taşımaz. Profesyonel portre, görselden metin, ilan metni ve SVG'ye dönüştürme sonuçları önbelleğe alınmaz: bu uçlarda aynı istek her seferinde yeniden işlenir ve kotandan düşer.
- İşlem kotan dolduğunda AI istekleri de durur: AI kredin kalsa bile 429 REQUEST_QUOTA_EXCEEDED alırsın.
Yanıtlara, kullanımını izleyebilmen için özel header'lar eklenir:
| Header | Örnek | Açıklama |
|---|---|---|
| X-Glitch-Plan | pro | Mevcut abonelik planın |
| X-Glitch-Requests-Remaining | 74922 | Bu dönem kalan işlem hakkı (bu istek dahil). AI istekleri buraya sayılmaz. |
| X-Glitch-GPU-Remaining | 1958 | Bu dönem kalan AI kredisi (bu istek dahil) |
| X-Glitch-AI-Units | 9 | Bu çağrıda düşülen AI kredisi. Yalnızca kredi düştüğünde gönderilir; başlık yoksa bu çağrıdan kredi düşmemiştir. |
| X-Glitch-Warnings | low_confidence | Görselden metin (ocr), ilan metni (listing-copy) ve SVG'ye dönüştürme (vectorize) uçlarında: virgülle ayrılmış uyarı anahtarları. ocr: low_confidence, truncated, fallback_used (her çıktı biçiminde gelir); listing-copy: fallback_used, truncated, wording_review (JSON yanıtındaki warnings ile aynı); vectorize: large_output (SVG 2 MB'ı ya da 5.000 yolu aştı). Uyarı yoksa gönderilmez. |
| X-Glitch-Notice | product-redrawn | Yalnız ürün sahnesi (product-scene) ucunda: product-redrawn, ürünün AI ile yeniden çizildiğini (orijinal piksellerin geri yapıştırılmadığını) bildirir; bu görsel ana görsel olarak kullanılmamalı. relight türünde ürün her zaman yeniden çizilir. |
| X-Glitch-Processing-Time | 142ms | Sunucu tarafı işleme süresi |
| Retry-After | 10 | 429 yanıtlarında ve 503 GPU_ERROR yanıtında: kaç saniye sonra tekrar denenmeli. AI_FAILURE_LIMIT'te süre dolunca girdiyi düzelterek dene. |
Hata Kodları
Hata yanıtları her zaman JSON'dur ve 4xx/5xx durum koduyla gelir. Başarılı yanıtlar binary görseldir; istisnalar /image-info ve /listing-copy (JSON), /ocr (output'a göre JSON, metin ya da belge) ve /vectorize (SVG). Başarıyı Content-Type'tan değil durum kodundan anla.
Hata yanıt formatı
{
"error": true,
"code": "INVALID_INPUT",
"message": "No image input provided. Use url, image (base64), file upload, or binary body."
}| HTTP | Kod | Açıklama |
|---|---|---|
| 400 | INVALID_INPUT | Görsel girdisi eksik veya geçersiz (url / image / file / binary gövdeden biri gerekli). Ayrıca AI bayrağı düz bir query parametresi ya da UTF-8 JSON gövdenin üst düzey alanı olarak gönderilmediyse (ör. önekli query adı, UTF-16 gövde) da bu kod döner. |
| 400 | MULTIPLE_AI_OPERATIONS | Tek istekte birden fazla AI bayrağı var (ör. /process?removeBackground=true&upscale=true) ya da /ocr isteğine bir AI bayrağı eklenmiş. Her AI işlemini ayrı bir istekle gönder; aynı isteği tekrarlamak aynı sonucu verir. |
| 400 | INVALID_FORMAT | İstenen çıkış formatı desteklenmiyor ya da yüklenen dosyanın biçimi kabul edilmiyor. Hata mesajı formatı adıyla söyler. /vectorize yalnızca PNG, JPEG ve WebP kabul eder. |
| 403 | FORMAT_REQUIRES_PLAN | TIFF ve AVIF ücretli planlara özeldir — hem giriş hem çıkış tarafında. Yanıt gövdesi format, direction ve requiredPlan alanlarını taşır. Bu istek aylık kotanızdan düşmez. |
| 400 | VALIDATION_ERROR | Görsel; boyut, çözünürlük (plan bazlı), 80 megapiksel çözme sınırı, AI büyütmenin 2,1 megapiksellik (1448×1448) kaynak tavanı veya format limitlerini aşıyor ya da bir parametre değeri geçersiz (ör. quality; headshot için background, aspectRatio; ocr için output, csvDelimiter; product-scene için sceneType, scenePreset, aspectRatio; listing-copy için 60 karakteri aşan brand ya da category ve boş görsel; vectorize için colors, curves, 4 megapiksel / 4096 px girdi sınırı, vektöre çevrilemeyecek kadar ayrıntılı (fotoğraf benzeri) girdi ve sunulamayacak kadar ayrıntılı çıktı). AI uçlarında bu hata istek sağlayıcıya gitmeden döner, yani AI kredinden düşmez. vectorize'da ret vektörleştirme çalıştıktan sonra gelirse (sunulamayacak kadar ayrıntılı çıktı) işlem kotandan 1 istek düşer. |
| 400 | MISSING_WATERMARK | watermarkText parametresi eksik (query string'de zorunlu). |
| 400 | INVALID_SCALE | upscaleScale yalnızca 2 veya 4 olabilir. |
| 400 | MISSING_MASK | mask parametresi eksik (query string'de URL ya da JSON gövdede base64 olarak gönderilir). |
| 400 | INVALID_MASK | Maske görseli çözülemedi (geçersiz URL/base64). |
| 400 | INVALID_PRESET | Bilinmeyen preset adı; yanıt geçerli preset listesini içerir. |
| 400 | INVALID_IMAGE | Görsel decode edilemedi (bozuk veya desteklenmeyen dosya). /image-info, /ocr, /listing-copy ve /vectorize döner (/ocr ve /listing-copy'de AI adımından önce, kredi düşmez); diğer işleme uçlarında aynı durum VALIDATION_ERROR olur. |
| 401 | UNAUTHORIZED | API anahtarı eksik veya geçersiz. |
| 403 | GPU_NOT_AVAILABLE | AI işlemleri mevcut planında yok; yükseltmeden bu uçlar çalışmaz. |
| 403 | FEATURE_DISABLED | İstenen özellik sunucuda kapalı. |
| 408 | TIMEOUT | İstek süre bütçesini aştı: hızlı işlemlerde 30 sn, AI işlemlerinde 90 sn. Yükleme süresi ve kaynak URL indirme (10 sn) de bu bütçeye dahildir. |
| 413 | PAYLOAD_TOO_LARGE | İstek gövdesi sunucu sınırını aştı. Base64 gövde ham görselden yaklaşık üçte bir büyüktür; sınıra ondan takılmak mümkün. |
| 422 | GPU_INPUT_REJECTED | AI modeli bu girdiyi işlemeyi reddetti — görsel bozuk olabilir, desteklenmeyen bir içerik taşıyor olabilir, nesne silmede maske görselle uyuşmuyor olabilir ya da ürün sahnesinde görselde arka plandan ayrılabilen bir ürün bulunamamış olabilir. Kalıcı bir hatadır: aynı girdiyle tekrar denemek sonucu değiştirmez. Boyut kaynaklı retler bu koda DÜŞMEZ — onlar AI hiç çalışmadan VALIDATION_ERROR döner ve AI kredinden düşmez. |
| 429 | REQUEST_QUOTA_EXCEEDED | Aylık işlem kotası doldu. |
| 429 | GPU_QUOTA_EXCEEDED | Bu işlem için yeterli AI kredin kalmadı. Gövde required (işlemin kredisi), limit, used ve resetsAt (dönemin bittiği an) alanlarını taşır; Retry-After dönem sonuna kadardır. |
| 429 | GPU_BUSY | AI servisi o an yoğun. Retry-After başlığındaki (ve gövdedeki retryAfterSeconds alanındaki) süre kadar bekleyip tekrar dene — kota hatası değildir. |
| 429 | SERVER_BUSY | Eşzamanlılık kapısı: sunucu o an kapasitesinde. Retry-After başlığındaki süre kadar bekleyip tekrar dene — kota hatası değildir. |
| 429 | AI_FAILURE_LIMIT | Hesabının son AI istekleri modelde çok kez başarısız oldu; kısa bir süre yeni AI istekleri kabul edilmez. Retry-After başlığındaki (ve gövdedeki retryAfterSeconds) süre dolunca girdiyi (görsel, format, maske) düzelterek tekrar dene. Kota hatası değildir. |
| 500 | PROCESSING_ERROR | Dahili görsel işleme hatası. |
| 500 | GPU_UNAVAILABLE | Bizim tarafımızda bir sorun: AI sağlayıcısı yapılandırılmamış ya da sağlayıcı hesabımızı veya yapılandırmamızı reddetti. Tekrar denemek bir şey değiştirmez; sürerse destek talebi aç. |
| 503 | GPU_ERROR | AI servisi geçici olarak başarısız oldu — kalıcı bir hata değildir. Yanıt her zaman Retry-After: 30 taşır; o kadar bekleyip tekrar dene. Görsel o an bu boyutta işlenemeyecek kadar yoğunluk olduğunda da bu hata döner; daha küçük bir görsel de işe yarayabilir. |
| 503 | GPU_UPLOAD_FAILED | Görsel AI işlemesine gönderilemedi. Geçici bir hatadır: kısa bir bekleyişten sonra aynı istekle tekrar dene. Bu yanıt Retry-After taşımaz. |
Dosya Formatları
| Format | Giriş | Çıkış | Not |
|---|---|---|---|
| JPG / JPEG | — | ||
| PNG | — | ||
| WebP | — | ||
| AVIF | Ücretli planlara özel — giriş ve çıkış. AVIF’in kalite ölçeği WebP’ninkinden farklıdır: aynı quality değerinde daha yüksek sadakat, dolayısıyla daha büyük dosya üretir. Daha küçük dosya için quality değerini 60-70 aralığında deneyin. | ||
| TIFF | Ücretli planlara özel — giriş ve çıkış. Çıktı kayıpsızdır (Deflate) ve quality yok sayılır. | ||
| GIF | GIF girişi okunur, çıkış PNG olarak servis edilir. Hareketli GIF’lerde yalnızca ilk kare işlenir. | ||
| BMP | BMP desteklenmiyor. Yüklerseniz formatı adıyla söyleyen bir hata alırsınız; dosyanız bozuk değildir. |
Webhooks
Uzun süren AI işlemlerinin sonucunu webhook ile almak yol haritamızda — yakında. Aşağıdaki taslak, planlanan payload yapısını gösterir.
{ "event": "transform.completed", "job_id": "job_8f3a91", "endpoint": "/v1/upscale", "status": "ok", "duration_ms": 3214, "result_url": "https://cdn.theglitch.app/r/8f3a91.png"}Değişiklik Günlüğü
v1.1 · Ekim 2026
- Görselden metin (OCR): fiş, fatura, menü, kartvizit ve eski belgelerdeki yazıyı okur; JSON, TXT, Markdown, HTML, CSV, Word (DOCX) ya da PDF olarak verir. Çıktı bir taslaktır, kullanmadan önce doğrula. Görsel başına 1 AI kredisi.
- Profesyonel portre: CV, LinkedIn ve kurumsal ekip sayfaları için stüdyo görünümlü portre; 5 arka plan, 4 en-boy oranı. Biyometrik vesikalık değildir. Çağrı başına 9 AI kredisi.
- İlan metni: ürün fotoğrafından Trendyol, Hepsiburada ve n11 kalıbında Türkçe ilan taslağı — başlık, açıklama, özellikler, renk, malzeme, anahtar kelimeler ve alt metin (JSON). Taslaktır; yayımlamadan önce kontrol et. Toplu işlemde ilanlar tek bir CSV'de de toplanır. Görsel başına 1 AI kredisi.
- Ürün sahnesi: ürün fotoğrafından ek görsel — beyaz fon (2 kredi), stüdyo ışığı (6 kredi) ya da yaşam alanı sahnesi (7 kredi). Pazaryerinin ana görseli beyaz fonlu orijinal kalmalı; ürün AI ile yeniden çizildiğinde panel ve API bunu bildirir.
- SVG'ye dönüştürme: düz renkli logo ve ikonları 2–16 renkli SVG vektöre çevirir; logodaki Türkçe harfler şekliyle korunur. AI kredisi düşmez, 1 işlem sayılır.
- AI kotası artık AI kredisi: her AI işlemi ağırlığı kadar kredi düşer — arka plan kaldırma, büyütme, renklendirme, nesne silme, OCR ve ilan metni 1; ürün sahnesi türüne göre 2, 6 ya da 7; yüz onarımı, fotoğraf onarımı ve profesyonel portre 9. Ücretsiz plan ayda 10 krediye çıktı.
- Yeni hata kodları: MULTIPLE_AI_OPERATIONS (tek istekte birden fazla AI işlemi) ve AI_FAILURE_LIMIT (art arda başarısız AI istekleri, Retry-After ile). 503 GPU_ERROR artık her zaman Retry-After: 30 taşır.
- Stüdyo 19 işleme çıktı ve bir AI işleminden önce kaç kredi düşeceğini gösteriyor. Fotoğraf onarımındaki ayrı "çizik onarımı" seçeneği kaldırıldı: onarım çizikleri zaten gideriyor.
v1.0.1 · 17 Ağustos 2026
- AI istekleri artık aylık işlem kotandan düşmüyor. Arka plan kaldırma, büyütme, renklendirme, yüz restorasyonu, fotoğraf restorasyonu ve nesne silme yalnızca AI kotasını kullanıyor; böylece planındaki işlem hakkı ilan edilen değerin tamamı oluyor.
- X-Glitch-Requests-Remaining ve X-Glitch-GPU-Remaining artık o an işlenen isteği de sayıyor. Planının izin verdiği son istek 1 yerine 0 gösteriyor ve bir sonraki istekte alacağın 429 ile tutarlı oluyor.
- Kalan hak sayıları kesin bir defter değil, yakın bir tahmindir: paralel çalışan istekler henüz yansımamış olabilir.
v1.0 · 29 Mayıs 2026
- 8 hızlı görsel işleme aracı: boyutlandırma, format dönüştürme, efektler, filigran, optimize, kırpma, sosyal medya boyutları ve görsel bilgisi.
- 6 AI aracı: arka plan kaldırma, AI ile büyütme, renklendirme, yüz restorasyonu, fotoğraf restorasyonu ve nesne silme.
- 3 erişim kanalı: web paneli, REST API ve MCP sunucusu.
- 4 plan: Free, Starter, Pro ve Business.