AI 이미지 설명 API
AI 기술을 사용하여 이미지 콘텐츠 설명
AI 이미지 설명 API를 사용하면 고급 AI 기술로 이미지 콘텐츠를 설명할 수 있습니다. 이 엔드포인트는 이미지를 처리하고 상세한 텍스트 설명을 반환합니다. AI Describe Picture의 강력한 AI 이미지 설명 기능을 경험해보세요.
엔드포인트
인증
Authorization 헤더에 유효한 API 키가 필요합니다:
요청
헤더
Header | Required | Description |
---|---|---|
Content-Type | Yes | application/json 이어야 합니다 |
Authorization | Yes | Bearer YOUR_API_KEY 형식의 API 키 |
본문 매개변수
Parameter | Type | Required | Description |
---|---|---|---|
imageUrl | string | Yes | 설명할 이미지의 URL (공개적으로 접근 가능해야 함) |
prompt | string | No | 사용자 정의 프롬프트 (선택사항) |
요청 예시
응답
성공 응답 (200)
API는 choices 배열을 포함한 이미지 설명 JSON 객체를 반환합니다.
설명:
choices
배열에는 AI 생성 설명 콘텐츠가 포함되며, 각 choice에는 완전한 메시지 객체가 포함됩니다message.content
필드에는 실제 이미지 설명 텍스트가 포함됩니다- 응답 형식은 OpenAI API와 호환됩니다
오류 응답
400 Bad Request
401 Unauthorized
402 Payment Required
500 Internal Server Error
사용 제한
- 크레딧 소비: 설명 1회당 1크레딧
- 이미지 요구사항: JPG, PNG, WebP 형식 지원, 최대 5MB
사용 예시
JavaScript/Node.js
cURL
이미지 요구사항
- 형식: JPG, PNG, WebP
- 크기: 최대 5MB
- 접근성: 이미지 URL은 공개적으로 접근 가능해야 합니다
- 콘텐츠: 유효한 이미지 파일이어야 합니다
처리 시간
- 일반적: 10-30초
- 큰 이미지: 최대 60초까지 걸릴 수 있습니다
크레딧
- 비용: 설명 1회당 1크레딧
- 공제: 처리 성공 시 크레딧이 공제됩니다
모범 사례
- 이미지 품질: 더 나은 결과를 위해 고품질 이미지 사용
- 오류 처리: 항상 적절한 오류 처리 구현
- 크레딧 관리: 크레딧 잔액을 정기적으로 모니터링
- 프롬프트: 더 정확한 설명을 위해 구체적인 프롬프트 사용
문제 해결
일반적인 문제
401 Unauthorized
- API 키가 올바른지 확인
- API 키가 활성화되어 있고 만료되지 않았는지 확인
402 Payment Required
- 계정에 크레딧 추가
- 현재 크레딧 잔액 확인
400 Bad Request
- imageUrl이 유효하고 접근 가능한 URL인지 확인
- 이미지 형식이 지원되는지 확인
500 Internal Server Error
- 서버 내부 오류, 나중에 다시 시도해주세요
- 이미지 URL이 접근 가능한지 확인
지원
여기서 다루지 않은 문제가 발생하면 지원팀에 문의해주세요.