Minicpm V Video | AI Video Understanding API

MiniCPM-V Video

MiniCPM-V Video is an advanced video understanding model that analyzes video content and generates detailed descriptions, summaries, or answers to your questions. Simply upload a video and let the AI understand what's happening on screen.

Why It Stands Out

Video understanding: Analyzes visual content, actions, and scenes in videos.
Preset prompts: Choose from ready-to-use prompts like "describe" for quick analysis.
Custom prompts: Ask specific questions or request particular types of analysis.
Affordable pricing: Get video insights at a low cost per analysis.
Reproducibility: Use the seed parameter to get consistent results.

Parameters

Parameter	Required	Description
video	Yes	Source video (upload or public URL).
preset_prompt	No	Pre-defined prompt type (e.g., describe & caption).
custom_prompt	No	Your own question or instruction about the video.
seed	No	Set for reproducibility; -1 for random.
enable_sync_mode	No	Wait for result before returning response (API only).

How to Use

Upload your video — drag and drop a file or paste a public URL.
Select a preset prompt — choose "describe" or other available options for quick analysis.
Add a custom prompt (optional) — ask specific questions about the video content.
Click Run and wait for analysis.
Review the output — get detailed descriptions or answers about your video.

Best Use Cases

Content Analysis — Understand what's happening in videos without watching them.
Video Cataloging — Generate descriptions for video libraries and archives.
Accessibility — Create text descriptions of video content for accessibility purposes.
Content Moderation — Analyze video content for review and categorization.
Research & Analysis — Extract insights from video data at scale.
Social Media — Generate captions and descriptions for video posts.

Pricing

Output	Price
Per video	$0.015

Pro Tips for Best Quality

Use videos with clear visuals for more accurate analysis.
Use preset prompts for quick, general descriptions.
Use custom prompts to ask specific questions like "What objects are in this video?" or "Describe the main action."
Keep videos reasonably short for faster processing.
Fix the seed when you need consistent results across multiple runs.

Notes

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

Minicpm V Video API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/wavespeed-ai/minicpm-v/video 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 Video below.

HTTP example

# Submit the prediction
curl -X POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/minicpm-v/video" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d '{
    "video": "https://example.com/your-input.mp4",
    "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/video", {
        "video": "https://example.com/your-input.mp4",
        "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/video",
    {
    "video": "https://example.com/your-input.mp4",
    "preset_prompt": "describe",
    "seed": -1,
    "enable_sync_mode": false
}
)

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

Minicpm V Video API — Frequently asked questions

What is the Minicpm V Video API?

Minicpm V Video 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 model for AI video understanding and analysis. 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 Video 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-video.

How much does Minicpm V Video cost per run?

Minicpm V Video starts at $0.015 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 Video accept?

Key inputs: `video`, `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-video.

How long does Minicpm V Video take to generate?

Average end-to-end generation time on WaveSpeedAI is around 14 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 Video 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