MeduxMedux

Generate > Create Text to Image

Create Text to Image

Generate an image from a text prompt.

POST/api/app/v1/generate/image/text_to_image

Examples

curl -X POST https://api.medux.io/api/app/v1/generate/image/text_to_image \
  -H 'Authorization: Bearer $MEDUX_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"cfg_normalization":false,"cfg_truncation":1,"guidance_scale":0,"height":1024,"max_sequence_length":512,"model_id":"text-to-image-default","num_inference_steps":9,"prompt":"PROMPT","seed":-1,"width":1024}'

Auth Requirements

Authentication is required via Authorization header.

Preconditions

Requires a valid Authorization header and the configured request body.

Successful requests return a Medux task record immediately. Use the task query or sync endpoints to track completion.

Request

Body

application/json
Authorizationstringrequired

Bearer token or API key.

Location: HEADER

promptstringrequired

Prompt text used to generate the image.

Location: BODY

negative_promptstringoptional

Optional negative prompt.

Location: BODY

heightintegeroptional

Output image height. Default: 1024.

Location: BODY

widthintegeroptional

Output image width. Default: 1024.

Location: BODY

seedintegeroptional

Random seed. Use -1 to auto-generate. Default: -1.

Location: BODY

num_inference_stepsintegeroptional

Number of inference steps. Default: 9.

Location: BODY

guidance_scalenumberoptional

Guidance scale. Default: 0.0.

Location: BODY

cfg_normalizationbooleanoptional

Whether to enable CFG normalization. Default: false.

Location: BODY

cfg_truncationnumberoptional

CFG truncation value. Default: 1.0.

Location: BODY

max_sequence_lengthintegeroptional

Maximum text sequence length. Default: 512.

Location: BODY

model_idstringoptional

Text-to-image model id. Default: text-to-image-default.

Location: BODY

titlestringoptional

Optional task title.

Location: BODY

Response

Response

application/json
No response fields documented for this endpoint.

MCP Tool

This endpoint is also available through the Medux-hosted remote MCP service.

Create Text to Image

Generate an image from a text prompt.

Invocation Example

Generate an image from a text prompt.