Generate 3.0 (텍스트 이미지 생성) Generate
POST
/ideogram/v1/ideogram-v3/generate
- 주어진 프롬프트와 선택적 매개변수를 기반으로 Ideogram 3.0 모델을 사용하여 이미지를 동기적으로 생성합니다
- 반환된 이미지 URL은 24시간 동안 유효하며, 이후에는 접근할 수 없습니다
- 이미지는 프록시를 통해 제공됩니다
- 공식 문서: Generate 3.0 API
Authorizations
bearer
Type
HTTP (bearer)
Request Body
application/json
prompt
string
Required
이미지 생성에 필요한 프롬프트 텍스트
seed
integer
랜덤 시드. 이 값을 설정하면 재현 가능한 생성 결과를 얻을 수 있습니다
Minimum
0Maximum
2147483647resolution
string
지원되는 해상도 옵션
Valid values
"512x1536""576x1408""576x1472""576x1536""640x1344""640x1408""640x1472""640x1536""704x1152""704x1216""704x1280""704x1344""704x1408""704x1472""736x1312""768x1088""768x1216""768x1280""768x1344""800x1280""832x960""832x1024""832x1088""832x1152""832x1216""832x1248""864x1152""896x960""896x1024""896x1088""896x1120""896x1152""960x832""960x896""960x1024""960x1088""1024x832""1024x896""1024x960""1024x1024""1088x768""1088x832""1088x896""1088x960""1120x896""1152x704""1152x832""1152x864""1152x896""1216x704""1216x768""1216x832""1248x832""1280x704""1280x768""1280x800""1312x736""1344x640""1344x704""1344x768""1408x576""1408x640""1408x704""1472x576""1472x640""1472x704""1536x512""1536x576""1536x640"aspect_ratio
string
이미지 생성을 위한 종횡비로, 이미지 해상도를 결정합니다. resolution 매개변수와 동시에 사용할 수 없습니다. 기본값은 1x1
Valid values
"1x3""3x1""1x2""2x1""9x16""16x9""10x16""16x10""2x3""3x2""3x4""4x3""4x5""5x4""1x1"rendering_speed
string
렌더링 속도 옵션
Valid values
"TURBO""DEFAULT""QUALITY"Default
"DEFAULT"magic_prompt
string
요청 생성 시 Magic Prompt 사용 여부를 결정합니다
Valid values
"AUTO""ON""OFF"negative_prompt
string
이미지에서 제외할 내용을 설명합니다. 프롬프트의 설명이 네거티브 프롬프트의 설명보다 우선합니다
num_images
integer
생성할 이미지 수
Minimum
1Maximum
8Default
1color_palette
object
생성을 위한 색상 팔레트로, 프리셋(name) 또는 선택적 가중치가 있는 HEX 색상 표현(members)을 통해 명시적으로 지정해야 합니다
Expand
style_codes
string[]
이미지 스타일을 나타내는 8자리 16진수 코드 목록. style_reference_images 또는 style_type과 동시에 사용할 수 없습니다
Expand
style_type
string
생성할 스타일 유형
Valid values
"AUTO""GENERAL""REALISTIC""DESIGN"Default
"GENERAL"Responses
성공
application/json
object
code
integer
Required
message
string
Required
request_id
string
Required
data
object
Required