Minicpm V Image

Minicpm V Image

Playground

Try it on WavespeedAI!

MiniCPM-V 4.5 is the latest, most capable MiniCPM-V image model for accurate AI image understanding and analysis across visual tasks. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

MiniCPM-V Image

MiniCPM-V Image is an efficient AI-powered image understanding model that analyzes and describes images based on your prompts. Upload an image, choose a preset or write a custom prompt, and get detailed descriptions, analysis, or answers about the visual content.


Why It Stands Out

  • Image understanding: Analyzes visual content and provides detailed descriptions.
  • Preset prompts: Quick access to common tasks like “describe” for instant use.
  • Custom prompts: Ask specific questions or request particular analysis.
  • Ultra-affordable: High-quality image understanding at just $0.005 per image.
  • Reproducibility: Use the seed parameter to recreate exact results.

Parameters

ParameterRequiredDescription
imageYesImage to analyze (upload or public URL).
preset_promptNoPreset task: describe, etc. (default: describe).
custom_promptNoCustom question or instruction about the image.
seedNoSet for reproducibility; -1 for random.

How to Use

  1. Upload your image — drag and drop a file or paste a public URL.
  2. Select a preset prompt — choose “describe” or other presets for quick analysis.
  3. Or write a custom prompt — ask specific questions about the image.
  4. Click Run and receive the analysis.

Example Use Cases

Using preset “describe”:

  • Get a detailed description of the image content, subjects, and scene.

Using custom prompts:

  • “What objects are in this image?”
  • “Describe the mood and atmosphere of this photo.”
  • “What text is visible in this image?”
  • “Count the number of people in this photo.”
  • “What is the main subject doing?”

Best Use Cases

  • Image Captioning — Generate descriptions for images in your content.
  • Content Analysis — Understand and categorize visual content at scale.
  • Accessibility — Create alt text and descriptions for visually impaired users.
  • Data Extraction — Extract information from images like text, objects, or scenes.
  • Quality Control — Analyze images for specific attributes or content.

Pricing

OutputPrice
Per image$0.005

Pro Tips for Best Quality

  • Use preset prompts for common tasks like general description.
  • Write specific custom prompts when you need particular information.
  • For OCR-style tasks, ask directly: “What text is in this image?”
  • Combine with other models for workflows like image-to-text-to-video.

Notes

  • Ensure uploaded image URLs are publicly accessible.
  • Processing time varies based on current queue load.
  • Please ensure your content complies with usage guidelines.

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result


# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/minicpm-v/image" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "preset_prompt": "describe",
    "seed": -1,
    "enable_sync_mode": false
}'

# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v3/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"

Parameters

Task Submission Parameters

Request Parameters

ParameterTypeRequiredDefaultRangeDescription
imagestringYes-Image to be analyzed.
preset_promptstringNodescribedescribe, captionPreset prompt for image analysis.
custom_promptstringNo--Custom prompt for image analysis.
seedintegerNo-1-1 ~ 2147483647The random seed to use for the generation.
enable_sync_modebooleanNofalse-If set to true, the function will wait for the result to be generated and uploaded before returning the response. It allows you to get the result directly in the response. This property is only available through the API.

Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
data.idstringUnique identifier for the prediction, Task Id
data.modelstringModel ID used for the prediction
data.outputsarrayArray of URLs to the generated content (empty when status is not completed)
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.has_nsfw_contentsarrayArray of boolean values indicating NSFW detection for each output
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds

Result Request Parameters

ParameterTypeRequiredDefaultDescription
idstringYes-Task ID

Result Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
dataobjectThe prediction data object containing all details
data.idstringUnique identifier for the prediction, the ID of the prediction to get
data.modelstringModel ID used for the prediction
data.outputsobjectArray of objects containing the moderation outputs (empty when status is not completed).
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds
© 2025 WaveSpeedAI. All rights reserved.