Skip to main content
← Recraft V4.1 Utility Endpoint: POST https://api.higgsfield.ai/recraft/v4.1/utility/text-to-image Endpoint ID: recraft/v4.1/utility/text-to-image ▶Open API PlaygroundRecraft V4.1 Utility · Text to image↗

Usage notes

  • This variant accepts only resolution=1k; use the separate standard/Pro endpoint for the other resolution tier.
  • colors is an array of objects shaped as {“rgb”: [R, G, B]}; background_color is one such object. Every RGB value is an integer 0–255, with exactly three entries.
  • output_format is jpg, png, or webp; default is jpg. No reference-image input is declared.
  • prompt must contain 1–10000 characters. Fourteen aspect-ratio values are listed in the schema, including 6:10, 14:10, and 10:14.

Quick start

Input schema

array
Preferred RGB palette for the generated image.
string
required
Write your prompt here Minimum characters: 1. Maximum characters: 10000.
string
default:"1k"
Output resolution tier. Allowed values: "1k".
string
default:"1:1"
Output width-to-height ratio. Allowed 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. Allowed values: "jpg", "png", "webp".
object
Preferred RGB background color.

Response

Submission returns a request handle. Poll status_url until status is completed, or use webhooks.
Accepted
A completed response includes the following output fields:
See idempotent requests, polling, request errors and authentication for shared request handling.