AltGen’i API ile Upload Pipeline’ınıza Bağlamak

Dashboard tek seferlik batch’ler için gayet iyi, ama görseller ürününüzde sürekli hareket ediyorsa, alt metin için döngüde bir insan istemezsiniz. İşte AltGen’i kendi upload yolunuza doğrudan nasıl bağlayacağınız.

Kapsamlı bir API anahtarı alın

Settings → API Keys üzerinden bir tane oluşturun. Anahtarlar workspace bazında kapsamlıdır, isteğe bağlı olarak süresi dolar ve entegrasyonunuzun geri kalanına dokunmadan iptal edilebilir.

curl -X POST https://api.altgen.io/v1/images/generate \
  -H "Authorization: Bearer $ALTGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://cdn.yourstore.com/sneaker.jpg",
    "preset": "ecommerce",
    "style": "concise",
    "languages": ["en", "de", "tr"]
  }'

Yanıt, birincil alt metnin yanı sıra istenen her dil için bir çeviriyle geri gelir:

{
  "altText": "Burgundy low-top sneaker with a white sole, floating on a yellow background",
  "translations": { "de": "…", "tr": "…" },
  "status": "completed",
  "creditsCost": 1
}

Sonuçları kullanmanın iki yolu

Senkron — endpoint’i çağırıp yanıtı bekleyin. Basittir, ama sadece tek bir görsel veya düşük hacim için mantıklıdır.

Webhook’lar — ölçekte bir şey için, bunun yerine üretim olaylarına abone olun. Bir görsel işlenmeyi bitirir bitirmez AltGen sonucu endpoint’inize gönderir, böylece upload handler’ınız 500 görsellik bir batch’i beklemek zorunda kalmaz.

Tipik bir CMS entegrasyonu

1. Editör CMS’inize bir görsel yükler.
2. Upload handler’ınız görsel URL’siyle POST /v1/images/generate çağırır.
3. AltGen görseli işler ve tamamlandığında endpoint’inize bir webhook gönderir.
4. Handler’ınız dönen alt metni doğrudan görselin metadata alanına yazar.

Dashboard yok, elle inceleme adımı yok, birinin bir alanı doldurmayı unuttuğu için alt metinsiz gönderilen görsel yok.

Bir batch’i takip etmeden başarısızlıkları tekrar denemek

Bir üretim başarısız olursa, her şeyi yeniden göndermek yerine PATCH /v1/images/{id}/retry çağırın. Bu, toplu batch’lerin dahili olarak kullandığı aynı mekanizma, sadece API üzerinden tek tek görsel yönettiğiniz durumlar için açık.

İşte bütün yüzey alanı bu: üretmek, listelemek, güncellemek ve tekrar denemek için tek bir endpoint, yoklama yapmak istemiyorsanız da webhook’lar. Tam referans API dokümanlarında.