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": "この画像のすべての要素、色、構図を詳細に説明してください"
  }'