Generate Metadata from Image File

POST

/api/v1/photo

This endpoint accepts an image as File and returns automatically generated metadata, including tags, color palettes, a title, and a description.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params multipart/form-data

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/v1/photo' \
--form 'image=@""' \
--form 'config="{
    \"tagConfig\": {
        \"allowOnlySingleWord\": false,
        \"hasTagCountLimits\": true,
        \"minTagCount\": 1,
        \"maxTagCount\": 10
    },
    \"metadataConfig\": {
        \"generateTitle\": true,
        \"maxTitleWords\": 10,
        \"generateColors\": false,
        \"generateDescription\": true,
        \"maxDescriptionWords\": 10,
        \"minDescriptionWords\": 1
    }
}"'

Responses

🟢200OK

application/json

Body

Example

{
    "success": true,
    "data": {
        "description": "string",
        "tags": [
            "string"
        ],
        "title": "string",
        "colors": [
            "string"
        ]
    }
}

Modified at 2025-06-11 03:21:34

Generate Metadata from Image URL