문서

AI 이미지 설명 API

AI 기술을 사용하여 이미지 콘텐츠 설명

AI 이미지 설명 API를 사용하면 고급 AI 기술로 이미지 콘텐츠를 설명할 수 있습니다. 이 엔드포인트는 이미지를 처리하고 상세한 텍스트 설명을 반환합니다. AI Describe Picture의 강력한 AI 이미지 설명 기능을 경험해보세요.

엔드포인트

POST /api/api-call/describe-picture

인증

Authorization 헤더에 유효한 API 키가 필요합니다:

Authorization: Bearer YOUR_API_KEY

요청

헤더

HeaderRequiredDescription
Content-TypeYesapplication/json이어야 합니다
AuthorizationYesBearer YOUR_API_KEY 형식의 API 키

본문 매개변수

ParameterTypeRequiredDescription
imageUrlstringYes설명할 이미지의 URL (공개적으로 접근 가능해야 함)
promptstringNo사용자 정의 프롬프트 (선택사항)

요청 예시

{
  "imageUrl": "https://example.com/image.jpg",
  "prompt": "이 이미지의 모든 요소, 색상, 구도를 자세히 설명하세요"
}

응답

성공 응답 (200)

API는 choices 배열을 포함한 이미지 설명 JSON 객체를 반환합니다.

{
  "choices": [
    {
      "logprobs": null,
      "finish_reason": "stop",
      "native_finish_reason": "STOP",
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "이미지는 카메라를 향해 서 있는 빨간 여우의 클로즈업을 보여줍니다. 여우는 푹신한 주황색과 흰색 털을 가지고 있으며, 똑바로 선 귀와 빛나는 갈색 눈을 가지고 있습니다. 배경은 흐릿하며, 아마도 눈이 쌓인 들판이나 밝은 환경일 것입니다.",
        "refusal": null,
        "reasoning": null
      }
    }
  ]
}

설명:

  • choices 배열에는 AI 생성 설명 콘텐츠가 포함되며, 각 choice에는 완전한 메시지 객체가 포함됩니다
  • message.content 필드에는 실제 이미지 설명 텍스트가 포함됩니다
  • 응답 형식은 OpenAI API와 호환됩니다

오류 응답

400 Bad Request

{
  "message": "Invalid input"
}

401 Unauthorized

{
  "message": "Invalid or expired API key"
}

402 Payment Required

{
  "message": "Insufficient credits"
}

500 Internal Server Error

{
  "message": "Service error"
}

사용 제한

  • 크레딧 소비: 설명 1회당 1크레딧
  • 이미지 요구사항: JPG, PNG, WebP 형식 지원, 최대 5MB

사용 예시

JavaScript/Node.js

async function describeImage(imageUrl, apiKey, prompt = null) {
  try {
    const response = await fetch('https://aidescribepicture.com/api/api-call/describe-picture', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': `Bearer ${apiKey}`
      },
      body: JSON.stringify({
        imageUrl: imageUrl,
        prompt: prompt
      })
    });
 
    if (!response.ok) {
      const error = await response.text();
      throw new Error(`API Error: ${response.status} - ${error}`);
    }
 
    const result = await response.json();
    
    // 설명 콘텐츠 추출
    const description = result.choices[0].message.content;
    return description;
  } catch (error) {
    console.error('Error describing image:', error);
    throw error;
  }
}
 
// 사용 예시
const description = await describeImage(
  'https://example.com/image.jpg',
  'your-api-key-here',
  '이 이미지를 자세히 설명하세요'
);
console.log('Image description:', description);

cURL

curl -X POST https://aidescribepicture.com/api/api-call/describe-picture \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "imageUrl": "https://example.com/image.jpg",
    "prompt": "이 이미지의 모든 요소, 색상, 구도를 자세히 설명하세요"
  }'

이미지 요구사항

  • 형식: JPG, PNG, WebP
  • 크기: 최대 5MB
  • 접근성: 이미지 URL은 공개적으로 접근 가능해야 합니다
  • 콘텐츠: 유효한 이미지 파일이어야 합니다

처리 시간

  • 일반적: 10-30초
  • 큰 이미지: 최대 60초까지 걸릴 수 있습니다

크레딧

  • 비용: 설명 1회당 1크레딧
  • 공제: 처리 성공 시 크레딧이 공제됩니다

모범 사례

  1. 이미지 품질: 더 나은 결과를 위해 고품질 이미지 사용
  2. 오류 처리: 항상 적절한 오류 처리 구현
  3. 크레딧 관리: 크레딧 잔액을 정기적으로 모니터링
  4. 프롬프트: 더 정확한 설명을 위해 구체적인 프롬프트 사용

문제 해결

일반적인 문제

401 Unauthorized

  • API 키가 올바른지 확인
  • API 키가 활성화되어 있고 만료되지 않았는지 확인

402 Payment Required

  • 계정에 크레딧 추가
  • 현재 크레딧 잔액 확인

400 Bad Request

  • imageUrl이 유효하고 접근 가능한 URL인지 확인
  • 이미지 형식이 지원되는지 확인

500 Internal Server Error

  • 서버 내부 오류, 나중에 다시 시도해주세요
  • 이미지 URL이 접근 가능한지 확인

지원

여기서 다루지 않은 문제가 발생하면 지원팀에 문의해주세요.