UseAPI icon

UseAPI

Interact with RunwayML through UseAPI
Join our community

Actions22

Overview

This node integrates with the RunwayML service via the UseAPI platform to generate images from textual descriptions. Specifically, the "Generate Image from Text" operation allows users to input a descriptive text prompt and receive an AI-generated image that visually represents the prompt.

Common scenarios where this node is beneficial include:

  • Creative content generation for marketing, advertising, or storytelling.
  • Rapid prototyping of visual concepts based on textual ideas.
  • Enhancing workflows that require automated image creation without manual design effort.

Practical example: A user inputs the prompt "A futuristic city skyline at sunset" with a "Cinematic" style and a 16:9 aspect ratio. The node returns an AI-generated image matching this description, which can then be used in presentations, websites, or social media posts.

Properties

Name Meaning
Text Prompt The descriptive text that instructs the AI what image to create.
Style The artistic style applied to the generated image. Options include Cinematic, Anime, Pixel Art, etc.
Aspect Ratio The width-to-height ratio of the output image. Options: 16:9 (Landscape), 21:9 (Widescreen), 1:1 (Square), 9:16 (Portrait), 4:3, 3:4.
Additional Options A collection of optional parameters:
- Prompt Weight Numeric weight (1-30) influencing how strongly the prompt affects the image generation.
- Negative Prompt Text specifying elements or features to avoid in the generated image.
- Seed Numeric seed value (1 to 4294967294) for reproducible results; using the same seed yields consistent images.

Output

The node outputs JSON data containing the response from the RunwayML API for the text-to-image request. This typically includes metadata about the generated image(s), such as URLs or asset IDs referencing the created images.

If the API supports binary data output (e.g., direct image files), it would be handled accordingly, but in this implementation, the output is JSON with references to the generated images rather than raw binary image data.

Dependencies

  • Requires an active API key credential for UseAPI with access to RunwayML services.
  • Network connectivity to the UseAPI endpoints (https://api.useapi.net/v1).
  • Proper configuration of the API key credential within n8n to authorize requests.

Troubleshooting

  • Missing or invalid API key: The node will fail if the API key credential is not set or invalid. Ensure the API key is correctly configured and has permissions for RunwayML operations.
  • Invalid prompt or parameters: If the text prompt is empty or parameters like style or aspect ratio are invalid, the API may return errors or no results. Always provide valid and supported values.
  • Rate limits or quota exceeded: The external API might enforce usage limits. If requests start failing, check your account's usage and quotas.
  • Seed value out of range: The seed must be between 1 and 4294967294. Values outside this range may cause errors.
  • Network issues: Connectivity problems can cause request failures. Verify network access to the API endpoint.

Error messages returned by the node generally include HTTP status codes and error details from the API response, which help diagnose issues.

Links and References

Discussion