Skip to main content
Generate a detailed text description of an image using /describe

​
Endpoint

POST https://api.legnext.ai/api/v1/describe

​
Headers

HeaderTypeRequiredDescription
x-api-keystringYesYour API key

​
Request Body

ParameterTypeRequiredDescription
imageBase64stringEither/OrBase64-encoded image string (format: data:image/xxx;base64,...)
imageLinkstringEither/OrURL link to the image
callbackstringNoCallback URL for task completion notifications
Note: Either imageBase64 or imageLink must be provided (not both).

​
Example Request

curl -X POST "https://api.legnext.ai/api/v1/describe" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "imageBase64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgA...",
    "callback": "https://webhook.site/your-webhook-id"
  }'

​
Response

Returns a task object containing the task information. 
{
    "job_id": "de3948a8-6df8-43dd-9739-d689ed480162",
    "model": "midjourney",
    "task_type": "describe",
    "status": "completed",
    "config": {
        "service_mode": "public",
        "webhook_config": {
            "endpoint": "https://webhook.site/c98cb890-fb92-439f-8d60-42c8a51eb52d",
            "secret": ""
        }
    },
    "input": null,
    "output": {
        "promptEn": "1️⃣ a cute, smiling punk girl with blue hair, in the style of chibi characters, has large eyes and a black background. she has purple ombre, shoulder-length hair, big, round, silver, glittery earrings, and is wearing a polka dot dress, drawn as an anime character with bold outlines. her outfit includes flowy patterned sleeves, and she wears heavy makeup. the overall mood should be cheerful and playful, with soft lighting that highlights her features and creates a vibrant contrast against the dark backdrop. --ar 3:4\n\n2️⃣ chibi drawing of a cute punk woman with blue hair, against a black background, wearing  in the style of flcl, with big eyes and pale skin, a punk rock aesthetic, a black shirt with light pink dots, and a tattoo in the shape of an \"x\" over her left eye, smiling. --ar 3:4\n\n3️⃣ chibi, a random blue-haired girl, against a black background, in a pixel art style. she has a cute face with large eyes and a smiling mouth, wearing a goth outfit, with small white dots on the . --ar 3:4\n\n4️⃣ chibi, a random person smiling at the camera, with blue hair and purple highlights, against a black background, wearing goth-style , including a black and white polka-dot dress. the character has big eyes, pale skin, red blush, and pink lips, in a cartoon-style, vector art format with low-saturation colors. --ar 3:4",
        "description": "/describe 1760035168840559.png",
        "finalPrompt": "1️⃣ a cute, smiling punk girl with blue hair, in the style of chibi characters, has large eyes and a black background. she has purple ombre, shoulder-length hair, big, round, silver, glittery earrings, and is wearing a polka dot dress, drawn as an anime character with bold outlines. her outfit includes flowy patterned sleeves, and she wears heavy makeup. the overall mood should be cheerful and playful, with soft lighting that highlights her features and creates a vibrant contrast against the dark backdrop. --ar 3:4\n\n2️⃣ chibi drawing of a cute punk woman with blue hair, against a black background, wearing  in the style of flcl, with big eyes and pale skin, a punk rock aesthetic, a black shirt with light pink dots, and a tattoo in the shape of an \"x\" over her left eye, smiling. --ar 3:4\n\n3️⃣ chibi, a random blue-haired girl, against a black background, in a pixel art style. she has a cute face with large eyes and a smiling mouth, wearing a goth outfit, with small white dots on the . --ar 3:4\n\n4️⃣ chibi, a random person smiling at the camera, with blue hair and purple highlights, against a black background, wearing goth-style , including a black and white polka-dot dress. the character has big eyes, pale skin, red blush, and pink lips, in a cartoon-style, vector art format with low-saturation colors. --ar 3:4",
        "prompts": [
            "a cute, smiling punk girl with blue hair, in the style of chibi characters, has large eyes and a black background. she has purple ombre, shoulder-length hair, big, round, silver, glittery earrings, and is wearing a polka dot dress, drawn as an anime character with bold outlines. her outfit includes flowy patterned sleeves, and she wears heavy makeup. the overall mood should be cheerful and playful, with soft lighting that highlights her features and creates a vibrant contrast against the dark backdrop. --ar 3:4",
            "chibi drawing of a cute punk woman with blue hair, against a black background, wearing  in the style of flcl, with big eyes and pale skin, a punk rock aesthetic, a black shirt with light pink dots, and a tattoo in the shape of an \"x\" over her left eye, smiling. --ar 3:4",
            "chibi, a random blue-haired girl, against a black background, in a pixel art style. she has a cute face with large eyes and a smiling mouth, wearing a goth outfit, with small white dots on the . --ar 3:4",
            "chibi, a random person smiling at the camera, with blue hair and purple highlights, against a black background, wearing goth-style , including a black and white polka-dot dress. the character has big eyes, pale skin, red blush, and pink lips, in a cartoon-style, vector art format with low-saturation colors. --ar 3:4"
        ]
    },
    "meta": {
        "created_at": "2025-10-09T18:41:42Z",
        "started_at": "2025-10-09T18:41:44Z",
        "ended_at": "2025-10-09T18:42:03Z",
        "usage": {
            "type": "point",
            "frozen": 40,
            "consume": 40
        }
    },
    "detail": null,
    "logs": [],
    "error": {
        "code": 0,
        "raw_message": "",
        "message": "",
        "detail": null
    }
}
⌘I