Recommend MaxVideoAI models
recommend_modelsUse this when the user is undecided or asks for advice on which AI video/image model fits a creative goal. Present the best-fit available executable model first, then strong alternatives from distinct model families when useful. Validate the selected mode with get_model_details. Nullable constraints must be null or omitted when unstated, never placeholders. Ask only for missing choices that change the result or budget. Clarify whether quality means story coherence, multi-shot continuity, reference/character fidelity, motion, audio or delivery resolution; never rank creative quality by resolution alone. Use calculate_project_budget on comparable proposals before calling an option cheaper or lower-cost. Mix models only when each shot has a factual rationale; do not force diversity or dilute a quality-first plan. Do not use when the user already chose a compatible model for validation, pricing or execution. Never substitute a named model without user approval. Use returned editorialGuidance: reference entries are reviewed starting points, alternative entries serve meaningful tradeoffs, and on_request entries are for explicit requests. Inspect reviewStatus, reviewedAt, rationale and provenance. Editorial preference is not measured quality or execution certification; a new version never inherits a review from its family. An idea, a prompt or a single asset can be a complete outcome; do not require a film or a multi-step recipe. Recommendations are capability matches with disclosed editorial preference. Do not use as an exact quote, generation command or guarantee that a provider will accept a request. Respect executable constraints and the user’s choice.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Exact public model ID to consider, or null unless the user named one. | |
| mode | No | Requested generation mode, or null unless the user constrained it. | |
| audio | No | Whether the user explicitly requires or excludes audio, or null when unstated. | |
| surface | No | Requested media surface, or null unless the user constrained it. | |
| useCase | No | Creative goal used only with reviewed MaxVideoAI model guidance, or null when unstated. | |
| priorities | No | Ordered user-stated factual priorities, most important first, or null when none of these values matches. For beautiful cinematography, expressive acting or smooth camera movement without an explicit listed priority, use null. highest_resolution requires a delivery-resolution preference such as 4K; it is not a proxy for overall creative quality. lower_cost requests a budget comparison when cheaper options are explicitly wanted. Asking what a project costs does not mean prefer the cheapest: keep priorities null and use calculate_project_budget for the estimate. | |
| resolution | No | Requested resolution, or null unless the user constrained it. | |
| aspectRatio | No | Requested aspect ratio, or null unless the user constrained it. | |
| maxDurationSec | No | Maximum duration requested by the user, or null. Never use 300 as a placeholder. | |
| referenceImages | No | Whether the user explicitly requires or excludes reference images, or null when unstated. | |
| excludedModelIds | No | Up to ten public model IDs to leave out of the recommendations, or null. | |
| preferredModelIds | No | Up to ten public model IDs the user would like considered when compatible, or null. | |
| budgetCeilingCents | No | Project budget ceiling in cents, or null when unstated; use calculate_project_budget for current comparable totals. |