Pokémon Card Image Reader API – Identify Card from Photo

Upload a Pokémon TCG card image and instantly get the exact card, variants, and confidence score in a clean JSON response.

原始信息汇总

Pokémon Card Image Reader API – Identify Card from Photo 数据集概述

基本信息

• API名称：Pokémon Card Image Reader API – Identify Card from Photo
• 类别：Visual Recognition
• 提供商：SolidAPI
• 版本：v1 (current)
• 端点：POST /
• 主要功能：通过图像识别宝可梦集换式卡牌（Pokémon TCG），并返回精确的卡牌信息、所有匹配的变体以及置信度分数。

性能指标

• 流行度：0
• 服务等级：90%
• 延迟：236ms
• 测试通过率：100%

订阅计划与定价

• BASIC：$0.00 / 月
• PRO：$8.99 / 月
• ULTRA：$29.99 / 月
• MEGA：$99.99 / 月

功能描述

• 从图像中检测宝可梦集换式卡牌。
• 返回置信度等级（高/中 + 数值概率）。
• 提供卡牌变体信息（系列、编号、HP、图像等）。
• 高亮显示一个主要的、最佳匹配项，便于在应用程序中使用。
• 底层技术使用Google Vision OCR和匹配算法，并结合宝可梦卡牌数据库，将卡牌上的文本与真实的TCG条目进行匹配。

适用场景

• 为市场或列表工具从照片自动填充卡牌详情。
• 构建通过摄像头扫描卡牌的宝可梦集换式卡牌收藏追踪器。
• 集成到评级或真实性辅助工作流中。
• 为需要自动检测确切卡牌和系列的价格/价值应用程序提供支持。

输入要求

• 方法：POST
• 支持的输入方式：
  1. JSON Body（推荐用于RapidAPI）：Content-Type: application/json，Body包含 imageUrl 字段。
  2. 查询参数：?imageUrl=<图片URL>。
  3. 表单数据（带URL）：Content-Type: application/x-www-form-urlencoded 或 multipart/form-data，字段名为 imageUrl。
  4. 直接文件上传：Content-Type: multipart/form-data，字段名为 image。
• 图像要求：
  • 支持格式：JPG/JPEG, PNG, WEBP, HEIC
  • 最大文件大小：10MB
  • URL图像：必须仅为HTTPS

认证方式

通过RapidAPI标准请求头：

• X-RapidAPI-Key – 您的RapidAPI密钥
• X-RapidAPI-Host – RapidAPI上的API主机名

响应结构

json { "success": true, "confidence": "high", "card": { "name": "Charizard", "matchedCards": 3, "variants": [ { "id": "xy12-11", "name": "Charizard", "number": "11", "set": { "id": "xy12", "name": "Evolutions" }, "hp": "150", "images": { "small": "…", "large": "…" } } ], "primary": { /* 最佳匹配变体 */ } }, "metadata": { "totalVariantsInDatabase": 12, "confidence": 0.95 } }

• 关键字段：
  • card.primary – 检测到的最佳卡牌变体（在应用中使用此项）。
  • card.variants[] – 所有匹配的变体。
  • metadata.confidence – 数值概率（0–1）。

错误处理

API返回带有HTTP状态码的结构化错误：

• 400 – NO_IMAGE – 未提供图像或imageUrl
• 400 – INVALID_IMAGE_URL – 无法从提供的URL获取图像
• 400 – INVALID_FORMAT – 不支持的文件类型（仅限JPG, PNG, WEBP, HEIC）
• 413 – FILE_TOO_LARGE – 文件超过10MB
• 404 – CARD_NOT_RECOGNIZED – 在图像中未找到匹配的宝可梦卡牌
• 500 – INTERNAL_ERROR – 意外的服务器错误

错误响应格式： json { "success": false, "error": { "code": "INVALID_IMAGE_URL", "message": "Failed to fetch image from provided URL" } }

最佳实践建议

• 拍摄正面、清晰的照片。
• 确保卡牌文字清晰可读。
• 每张图像只包含一张卡牌。
• 使用URL时，确保其为HTTPS。

搜集汇总

背景与挑战

背景概述

该数据集提供了一个API服务，能够通过上传的宝可梦交易卡牌图片，准确识别出对应的具体卡片及其变体，并以JSON格式返回包含置信度评分的清晰结果。