Dokümanlar / Genel Bakış

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ı:

Web Panel

Tarayıcıda sürükle, bırak. Kod yazmadan tek seferde 100 görsele kadar işle.

Panele git

REST API

Backend'inden tek istekle çağır. Standart HTTP, JSON yanıt.

Hızlı başla

MCP Server

Claude, Cursor gibi AI asistanlardan doğrudan çağrı.

MCP'yi gör
İlk istek? Aşağıdaki Hızlı Başlangıç ile 60 saniyede ilk yanıtını al.

Hızlı Başlangıç

Hesap oluştur, anahtar al, ilk isteği gönder — toplam 60 saniye.

  1. API anahtarı al

    Panel → API Anahtarları → Yeni anahtar. Üretilen erişim anahtarı 32 karakterlik benzersiz bir dizedir.

  2. İlk isteği gönder

    Bir görseli 800px genişliğe boyutlandır:

    ~/glitch · curl
    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
  3. Yanıtı al

    Yanıt 200 OK + işlenmiş görsel (binary). result.webp dosyasına yazılır.

  4. Daha fazlasını dene

    19 işleme endpoint'inin tamamı aşağıda: API Referans.

İpucu: Kod yazmadan denemek istiyorsan Web Panel'den tek tık yeterli.

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 · header
curl "https://theglitch.app/api/v1/resize?width=800" \  -H "X-Api-Key: YOUR_API_KEY" \  -F "file=@photo.jpg" -o result.webp
Güvenlik: API anahtarını tarayıcı tarafında (client-side) paylaşma. Daima sunucu tarafında tut.

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. 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. 2 · Base64

    JSON gövdede image alanı (data-URI destekli): Content-Type: application/json.

  3. 3 · Binary gövde

    Ham byte'ları image/* Content-Type'ı ile doğrudan gövdede gönder.

  4. 4 · Form upload

    Multipart form'da file alanıyla dosya yükle.

4 input · curl
# 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.webp
Önemli: Form upload'da yalnızca dosya okunur — width, format gibi parametreleri form alanı olarak değil, query string'de gönder.
Limitler: Maks. girdi 25 MB · her isteğin bir süre bütçesi vardır: hızlı işlemlerde 30 sn, AI işlemlerinde 90 sn (aşımı 408 TIMEOUT). Yükleme süresi de bu bütçeye dahildir, bu yüzden yavaş bir bağlantıda 25 MB'a varmadan 408 alabilirsin · kaynak görsel en fazla 80 megapiksel · AI büyütmede kaynak en fazla 2,1 megapiksel (1448×1448) · restorasyon çıktısı yaklaşık 1 megapiksele normalize edilir · URL indirme zaman aşımı 10 sn (aşımı 408 TIMEOUT) · çıkış çözünürlüğü plana bağlı (2048–8000 px).

Tü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.

MethodEndpointAçıklama
GET POST/v1/processTüm işlemler tek istekte (ana endpoint)
GET POST/v1/resizeYeniden boyutlandır
GET POST/v1/convertFormat dönüştür
GET POST/v1/effectsParlaklık, kontrast, doygunluk, bulanıklık
GET POST/v1/watermarkFiligran ekle
GET POST/v1/optimizeWeb için optimize et
GET POST/v1/preset/{name}Sosyal medya hazır boyutlar
GET POST/v1/image-infoGörsel meta verisi (JSON yanıt)
GET POST/v1/vectorizeLogo ve ikonu SVG'ye dönüştür (SVG yanıt)
GET POST/v1/remove-bgArka plan kaldır (AI)
GET POST/v1/upscaleAI ile 2x / 4x büyüt
GET POST/v1/colorizeSiyah-beyaz görseli renklendir
GET POST/v1/face-restoreYüz restorasyonu
GET POST/v1/restoreEski fotoğraf restorasyonu
GET POST/v1/remove-objectNesne sil (AI)
GET POST/v1/headshotProfesyonel portre (AI)
GET POST/v1/ocrGörselden metin — OCR (AI)
GET POST/v1/listing-copyFotoğraftan pazaryeri ilan taslağı — JSON (AI)
GET POST/v1/product-sceneÜrün sahnesi: ek ürün görseli (AI)
GET/v1/infoAPI 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

