AI 图片描述 API
使用AI技术描述图片内容
AI 图片描述 API 允许您使用先进的AI技术来描述图片内容。此端点处理图像并返回详细的文字描述。体验 AI Describe Picture 的强大AI图片描述功能。
端点
认证
需要在 Authorization 头部提供有效的 API 密钥:
请求
头部
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 | 自定义提示词(可选) |
请求示例
响应
成功响应 (200)
API 返回包含图片描述的 JSON 对象,包含 choices 数组。
说明:
choices
数组包含AI生成的描述内容,每个choice包含完整的消息对象message.content
字段包含实际的图片描述文本- 响应格式与OpenAI API兼容
错误响应
400 Bad Request
401 Unauthorized
402 Payment Required
500 Internal Server Error
使用限制
- 积分消耗: 每次描述消耗 1 积分
- 图片要求: 支持 JPG、PNG、WebP 格式,最大 5MB
使用示例
JavaScript/Node.js
cURL
图片要求
- 格式: JPG、PNG、WebP
- 大小: 最大 5MB
- 可访问性: 图片URL必须是公开可访问的
- 内容: 必须是有效的图片文件
处理时间
- 典型: 10-30 秒
- 大图片: 可能需要 60 秒
积分
- 成本: 每次描述消耗 1 积分
- 扣除: 积分在处理成功后扣除
最佳实践
- 图片质量: 使用高质量图片以获得更好的结果
- 错误处理: 始终实现适当的错误处理
- 积分管理: 定期监控您的积分余额
- 提示词: 使用具体的提示词可以获得更精确的描述
故障排除
常见问题
401 Unauthorized
- 检查您的API密钥是否正确
- 确保API密钥是活跃的且未过期
402 Payment Required
- 为您的账户添加积分
- 检查您当前的积分余额
400 Bad Request
- 验证 imageUrl 是有效的、可访问的URL
- 确保图片格式受支持
500 Internal Server Error
- 服务器内部错误,请稍后重试
- 检查图片URL是否可访问
支持
如果您遇到本文档未涵盖的问题,请联系我们的支持团队。