Minicpm V Image | AI Image Understanding API

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

Parameter	Required	Description
image	Yes	Image to analyze (upload or public URL).
preset_prompt	No	Preset task: describe, etc. (default: describe).
custom_prompt	No	Custom question or instruction about the image.
seed	No	Set for reproducibility; -1 for random.

How to Use

Upload your image — drag and drop a file or paste a public URL.
Select a preset prompt — choose "describe" or other presets for quick analysis.
Or write a custom prompt — ask specific questions about the image.
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

Output	Price
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.

Minicpm V Image API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/wavespeed-ai/minicpm-v/image with your input as JSON. The endpoint returns a prediction id; poll the prediction endpoint until status flips to completed, then read the output URL from data.outputs[0]. Examples for Minicpm V Image below.

HTTP example

# Submit the prediction
curl -X POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/minicpm-v/image" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d '{
    "image": "https://example.com/your-input.jpg",
    "preset_prompt": "describe",
    "seed": -1,
    "enable_sync_mode": false
}'

# Response includes a prediction id. Poll for the result:
curl -X GET "https://api.wavespeed.ai/api/v3/predictions/{request_id}/result" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY"

# When status is "completed", read the output from data.outputs[0].

Node.js example

// npm install wavespeed
const WaveSpeed = require('wavespeed');

const client = new WaveSpeed(); // reads WAVESPEED_API_KEY from env

const result = await client.run("wavespeed-ai/minicpm-v/image", {
        "image": "https://example.com/your-input.jpg",
        "preset_prompt": "describe",
        "seed": -1,
        "enable_sync_mode": false
});

console.log(result.outputs[0]); // → URL of the generated output

Python example

# pip install wavespeed
import wavespeed

output = wavespeed.run(
    "wavespeed-ai/minicpm-v/image",
    {
    "image": "https://example.com/your-input.jpg",
    "preset_prompt": "describe",
    "seed": -1,
    "enable_sync_mode": false
}
)

print(output["outputs"][0])  # → URL of the generated output

Minicpm V Image API — Frequently asked questions

What is the Minicpm V Image API?

Minicpm V Image is a WaveSpeedAI model for AI inference, exposed as a REST API 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. You can call it programmatically or try it from the playground above.

How do I call the Minicpm V Image API?

POST your input parameters to the model's REST endpoint (shown in the API tab of this playground) with your WaveSpeedAI API key in the Authorization header. Submission returns a prediction ID; poll the prediction endpoint until status flips to "completed", then read the output URL from the result. The playground generates a ready-to-paste code sample in Python, JavaScript, or cURL for whatever inputs you've set. Full request/response shape is documented at https://wavespeed.ai/docs/docs-api/wavespeed-ai/minicpm-v-image.

How much does Minicpm V Image cost per run?

Minicpm V Image starts at $0.005 per run. That figure is the base price — the final charge scales with the parameters you set in the form (output size, length, count, references, or whatever knobs this model exposes), so a higher-quality or larger output costs more than a minimal one. The exact cost for your current input is shown live next to the Generate button before you submit, and the actual per-call charge is recorded on the prediction afterwards.

What inputs does Minicpm V Image accept?

Key inputs: `image`, `seed`, `custom_prompt`, `enable_sync_mode`, `preset_prompt`. The full JSON schema (types, defaults, allowed values) is rendered above the Generate button and mirrored in the API reference at https://wavespeed.ai/docs/docs-api/wavespeed-ai/minicpm-v-image.

How long does Minicpm V Image take to generate?

Average end-to-end generation time on WaveSpeedAI is around 4 seconds per request — measured across recent runs. Queue time scales with global demand; live status is visible in the prediction record.

Can I use Minicpm V Image outputs commercially?

Commercial usage rights depend on the model's license, set by its provider (WaveSpeedAI). The license summary appears on the model card above; see WaveSpeedAI's Terms of Service for platform-level conditions.

示例查看全部

相关模型

README