AI 이미지 설명 API

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

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

엔드포인트

POST /api/api-call/describe-picture

인증

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

Authorization: Bearer YOUR_API_KEY

요청

헤더

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	사용자 정의 프롬프트 (선택사항)

요청 예시

{
  "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": "이 이미지의 모든 요소, 색상, 구도를 자세히 설명하세요"
  }'