AI 대체 텍스트 생성기 API 문서 - 이미지 대체 텍스트 자동 생성

개요

AI 대체 텍스트 생성기 API는 이미지에 대한 설명적인 대체 텍스트를 자동으로 생성하도록 설계된 강력한 서비스입니다. 고급 AI를 활용하여 이미지를 분석하고 의미 있고 문맥에 맞는 대체 텍스트를 생성하며, 이는 접근성과 SEO에 매우 중요합니다. 이와 같은 이미지용 대체 텍스트 생성기를 사용하면 시각적 콘텐츠를 검색 엔진이 이해할 수 있도록 보장할 수 있습니다. 또한 수작업 시간을 절약하고 생산성을 높일 수 있습니다.

적용 시나리오

AI 대체 텍스트 생성기 API는 이미지 대체 텍스트 생성이 필수적인 다양한 애플리케이션에 이상적입니다.

웹사이트 접근성: 대체 텍스트를 자동으로 생성하여 웹사이트가 접근성 표준을 준수하도록 하고 모든 사용자에게 더 나은 경험을 제공합니다.
SEO 최적화: 이미지에 설명적인 대체 텍스트를 제공하여 웹사이트의 검색 엔진 순위를 향상시키고, 검색 엔진이 시각적 콘텐츠를 이해하도록 돕습니다.
콘텐츠 관리 시스템 (CMS): API를 통합하여 이미지가 업로드될 때 대체 텍스트를 자동으로 생성함으로써 시간을 절약하고 일관성을 보장합니다.
전자상거래 플랫폼: 설명적인 대체 텍스트로 제품 목록을 강화하여 SEO와 시각 장애인 사용자의 쇼핑 경험을 모두 개선합니다.
블로그 및 뉴스 사이트: 편집 이미지에 자동으로 대체 텍스트를 추가하여 접근성과 검색 가시성을 향상시킵니다.

API 키

AI 대체 텍스트 생성기 API에 액세스하려면 먼저 유효한 API 키를 받아야 합니다. 이 키는 요청을 인증하고 API에 대한 안전한 액세스를 보장하는 데 사용됩니다.

API 키 발급받기

API 키 관리 페이지 접속: 시스템에 로그인한 후, 오른쪽 상단의 사용자 아바타를 클릭합니다. 드롭다운 메뉴에서 "API 신청"을 클릭하여 API 키 관리 페이지를 엽니다.

새 키 생성: "새 키 생성"을 클릭하고, 팝업 대화 상자에서 키 이름을 입력한 다음 "생성"을 클릭합니다.

키 복사 및 보관: 키는 한 번만 전체가 표시됩니다. 복사 아이콘을 클릭하여 키를 클립보드에 복사한 다음 "확인"을 클릭하여 대화 상자를 닫습니다.

중요: 키를 다른 사람과 공유하거나 브라우저, 클라이언트 사이드 코드 또는 기타 안전하지 않은 위치에 노출하지 마십시오. 무단 액세스를 방지하기 위해 키를 안전하게 보관하십시오.

API 엔드포인트

POST https://api.imagedescriber.app/api/v1/generate_alt_text

요청 매개변수

요청 헤더

요청 본문

AI 대체 텍스트 생성기 API는 다음 요청 구조를 허용합니다.

{
  "image": "data:image/jpeg;base64,{image_base64_data}",
  "lang": "ko"
}

지원 언어

요청 예시 (cURL)

curl --location 'https://api.imagedescriber.app/api/v1/generate_alt_text' \
--header 'content-type: application/json' \
--header 'authorization: Bearer your_api_key' \
--data '{
    "image":"data:image/jpeg;base64,/9j/4AAQSkZJRgABAQE...",
    "lang":"ko"
}'

요청 예시 (Python)

import requests
import base64

def image_to_base64(image_path):
    """이미지를 Base64 인코딩으로 변환합니다"""
    with open(image_path, "rb") as image_file:
        encoded_string = base64.b64encode(image_file.read()).decode("utf-8")
    return encoded_string

def generate_alt_text(api_key, image_path, lang="ko"):
    """AI 대체 텍스트 생성기 API를 사용하여 이미지의 대체 텍스트를 생성합니다"""
    url = "https://api.imagedescriber.app/api/v1/generate_alt_text"
    headers = {
        "content-type": "application/json",
        "authorization": f"Bearer {api_key}"
    }

    image_base64_data = image_to_base64(image_path)
    payload = {
        "image": f"data:image/jpeg;base64,{image_base64_data}",
        "lang": lang
    }

    response = requests.post(url, headers=headers, json=payload)

    if response.status_code == 200:
        result = response.json()
        alt_text_data = result["data"]["alt_text"]
        print("생성된 설명:", alt_text_data["description"])
        print("생성된 대체 텍스트:", alt_text_data["alt"])
        print("남은 크레딧:", result["data"]["credits"]["remaining"])
    else:
        print(f"오류: {response.status_code}")
        print(response.text)

# 사용 예시
api_key = "your_api_key"
image_path = "your_image.jpg"

generate_alt_text(api_key, image_path)

요청 예시 (Next.js)

import fs from 'fs';

// 서버사이드 구현
const buffer = await fs.readFileSync("/temp/test.jpg");
const base64Image = buffer.toString('base64');
const imageData = `data:image/jpeg;base64,${base64Image}`;

