Skip to main content
Endpoint: POST https://api.higgsfield.ai/recraft/v4.1/pro/text-to-image Endpoint ID: recraft/v4.1/pro/text-to-image Try Recraft V4.1 ProOpen this endpoint in the Higgsfield API Playground.

Quick Start

Input Schema

string
required
Text description of the image to generate, from 1 to 10,000 characters.
string
default:"2k"
Output resolution. Recraft V4.1 Pro uses 2k.
string
default:"1:1"
Supported values: 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 6:10, 14:10, 10:14, 16:9, 9:16.
string
default:"jpg"
Output file format. Supported values: png, jpg, webp.
array
Optional palette. Each item contains rgb, an array of three integers from 0 to 255.
object
Optional background color as { "rgb": [red, green, blue] }. The rgb array must contain exactly three integers from 0 to 255.

Output Schema

string
required
Request state. A newly accepted request returns queued.
string
required
Stable identifier used for polling, cancellation, and support.
string
required
URL to poll until the request reaches a terminal state.
string
required
URL used to cancel a request before processing starts.
array
Completed image outputs. Each item contains a download url.

Input Example

Output Example

Use an SDK for automatic polling, or poll the returned status URL.