Image Describer API 문서 - AI 이미지 설명 생성

개요

Image Describer API는 제공된 이미지와 프롬프트를 기반으로 정확하고 상세하며 통찰력 있는 이미지 설명을 지능적으로 생성하는 강력한 이미지 설명 생성 도구입니다. 이 AI 기반 이미지 인식 API는 이미지 콘텐츠를 이해하고 분석하여 프롬프트에 따라 해당 텍스트 설명을 생성합니다. 이미지 이해, 이미지 분석, 이미지 콘텐츠 생성과 관련된 다양한 시나리오에 널리 적용할 수 있어 이미지 질문 응답 및 이미지-텍스트 변환을 쉽게 구현할 수 있습니다.

애플리케이션 시나리오

Image Describer API는 다음 영역에서 이미지 이해 및 콘텐츠 생성을 효율적으로 수행하는 데 도움이 될 수 있습니다.

• 데이터 차트 분석: 차트 데이터를 자동으로 해석하고 통계 분석 보고서를 생성합니다.
• 예술 작품 평가: 예술 작품에 대한 전문적인 평가 및 해석을 제공합니다.
• 블로그 게시물 생성: 이미지를 기반으로 단락 또는 전체 기사를 생성합니다.
• 객체 인식: 이미지에서 객체를 식별하고 객체 이름, 속성 및 잠재적 용도와 같은 자세한 정보를 제공합니다.
• 이미지 질문 응답: "사진에 무엇이 있나요?" 또는 "이 사람은 무엇을 하고 있나요?"와 같은 질문을 통해 이미지 콘텐츠에 대한 자세한 정보를 얻습니다.
• 교육 애플리케이션: 식물 및 동물 이미지 식별, 역사적 사진 설명 등 교육을 지원합니다.
• 전자 상거래: 제품 설명을 자동으로 생성하여 제품 정보의 풍부함을 향상시킵니다.

API 키

Image Describer API에 액세스하려면 먼저 유효한 API 키를 발급받아야 합니다. 이 키는 요청을 인증하고 API에 대한 안전한 액세스를 보장하는 데 사용됩니다.

API 키 발급

1. API 키 관리 페이지에 액세스: 시스템에 로그인한 다음 오른쪽 상단 모서리에 있는 사용자 아바타를 클릭합니다. 드롭다운 메뉴에서 "API 신청"을 클릭하여 API 키 관리 페이지를 엽니다.
2. 새 키 생성: "새 키 생성"을 클릭하고 팝업 대화 상자에 키 이름을 입력한 다음 "생성"을 클릭합니다.
3. 키 복사 및 저장: 키는 한 번만 전체가 표시됩니다. 복사 아이콘을 클릭하여 키를 클립보드에 복사한 다음 "확인"을 클릭하여 대화 상자를 닫습니다.

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

API 엔드포인트

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

요청 매개변수

요청 헤더

요청 본문

{
  "image": "data:image/jpeg;base64,{image_base64_data}",
  "prompt": "이 물체는 무엇입니까? 가능한 용도를 설명하십시오.",
  "lang": "ko"
}

지원되는 언어

요청 예시 (cURL)

curl --location 'https://api.imagedescriber.app/api/v1/generate_content' \
--header 'content-type: application/json' \
--header 'authorization: Bearer your_api_key' \
--data '{
    "image":"data:image/jpeg;base64,/9j/4AAQSkZJRgABAQE...",
    "prompt":"이 물체는 무엇입니까? 가능한 용도를 설명하십시오.",
    "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_image_description(api_key, image_path, prompt, lang="ko"):
  """Image Describer API를 사용하여 이미지 설명 생성"""
  url = "https://api.imagedescriber.app/api/v1/generate_content"
  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}",
      "prompt": prompt,
      "lang": lang
  }

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

  if response.status_code == 200:
      result = response.json()
      print(result["data"]["content"])
  else:
    print(f"오류: {response.status_code}")
    print(response.text)

# 사용 예시
api_key = "your_api_key"
image_path = "your_image.jpg"
prompt = "이 물체는 무엇입니까? 가능한 용도를 설명하십시오."

generate_image_description(api_key, image_path, prompt, lang="ko")

요청 예시 (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 또는 drop 이벤트의 파일 */;
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,
  "prompt": "이미지를 자세히 설명해 주세요",
  "lang": "ko"
};

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

const result = await response.json();
console.log(result);

응답

응답 본문 (JSON 응답)

이제 API는 전체 응답을 단일 JSON 객체로 반환합니다. data 객체 내의 content 필드에는 생성된 이미지 설명이 Markdown 형식으로 포함됩니다.

{
  "code": 0,
  "message": "성공",
  "request_id": "고유 요청 ID 문자열",
  "data": {
    "content": "Markdown 형식으로 생성된 콘텐츠"
  }
}

요청 제한

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

크레딧 시스템

• API 호출이 성공할 때마다 1 크레딧이 소비됩니다.
• 보안 필터에 의해 차단된 콘텐츠는 크레딧을 소비하지 않습니다.
• 시스템 오류는 크레딧을 소비하지 않습니다.

크레딧을 더 얻는 방법은 무엇입니까?

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

오류 처리

다음 표에는 일반적인 오류 코드, 그 의미 및 해결 방법이 나열되어 있습니다.

문의하기

질문이나 제안 사항이 있으면 다음 방법을 통해 언제든지 문의해 주십시오.

• 이메일: [email protected]
• 기술 지원: 고객 지원팀

지금 Image Describer API 사용을 시작하고 이미지 이해의 무한한 가능성을 열어보십시오!