Skip to main content
← Recraft Model name: recraft/v3/text-to-image
Generation type: text_to_image
Endpoint: POST /api/asset_generator/

​
Pricing

0.5 credits per output. Prices are per output. When a request asks for several outputs, the charge is this price times the number of outputs.

​
Quick start

​
Input parameters

Send these fields in input_params.
​
string
required
The prompt to generate an image from.Minimum characters: 1. Maximum characters: 1000.
​
string
default:"realistic_image"
The style of the generated images. Vector images cost 2X as much.Allowed values: "any", "realistic_image", "digital_illustration", "vector_illustration", "realistic_image/b_and_w", "realistic_image/hard_flash", "realistic_image/hdr", "realistic_image/natural_light", "realistic_image/studio_portrait", "realistic_image/enterprise", "realistic_image/motion_blur", "realistic_image/evening_light", "realistic_image/faded_nostalgia", "realistic_image/forest_life", "realistic_image/mystic_naturalism", "realistic_image/natural_tones", "realistic_image/organic_calm", "realistic_image/real_life_glow", "realistic_image/retro_realism", "realistic_image/retro_snapshot", "realistic_image/urban_drama", "realistic_image/village_realism", "realistic_image/warm_folk", "digital_illustration/pixel_art", "digital_illustration/hand_drawn", "digital_illustration/grain", "digital_illustration/infantile_sketch", "digital_illustration/2d_art_poster", "digital_illustration/handmade_3d", "digital_illustration/hand_drawn_outline", "digital_illustration/engraving_color", "digital_illustration/2d_art_poster_2", "digital_illustration/antiquarian", "digital_illustration/bold_fantasy", "digital_illustration/child_book", "digital_illustration/child_books", "digital_illustration/cover", "digital_illustration/crosshatch", "digital_illustration/digital_engraving", "digital_illustration/expressionism", "digital_illustration/freehand_details", "digital_illustration/grain_20", "digital_illustration/graphic_intensity", "digital_illustration/hard_comics", "digital_illustration/long_shadow", "digital_illustration/modern_folk", "digital_illustration/multicolor", "digital_illustration/neon_calm", "digital_illustration/noir", "digital_illustration/nostalgic_pastel", "digital_illustration/outline_details", "digital_illustration/pastel_gradient", "digital_illustration/pastel_sketch", "digital_illustration/pop_art", "digital_illustration/pop_renaissance", "digital_illustration/street_art", "digital_illustration/tablet_sketch", "digital_illustration/urban_glow", "digital_illustration/urban_sketching", "digital_illustration/vanilla_dreams", "digital_illustration/young_adult_book", "digital_illustration/young_adult_book_2", "vector_illustration/bold_stroke", "vector_illustration/chemistry", "vector_illustration/colored_stencil", "vector_illustration/contour_pop_art", "vector_illustration/cosmics", "vector_illustration/cutout", "vector_illustration/depressive", "vector_illustration/editorial", "vector_illustration/emotional_flat", "vector_illustration/infographical", "vector_illustration/marker_outline", "vector_illustration/mosaic", "vector_illustration/naivector", "vector_illustration/roundish_flat", "vector_illustration/segmented_colors", "vector_illustration/sharp_contrast", "vector_illustration/thin", "vector_illustration/vector_photo", "vector_illustration/vivid_shapes", "vector_illustration/engraving", "vector_illustration/line_art", "vector_illustration/line_circuit", "vector_illustration/linocut".
​
string
default:"square_hd"
Image SizeAllowed values: "square_hd", "square", "portrait_4_3", "portrait_16_9", "landscape_4_3", "landscape_16_9".
​
integer
default:1
The number of images to generate.Minimum: 1. Maximum: 1.

​
Response

The request returns the task with status: "initializing". Poll GET /api/asset_generator/{id}/ until status is done or failed, or pass a webhook_url to be notified. A finished task lists its files in assets and the credits it charged in credits_used.