Remix（subject reference）

POST

/ideogram/v1/ideogram-v3/remix

Text-to-image generation from Ideogram excels at producing accurate text and posters. It now supports inputting portrait subjects to generate images referencing the subject.
Official documentation: https://developer.ideogram.ai/api-reference/api-reference/remix-v3

Price: Ideogram v3 turbo - 0.1 PTC/request
Price: Ideogram v3 default - 0.15 PTC/request
Price: Ideogram v3 quality - 0.2 PTC/request

Request

Header Params

Body Params multipart/form-data

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.302.ai/ideogram/v1/ideogram-v3/remix' \
--header 'Authorization: Bearer sk-jls4AaVBGoe1GwZD64qZA1qyKTN1MPHa4NmvH1cT68z7K1Zz' \
--form 'image=@""' \
--form 'prompt=""' \
--form 'rendering_speed="DEFAULT"' \
--form 'character_reference_images=""' \
--form 'character_reference_images_mask=""'

Responses

🟢200成功

application/json

Body

Example

{"created":"2025-04-18T03:33:36.406137+00:00","data":[{"is_image_safe":true,"prompt":"A photo of a golden retriever dog playing fetch in a field. The dog is running with a stick in its mouth. The background is a vast green field with a few trees. The sky is clear with a few clouds.","resolution":"1024x1024","seed":12345,"url":"https://file.302.ai/gpt/imgs/20250418/53b334a66f4746b1b5facf73d8339659.png"}]}

Modified at 2025-08-19 06:10:16

Edit（subject reference）

Edit（Image EditionV3）