Generate（subject reference）

POST

/ideogram/v1/ideogram-v3/generate

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/generate-v3

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

Request

Header Params

Body Params application/json

Example

{
  "prompt": "cat"
}

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/generate' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
  "prompt": "cat"
}'

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:09:54

Flux-1-SRPO（Image-to-Image Generation）

Generate（Text-to-image V3）