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	您的API密鑰，格式為 `Bearer YOUR_API_KEY`

請求體參數

Parameter	Type	Required	Description
`imageUrl`	string	Yes	要描述的圖片URL（必須是公開可訪問的）
`prompt`	string	No	自定義提示詞（可選）

請求示例

{
  "imageUrl": "https://example.com/image.jpg",
  "prompt": "詳細描述這張圖片中的所有元素、顏色和構圖"
}

響應

成功響應 (200)

API 返回包含圖片描述的 JSON 對象，包含 choices 數組。

{
  "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 積分
圖片要求: 支持 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": "詳細描述這張圖片中的所有元素、顏色和構圖"
  }'