UseAPI icon

UseAPI

Interact with RunwayML through UseAPI

Overview

The "Minimax Create Video" operation allows users to generate videos using AI models by providing either a text prompt alone or an image combined with optional text. This node is useful for automating video content creation based on descriptive inputs, enabling creative workflows such as marketing video generation, social media content production, or rapid prototyping of visual ideas.

Practical examples include:

  • Creating a video purely from a textual description, e.g., "A sunset over the mountains with birds flying."
  • Generating a video that animates or extends an uploaded image, optionally enhanced with a text prompt to guide the video style or content.

Properties

Name Meaning
Input Type Selects the type of input for video creation:
- Text Prompt Only: Generate video solely from a text description.
- Image + Optional Text: Use an uploaded image plus optional text prompt.
Text Prompt A descriptive text prompt that explains what the generated video should depict. Used in both input types but mandatory for text-only input.
File ID The identifier of the uploaded image file to use when the input type is "Image + Optional Text". Format example: user:user_id-minimax:account-file:file_id.
Model The AI model to use for video generation. Options depend on the input type:
- For Text Prompt Only: T2V-01 (Text-to-Video), T2V-01-Director (Text-to-Video Director).
- For Image + Optional Text: I2V-01, I2V-01-live, I2V-01-Director, S2V-01 (Subject Reference).
Additional Options Collection of optional settings:
- Prompt Optimization (boolean): Whether to optimize the provided prompt before generation.
- Reply URL (string): Webhook URL to receive notification when generation completes.
- Reply Reference (string): Custom reference ID included in callback notifications.

Output

The node outputs JSON data representing the response from the Minimax API after requesting video creation. This typically includes metadata about the created video such as its ID, status, and possibly URLs or references to access the generated video once ready.

If the node supports asynchronous processing via webhook callbacks (using Reply URL and Reply Reference), the initial output may contain job identifiers or status indicators rather than the final video data.

No binary data output is indicated for this operation; the output is structured JSON describing the video creation request and its result.

Dependencies

  • Requires an active API key credential for the Minimax service.
  • The node makes HTTP POST requests to the Minimax API endpoint at https://api.useapi.net/v1/minimax/videos/create.
  • If using webhook callbacks, a publicly accessible URL must be provided to receive generation completion notifications.

Troubleshooting

  • Missing Required Fields: Ensure that when using "Image + Optional Text" input type, the File ID is provided and valid.
  • Invalid Model Selection: The model choice must correspond to the selected input type; otherwise, the API call may fail.
  • API Authentication Errors: Verify that the Minimax API key credential is correctly configured and has necessary permissions.
  • Webhook Failures: If using Reply URL, ensure the URL is reachable and properly handles incoming webhook requests.
  • Prompt Optimization Issues: Disabling prompt optimization might lead to less accurate or lower-quality video generation results.
  • Error Responses from API: The node surfaces error messages returned by the API. Check the error details for guidance, such as invalid parameters or quota limits.

Links and References


This summary is based on static analysis of the node's source code and provided property definitions without runtime execution.

Discussion