// 클라이언트사이드 구현
const file: File = /* input 또는 드롭 이벤트에서 가져온 파일 */;
const arrayBuffer = await file.arrayBuffer();
const bytes = new Uint8Array(arrayBuffer);
const base64Image = btoa(String.fromCharCode.apply(null, bytes as any));
const imageData = `data:${file.type};base64,${base64Image}`;

const body = {
  "image": imageData,
  "lang": "ko"
};

const response = await fetch('https://api.imagedescriber.app/api/v1/generate_alt_text', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer {your_api_key}'
  },
  body: JSON.stringify(body),
});

const result = await response.json();
console.log('생성된 설명:', result.data.alt_text.description);
console.log('생성된 대체 텍스트:', result.data.alt_text.alt);

응답

응답 본문 (JSON 응답)

이미지용 대체 텍스트 생성기는 상세한 설명과 대체 텍스트 옵션 배열을 포함하는 응답을 반환합니다.

{
  "code": 0,
  "message": "success",
  "request_id": "unique_request_id_string",
  "data": {
    "alt_text": {
      "description": "상세 이미지 설명",
      "alt": [
        "alt1",
        "alt2",
        "..."
      ]
    },
    "credits": {
      "amount": "이번 호출에 소모된 크레딧",
      "remaining": "이번 호출 후 남은 총 크레딧"
    }
  }
}

요청 제한

서비스 안정성과 공정성을 보장하기 위해 각 API 키는 **분당 30회 요청(시간당 1800회 요청)**으로 제한됩니다. 이 제한을 초과하는 요청은 오류 코드 1004로 거부됩니다.

크레딧 시스템

이미지 대체 텍스트를 생성하는 성공적인 API 호출마다 1 크레딧이 소모됩니다.
보안 필터에 의해 차단된 콘텐츠는 크레딧을 소모하지 않습니다.
시스템 오류는 크레딧을 소모하지 않습니다.

더 많은 크레딧을 얻는 방법

크레딧 충전 페이지를 방문하여 더 많은 API 호출을 지원하기 위한 크레딧 패키지를 구매할 수 있습니다. 다양한 사용자의 요구를 충족시키기 위해 여러 패키지를 제공합니다.

오류 처리

다음 표는 일반적인 오류 코드, 의미 및 해결 방법을 나열합니다.

이미지 형식 세부 정보

현재 지원되는 이미지 형식은 JPG, JPEG, PNG, WebP입니다. 최대 이미지 크기는 4MB입니다.

대체 텍스트 생성을 위한 모범 사례

고해상도: 더 정확한 이미지용 대체 텍스트 생성기를 위해 선명하고 고해상도 이미지를 사용하십시오.
좋은 조명: 조명이 좋은 이미지는 더 정확하고 설명적인 대체 텍스트를 생성합니다.
명확한 주제: 주제와 객체가 뚜렷한 이미지는 더 관련성 높은 대체 텍스트를 생성합니다.
지원되는 형식: 최적의 결과를 위해 지원되는 형식(JPG, PNG, WebP)을 사용하십시오.

사용 사례 및 통합 예시

SEO 강화

AI 대체 텍스트 생성기 API를 사용하여 웹사이트의 이미지 대체 텍스트를 자동으로 생성하십시오.

// AI 생성 대체 텍스트로 이미지 SEO 강화
const enhanceImageSEO = async (imageElement, apiKey) => {
  const canvas = document.createElement('canvas');
  const ctx = canvas.getContext('2d');
  canvas.width = imageElement.width;
  canvas.height = imageElement.height;
  ctx.drawImage(imageElement, 0, 0);

  const base64Image = canvas.toDataURL('image/jpeg');

  const response = await fetch('/api/v1/generate_alt_text', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${apiKey}`
    },
    body: JSON.stringify({ image: base64Image })
  });

  const result = await response.json();
  const { alt } = result.data.alt_text;

  // SEO 및 접근성을 위해 이미지 alt 속성 업데이트
  if (alt && alt.length > 0) {
    imageElement.alt = alt[0];
  }
};

콘텐츠 관리 통합

이미지용 대체 텍스트 생성기를 CMS 워크플로에 통합하십시오.

# 콘텐츠 관리 시스템에서 이미지 일괄 처리
import os
import requests
from pathlib import Path

def bulk_generate_alt_text(directory_path, api_key):
    """디렉토리의 모든 이미지를 처리하여 대체 텍스트 생성"""
    image_extensions = ['.jpg', '.jpeg', '.png', '.webp']

    for image_path in Path(directory_path).iterdir():
        if image_path.suffix.lower() in image_extensions:
            try:
                # 각 이미지에 대한 대체 텍스트 생성
                result = generate_alt_text(api_key, str(image_path))

                # 메타데이터를 별도 파일에 저장
                metadata_path = image_path.with_suffix('.json')
                with open(metadata_path, 'w') as f:
                    json.dump(result['data']['alt_text'], f, indent=2)

                print(f"처리 완료: {image_path.name}")

            except Exception as e:
                print(f"{image_path.name} 처리 중 오류 발생: {e}")

# 사용법
bulk_generate_alt_text("/path/to/images", "your_api_key")

문의하기

AI 대체 텍스트 생성기 API에 대한 질문이나 제안이 있으시면 다음 방법을 통해 언제든지 문의해 주십시오.

지금 바로 AI 대체 텍스트 생성기 API를 사용하여 자동화된 이미지 접근성과 SEO의 힘을 경험해 보세요!