API로 AltGen을 업로드 파이프라인에 연결하기

대시보드는 일회성 배치에는 좋지만, 이미지가 제품 안에서 끊임없이 이동한다면 대체 텍스트 작업에 사람이 개입하는 것을 원하지 않을 겁니다. AltGen을 여러분의 업로드 경로에 직접 연결하는 방법을 소개합니다.

범위가 지정된 API 키 발급받기

Settings → API Keys에서 하나를 만드세요. 키는 워크스페이스별로 범위가 지정되고, 선택적으로 만료될 수 있으며, 다른 통합에 영향을 주지 않고 취소할 수 있습니다.

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"]
  }'

응답에는 기본 대체 텍스트와 함께 요청한 언어별 번역이 함께 돌아옵니다.

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

결과를 받는 두 가지 방법

동기 방식 — 엔드포인트를 호출하고 응답을 기다립니다. 간단하지만 단일 이미지나 적은 물량에서만 의미가 있습니다.

웹훅 — 규모가 있는 작업이라면 대신 생성 이벤트를 구독하세요. 이미지 처리가 끝나는 즉시 AltGen이 여러분의 엔드포인트로 페이로드를 보내주므로, 업로드 핸들러가 500개짜리 배치를 기다리며 멈춰 있을 필요가 없습니다.

일반적인 CMS 통합

편집자가 CMS에 이미지를 업로드합니다.
업로드 핸들러가 이미지 URL과 함께 POST /v1/images/generate를 호출합니다.
AltGen이 이를 처리하고 완료 시 여러분의 엔드포인트로 웹훅을 보냅니다.
핸들러가 반환된 대체 텍스트를 이미지의 메타데이터 필드에 바로 기록합니다.

대시보드도 없고, 수동 검토 단계도 없고, 누군가 필드 채우는 것을 잊어서 대체 텍스트 없이 배포되는 이미지도 없습니다.

배치를 지켜보지 않고 실패 재시도하기

생성이 실패하면 전체를 다시 보내는 대신 PATCH /v1/images/{id}/retry를 호출하세요. 이는 대량 배치가 내부적으로 사용하는 것과 동일한 메커니즘이며, API를 통해 개별 이미지를 관리하는 경우를 위해 노출되어 있을 뿐입니다.

전체 기능은 이렇습니다. 생성, 목록 조회, 업데이트, 재시도를 위한 엔드포인트 하나, 그리고 폴링하고 싶지 않다면 웹훅까지. 전체 레퍼런스는 API 문서에서 확인할 수 있습니다.