text-to-image - ChatfireAPI

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

model

string

枚举值

必需

示例值:

recraft

submodel

enum<string>

必需

枚举值:

v3/text-to-imagev3/image-to-imageupscale/creativeupscale/crisp

示例值:

v3/text-to-image

Body 参数application/json

prompt

string

必需

用于生成图像的文本提示

image_size

可选

图像尺寸。默认为 'square_hd'。对于自定义图像尺寸，可以传递一个包含宽度和高度的对象。

One of

string

object

枚举值:

square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9

默认值:

square_hd

style

enum<string>

可选

生成图像的风格。矢量图像的成本是其2倍。默认为 'realistic_image'。

枚举值:

anyrealistic_imagedigital_illustrationvector_illustrationrealistic_image/b_and_wrealistic_image/hard_flashrealistic_image/hdrrealistic_image/natural_lightrealistic_image/studio_portraitrealistic_image/enterpriserealistic_image/motion_blurrealistic_image/evening_lightrealistic_image/faded_nostalgiarealistic_image/forest_liferealistic_image/mystic_naturalismrealistic_image/natural_tonesrealistic_image/organic_calmrealistic_image/real_life_glowrealistic_image/retro_realismrealistic_image/retro_snapshotrealistic_image/urban_dramarealistic_image/village_realismrealistic_image/warm_folkdigital_illustration/pixel_artdigital_illustration/hand_drawndigital_illustration/graindigital_illustration/infantile_sketchdigital_illustration/2d_art_posterdigital_illustration/handmade_3ddigital_illustration/hand_drawn_outlinedigital_illustration/engraving_colordigital_illustration/2d_art_poster_2digital_illustration/antiquariandigital_illustration/bold_fantasydigital_illustration/child_bookdigital_illustration/child_booksdigital_illustration/coverdigital_illustration/crosshatchdigital_illustration/digital_engravingdigital_illustration/expressionismdigital_illustration/freehand_detailsdigital_illustration/grain_20digital_illustration/graphic_intensitydigital_illustration/hard_comicsdigital_illustration/long_shadowdigital_illustration/modern_folkdigital_illustration/multicolordigital_illustration/neon_calmdigital_illustration/noirdigital_illustration/nostalgic_pasteldigital_illustration/outline_detailsdigital_illustration/pastel_gradientdigital_illustration/pastel_sketchdigital_illustration/pop_artdigital_illustration/pop_renaissancedigital_illustration/street_artdigital_illustration/tablet_sketchdigital_illustration/urban_glowdigital_illustration/urban_sketchingdigital_illustration/vanilla_dreamsdigital_illustration/young_adult_bookdigital_illustration/young_adult_book_2vector_illustration/bold_strokevector_illustration/chemistryvector_illustration/colored_stencilvector_illustration/contour_pop_artvector_illustration/cosmicsvector_illustration/cutoutvector_illustration/depressivevector_illustration/editorialvector_illustration/emotional_flatvector_illustration/infographicalvector_illustration/marker_outlinevector_illustration/mosaicvector_illustration/naivectorvector_illustration/roundish_flatvector_illustration/segmented_colorsvector_illustration/sharp_contrastvector_illustration/thinvector_illustration/vector_photovector_illustration/vivid_shapesvector_illustration/engravingvector_illustration/line_artvector_illustration/line_circuitvector_illustration/linocut

默认值:

realistic_image

colors

array[object (RGBColor) {3}]

可选

一个包含偏好颜色的数组

r

integer

必需

红色分量 (0-255)

g

integer

必需

绿色分量 (0-255)

b

integer

必需

蓝色分量 (0-255)

style_id

string

可选

自定义风格参考的ID（可选）

enable_safety_checker

boolean

可选

如果设置为 true，将启用安全检查器。

示例

{
  "prompt": "a red panda eating a bamboo in front of a poster that says \"recraft V3 now available at fal\"",
  "image_size": "square_hd",
  "style": "realistic_image",
  "colors": []
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.chatfire.cn/fal-ai/recraft/v3/text-to-image' \
--header 'Content-Type: application/json' \
--data-raw '{
  "prompt": "a red panda eating a bamboo in front of a poster that says \"recraft V3 now available at fal\"",
  "image_size": "square_hd",
  "style": "realistic_image",
  "colors": []
}'

返回响应

🟢200成功

application/json

Body

status

string

必需

request_id

string

必需

response_url

string

必需

status_url

string

必需

cancel_url

string

必需

logs

null

必需

metrics

object

必需

queue_position

integer

必需

示例

{
    "status": "IN_QUEUE",
    "request_id": "714e4d31-d735-45f7-a9f5-e50eecbb0743",
    "response_url": "https://queue.fal.run/fal-ai/minimax/requests/714e4d31-d735-45f7-a9f5-e50eecbb0743",
    "status_url": "https://queue.fal.run/fal-ai/minimax/requests/714e4d31-d735-45f7-a9f5-e50eecbb0743/status",
    "cancel_url": "https://queue.fal.run/fal-ai/minimax/requests/714e4d31-d735-45f7-a9f5-e50eecbb0743/cancel",
    "logs": null,
    "metrics": {},
    "queue_position": 0
}