Remix (Blend Image)

POST https://www.kkiai.com/ideogram/remix

Official documentation: https://developer.ideogram.ai/api-reference/api-reference/remix

Request Parameters

Header Parameters

Parameter	Type	Required	Description	Example
Content-Type	string	Required		multipart/form-data
Accept	string	Required		application/json
Authorization	string	Required		Bearer {{YOUR_API_KEY}}

Body Parameters (multipart/form-data)

Parameter	Type	Required	Description
image_request	string	Optional	"prompt": "a beautiful sunset over mountains", // Prompt text for generating images (required) "aspect_ratio": "ASPECT_16_9", // Image aspect ratio (optional) Optional values: ASPECT_10_16/ASPECT_16_10/ASPECT_9_16/ASPECT_16_9/ASPECT_3_2/ASPECT_2_3/ASPECT_4_3/ASPECT_3_4/ASPECT_1_1/ASPECT_1_3/ASPECT_3_1 "color_palette": { // Color palette (optional) "name": "FRESH" // Preset palette name (choose one with members) Optional values: EMBER/FRESH/JUNGLE/MAGIC/MELON/MOSAIC/PASTEL/ULTRAMARINE // Or use custom colors: /"members": [ { "color_hex": "#FF0000", // Hex color value (required) "color_weight": 1.0 // Color weight (optional) Range: 0.05-1.0 } ]/ }, "image_weight": 50, // Image weight (optional) Range: 1-100, default 50 "magic_prompt_option": "AUTO", // Whether to use MagicPrompt (optional) Optional values: AUTO/ON/OFF "model": "V_2", // Model to use (optional) Default V_2, optional values: V_1/V_1_TURBO/V_2/V_2_TURBO "negative_prompt": "clouds,blur", // Negative prompt (optional) Describes content you don't want in the image "num_images": 1, // Number of images to generate (optional) Range: 1-8, default 1 "resolution": "RESOLUTION_1024_1024", // Resolution (optional) Optional values include various resolution combinations from 512x1536 to 1536x640 "seed": 123456, // Random seed (optional) Range: 0-2147483647 "style_type": "REALISTIC" // Style type (optional) Optional values: AUTO/GENERAL/REALISTIC/DESIGN/RENDER_3D/ANIME
image_file	file	Optional	Image file (required) Source image file for generating new images

cURL Example

curl --location --request POST 'https://www.kkiai.com/ideogram/remix' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer ' \
--form 'image_request="{    \"image_weight\": 50,    \"model\": \"V_1\",    \"magic_prompt_option\": \"AUTO\",    \"prompt\": \"A%20serene%20tropical%20beach%20\",    \"aspect_ratio\": \"ASPECT_10_16\",    \"seed\": 12345,    \"negative_prompt\": \"brush%20strokes%2C%20painting\"}"' \
--form 'image_file=@"C:\\Users\\Administrator\\Desktop\\example.png"'

Response

🟢 200 Success

Response Body

Parameter	Type	Required	Description
code	integer	Required
message	string	Required
request_id	string	Required
data	object	Required
└ task_id	string	Required
└ task_status	string	Required
└ created_at	integer	Required
└ updated_at	integer	Required

Response Example

{
    "code": 0,
    "message": "SUCCEED",
    "request_id": "CjMT7WdSwWcAAAAAALvB3g",
    "data": {
        "task_id": "CjMT7WdSwWcAAAAAALvB3g",
        "task_status": "submitted",
        "created_at": 1733851336696,
        "updated_at": 1733851336696
    }
}