## Basic model info - Model name: ideogram/ideogram ideogram-v3 - Model description: Generate high-quality images, posters, and logos with Ideogram V3. Features exceptional typography handling and realistic outputs optimized for commercial and creative use. - Endpoint name: remix ## Model schema The model schema is defined in the OpenAPI schema: [OpenAPI Schema](https://oapi.sunra.ai/main/ideogram/ideogram-v3/latest.json) ### Model input schema The model input schema is: ```json { "description": "Input schema for Ideogram V3 image remixing.", "properties": { "prompt": { "description": "Text prompt for image remixing", "title": "Prompt", "type": "string", "x-sr-order": 201 }, "aspect_ratio": { "default": "1:1", "description": "Aspect ratio for the remixed image", "enum": [ "1:1", "4:3", "3:4", "16:9", "9:16" ], "title": "Aspect Ratio", "type": "string", "x-sr-order": 401 }, "prompt_enhancer": { "description": "Whether to enhance the prompt automatically", "title": "Prompt Enhancer", "type": "boolean", "x-sr-order": 202 }, "seed": { "anyOf": [ { "maximum": 2147483647, "minimum": 0, "type": "integer" }, { "type": "null" } ], "description": "Random seed for reproducibility", "title": "Seed", "x-sr-order": 201 }, "negative_prompt": { "description": "Description of what to exclude from an image", "title": "Negative Prompt", "type": "string", "x-sr-order": 203 }, "color_palette": { "anyOf": [ { "properties": { "members": { "anyOf": [ { "items": { "properties": { "color": { "description": "Hexadecimal color code (e.g. '#FF0000')", "title": "Color", "type": "string" }, "weight": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "description": "Weight of the color (0.0-1.0)", "title": "Weight" } }, "required": [ "color" ], "title": "ColorPaletteMember", "type": "object" }, "type": "array" }, { "type": "null" } ], "description": "Custom color palette members", "title": "Members" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Preset color palette name", "title": "Name" } }, "title": "ColorPalette", "type": "object" }, { "type": "null" } ], "description": "Color palette for generation", "x-sr-order": 409 }, "image": { "anyOf": [ { "format": "uri", "maxLength": 2083, "minLength": 1, "type": "string" }, { "type": "string" } ], "description": "URL of the image to remix", "title": "Image", "x-sr-order": 301 }, "image_strength": { "default": 0.5, "description": "Strength of the input image in the remix process", "maximum": 1, "minimum": 0, "multipleOf": 0.01, "title": "Image Strength", "type": "number", "x-sr-order": 303 }, "number_of_images": { "default": 1, "description": "Number of images to generate", "maximum": 8, "minimum": 1, "multipleOf": 1, "title": "Number Of Images", "type": "integer", "x-sr-order": 205 }, "rendering_speed": { "default": "default", "description": "Rendering speed mode", "enum": [ "turbo", "default", "quality" ], "title": "Rendering Speed", "type": "string", "x-sr-order": 402 }, "style_codes": { "description": "A list of 8 character hexadecimal codes representing the style of the image. Cannot be used in conjunction with style_reference_images or style_type", "items": { "type": "string" }, "title": "Style Codes", "type": "array", "x-sr-order": 405 }, "style_reference_images": { "description": "Reference images for style transfer", "items": { "anyOf": [ { "format": "uri", "maxLength": 2083, "minLength": 1, "type": "string" }, { "type": "string" } ] }, "title": "Style Reference Images", "type": "array", "x-sr-order": 407 }, "style_type": { "default": "general", "description": "Type of style to apply", "enum": [ "auto", "general", "realistic", "design" ], "title": "Style Type", "type": "string", "x-sr-order": 406 } }, "required": [ "prompt", "image" ], "title": "RemixInput", "type": "object" } ``` ### Model output schema The model output schema is: ```json { "properties": { "images": { "items": { "properties": { "content_type": { "description": "The mime type of the file.", "title": "Content Type", "type": "string" }, "file_name": { "description": "The name of the file. It will be auto-generated if not provided.", "title": "File Name", "type": "string" }, "file_size": { "description": "The size of the file in bytes.", "title": "File Size", "type": "integer" }, "url": { "description": "The URL where the file can be downloaded from.", "title": "Url", "type": "string" } }, "required": [ "content_type", "file_name", "file_size", "url" ], "title": "SunraFile", "type": "object" }, "title": "Images", "type": "array" } }, "required": [ "images" ], "title": "ImagesOutput", "type": "object" } ``` ## Example inputs and outputs Use the following example inputs and outputs to understand the model. ### Input example ```json { "prompt": "", "aspect_ratio": "1:1", "prompt_enhancer": false, "seed": null, "negative_prompt": "", "color_palette": null, "image": "", "image_strength": 0.5, "number_of_images": 1, "rendering_speed": "default", "style_codes": [ ], "style_reference_images": [ ], "style_type": "general" } ``` ### Output example ```json { } ``` ## Model code examples ### JavaScript ```javascript import { sunra } from "@sunra/client"; const result = await sunra.subscribe("ideogram/ideogram-v3/remix", { input: { prompt: '', prompt_enhancer: false, negative_prompt: '', number_of_images: 1, image: '', image_strength: 0.5, aspect_ratio: '1:1', rendering_speed: 'default', style_codes: [], style_type: 'general', style_reference_images: [], color_palette: null, seed: null }, logs: true, onQueueUpdate: (update) => { console.log(`Status Update: ${update.status}, Request ID: ${update.request_id}`); }, }); console.log(result.data); console.log(result.requestId); ``` ### Python ```python import sunra_client result = sunra_client.subscribe( "ideogram/ideogram-v3/remix", arguments={ "prompt": "", "prompt_enhancer": False, "negative_prompt": "", "number_of_images": 1, "image": "", "image_strength": 0.5, "aspect_ratio": "1:1", "rendering_speed": "default", "style_codes": [], "style_type": "general", "style_reference_images": [], "color_palette": None, "seed": None }, with_logs=True, on_enqueue=print, on_queue_update=print, ) print(result) ``` ### Java ```java import ai.sunra.client.*; import java.util.Map; import com.google.gson.JsonObject; var client = SunraClient.withEnvCredentials(); var response = client.subscribe( "ideogram/ideogram-v3/remix", SubscribeOptions.builder() .input(Map.of( "prompt", "", "prompt_enhancer", false, "negative_prompt", "", "number_of_images", 1, "image", "", "image_strength", 0.5, "aspect_ratio", "1:1", "rendering_speed", "default", "style_codes", , "style_type", "general", "style_reference_images", , "color_palette", null, "seed", null)) .resultType(JsonObject.class) .onQueueUpdate(update -> System.out.printf( "\nStatus Update: %s, Request ID: %s%n", update.getStatus(), update.getRequestId() )) .logs(true) .build() ); System.out.println("Completed!"); System.out.println(response.getData()); ``` ### Kotlin ```kotlin import ai.sunra.client.kt.* import com.google.gson.JsonObject val client = createSunraClient() val response = client.subscribe( endpointId = "ideogram/ideogram-v3/remix", input = mapOf( "prompt" to "", "prompt_enhancer" to false, "negative_prompt" to "", "number_of_images" to 1, "image" to "", "image_strength" to 0.5, "aspect_ratio" to "1:1", "rendering_speed" to "default", "style_codes" to , "style_type" to "general", "style_reference_images" to , "color_palette" to null, "seed" to null), options = ai.sunra.client.kt.SubscribeOptions(logs = true), onUpdate = { update -> println("\nStatus Update: ${update.status}, Request ID: ${update.requestId}") } ) println("Completed!") println(response.data) ``` ### Curl ```bash curl --request POST \ --url https://api.sunra.ai/v1/queue/ideogram/ideogram-v3/remix \ --header "Authorization: Key $SUNRA_KEY" \ --header "Content-Type: application/json" \ --data '{"prompt":"","prompt_enhancer":false,"negative_prompt":"","number_of_images":1,"image":"","image_strength":0.5,"aspect_ratio":"1:1","rendering_speed":"default","style_codes":[],"style_type":"general","style_reference_images":[],"color_palette":null,"seed":null}' ``` ## Model readme undefined