Ideogram - Image to Prompt

Generate a descriptive text prompt from an image using Ideogram's Describe endpoint. Useful for reverse-engineering prompts, captioning, or feeding the output back into an image generator.

Endpoint

POSThttps://api.1min.ai/api/features

Request Headers

Field	Value
API-KEY	<api-key>
Content-Type	application/json

Parameters

Parameter	Type	Required	Description
type	string	Yes	Feature type identifier. Must be IMAGE_TO_PROMPT
model	string	Yes	AI model identifier. Must be ideogram-3
promptObject	object	Yes	Configuration object containing the describe parameters

Prompt Object Parameters

Parameter	Type	Required	Description	Default
imageUrl	string	Yes	Asset path to the image to describe	-

Image Requirements

• Per-file maximum size: 10 MB
• Formats: JPEG, PNG, WebP

Code Examples

cURL

curl --location 'https://api.1min.ai/api/features' \
--header 'API-KEY: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"type": "IMAGE_TO_PROMPT",
"model": "ideogram-3",
"promptObject": {
  "imageUrl": "development/images/cat_on_couch.png"
}
}'

JavaScript

fetch('https://api.1min.ai/api/features', {
method: 'POST',
headers: {
  'Content-Type': 'application/json',
  'API-KEY': 'YOUR_API_KEY'
},
body: JSON.stringify({
  type: 'IMAGE_TO_PROMPT',
  model: 'ideogram-3',
  promptObject: {
    imageUrl: 'development/images/cat_on_couch.png'
  }
})
})

Python

import requests

url = "https://api.1min.ai/api/features"
headers = {
"Content-Type": "application/json",
"API-KEY": "YOUR_API_KEY"
}

data = {
"type": "IMAGE_TO_PROMPT",
"model": "ideogram-3",
"promptObject": {
  "imageUrl": "development/images/cat_on_couch.png"
}
}

response = requests.post(url, headers=headers, json=data)

Interactive Playground

API Playground

GETPOSTPUTDELETEhttps://api.1min.ai/api/features

AI Model *Ideogram 3.0

Source Image *

Asset path to the image to describe

Generated cURL Command:

curl -X POST "https://api.1min.ai/api/features" \
  -H "API-KEY: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "IMAGE_TO_PROMPT",
  "model": "ideogram-3",
  "promptObject": {
    "imageUrl": "development/images/cat_on_couch.png"
  }
}'

Response Format

{
"aiRecord": {
  "uuid": "e40dd9ef-0944-4ce5-bc90-1edd2548619a",
  "model": "ideogram-3",
  "type": "IMAGE_TO_PROMPT",
  "status": "SUCCESS",
  "aiRecordDetail": {
    "promptObject": {
      "imageUrl": "development/images/cat_on_couch.png"
    },
    "resultObject": [
      "A cute orange cat sitting on a white couch."
    ],
    "responseObject": {
      "descriptions": [
        {
          "text": "A cute orange cat sitting on a white couch."
        }
      ]
    }
  }
}
}