API
Image Tagging
POST /api/ai/tag — classify or tag an image using AI
Image Tagging
Classify an image or generate tags using a custom prompt.
SDK equivalent: sdk.tag() — see Vision SDK
Endpoint
POST /api/ai/tagRequest
curl -X POST https://lab.coreviz.io/api/ai/tag \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"image": "https://example.com/photo.jpg",
"prompt": "What type of vehicle is this?",
"options": ["car", "truck", "motorcycle"],
"multiple": false
}'Request Body
| Field | Type | Required | Description |
|---|---|---|---|
image | string | Yes | Image URL or base64 data URI |
prompt | string | Yes | Classification question or tagging context |
options | string[] | No | Constrained list of valid tag values |
multiple | boolean | No | Allow multiple tags (default: true) |
Response
{
"tags": ["car"],
"raw": { ... }
}| Field | Type | Description |
|---|---|---|
tags | string[] | Selected tags or classifications |
raw | object | Raw model response |