Skip to main content

AI-powered image analysis

Analyze any image and generate detailed text prompts that describe its content, style, and composition.
Image to Prompt is an AI-powered API that analyzes images and generates descriptive text prompts. Submit any image and receive a detailed text description suitable for use with AI image generation models. The API extracts visual elements, artistic styles, compositions, and contextual details to create prompts that can reproduce or inspire similar images.

​
Key capabilities

  • Automatic image analysis: AI extracts subjects, objects, colors, lighting, and composition from images
  • Prompt-ready output: Generated descriptions formatted for direct use with text-to-image models
  • Flexible input: Accepts images via URL or base64-encoded string
  • Style detection: Identifies artistic styles, photography techniques, and visual aesthetics
  • Detail extraction: Captures fine details including textures, materials, and environmental elements
  • Multi-format support: Works with common image formats (JPEG, PNG, WebP)
  • Async processing: Webhook notifications or polling for task completion

​
Use cases

  • Prompt engineering: Reverse-engineer prompts from reference images to recreate similar styles
  • Image cataloging: Generate searchable text descriptions for image libraries
  • AI workflow automation: Bridge image-to-text pipelines for automated content creation
  • Style transfer preparation: Extract style descriptions for consistent AI image generation
  • Content moderation: Generate text descriptions for image review and classification
  • Accessibility: Create alt-text descriptions for images in web applications

​
Generate prompts with Image to Prompt

Submit an image via URL or base64-encoded string. The service returns a task ID for async polling or webhook notification.

POST /v1/ai/image-to-prompt

Create a new image analysis task

GET /v1/ai/image-to-prompt

List all image-to-prompt tasks

GET /v1/ai/image-to-prompt/{task-id}

Get task status and results by ID

​
Parameters

ParameterTypeRequiredDefaultDescription
imagestringYes-Input image for analysis. Accepts URL or base64-encoded string (e.g., data:image/jpeg;base64,...)
webhook_urlstringNo-URL for task completion notification

​
Response

When the task completes successfully, the response includes:
FieldTypeDescription
task_idstringUnique identifier for the task (UUID format)
statusstringTask status: CREATED, IN_PROGRESS, COMPLETED, or FAILED
generatedarrayArray containing the generated prompt text

​
Frequently Asked Questions

Image to Prompt is an AI-powered API that analyzes images and generates text descriptions suitable for AI image generation. You submit an image (via URL or base64), receive a task ID immediately, then poll for results or receive a webhook notification. The output is a detailed text prompt describing the image content, style, and composition.
Image to Prompt accepts common image formats including JPEG, PNG, and WebP. Images can be provided as publicly accessible URLs or as base64-encoded strings with the appropriate data URI prefix (e.g., data:image/jpeg;base64,...).
The generated prompts capture multiple aspects of the image including subjects, objects, colors, lighting, composition, artistic style, and fine details like textures and materials. The descriptions are formatted for direct use with AI image generation models like Flux, Seedream, or Mystic.
Yes, the prompts generated by Image to Prompt are designed to work with any text-to-image AI model. Use them directly with Freepik API models like Flux, Seedream, or Mystic, or with external image generation services.
Processing time varies based on image complexity and current system load. Typical analysis completes within a few seconds. For production workflows, use webhooks instead of polling to receive instant notifications when processing completes.
Rate limits vary by subscription tier. See Rate Limits for current limits.
See the Pricing page for current rates and subscription options.

​
Best practices

  • Image quality: Higher resolution images with clear subjects produce more detailed and accurate prompts
  • URL accessibility: Ensure image URLs are publicly accessible without authentication
  • Base64 encoding: Include the proper data URI prefix when using base64 (e.g., data:image/jpeg;base64,)
  • Production integration: Use webhooks instead of polling for scalable applications
  • Prompt refinement: Use generated prompts as starting points and refine them for specific use cases
  • Error handling: Implement retry logic with exponential backoff for 503 errors
  • Improve Prompt: Enhance and refine text prompts for better AI generation results
  • Flux Kontext Pro: Generate images from text prompts with advanced context understanding
  • Seedream 4: High-quality text-to-image generation with detailed prompt support
  • Mystic: Freepik’s flagship image generation model with style customization