Official SDKs

1import { CardSightAI, getFieldValue } from 'cardsightai';
2
3// Initialize the client
4const client = new CardSightAI({ apiKey: 'your_api_key_here' });
5
6// Identify a card from an image
7const imageFile = // File, Blob, Buffer, or ArrayBuffer
8const result = await client.identify.card(imageFile);
9
10// Access identification results
11if (result.data?.success) {
12  const detection = result.data.detections?.[0];
13  if (detection?.card) {
14    console.log(`Card: ${detection.card.name}`);
15    console.log(`Confidence: ${detection.confidence}`);
16    console.log(`Total cards detected: ${result.data.detections.length}`);
17
18    // Pokemon, One Piece, and Magic detections report the printed
19    // language as an ISO 639-1 code; undefined on sports cards
20    console.log(getFieldValue(detection, 'CARD_LANGUAGE')); // "ja"
21  }
22}
23
24// Response structure for multiple cards:
25// {
26//   success: true,
27//   requestId: "req_xyz789",
28//   detections: [
29//     {
30//       confidence: "High",
31//       card: {
32//         /* Card details */
33//         fields: [{ key: "CARD_LANGUAGE", value: "ja" }]  // TCG only
34//       }
35//     }
36//   ],
37//   processingTime: 287
38// }