Ideogram 3.0

Ideogram 3.0 is a text to image model for high fidelity design work. It improves text rendering, complex layout handling, and photorealism. It also adds stronger style controls and supports editing tasks like inpainting and background replacement for production workflows.

Complete technical specification for integration
Ready-to-use code snippets for common workflows
text-to-image
Ceramic Glaze Powder Pouch Label$0.09~26s
Create a polished square packaging label for a professional ceramic glaze powder used by pottery studios. Show the flat, print-ready front label artwork only, edge to edge, with no pouch, mockup, hands, shadows, or surrounding scene. Art direction: bold Swiss modernism with subtle Bauhaus influence, disciplined grid, oversized condensed sans-serif typography, crisp rules, registration marks, and an abstract orbital diagram inspired by a kiln viewed from above. Palette of carbon black, warm uncoated ivory, vivid cobalt blue, and one sharp safety-orange accent. Matte screen-printed character with slight ink texture while remaining exceptionally clean and commercially finished. Render this wording clearly and exactly, with strong hierarchy and no additional text: CLAY SIGNAL NIGHT ORBIT CONE 6 CERAMIC GLAZE SATIN BLACK BRUSH / DIP / SPRAY FIRING RANGE 1200–1240°C MIX • SIEVE • FIRE LEAD-FREE NET WT 1 KG Make “NIGHT ORBIT” the dominant headline across two lines. Set “CLAY SIGNAL” as a compact brand wordmark at the top. Arrange the technical details in a precise modular information panel along the lower third. Integrate the cobalt orbital graphic behind and around the headline without reducing legibility. Premium contemporary art-supply packaging, balanced negative space, sharp alignment, accurate spelling, highly legible typography, production-ready label design.
import { createClient } from '@runware/sdk'
const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()
const [result] = await client.run({
model: 'ideogram:4@1',
positivePrompt: 'Create a polished square packaging label for a professional ceramic glaze powder used by pottery studios. Show the flat, print-ready front label artwork only, edge to edge, with no pouch, mockup, hands, shadows, or surrounding scene. Art direction: bold Swiss modernism with subtle Bauhaus influence, disciplined grid, oversized condensed sans-serif typography, crisp rules, registration marks, and an abstract orbital diagram inspired by a kiln viewed from above. Palette of carbon black, warm uncoated ivory, vivid cobalt blue, and one sharp safety-orange accent. Matte screen-printed character with slight ink texture while remaining exceptionally clean and commercially finished.\n\nRender this wording clearly and exactly, with strong hierarchy and no additional text:\n\nCLAY SIGNAL\nNIGHT ORBIT\nCONE 6 CERAMIC GLAZE\nSATIN BLACK\nBRUSH / DIP / SPRAY\nFIRING RANGE 1200–1240°C\nMIX • SIEVE • FIRE\nLEAD-FREE\nNET WT 1 KG\n\nMake “NIGHT ORBIT” the dominant headline across two lines. Set “CLAY SIGNAL” as a compact brand wordmark at the top. Arrange the technical details in a precise modular information panel along the lower third. Integrate the cobalt orbital graphic behind and around the headline without reducing legibility. Premium contemporary art-supply packaging, balanced negative space, sharp alignment, accurate spelling, highly legible typography, production-ready label design.',
width: 1024,
height: 1024,
providerSettings: {
ideogram: {
magicPrompt: 'ON',
renderingSpeed: 'QUALITY',
styleType: 'DESIGN'
}
}
})import asyncio
import os
from runware import Runware
async def main():
async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
results = await client.run({
"model": "ideogram:4@1",
"positivePrompt": "Create a polished square packaging label for a professional ceramic glaze powder used by pottery studios. Show the flat, print-ready front label artwork only, edge to edge, with no pouch, mockup, hands, shadows, or surrounding scene. Art direction: bold Swiss modernism with subtle Bauhaus influence, disciplined grid, oversized condensed sans-serif typography, crisp rules, registration marks, and an abstract orbital diagram inspired by a kiln viewed from above. Palette of carbon black, warm uncoated ivory, vivid cobalt blue, and one sharp safety-orange accent. Matte screen-printed character with slight ink texture while remaining exceptionally clean and commercially finished.\n\nRender this wording clearly and exactly, with strong hierarchy and no additional text:\n\nCLAY SIGNAL\nNIGHT ORBIT\nCONE 6 CERAMIC GLAZE\nSATIN BLACK\nBRUSH / DIP / SPRAY\nFIRING RANGE 1200–1240°C\nMIX • SIEVE • FIRE\nLEAD-FREE\nNET WT 1 KG\n\nMake “NIGHT ORBIT” the dominant headline across two lines. Set “CLAY SIGNAL” as a compact brand wordmark at the top. Arrange the technical details in a precise modular information panel along the lower third. Integrate the cobalt orbital graphic behind and around the headline without reducing legibility. Premium contemporary art-supply packaging, balanced negative space, sharp alignment, accurate spelling, highly legible typography, production-ready label design.",
"width": 1024,
"height": 1024,
"providerSettings": {
"ideogram": {
"magicPrompt": "ON",
"renderingSpeed": "QUALITY",
"styleType": "DESIGN"
}
}
})
asyncio.run(main())curl https://api.runware.ai/v1 \
-H "Authorization: Bearer $RUNWARE_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"taskType": "imageInference",
"taskUUID": "653ba01e-1c29-4013-9059-9a0311b48dc8",
"model": "ideogram:4@1",
"positivePrompt": "Create a polished square packaging label for a professional ceramic glaze powder used by pottery studios. Show the flat, print-ready front label artwork only, edge to edge, with no pouch, mockup, hands, shadows, or surrounding scene. Art direction: bold Swiss modernism with subtle Bauhaus influence, disciplined grid, oversized condensed sans-serif typography, crisp rules, registration marks, and an abstract orbital diagram inspired by a kiln viewed from above. Palette of carbon black, warm uncoated ivory, vivid cobalt blue, and one sharp safety-orange accent. Matte screen-printed character with slight ink texture while remaining exceptionally clean and commercially finished.\n\nRender this wording clearly and exactly, with strong hierarchy and no additional text:\n\nCLAY SIGNAL\nNIGHT ORBIT\nCONE 6 CERAMIC GLAZE\nSATIN BLACK\nBRUSH / DIP / SPRAY\nFIRING RANGE 1200–1240°C\nMIX • SIEVE • FIRE\nLEAD-FREE\nNET WT 1 KG\n\nMake “NIGHT ORBIT” the dominant headline across two lines. Set “CLAY SIGNAL” as a compact brand wordmark at the top. Arrange the technical details in a precise modular information panel along the lower third. Integrate the cobalt orbital graphic behind and around the headline without reducing legibility. Premium contemporary art-supply packaging, balanced negative space, sharp alignment, accurate spelling, highly legible typography, production-ready label design.",
"width": 1024,
"height": 1024,
"providerSettings": {
"ideogram": {
"magicPrompt": "ON",
"renderingSpeed": "QUALITY",
"styleType": "DESIGN"
}
}
}
]'runware run ideogram:4@1 \
positivePrompt="Create a polished square packaging label for a professional ceramic glaze powder used by pottery studios. Show the flat, print-ready front label artwork only, edge to edge, with no pouch, mockup, hands, shadows, or surrounding scene. Art direction: bold Swiss modernism with subtle Bauhaus influence, disciplined grid, oversized condensed sans-serif typography, crisp rules, registration marks, and an abstract orbital diagram inspired by a kiln viewed from above. Palette of carbon black, warm uncoated ivory, vivid cobalt blue, and one sharp safety-orange accent. Matte screen-printed character with slight ink texture while remaining exceptionally clean and commercially finished.
Render this wording clearly and exactly, with strong hierarchy and no additional text:
CLAY SIGNAL
NIGHT ORBIT
CONE 6 CERAMIC GLAZE
SATIN BLACK
BRUSH / DIP / SPRAY
FIRING RANGE 1200–1240°C
MIX • SIEVE • FIRE
LEAD-FREE
NET WT 1 KG
Make “NIGHT ORBIT” the dominant headline across two lines. Set “CLAY SIGNAL” as a compact brand wordmark at the top. Arrange the technical details in a precise modular information panel along the lower third. Integrate the cobalt orbital graphic behind and around the headline without reducing legibility. Premium contemporary art-supply packaging, balanced negative space, sharp alignment, accurate spelling, highly legible typography, production-ready label design." \
width=1024 \
height=1024 \
providerSettings.ideogram.magicPrompt=ON \
providerSettings.ideogram.renderingSpeed=QUALITY \
providerSettings.ideogram.styleType=DESIGN{
"taskType": "imageInference",
"taskUUID": "653ba01e-1c29-4013-9059-9a0311b48dc8",
"model": "ideogram:4@1",
"positivePrompt": "Create a polished square packaging label for a professional ceramic glaze powder used by pottery studios. Show the flat, print-ready front label artwork only, edge to edge, with no pouch, mockup, hands, shadows, or surrounding scene. Art direction: bold Swiss modernism with subtle Bauhaus influence, disciplined grid, oversized condensed sans-serif typography, crisp rules, registration marks, and an abstract orbital diagram inspired by a kiln viewed from above. Palette of carbon black, warm uncoated ivory, vivid cobalt blue, and one sharp safety-orange accent. Matte screen-printed character with slight ink texture while remaining exceptionally clean and commercially finished.\n\nRender this wording clearly and exactly, with strong hierarchy and no additional text:\n\nCLAY SIGNAL\nNIGHT ORBIT\nCONE 6 CERAMIC GLAZE\nSATIN BLACK\nBRUSH / DIP / SPRAY\nFIRING RANGE 1200–1240°C\nMIX • SIEVE • FIRE\nLEAD-FREE\nNET WT 1 KG\n\nMake “NIGHT ORBIT” the dominant headline across two lines. Set “CLAY SIGNAL” as a compact brand wordmark at the top. Arrange the technical details in a precise modular information panel along the lower third. Integrate the cobalt orbital graphic behind and around the headline without reducing legibility. Premium contemporary art-supply packaging, balanced negative space, sharp alignment, accurate spelling, highly legible typography, production-ready label design.",
"width": 1024,
"height": 1024,
"providerSettings": {
"ideogram": {
"magicPrompt": "ON",
"renderingSpeed": "QUALITY",
"styleType": "DESIGN"
}
}
}Response
{
"taskType": "imageInference",
"taskUUID": "653ba01e-1c29-4013-9059-9a0311b48dc8",
"imageUUID": "8004d253-a0cc-4f5d-b458-feca0541e119",
"imageURL": "https://im.runware.ai/image/os/a08dlim3/ws/3/ii/8004d253-a0cc-4f5d-b458-feca0541e119.jpg",
"seed": 1470565002,
"cost": 0.09
}text-to-image
Municipal Dive Supervisor Headshot$0.09~24s
Create a finished square editorial profile graphic centered on a professional head-and-shoulders portrait of AMARA IBE, a Black woman in her early 40s who leads a municipal underwater inspection team. She has close-cropped natural hair, a composed direct gaze, and a quietly authoritative expression. She wears a spotless black technical drysuit with a high neoprene collar and subtle reflective seams, no helmet. Photorealistic skin, authentic facial detail, dignified and credible rather than glamorous. Crisp studio lighting: cool cyan edge light, soft neutral key light, deep cobalt shadows. Graphic art direction inspired by contemporary infrastructure journals: saturated chlorine-aqua background, cobalt geometric blocks, one narrow signal-yellow rule, restrained sonar rings and technical depth marks. Strong asymmetrical composition with the portrait occupying the right two-thirds and typography integrated on the left without covering her face. Render this exact wording clearly and accurately: large bold uppercase “AMARA IBE”; beneath it, smaller uppercase “MUNICIPAL DIVE SUPERVISOR”; prominent editorial headline “BELOW THE WATERLINE”; small label “INFRASTRUCTURE PORTRAIT 07”. Use a clean condensed sans-serif for the name and headline, precise spacing, sharp hierarchy, immaculate alignment, and high legibility. No other words. Premium commissioned portrait, modern civic engineering mood, calm competence, full-bleed finished artwork, no logo, no interface, no mockup, no border.
import { createClient } from '@runware/sdk'
const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()
const [result] = await client.run({
model: 'ideogram:4@1',
positivePrompt: 'Create a finished square editorial profile graphic centered on a professional head-and-shoulders portrait of AMARA IBE, a Black woman in her early 40s who leads a municipal underwater inspection team. She has close-cropped natural hair, a composed direct gaze, and a quietly authoritative expression. She wears a spotless black technical drysuit with a high neoprene collar and subtle reflective seams, no helmet. Photorealistic skin, authentic facial detail, dignified and credible rather than glamorous. Crisp studio lighting: cool cyan edge light, soft neutral key light, deep cobalt shadows. Graphic art direction inspired by contemporary infrastructure journals: saturated chlorine-aqua background, cobalt geometric blocks, one narrow signal-yellow rule, restrained sonar rings and technical depth marks. Strong asymmetrical composition with the portrait occupying the right two-thirds and typography integrated on the left without covering her face. Render this exact wording clearly and accurately: large bold uppercase “AMARA IBE”; beneath it, smaller uppercase “MUNICIPAL DIVE SUPERVISOR”; prominent editorial headline “BELOW THE WATERLINE”; small label “INFRASTRUCTURE PORTRAIT 07”. Use a clean condensed sans-serif for the name and headline, precise spacing, sharp hierarchy, immaculate alignment, and high legibility. No other words. Premium commissioned portrait, modern civic engineering mood, calm competence, full-bleed finished artwork, no logo, no interface, no mockup, no border.',
width: 1024,
height: 1024,
providerSettings: {
ideogram: {
magicPrompt: 'ON',
renderingSpeed: 'QUALITY',
styleType: 'DESIGN'
}
}
})import asyncio
import os
from runware import Runware
async def main():
async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
results = await client.run({
"model": "ideogram:4@1",
"positivePrompt": "Create a finished square editorial profile graphic centered on a professional head-and-shoulders portrait of AMARA IBE, a Black woman in her early 40s who leads a municipal underwater inspection team. She has close-cropped natural hair, a composed direct gaze, and a quietly authoritative expression. She wears a spotless black technical drysuit with a high neoprene collar and subtle reflective seams, no helmet. Photorealistic skin, authentic facial detail, dignified and credible rather than glamorous. Crisp studio lighting: cool cyan edge light, soft neutral key light, deep cobalt shadows. Graphic art direction inspired by contemporary infrastructure journals: saturated chlorine-aqua background, cobalt geometric blocks, one narrow signal-yellow rule, restrained sonar rings and technical depth marks. Strong asymmetrical composition with the portrait occupying the right two-thirds and typography integrated on the left without covering her face. Render this exact wording clearly and accurately: large bold uppercase “AMARA IBE”; beneath it, smaller uppercase “MUNICIPAL DIVE SUPERVISOR”; prominent editorial headline “BELOW THE WATERLINE”; small label “INFRASTRUCTURE PORTRAIT 07”. Use a clean condensed sans-serif for the name and headline, precise spacing, sharp hierarchy, immaculate alignment, and high legibility. No other words. Premium commissioned portrait, modern civic engineering mood, calm competence, full-bleed finished artwork, no logo, no interface, no mockup, no border.",
"width": 1024,
"height": 1024,
"providerSettings": {
"ideogram": {
"magicPrompt": "ON",
"renderingSpeed": "QUALITY",
"styleType": "DESIGN"
}
}
})
asyncio.run(main())curl https://api.runware.ai/v1 \
-H "Authorization: Bearer $RUNWARE_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"taskType": "imageInference",
"taskUUID": "b5562498-d2ac-4690-b9b4-c6770672f4cd",
"model": "ideogram:4@1",
"positivePrompt": "Create a finished square editorial profile graphic centered on a professional head-and-shoulders portrait of AMARA IBE, a Black woman in her early 40s who leads a municipal underwater inspection team. She has close-cropped natural hair, a composed direct gaze, and a quietly authoritative expression. She wears a spotless black technical drysuit with a high neoprene collar and subtle reflective seams, no helmet. Photorealistic skin, authentic facial detail, dignified and credible rather than glamorous. Crisp studio lighting: cool cyan edge light, soft neutral key light, deep cobalt shadows. Graphic art direction inspired by contemporary infrastructure journals: saturated chlorine-aqua background, cobalt geometric blocks, one narrow signal-yellow rule, restrained sonar rings and technical depth marks. Strong asymmetrical composition with the portrait occupying the right two-thirds and typography integrated on the left without covering her face. Render this exact wording clearly and accurately: large bold uppercase “AMARA IBE”; beneath it, smaller uppercase “MUNICIPAL DIVE SUPERVISOR”; prominent editorial headline “BELOW THE WATERLINE”; small label “INFRASTRUCTURE PORTRAIT 07”. Use a clean condensed sans-serif for the name and headline, precise spacing, sharp hierarchy, immaculate alignment, and high legibility. No other words. Premium commissioned portrait, modern civic engineering mood, calm competence, full-bleed finished artwork, no logo, no interface, no mockup, no border.",
"width": 1024,
"height": 1024,
"providerSettings": {
"ideogram": {
"magicPrompt": "ON",
"renderingSpeed": "QUALITY",
"styleType": "DESIGN"
}
}
}
]'runware run ideogram:4@1 \
positivePrompt="Create a finished square editorial profile graphic centered on a professional head-and-shoulders portrait of AMARA IBE, a Black woman in her early 40s who leads a municipal underwater inspection team. She has close-cropped natural hair, a composed direct gaze, and a quietly authoritative expression. She wears a spotless black technical drysuit with a high neoprene collar and subtle reflective seams, no helmet. Photorealistic skin, authentic facial detail, dignified and credible rather than glamorous. Crisp studio lighting: cool cyan edge light, soft neutral key light, deep cobalt shadows. Graphic art direction inspired by contemporary infrastructure journals: saturated chlorine-aqua background, cobalt geometric blocks, one narrow signal-yellow rule, restrained sonar rings and technical depth marks. Strong asymmetrical composition with the portrait occupying the right two-thirds and typography integrated on the left without covering her face. Render this exact wording clearly and accurately: large bold uppercase “AMARA IBE”; beneath it, smaller uppercase “MUNICIPAL DIVE SUPERVISOR”; prominent editorial headline “BELOW THE WATERLINE”; small label “INFRASTRUCTURE PORTRAIT 07”. Use a clean condensed sans-serif for the name and headline, precise spacing, sharp hierarchy, immaculate alignment, and high legibility. No other words. Premium commissioned portrait, modern civic engineering mood, calm competence, full-bleed finished artwork, no logo, no interface, no mockup, no border." \
width=1024 \
height=1024 \
providerSettings.ideogram.magicPrompt=ON \
providerSettings.ideogram.renderingSpeed=QUALITY \
providerSettings.ideogram.styleType=DESIGN{
"taskType": "imageInference",
"taskUUID": "b5562498-d2ac-4690-b9b4-c6770672f4cd",
"model": "ideogram:4@1",
"positivePrompt": "Create a finished square editorial profile graphic centered on a professional head-and-shoulders portrait of AMARA IBE, a Black woman in her early 40s who leads a municipal underwater inspection team. She has close-cropped natural hair, a composed direct gaze, and a quietly authoritative expression. She wears a spotless black technical drysuit with a high neoprene collar and subtle reflective seams, no helmet. Photorealistic skin, authentic facial detail, dignified and credible rather than glamorous. Crisp studio lighting: cool cyan edge light, soft neutral key light, deep cobalt shadows. Graphic art direction inspired by contemporary infrastructure journals: saturated chlorine-aqua background, cobalt geometric blocks, one narrow signal-yellow rule, restrained sonar rings and technical depth marks. Strong asymmetrical composition with the portrait occupying the right two-thirds and typography integrated on the left without covering her face. Render this exact wording clearly and accurately: large bold uppercase “AMARA IBE”; beneath it, smaller uppercase “MUNICIPAL DIVE SUPERVISOR”; prominent editorial headline “BELOW THE WATERLINE”; small label “INFRASTRUCTURE PORTRAIT 07”. Use a clean condensed sans-serif for the name and headline, precise spacing, sharp hierarchy, immaculate alignment, and high legibility. No other words. Premium commissioned portrait, modern civic engineering mood, calm competence, full-bleed finished artwork, no logo, no interface, no mockup, no border.",
"width": 1024,
"height": 1024,
"providerSettings": {
"ideogram": {
"magicPrompt": "ON",
"renderingSpeed": "QUALITY",
"styleType": "DESIGN"
}
}
}Response
{
"taskType": "imageInference",
"taskUUID": "b5562498-d2ac-4690-b9b4-c6770672f4cd",
"imageUUID": "b3aa6071-4b61-4d53-b559-72e3e15348dd",
"imageURL": "https://im.runware.ai/image/os/a04d20/ws/3/ii/b3aa6071-4b61-4d53-b559-72e3e15348dd.jpg",
"seed": 1868229581,
"cost": 0.09
}identity-preservation
Geothermal Careers Recruitment Campaign Visual$0.09~1m 35s
Create a finished 896x1152 portrait advertising campaign visual for geothermal-energy career recruitment. Use the supplied character reference as the sole person and preserve her recognizable facial structure, skin tone, hair, age, height, and sturdy athletic body proportions. Place her at a working geothermal power station on a volcanic plateau at dawn, standing confidently in the foreground in a clean rust-red utility coverall, white hard hat held at her side, safety boots, and practical work gloves. Her face remains unobstructed and clearly recognizable; direct, capable gaze toward camera. Behind her: silver insulated pipes, valves, low industrial buildings, dark basalt ground, and dramatic white steam drifting laterally through cold blue morning light. No other people. Premium editorial campaign photography mixed with disciplined Swiss-inspired graphic design, strong geometric framing, mineral-gray and icy-cyan environment with rust-red accents, crisp detail, subtle film grain, realistic skin and industrial textures. Compose with the subject in the lower-right two-thirds and ample steam-filled negative space at upper left. Add one bold condensed sans-serif headline in exact uppercase text: “POWER FROM BELOW”. Place a small uppercase kicker above it reading exactly: “GEOTHERMAL CAREERS”. High legibility, clean spacing, off-white typography, no logo, no URL, no additional text. Standalone finished ad artwork, not a billboard mockup or interface.
import { createClient } from '@runware/sdk'
const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()
const [result] = await client.run({
model: 'ideogram:4@1',
positivePrompt: 'Create a finished 896x1152 portrait advertising campaign visual for geothermal-energy career recruitment. Use the supplied character reference as the sole person and preserve her recognizable facial structure, skin tone, hair, age, height, and sturdy athletic body proportions. Place her at a working geothermal power station on a volcanic plateau at dawn, standing confidently in the foreground in a clean rust-red utility coverall, white hard hat held at her side, safety boots, and practical work gloves. Her face remains unobstructed and clearly recognizable; direct, capable gaze toward camera. Behind her: silver insulated pipes, valves, low industrial buildings, dark basalt ground, and dramatic white steam drifting laterally through cold blue morning light. No other people. Premium editorial campaign photography mixed with disciplined Swiss-inspired graphic design, strong geometric framing, mineral-gray and icy-cyan environment with rust-red accents, crisp detail, subtle film grain, realistic skin and industrial textures. Compose with the subject in the lower-right two-thirds and ample steam-filled negative space at upper left. Add one bold condensed sans-serif headline in exact uppercase text: “POWER FROM BELOW”. Place a small uppercase kicker above it reading exactly: “GEOTHERMAL CAREERS”. High legibility, clean spacing, off-white typography, no logo, no URL, no additional text. Standalone finished ad artwork, not a billboard mockup or interface.',
negativePrompt: 'Extra people, duplicated person, altered identity, obscured face, sunglasses, face shield, distorted hands, extra fingers, fashion styling, fantasy machinery, explosions, dirty typography, misspelled text, extra words, logos, watermarks, website UI, billboard mockup, border.',
width: 896,
height: 1152,
providerSettings: {
ideogram: {
characterReferenceImages: [
'https://assets.runware.ai/assets/inputs/f6f7cf2a-1628-4521-947f-b6452095df2b.jpg'
],
characterReferenceImagesMask: [
'https://assets.runware.ai/assets/inputs/3a27aac4-323f-407e-9553-e927cc3bae3c.png'
],
magicPrompt: 'AUTO',
renderingSpeed: 'QUALITY',
styleType: 'REALISTIC'
}
}
})import asyncio
import os
from runware import Runware
async def main():
async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
results = await client.run({
"model": "ideogram:4@1",
"positivePrompt": "Create a finished 896x1152 portrait advertising campaign visual for geothermal-energy career recruitment. Use the supplied character reference as the sole person and preserve her recognizable facial structure, skin tone, hair, age, height, and sturdy athletic body proportions. Place her at a working geothermal power station on a volcanic plateau at dawn, standing confidently in the foreground in a clean rust-red utility coverall, white hard hat held at her side, safety boots, and practical work gloves. Her face remains unobstructed and clearly recognizable; direct, capable gaze toward camera. Behind her: silver insulated pipes, valves, low industrial buildings, dark basalt ground, and dramatic white steam drifting laterally through cold blue morning light. No other people. Premium editorial campaign photography mixed with disciplined Swiss-inspired graphic design, strong geometric framing, mineral-gray and icy-cyan environment with rust-red accents, crisp detail, subtle film grain, realistic skin and industrial textures. Compose with the subject in the lower-right two-thirds and ample steam-filled negative space at upper left. Add one bold condensed sans-serif headline in exact uppercase text: “POWER FROM BELOW”. Place a small uppercase kicker above it reading exactly: “GEOTHERMAL CAREERS”. High legibility, clean spacing, off-white typography, no logo, no URL, no additional text. Standalone finished ad artwork, not a billboard mockup or interface.",
"negativePrompt": "Extra people, duplicated person, altered identity, obscured face, sunglasses, face shield, distorted hands, extra fingers, fashion styling, fantasy machinery, explosions, dirty typography, misspelled text, extra words, logos, watermarks, website UI, billboard mockup, border.",
"width": 896,
"height": 1152,
"providerSettings": {
"ideogram": {
"characterReferenceImages": [
"https://assets.runware.ai/assets/inputs/f6f7cf2a-1628-4521-947f-b6452095df2b.jpg"
],
"characterReferenceImagesMask": [
"https://assets.runware.ai/assets/inputs/3a27aac4-323f-407e-9553-e927cc3bae3c.png"
],
"magicPrompt": "AUTO",
"renderingSpeed": "QUALITY",
"styleType": "REALISTIC"
}
}
})
asyncio.run(main())curl https://api.runware.ai/v1 \
-H "Authorization: Bearer $RUNWARE_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"taskType": "imageInference",
"taskUUID": "f4d82c0c-1b91-48b3-85b9-2715f9d5af09",
"model": "ideogram:4@1",
"positivePrompt": "Create a finished 896x1152 portrait advertising campaign visual for geothermal-energy career recruitment. Use the supplied character reference as the sole person and preserve her recognizable facial structure, skin tone, hair, age, height, and sturdy athletic body proportions. Place her at a working geothermal power station on a volcanic plateau at dawn, standing confidently in the foreground in a clean rust-red utility coverall, white hard hat held at her side, safety boots, and practical work gloves. Her face remains unobstructed and clearly recognizable; direct, capable gaze toward camera. Behind her: silver insulated pipes, valves, low industrial buildings, dark basalt ground, and dramatic white steam drifting laterally through cold blue morning light. No other people. Premium editorial campaign photography mixed with disciplined Swiss-inspired graphic design, strong geometric framing, mineral-gray and icy-cyan environment with rust-red accents, crisp detail, subtle film grain, realistic skin and industrial textures. Compose with the subject in the lower-right two-thirds and ample steam-filled negative space at upper left. Add one bold condensed sans-serif headline in exact uppercase text: “POWER FROM BELOW”. Place a small uppercase kicker above it reading exactly: “GEOTHERMAL CAREERS”. High legibility, clean spacing, off-white typography, no logo, no URL, no additional text. Standalone finished ad artwork, not a billboard mockup or interface.",
"negativePrompt": "Extra people, duplicated person, altered identity, obscured face, sunglasses, face shield, distorted hands, extra fingers, fashion styling, fantasy machinery, explosions, dirty typography, misspelled text, extra words, logos, watermarks, website UI, billboard mockup, border.",
"width": 896,
"height": 1152,
"providerSettings": {
"ideogram": {
"characterReferenceImages": [
"https://assets.runware.ai/assets/inputs/f6f7cf2a-1628-4521-947f-b6452095df2b.jpg"
],
"characterReferenceImagesMask": [
"https://assets.runware.ai/assets/inputs/3a27aac4-323f-407e-9553-e927cc3bae3c.png"
],
"magicPrompt": "AUTO",
"renderingSpeed": "QUALITY",
"styleType": "REALISTIC"
}
}
}
]'runware run ideogram:4@1 \
positivePrompt="Create a finished 896x1152 portrait advertising campaign visual for geothermal-energy career recruitment. Use the supplied character reference as the sole person and preserve her recognizable facial structure, skin tone, hair, age, height, and sturdy athletic body proportions. Place her at a working geothermal power station on a volcanic plateau at dawn, standing confidently in the foreground in a clean rust-red utility coverall, white hard hat held at her side, safety boots, and practical work gloves. Her face remains unobstructed and clearly recognizable; direct, capable gaze toward camera. Behind her: silver insulated pipes, valves, low industrial buildings, dark basalt ground, and dramatic white steam drifting laterally through cold blue morning light. No other people. Premium editorial campaign photography mixed with disciplined Swiss-inspired graphic design, strong geometric framing, mineral-gray and icy-cyan environment with rust-red accents, crisp detail, subtle film grain, realistic skin and industrial textures. Compose with the subject in the lower-right two-thirds and ample steam-filled negative space at upper left. Add one bold condensed sans-serif headline in exact uppercase text: “POWER FROM BELOW”. Place a small uppercase kicker above it reading exactly: “GEOTHERMAL CAREERS”. High legibility, clean spacing, off-white typography, no logo, no URL, no additional text. Standalone finished ad artwork, not a billboard mockup or interface." \
negativePrompt="Extra people, duplicated person, altered identity, obscured face, sunglasses, face shield, distorted hands, extra fingers, fashion styling, fantasy machinery, explosions, dirty typography, misspelled text, extra words, logos, watermarks, website UI, billboard mockup, border." \
width=896 \
height=1152 \
providerSettings.ideogram.characterReferenceImages.0=https://assets.runware.ai/assets/inputs/f6f7cf2a-1628-4521-947f-b6452095df2b.jpg \
providerSettings.ideogram.characterReferenceImagesMask.0=https://assets.runware.ai/assets/inputs/3a27aac4-323f-407e-9553-e927cc3bae3c.png \
providerSettings.ideogram.magicPrompt=AUTO \
providerSettings.ideogram.renderingSpeed=QUALITY \
providerSettings.ideogram.styleType=REALISTIC{
"taskType": "imageInference",
"taskUUID": "f4d82c0c-1b91-48b3-85b9-2715f9d5af09",
"model": "ideogram:4@1",
"positivePrompt": "Create a finished 896x1152 portrait advertising campaign visual for geothermal-energy career recruitment. Use the supplied character reference as the sole person and preserve her recognizable facial structure, skin tone, hair, age, height, and sturdy athletic body proportions. Place her at a working geothermal power station on a volcanic plateau at dawn, standing confidently in the foreground in a clean rust-red utility coverall, white hard hat held at her side, safety boots, and practical work gloves. Her face remains unobstructed and clearly recognizable; direct, capable gaze toward camera. Behind her: silver insulated pipes, valves, low industrial buildings, dark basalt ground, and dramatic white steam drifting laterally through cold blue morning light. No other people. Premium editorial campaign photography mixed with disciplined Swiss-inspired graphic design, strong geometric framing, mineral-gray and icy-cyan environment with rust-red accents, crisp detail, subtle film grain, realistic skin and industrial textures. Compose with the subject in the lower-right two-thirds and ample steam-filled negative space at upper left. Add one bold condensed sans-serif headline in exact uppercase text: “POWER FROM BELOW”. Place a small uppercase kicker above it reading exactly: “GEOTHERMAL CAREERS”. High legibility, clean spacing, off-white typography, no logo, no URL, no additional text. Standalone finished ad artwork, not a billboard mockup or interface.",
"negativePrompt": "Extra people, duplicated person, altered identity, obscured face, sunglasses, face shield, distorted hands, extra fingers, fashion styling, fantasy machinery, explosions, dirty typography, misspelled text, extra words, logos, watermarks, website UI, billboard mockup, border.",
"width": 896,
"height": 1152,
"providerSettings": {
"ideogram": {
"characterReferenceImages": [
"https://assets.runware.ai/assets/inputs/f6f7cf2a-1628-4521-947f-b6452095df2b.jpg"
],
"characterReferenceImagesMask": [
"https://assets.runware.ai/assets/inputs/3a27aac4-323f-407e-9553-e927cc3bae3c.png"
],
"magicPrompt": "AUTO",
"renderingSpeed": "QUALITY",
"styleType": "REALISTIC"
}
}
}Response
{
"taskType": "imageInference",
"taskUUID": "f4d82c0c-1b91-48b3-85b9-2715f9d5af09",
"imageUUID": "d6b65b0b-40f7-4565-acb2-273a031a7733",
"imageURL": "https://im.runware.ai/image/os/a01d21/ws/3/ii/d6b65b0b-40f7-4565-acb2-273a031a7733.jpg",
"seed": 1318035046,
"cost": 0.09
}