RECRAFT V4

Recraft V4 is a text-to-image model developed to meet the specific demands of professional design and marketing workflows. Positioned within the inference model category, it transforms textual prompts into visually compelling images, supporting highly customizable outputs that fit a variety of creative requirements. The model is accessible programmatically through HTTP API endpoints as well as client libraries for Python and JavaScript, making it suitable for both integration within larger workflows and for direct interactive use.

Key Capabilities: Recraft V4 is built to serve contexts where design quality, control, and adaptability are essential. With its API, users supply a required text prompt to direct the content, theme, and style of the desired image. The model outputs image files in standard web-friendly formats, with detailed information such as file size, name, content type, and direct access URL provided in the response payload for easy downstream use or storage.

Input Customization: The model offers a range of configurable parameters to tailor image outputs:

• Enable Safety Checker: A boolean option, enabled by default, that applies safety validation to the output, giving organizations control over suitability for public or professional use.
• Background Color: Users can specify the RGB values for the preferred background color, ensuring the generated image matches specific design palettes or environmental requirements.
• Colors: An array of RGB color preferences can be provided, guiding the model when particular hues are desired in the output.
• Image Size: Outputs can be generated in a spectrum of common aspect ratios and resolutions. Supported string presets include "square_hd", "square", "portrait_4_3", "portrait_16_9", "landscape_4_3", and "landscape_16_9". Users may also specify custom dimensions by supplying explicit width and height values, facilitating exact format requirements for different media or platforms.
• Prompt: This is a required free-text field that controls the content, aesthetic, and composition of the generated image. Prompts may reference visual styles, lighting effects, subject matter, color sensibility, and more, aligning closely with creative direction for marketing assets or professional visual content.

Output Format: The model returns generated images as an array of file objects. Each file object includes metadata such as file size, file name, content type (for example, image/webp), and a direct access URL for integrating into design pipelines or publishing workflows. This structure supports seamless download, sharing, or direct embedding of generated images.

API Access and Integration: Recraft V4 is available via HTTP API endpoint (https://fal.run/fal-ai/recraft/v4/text-to-image). Client libraries are provided for Python (fal-client) and JavaScript (@fal-ai/client), with code examples illustrating how to construct and submit requests and monitor job progress via logs.

Ideal Use Cases and Users: The documentation positions Recraft V4 as particularly valuable for professional design and marketing use cases. Its fine control over image content, palette, and format makes it well suited for creating images that meet strict brand guidelines, campaign themes, or marketing objectives.

Technical Considerations:

• Input/Output: The model is text-in, image-out, and all configuration is handled through structured API requests.
• Safety: Safety checker functionality is enabled by default, aligning with common content moderation requirements in commercial environments.
• Customization: Every aspect from background to color scheme and dimensions can be controlled by API parameters, promoting adaptability across projects.

Limitations and Best Practices: While the documentation fully specifies input parameters, output format, and intended use, it does not mention image quality metrics, specific limitations, or best practices beyond normal API usage. The model’s behavior reflects the supplied parameters and prompt detail, enabling a high level of customization, but users should experiment with different prompt formulations and settings to best match their design vision.

In conclusion, Recraft V4 empowers professionals in design and marketing to generate highly customizable images from textual directions. With its API-driven approach, parameter flexibility, and integration-ready output format, it fits naturally into creative, branding, and campaign asset workflows that demand both efficiency and control.