Ideogram V3 Text to Image

Endpoint

POST /images/generations

Full URL: https://modelfold.ai/v1/images/generations

Authentication: every request must include the Authorization: Bearer <API_KEY> header.

Send model parameters directly in the JSON body. Do not wrap them in input. This request waits for generation to finish and returns data[].url; supported media models also offer async jobs, polling and callbacks. Replace example media URLs with your own publicly accessible files. See API gateway for billing and errors.

Input parameters for the generation task.

Request Parameters

Body (application/json)

Parameter	Type	Required	Description
model	string	Yes	The model name used for generation. This field is required. - This endpoint must use the ideogram/v3-text-to-image model Default："ideogram/v3-text-to-image"。 Allowed values：ideogram/v3-text-to-image。 Example：ideogram/v3-text-to-image。
prompt	string	Yes	Prompt required by the ModelFold gateway; at most 2000 characters. Description of the image to generate. Maximum length: 5000 characters. maxLength: 2000. Example：A cinematic photograph of a tranquil lakeside at twilight, viewed from a slight elevation. In the center, a cluster of softly glowing reeds and water lilies emit a gentle golden light, their reflections shimmering on the calm surface. The elegant neon-style white text 'modelfold.ai' hovers just above the water, subtly illuminated and harmonizing with the natural glow. Surrounding willows and drifting mist frame the scene, creating a serene yet magical atmosphere, with warm highlights contrasting against the cool blues of the evening sky.。
rendering_speed	string	No	The rendering speed to use. - TURBO: Turbo - BALANCED: Balanced - QUALITY: Quality Allowed values：TURBO / BALANCED / QUALITY。 Example：BALANCED。
style	string	No	The style type to generate with. - AUTO: Auto - GENERAL: General - REALISTIC: Realistic - DESIGN: Design Allowed values：AUTO / GENERAL / REALISTIC / DESIGN。 Example：AUTO。
expand_prompt	boolean	No	Determines whether MagicPrompt should be used to enhance the generation request. - Boolean value: true / false Example：true。
image_size	string	No	The resolution of the generated image. - square: Square - square_hd: Square HD - portrait_4_3: Portrait 3:4 - portrait_16_9: Portrait 9:16 - landscape_4_3: Landscape 4:3 - landscape_16_9: Landscape 16:9 Allowed values：square / square_hd / portrait_4_3 / portrait_16_9 / landscape_4_3 / landscape_16_9。 Example：square_hd。
seed	integer	No	Seed for the random number generator.
negative_prompt	string	No	Description of what to exclude from the generated image. If the positive prompt conflicts with the negative prompt, the positive prompt takes precedence. Maximum length: 5000 characters. maxLength: 5000.

Request Example

curl -X POST "https://modelfold.ai/v1/images/generations" \
  -H "Authorization: Bearer $MODELFOLD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "ideogram/v3-text-to-image",
  "prompt": "A cinematic photograph of a tranquil lakeside at twilight, viewed from a slight elevation. In the center, a cluster of softly glowing reeds and water lilies emit a gentle golden light, their reflections shimmering on the calm surface. The elegant neon-style white text '\''ModelFold'\'' hovers just above the water, subtly illuminated and harmonizing with the natural glow. Surrounding willows and drifting mist frame the scene, creating a serene yet magical atmosphere, with warm highlights contrasting against the cool blues of the evening sky."
}'

{
  "model": "ideogram/v3-text-to-image",
  "prompt": "A cinematic photograph of a tranquil lakeside at twilight, viewed from a slight elevation. In the center, a cluster of softly glowing reeds and water lilies emit a gentle golden light, their reflections shimmering on the calm surface. The elegant neon-style white text 'ModelFold' hovers just above the water, subtly illuminated and harmonizing with the natural glow. Surrounding willows and drifting mist frame the scene, creating a serene yet magical atmosphere, with warm highlights contrasting against the cool blues of the evening sky."
}

Response

200 — Generation completed. usage contains actual billing details; result URLs are illustrative.

{
  "ok": true,
  "created": 1792134000,
  "data": [
    {
      "url": "https://modelfold.ai/uploads/outputs/result.png"
    }
  ],
  "usage": {}
}