İsimTipZorunluVarsayılan · AralıkAçıklama
urlstringOpsiyonel—İş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).
imagestringOpsiyonel—Base64 kodlu görsel (data-URI destekli). JSON gövdede gönderilir.
filefileOpsiyonel—Multipart form dosyası (alan adı: file). Diğer parametreler query string'de kalmalı.
widthintOpsiyonel1 … 8000Hedef genişlik (px). Tek başına verilirse en-boy oranı korunur.
heightintOpsiyonel1 … 8000Hedef yükseklik (px). Tek başına verilirse en-boy oranı korunur.
modestringOpsiyonelfit (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.
padColorstringOpsiyonel#FFFFFF (#RRGGBB)mode=pad'de kenarlarda kalan boşluğun rengi. GET'te # işaretini %23 olarak kodla.
qualityintOpsiyonel85 (1 … 100)Kayıplı formatlarda (JPEG, WebP) sıkıştırma kalitesi. PNG'de etkisizdir.
formatstringOpsiyonelauto (auto · jpeg · png · webp · tiff · avif · gif)Çıkış formatı. auto: Accept header'a göre seçilir, varsayılan WebP.
brightnessintOpsiyonel0 (-100 … 100)Parlaklık. -100 tamamen siyah, +100 iki kat parlak.
contrastintOpsiyonel0 (-100 … 100)Kontrast. Negatif soluklaştırır, pozitif derinleştirir.
saturationintOpsiyonel0 (-100 … 100)Doygunluk. -100 gri tonlamayla aynı sonucu verir.
blurintOpsiyonel0 (0 … 100)Gaussian bulanıklaştırma şiddeti.
sharpenintOpsiyonel0 (0 … 100)Keskinleştirme şiddeti. Düşük değerlerle başla (10–30); yüksek değerler artefakt üretebilir.
grayscaleboolOpsiyonelfalseGri tonlamaya çevirir.
sepiaboolOpsiyonelfalseSıcak sepya tonu uygular.
rotateintOpsiyonel0 (0 · 90 · 180 · 270)Saat yönünde döndürme. Yalnızca 90° katları.
flipHboolOpsiyonelfalseYatay aynalama (sol-sağ).
flipVboolOpsiyonelfalseDikey aynalama (üst-alt).
presetstringOpsiyonel14 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
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

İsimTipZorunluVarsayılan · AralıkAçıklama
urlstringOpsiyonel—İş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).
imagestringOpsiyonel—Base64 kodlu görsel (data-URI destekli). JSON gövdede gönderilir.
filefileOpsiyonel—Multipart form dosyası (alan adı: file). Diğer parametreler query string'de kalmalı.
widthintOpsiyonel1 … 8000Hedef genişlik (px). Tek başına verilirse en-boy oranı korunur.
heightintOpsiyonel1 … 8000Hedef yükseklik (px). Tek başına verilirse en-boy oranı korunur.
modestringOpsiyonelfit (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.
padColorstringOpsiyonel#FFFFFF (#RRGGBB)mode=pad'de kenarlarda kalan boşluğun rengi. GET'te # işaretini %23 olarak kodla.
qualityintOpsiyonel85 (1 … 100)Kayıplı formatlarda (JPEG, WebP) sıkıştırma kalitesi. PNG'de etkisizdir.
formatstringOpsiyonelauto (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
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

İsimTipZorunluVarsayılan · AralıkAçıklama
urlstringOpsiyonel—İş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).
imagestringOpsiyonel—Base64 kodlu görsel (data-URI destekli). JSON gövdede gönderilir.
filefileOpsiyonel—Multipart form dosyası (alan adı: file). Diğer parametreler query string'de kalmalı.
formatstringOpsiyonelauto (auto · jpeg · png · webp · tiff · avif · gif)Çıkış formatı. auto: Accept header'a göre seçilir, varsayılan WebP.
qualityintOpsiyonel85 (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
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

İsimTipZorunluVarsayılan · AralıkAçıklama
urlstringOpsiyonel—İş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).
imagestringOpsiyonel—Base64 kodlu görsel (data-URI destekli). JSON gövdede gönderilir.
filefileOpsiyonel—Multipart form dosyası (alan adı: file). Diğer parametreler query string'de kalmalı.
brightnessintOpsiyonel0 (-100 … 100)Parlaklık. -100 tamamen siyah, +100 iki kat parlak.
contrastintOpsiyonel0 (-100 … 100)Kontrast. Negatif soluklaştırır, pozitif derinleştirir.
saturationintOpsiyonel0 (-100 … 100)Doygunluk. -100 gri tonlamayla aynı sonucu verir.
blurintOpsiyonel0 (0 … 100)Gaussian bulanıklaştırma şiddeti.
sharpenintOpsiyonel0 (0 … 100)Keskinleştirme şiddeti. Düşük değerlerle başla (10–30); yüksek değerler artefakt üretebilir.
grayscaleboolOpsiyonelfalseGri tonlamaya çevirir.
sepiaboolOpsiyonelfalseSıcak sepya tonu uygular.
rotateintOpsiyonel0 (0 · 90 · 180 · 270)Saat yönünde döndürme. Yalnızca 90° katları.
flipHboolOpsiyonelfalseYatay aynalama (sol-sağ).
flipVboolOpsiyonelfalseDikey aynalama (üst-alt).
qualityintOpsiyonel85 (1 … 100)Kayıplı formatlarda (JPEG, WebP) sıkıştırma kalitesi. PNG'de etkisizdir.
formatstringOpsiyonelauto (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
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

İsimTipZorunluVarsayılan · AralıkAçıklama
urlstringOpsiyonel—İş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).
imagestringOpsiyonel—Base64 kodlu görsel (data-URI destekli). JSON gövdede gönderilir.
filefileOpsiyonel—Multipart form dosyası (alan adı: file). Diğer parametreler query string'de kalmalı.
watermarkTextstringZorunlu—Filigran metni (Unicode destekli). GET isteklerinde özel karakterleri URL-encode et.
watermarkPositionstringOpsiyonelbottom-right (top-left · top-right · bottom-left · bottom-right · center)Filigranın konumu.
watermarkOpacityintOpsiyonel50 (0 … 100)Saydamlık: 0 görünmez, 100 opak.
watermarkFontSizeintOpsiyonel24 (12 … 120 px)Yazı boyutu (px).
watermarkColorstringOpsiyonel#FFFFFF (#RRGGBB)Metin rengi. GET'te # işaretini %23 olarak gönder.
qualityintOpsiyonel85 (1 … 100)Kayıplı formatlarda (JPEG, WebP) sıkıştırma kalitesi. PNG'de etkisizdir.
formatstringOpsiyonelauto (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
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

İsimTipZorunluVarsayılan · AralıkAçıklama
urlstringOpsiyonel—İş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).
imagestringOpsiyonel—Base64 kodlu görsel (data-URI destekli). JSON gövdede gönderilir.
filefileOpsiyonel—Multipart form dosyası (alan adı: file). Diğer parametreler query string'de kalmalı.
qualityintOpsiyonel85 (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
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

İsimTipZorunluVarsayılan · AralıkAçıklama
urlstringOpsiyonel—İş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).
imagestringOpsiyonel—Base64 kodlu görsel (data-URI destekli). JSON gövdede gönderilir.
filefileOpsiyonel—Multipart form dosyası (alan adı: file). Diğer parametreler query string'de kalmalı.
qualityintOpsiyonel85 (1 … 100)Kayıplı formatlarda (JPEG, WebP) sıkıştırma kalitesi. PNG'de etkisizdir.
formatstringOpsiyonelauto (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

namepxAçıklama
instagram_square1080 × 1080Akış gönderisi (1:1)
instagram_story1080 × 1920Story / Reels (9:16)
instagram_post1080 × 1350Dikey gönderi (4:5)
facebook_cover820 × 312Sayfa kapak fotoğrafı
facebook_post1200 × 630Akış gönderisi / link paylaşımı
twitter_header1500 × 500Profil başlığı
twitter_post1200 × 675Tweet görseli (16:9)
linkedin_banner1584 × 396Şirket banner'ı
linkedin_post1200 × 627Akış gönderisi
youtube_thumbnail1280 × 720Video küçük resmi (16:9)
youtube_banner2560 × 1440Kanal banner'ı
og_image1200 × 630Open Graph / SEO önizleme
whatsapp_status1080 × 1920Durum görseli (9:16)
tiktok_video1080 × 1920Video kapağı (9:16)

Örnek

curl
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

İsimTipZorunluVarsayılan · AralıkAçıklama
urlstringOpsiyonel—İş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).
imagestringOpsiyonel—Base64 kodlu görsel (data-URI destekli). JSON gövdede gönderilir.
filefileOpsiyonel—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ı

İsimTipAçıklama
widthintGenişlik (px)
heightintYükseklik (px)
formatstringAlgılanan format: jpeg, png, webp, gif, tiff, avif
colorTypestringRenk modeli: rgb, rgba, grayscale veya cmyk. Bu dört değerin dışında bir şey dönmez.
hasAlphaboolŞeffaflık kanalı var mı
orientationintHam 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.
fileSizeintDosya boyutu (byte)
fileSizeHumanstringOkunabilir dosya boyutu (örn. "240.0 KB")
200 · application/json
{
  "width": 1920,
  "height": 1080,
  "format": "jpeg",
  "colorType": "rgb",
  "hasAlpha": false,
  "orientation": 1,
  "fileSize": 245760,
  "fileSizeHuman": "240.0 KB"
}

Örnek

curl
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

İsimTipZorunluVarsayılan · AralıkAçıklama
urlstringOpsiyonel—İş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).
imagestringOpsiyonel—Base64 kodlu görsel (data-URI destekli). JSON gövdede gönderilir.
filefileOpsiyonel—Multipart form dosyası (alan adı: file). Diğer parametreler query string'de kalmalı.
colorsintOpsiyonel8 (2 … 16)Paletteki renk sayısı, 2–16 (varsayılan 8). Az renk daha sade bir çıktı verir.
curvesstringOpsiyonelspline (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ÖrnekAçıklama
Content-Typeimage/svg+xml; charset=utf-8Gövde UTF-8 SVG metnidir.
Content-Security-Policydefault-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-OptionsnosniffTarayıcı içerik türünü tahmin etmez; dosya her zaman SVG olarak işlenir.

Örnek

curl
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

İsimTipZorunluVarsayılan · AralıkAçıklama
urlstringOpsiyonel—İş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).
imagestringOpsiyonel—Base64 kodlu görsel (data-URI destekli). JSON gövdede gönderilir.
filefileOpsiyonel—Multipart form dosyası (alan adı: file). Diğer parametreler query string'de kalmalı.
formatstringOpsiyonelauto (auto · jpeg · png · webp · tiff · avif · gif)Çıkış formatı. auto: Accept header'a göre seçilir, varsayılan WebP.
qualityintOpsiyonel85 (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
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

İsimTipZorunluVarsayılan · AralıkAçıklama
urlstringOpsiyonel—İş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).
imagestringOpsiyonel—Base64 kodlu görsel (data-URI destekli). JSON gövdede gönderilir.
filefileOpsiyonel—Multipart form dosyası (alan adı: file). Diğer parametreler query string'de kalmalı.
upscaleScaleintOpsiyonel4 (2 · 4)Büyütme çarpanı: 2x veya 4x. Başka değer INVALID_SCALE hatası döner.
formatstringOpsiyonelauto (auto · jpeg · png · webp · tiff · avif · gif)Çıkış formatı. auto: Accept header'a göre seçilir, varsayılan WebP.
qualityintOpsiyonel85 (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
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

İsimTipZorunluVarsayılan · AralıkAçıklama
urlstringOpsiyonel—İş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).
imagestringOpsiyonel—Base64 kodlu görsel (data-URI destekli). JSON gövdede gönderilir.
filefileOpsiyonel—Multipart form dosyası (alan adı: file). Diğer parametreler query string'de kalmalı.
formatstringOpsiyonelauto (auto · jpeg · png · webp · tiff · avif · gif)Çıkış formatı. auto: Accept header'a göre seçilir, varsayılan WebP.
qualityintOpsiyonel85 (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
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

İsimTipZorunluVarsayılan · AralıkAçıklama
urlstringOpsiyonel—İş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).
imagestringOpsiyonel—Base64 kodlu görsel (data-URI destekli). JSON gövdede gönderilir.
filefileOpsiyonel—Multipart form dosyası (alan adı: file). Diğer parametreler query string'de kalmalı.
formatstringOpsiyonelauto (auto · jpeg · png · webp · tiff · avif · gif)Çıkış formatı. auto: Accept header'a göre seçilir, varsayılan WebP.
qualityintOpsiyonel85 (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
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

İsimTipZorunluVarsayılan · AralıkAçıklama
urlstringOpsiyonel—İş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).
imagestringOpsiyonel—Base64 kodlu görsel (data-URI destekli). JSON gövdede gönderilir.
filefileOpsiyonel—Multipart form dosyası (alan adı: file). Diğer parametreler query string'de kalmalı.
formatstringOpsiyonelauto (auto · jpeg · png · webp · tiff · avif · gif)Çıkış formatı. auto: Accept header'a göre seçilir, varsayılan WebP.
qualityintOpsiyonel85 (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
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

İsimTipZorunluVarsayılan · AralıkAçıklama
urlstringOpsiyonel—İş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).
imagestringOpsiyonel—Base64 kodlu görsel (data-URI destekli). JSON gövdede gönderilir.
filefileOpsiyonel—Multipart form dosyası (alan adı: file). Diğer parametreler query string'de kalmalı.
maskstringZorunlu—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.
formatstringOpsiyonelauto (auto · jpeg · png · webp · tiff · avif · gif)Çıkış formatı. auto: Accept header'a göre seçilir, varsayılan WebP.
qualityintOpsiyonel85 (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
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

İsimTipZorunluVarsayılan · AralıkAçıklama
urlstringOpsiyonel—İş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).
imagestringOpsiyonel—Base64 kodlu görsel (data-URI destekli). JSON gövdede gönderilir.
filefileOpsiyonel—Multipart form dosyası (alan adı: file). Diğer parametreler query string'de kalmalı.
backgroundstringOpsiyonelneutral (neutral · white · gray · black · office)Portrenin arka planı: neutral (nötr, varsayılan), white (beyaz), gray (gri), black (siyah) ya da office (ofis).
aspectRatiostringOpsiyonel3: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.
formatstringOpsiyonelauto (auto · jpeg · png · webp · tiff · avif · gif)Çıkış formatı. auto: Accept header'a göre seçilir, varsayılan WebP.
qualityintOpsiyonel85 (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
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

İsimTipZorunluVarsayılan · AralıkAçıklama
urlstringOpsiyonel—İş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).
imagestringOpsiyonel—Base64 kodlu görsel (data-URI destekli). JSON gövdede gönderilir.
filefileOpsiyonel—Multipart form dosyası (alan adı: file). Diğer parametreler query string'de kalmalı.
outputstringOpsiyoneljson (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.
csvDelimiterstringOpsiyonel; (; · , · 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

outputContent-TypeAçıklama
jsonapplication/json; charset=utf-8Varsayılan. Yapılandırılmış sonuç; alanlar aşağıda.
txttext/plain; charset=utf-8Düz metin; tablo hücreleri sekmeyle ayrılır.
mdtext/markdown; charset=utf-8Markdown (GFM); tablolar Markdown tablosu olarak.
htmltext/html; charset=utf-8HTML belgesi (lang="tr"). Görseldeki metin işaretleme olarak işlenmez; ham HTML üretilmez.
csvtext/csv; charset=utf-8Gö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.
docxapplication/vnd.openxmlformats-officedocument.wordprocessingml.documentWord belgesi; attachment, filename="ocr.docx".
pdfapplication/pdfYeniden dizilmiş metin PDF'i, Türkçe karakterler gömülü; attachment, filename="ocr.pdf".

JSON alanları (output=json)

İsimTipAçıklama
textstringOkunan metnin tamamı, düz metin olarak.
markdownstringAynı içerik Markdown (GFM) olarak.
blocksarrayBelgenin yapısı, sırayla: her blokta type (heading, paragraph, list, table) ve türüne göre level, text, items ya da rows bulunur.
warningsstring[]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.

200 · application/json · output=json
{
  "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
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

İsimTipZorunluVarsayılan · AralıkAçıklama
urlstringOpsiyonel—İş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).
imagestringOpsiyonel—Base64 kodlu görsel (data-URI destekli). JSON gövdede gönderilir.
filefileOpsiyonel—Multipart form dosyası (alan adı: file). Diğer parametreler query string'de kalmalı.
brandstringOpsiyonel≤ 60Marka 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.
categorystringOpsiyonel≤ 60Kategori 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ı

İsimTipAçıklama
titlestringBaş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.
descriptionstringÜrün açıklaması; paragraflar boş satırla ayrılır.
featuresstring[]Görselde görülebilen özellik maddeleri.
colorstring | nullBaskın renk; görselde belirlenemiyorsa null.
materialstring | nullMalzeme; görselden belirlenemiyorsa null (tahmin yazılmaz).
keywordsstring[]Arama için küçük harfli Türkçe anahtar kelimeler.
altTextstringGörme engelli kullanıcılar için nesnel görsel açıklaması, en fazla 125 karakter.
warningsstring[]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.

200 · application/json; charset=utf-8
{
  "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
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

İsimTipZorunluVarsayılan · AralıkAçıklama
urlstringOpsiyonel—İş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).
imagestringOpsiyonel—Base64 kodlu görsel (data-URI destekli). JSON gövdede gönderilir.
filefileOpsiyonel—Multipart form dosyası (alan adı: file). Diğer parametreler query string'de kalmalı.
sceneTypestringOpsiyonelstudio (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.
scenePresetstringOpsiyoneloak_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).
aspectRatiostringOpsiyonel2: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.
formatstringOpsiyonelauto (auto · jpeg · png · webp · tiff · avif · gif)Çıkış formatı. auto: Accept header'a göre seçilir, varsayılan WebP.
qualityintOpsiyonel85 (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ÖrnekAçıklama
Content-Typeimage/webpSonuç görseldir; format ve quality diğer AI uçlarındaki gibi uygulanır (varsayılan WebP).
X-Glitch-Noticeproduct-redrawnYalnı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
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 / ayAI kredisi / ayMaks. çözünürlük
Free500102048 × 2048
Starter15.0002004000 × 4000
Pro75.0002.0008000 × 8000
Business300.00010.0008000 × 8000
Scale1.000.00030.0008000 × 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ÖrnekAçıklama
X-Glitch-PlanproMevcut abonelik planın
X-Glitch-Requests-Remaining74922Bu dönem kalan işlem hakkı (bu istek dahil). AI istekleri buraya sayılmaz.
X-Glitch-GPU-Remaining1958Bu dönem kalan AI kredisi (bu istek dahil)
X-Glitch-AI-Units9Bu ç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-Warningslow_confidenceGö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-Noticeproduct-redrawnYalnı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-Time142msSunucu tarafı işleme süresi
Retry-After10429 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.
İpucu: Bu sayılar o an işlenen isteği de içerir; 0 görmen sonuncuyu kullandığın anlamına gelir ve bir sonraki istek REQUEST_QUOTA_EXCEEDED veya GPU_QUOTA_EXCEEDED koduyla 429 döner. AI kredisi 0'a inmeden de GPU_QUOTA_EXCEEDED alabilirsin: kalan kredi işlemin maliyetinden azsa (ör. 9 kredilik onarım için 5 kredi). Kesin bir defter değil, yakın bir tahmin olarak değerlendir: paralel çalışan istekler henüz yansımamış olabilir. Kota dolmadan da 429 alabilirsin: GPU_BUSY kodu AI servisinin geçici yoğunluğunu anlatır ve Retry-After süresinden sonra tekrar denenebilir; AI_FAILURE_LIMIT ise son AI isteklerinin modelde çok kez başarısız olduğunu söyler — süre dolunca aynı isteği değil, düzeltilmiş girdiyi gönder.

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ı

4xx/5xx · application/json
{
  "error": true,
  "code": "INVALID_INPUT",
  "message": "No image input provided. Use url, image (base64), file upload, or binary body."
}
Ek alanlar: Bazı hatalar bu üç alana ek olarak bilgi taşır: 429 kota yanıtlarında limit, used, resetsAt, retryAfterSeconds ve upgrade (AI kredisinde ayrıca required); 429 GPU_BUSY ve AI_FAILURE_LIMIT'te retryAfterSeconds; 401'de signup ve docs.
HTTPKodAçıklama
400INVALID_INPUTGö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.
400MULTIPLE_AI_OPERATIONSTek 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.
400INVALID_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.
403FORMAT_REQUIRES_PLANTIFF 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.
400VALIDATION_ERRORGö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.
400MISSING_WATERMARKwatermarkText parametresi eksik (query string'de zorunlu).
400INVALID_SCALEupscaleScale yalnızca 2 veya 4 olabilir.
400MISSING_MASKmask parametresi eksik (query string'de URL ya da JSON gövdede base64 olarak gönderilir).
400INVALID_MASKMaske görseli çözülemedi (geçersiz URL/base64).
400INVALID_PRESETBilinmeyen preset adı; yanıt geçerli preset listesini içerir.
400INVALID_IMAGEGö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.
401UNAUTHORIZEDAPI anahtarı eksik veya geçersiz.
403GPU_NOT_AVAILABLEAI işlemleri mevcut planında yok; yükseltmeden bu uçlar çalışmaz.
403FEATURE_DISABLEDİstenen özellik sunucuda kapalı.
408TIMEOUTİ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.
413PAYLOAD_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.
422GPU_INPUT_REJECTEDAI 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.
429REQUEST_QUOTA_EXCEEDEDAylık işlem kotası doldu.
429GPU_QUOTA_EXCEEDEDBu 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.
429GPU_BUSYAI 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.
429SERVER_BUSYEşzamanlılık kapısı: sunucu o an kapasitesinde. Retry-After başlığındaki süre kadar bekleyip tekrar dene — kota hatası değildir.
429AI_FAILURE_LIMITHesabı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.
500PROCESSING_ERRORDahili görsel işleme hatası.
500GPU_UNAVAILABLEBizim 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ç.
503GPU_ERRORAI 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.
503GPU_UPLOAD_FAILEDGö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.
Retry-After başlığı Tüm 429 yanıtlarında ve 503 GPU_ERROR'da Retry-After başlığı gönderilir (GPU_ERROR'da her zaman 30 sn); tarayıcıdan yapılan çağrılar için CORS'ta da açıktır. Başlık geldiğinde sabit bir süre beklemek yerine oradaki saniyeyi kullan. 408 TIMEOUT ve 503 GPU_UPLOAD_FAILED bu başlığı taşımaz; ikisi de tekrar denenebilir, bekleme süresini kendin seçersin.

Dosya Formatları

FormatGirişÇı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.
GIFGIF girişi okunur, çıkış PNG olarak servis edilir. Hareketli GIF’lerde yalnızca ilk kare işlenir.
BMPBMP desteklenmiyor. Yüklerseniz formatı adıyla söyleyen bir hata alırsınız; dosyanız bozuk değildir.
format=auto: Accept header'dan en iyi format seçilir, varsayılan WebP. Arka plan kaldırmada auto, şeffaflık için PNG'ye döner.

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.

Yakında
taslak payload
{  "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.

Tüm sürüm notları