IdeogramFastHigh

Ideogram V3 Turbo

The fastest and cheapest Ideogram v3 tier. V3 creates images with stunning realism, creative designs, and consistent styles.

70 credits

per image

Fastest and cheapest tier of Ideogram v3

60+ fixed resolution presets in addition to aspect ratio

Inpainting support via image + mask

60+ curated style presets and 4 broad style types

Magic Prompt auto-optimizes and can translate prompts

Run it right now

Test this model instantly in the Console Playground — no code required

Use with AI Assistant

Copy usage instructions for Claude, ChatGPT, or other AI

llms.txtllms.txt ↗

Quick Start

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "ideogram-ai/ideogram-v3-turbo",
  "input": {
    "prompt": "The text \"V3 Turbo\" in the center middle. A color film-inspired portrait of a young man looking to the side with a shallow depth of field.",
    "aspect_ratio": "3:2",
    "magic_prompt_option": "Auto"
  }
}'

Parameters

Parameter	Type	Required	Default	Description
`prompt`	string	Yes	-	Text prompt for image generation
`aspect_ratio`	string	No	1:1	Aspect ratio. Ignored if a resolution or inpainting image is given 1:33:11:22:19:1616:910:1616:102:33:23:44:34:55:41:1
`resolution`	string	No	None	Fixed pixel resolution. Overrides aspect_ratio. Ignored if an inpainting image is given None512x1536576x1408576x1472576x1536640x1344640x1408640x1472640x1536704x1152704x1216704x1280704x1344704x1408704x1472736x1312768x1088768x1216768x1280768x1344800x1280832x960832x1024832x1088832x1152832x1216832x1248864x1152896x960896x1024896x1088896x1120896x1152960x832960x896960x1024960x10881024x8321024x8961024x9601024x10241088x7681088x8321088x8961088x9601120x8961152x7041152x8321152x8641152x8961216x7041216x7681216x8321248x8321280x7041280x7681280x8001312x7361344x6401344x7041344x7681408x5761408x6401408x7041472x5761472x6401472x7041536x5121536x5761536x640
`magic_prompt_option`	string	No	Auto	Interprets and optimizes your prompt for variety and quality; can rewrite prompts in other languages AutoOnOff
`image`	string	No	-	An image file to use for inpainting. Requires a mask
`mask`	string	No	-	A black and white image; black pixels are inpainted, white pixels are preserved
`style_type`	string	No	None	The overall aesthetic style of the generated image NoneAutoGeneralRealisticDesign
`style_reference_images`	array	No	-	A list of images to use as style references.
`seed`	integer	No	-	Random seed. Set for reproducible generation
`style_preset`	string	No	None	Apply a predefined artistic style to the generated image (V3 models only) None80s Illustration90s NostalgiaAbstract OrganicAnalog NostalgiaArt BrutArt DecoArt PosterAuraAvant GardeBauhausBlueprintBlurry MotionBright ArtC4D CartoonChildren's BookCollageColoring Book IColoring Book IICubismDark AuraDoodleDouble ExposureDramatic CinemaEditorialEmotional MinimalEthereal PartyExpired FilmFlat ArtFlat VectorForest ReverieGeo MinimalistGlass PrismGolden HourGraffiti IGraffiti IIHalftone PrintHigh ContrastHippie EraIconicJapandi FusionJazzyLong ExposureMagazine EditorialMinimal IllustrationMixed MediaMonochromeNightlifeOil PaintingOld CartoonsPaint GesturePop ArtRetro EtchingRiviera PopSpotlight 80sStylized RedSurreal CollageTravel PosterVintage GeoVintage PosterWatercolorWeirdWoodblock Print

How to Provide File Input

There are 3 ways to provide files for the imagemask parameters:

Recommended

Direct Upload (Multipart)

Attach files directly to POST /v1/predictions/upload. No separate upload step needed.

curl -X POST "https://api.core.today/v1/predictions/upload" \
  -H "X-API-Key: cdt_your_api_key" \
  -F "model=ideogram-ai/ideogram-v3-turbo" \
  -F 'input={"prompt":"your prompt here"}' \
  -F "file:image=@your_file.png"

Image URL

Pass a publicly accessible URL directly. You can also use file_url from the Storage API.

{
  "model": "ideogram-ai/ideogram-v3-turbo",
  "input": {
    "prompt": "your prompt here",
    "image": "https://example.com/image.jpg"
  }
}

See the File Upload docs for more upload methods including Presigned URLs.

Common Parameters

Common parameters used when calling POST /v1/predictions.

Parameter	Type	Required	Default	Description
`model`	string	Yes	-	Model identifier
`input`	object	Yes	-	Object containing the model-specific parameters from the table above
`output_folder`	string	No	-	Folder path for output files (max 256 chars, '..' not allowed)
`webhook_url`	string	No	-	Webhook URL to call on completion
`is_public`	boolean	No	false	If true, output files are also available via permanent public URLs

Examples

Typography Portrait

A film-inspired portrait with embedded text

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "ideogram-ai/ideogram-v3-turbo",
  "input": {
    "prompt": "The text \"V3 Turbo\" in the center middle. A color film-inspired portrait of a young man looking to the side with a shallow depth of field.",
    "aspect_ratio": "3:2",
    "magic_prompt_option": "Auto"
  }
}'