Ideogram V3 Remix

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 image remix 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-remix` model Default：`"ideogram/v3-remix"`。 Allowed values：`ideogram/v3-remix`。 Example：`ideogram/v3-remix`。
`prompt`	`string`	Yes	Prompt required by the ModelFold gateway; at most 2000 characters. The prompt to remix the image with. Maximum length: 5000 characters. maxLength: `2000`. Example：`Change the cube into a sphere`。
`image_url`	`string`	Yes	The image URL to remix. - Please provide the URL of the uploaded file, not raw file content - Accepted types: `image/jpeg`, `image/png`, `image/webp` - Max size: 10.0MB Example：`https://file.aiquickdraw.com/custom-page/akr/section-images/17550782013854ykfihxv.webp`。
`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	Determine if MagicPrompt should be used in generating the request or not. - 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.
`strength`	`number`	No	Strength of the input image in the remix. - Minimum: `0.01` - Maximum: `1` - Step: `0.01` minimum: `0.01`. maximum: `1`. Example：`0.8`。
`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

bash

curl -X POST "https://modelfold.ai/v1/images/generations" \
  -H "Authorization: Bearer $MODELFOLD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "ideogram/v3-remix",
  "prompt": "Change the cube into a sphere",
  "image_url": "https://file.aiquickdraw.com/custom-page/akr/section-images/17550782013854ykfihxv.webp"
}'

json

{
  "model": "ideogram/v3-remix",
  "prompt": "Change the cube into a sphere",
  "image_url": "https://file.aiquickdraw.com/custom-page/akr/section-images/17550782013854ykfihxv.webp"
}

Response

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

json

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

Ideogram V3 Remix ​

Endpoint ​

Request Parameters ​

Body (application/json) ​

Request Example ​

Response ​