Identify an item from a photo without adding it to inventory. Returns detailed product information using GPT-4 Vision.
| Parameter | Type | Required | Description |
|---|---|---|---|
photo_url | string | No* | URL to the item photo |
photo_base64 | string | No* | Base64 encoded photo |
photo_url or photo_base64.{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "identify_item",
"arguments": {
"photo_url": "https://example.com/photos/unknown-appliance.jpg"
}
}
}
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "identify_item",
"arguments": {
"photo_base64": "/9j/4AAQSkZJRgABAQEASABIAAD..."
}
}
}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"content": [
{
"type": "text",
"text": "{\"name\":\"Dyson V15 Detect Cordless Vacuum\",\"category\":\"Appliance\",\"brand\":\"Dyson\",\"model\":\"V15 Detect\",\"estimated_value\":\"$749\",\"description\":\"High-end cordless stick vacuum with laser dust detection, LCD screen showing particle counts, and up to 60 minutes of runtime. Features HEPA filtration and multiple cleaning heads.\",\"purchase_links\":[\"Dyson V15 Detect cordless vacuum\",\"Dyson V15 Detect best price\",\"Dyson V15 Detect Amazon\"],\"confidence\":0.85}"
}
]
}
}
{
"name": "Dyson V15 Detect Cordless Vacuum",
"category": "Appliance",
"brand": "Dyson",
"model": "V15 Detect",
"estimated_value": "$749",
"description": "High-end cordless stick vacuum with laser dust detection, LCD screen showing particle counts, and up to 60 minutes of runtime. Features HEPA filtration and multiple cleaning heads.",
"purchase_links": [
"Dyson V15 Detect cordless vacuum",
"Dyson V15 Detect best price",
"Dyson V15 Detect Amazon"
],
"confidence": 0.85
}
| Field | Type | Description |
|---|---|---|
name | string | Identified product name |
category | string | null | Item category (Electronics, Appliance, Furniture, Tool, etc.) |
brand | string | null | Manufacturer or brand name |
model | string | null | Specific model number or name |
estimated_value | string | null | Approximate retail price in USD |
description | string | null | Detailed product description |
purchase_links | array | Suggested search terms for finding the item |
confidence | number | Identification confidence score (0-1) |
Items are classified into categories such as:
{
"content": [
{
"type": "text",
"text": "{\"error\": \"Must provide either photo URL or base64 photo\"}"
}
],
"isError": true
}
{
"content": [
{
"type": "text",
"text": "{\"error\": \"Invalid photo URL format\"}"
}
],
"isError": true
}
{
"content": [
{
"type": "text",
"text": "{\"error\": \"Failed to identify item\"}"
}
],
"isError": true
}
{
"content": [
{
"type": "text",
"text": "{\"error\": \"AI identification not configured\"}"
}
],
"isError": true
}
| Feature | identify_item | add_item |
|---|---|---|
| Adds to inventory | No | Yes |
| Requires property_id | No | Yes |
| Returns estimated value | Yes | No |
| Returns purchase links | Yes | No |
| Returns description | Yes | No |
| AI model used | GPT-4o | GPT-4o-mini |
Use identify_item when you want detailed product information without saving. Use add_item when you want to add the item to your inventory.