Ideogram V3 인터페이스
Ideogram V3 모델은 고급 이미지 생성 및 처리 기능을 제공합니다. V3 인터페이스는 이전 버전과 매개변수 및 사용법이 다르며, 이 섹션에서는 V3 인터페이스 및 사용 예제를 자세히 설명합니다.V3 생성
POST https://aihubmix.com/ideogram/v1/ideogram-v3/generate
주어진 프롬프트를 기반으로 이미지를 생성합니다. V3 모델은 더 높은 품질의 이미지 생성 기능을 제공하며 더 다양한 스타일과 매개변수 제어를 지원합니다.
string
필수
이미지 생성을 위한 프롬프트
string
기본값:"DEFAULT"
렌더링 속도 옵션, 사용 가능
TURBO, DEFAULT, QUALITYinteger
기본값:"1"
생성할 이미지 수, 범위 1-8
더 많은 이미지를 생성해도 생성 시간이 크게 늘어나지 않습니다.
더 많은 이미지를 생성해도 생성 시간이 크게 늘어나지 않습니다.
string
기본값:"1x1"
이미지 생성을 위한 가로 세로 비율, 다양한 사양 지원
사용 가능 [‘1x3’, ‘3x1’, ‘1x2’, ‘2x1’, ‘9x16’, ‘16x9’, ‘10x16’, ‘16x10’, ‘2x3’, ‘3x2’, ‘3x4’, ‘4x3’, ‘4x5’, ‘5x4’, ‘1x1’]
다른 모델에서 사용되는 가로 세로 비율은 다릅니다.
사용 가능 [‘1x3’, ‘3x1’, ‘1x2’, ‘2x1’, ‘9x16’, ‘16x9’, ‘10x16’, ‘16x10’, ‘2x3’, ‘3x2’, ‘3x4’, ‘4x3’, ‘4x5’, ‘5x4’, ‘1x1’]
다른 모델에서 사용되는 가로 세로 비율은 다릅니다.
string
기본값:"AUTO"
프롬프트 향상. 사용 가능한 매개변수:
AUTO, ON, OFFstring
기본값:"AUTO"
이미지 생성을 위한 스타일 유형, 사용 가능
참고: V2 버전에 비해 유형이 더 집중되었습니다.
AUTO, GENERAL, REALISTIC, DESIGN참고: V2 버전에 비해 유형이 더 집중되었습니다.
string
이미지에 나타나지 않기를 바라는 내용 설명
integer
랜덤 시드, 범위: 0-2147483647
여러 이미지를 생성할 때 시드를 사용하지 마십시오. 그렇지 않으면 동일한 이미지가 생성됩니다.
여러 이미지를 생성할 때 시드를 사용하지 마십시오. 그렇지 않으면 동일한 이미지가 생성됩니다.
file
스타일 참조 이미지, 스타일 안내에 사용할 수 있습니다.
사용 예제
V3 리믹스
POST https://aihubmix.com/ideogram/v1/ideogram-v3/remix
참조 이미지와 프롬프트를 기반으로 이미지를 리믹스합니다. V3의 리믹스 기능은 원본 이미지의 스타일과 내용을 더 잘 유지합니다.
string
필수
이미지 리믹스를 위한 프롬프트
file
필수
원본 이미지 파일
integer
기본값:"50"
원본 이미지의 가중치, 범위 1-100, 값이 클수록 원본 이미지와 결과가 더 유사합니다.
string
기본값:"DEFAULT"
렌더링 속도 옵션, 사용 가능
TURBO, DEFAULT, QUALITYinteger
기본값:"1"
생성할 이미지 수, 범위 1-8
더 많은 이미지를 생성해도 생성 시간이 크게 늘어나지 않습니다.
string
출력 이미지의 가로 세로 비율, 사용 가능 [‘1x3’, ‘3x1’, ‘1x2’, ‘2x1’, ‘9x16’, ‘16x9’, ‘10x16’, ‘16x10’, ‘2x3’, ‘3x2’, ‘3x4’, ‘4x3’, ‘4x5’, ‘5x4’, ‘1x1’]
file
스타일 참조 이미지, 스타일 안내에 사용할 수 있습니다.
integer
랜덤 시드, 범위: 0-2147483647
string
기본값:"AUTO"
프롬프트 향상. 사용 가능한 매개변수:
AUTO, ON, OFFstring
기본값:"AUTO"
이미지 생성을 위한 스타일 유형, 사용 가능
AUTO, GENERAL, REALISTIC, DESIGNstring
이미지에 나타나지 않기를 바라는 내용 설명
사용 예제
V3 편집
POST https://aihubmix.com/ideogram/v1/ideogram-v3/edit
V3의 로컬 편집 기능을 사용하면 원본 이미지와 마스크를 제공하여 이미지의 특정 영역을 정밀하게 편집하고 다른 영역은 변경하지 않은 상태로 유지할 수 있습니다.
string
필수
이미지 편집을 위한 프롬프트
file
필수
원본 이미지 파일
file
필수
마스크 이미지, 검은색 영역은 편집할 부분을 나타내고 흰색 영역은 변경하지 않을 부분을 나타냅니다.
string
기본값:"DEFAULT"
렌더링 속도 옵션, 사용 가능
TURBO, DEFAULT, QUALITYinteger
기본값:"1"
생성할 이미지 수, 범위 1-8
더 많은 이미지를 생성해도 생성 시간이 크게 늘어나지 않습니다.
string
출력 이미지의 가로 세로 비율, 사용 가능 [‘1x3’, ‘3x1’, ‘1x2’, ‘2x1’, ‘9x16’, ‘16x9’, ‘10x16’, ‘16x10’, ‘2x3’, ‘3x2’, ‘3x4’, ‘4x3’, ‘4x5’, ‘5x4’, ‘1x1’]
integer
랜덤 시드, 범위: 0-2147483647
string
기본값:"AUTO"
프롬프트 향상. 사용 가능한 매개변수:
AUTO, ON, OFFstring
기본값:"AUTO"
이미지 생성을 위한 스타일 유형, 사용 가능
AUTO, GENERAL, REALISTIC, DESIGNstring
이미지에 나타나지 않기를 바라는 내용 설명
사용 예제
V3 배경 교체
POST https://aihubmix.com/ideogram/v1/ideogram-v3/replace-background
V3의 배경 교체 기능은 이미지의 전경과 배경을 지능적으로 식별하고 프롬프트에 따라 배경을 교체하면서 전경 개체는 그대로 유지합니다.
string
필수
배경 교체를 위한 프롬프트
file
필수
원본 이미지 파일
string
기본값:"DEFAULT"
렌더링 속도 옵션, 사용 가능
TURBO, DEFAULT, QUALITYinteger
기본값:"1"
생성할 이미지 수, 범위 1-8
더 많은 이미지를 생성해도 생성 시간이 크게 늘어나지 않습니다.
file
스타일 참조 이미지, 스타일 안내에 사용할 수 있습니다.
integer
랜덤 시드, 범위: 0-2147483647
string
기본값:"AUTO"
프롬프트 향상. 사용 가능한 매개변수:
AUTO, ON, OFFstring
기본값:"AUTO"
이미지 생성을 위한 스타일 유형, 사용 가능
AUTO, GENERAL, REALISTIC, DESIGN사용 예제
💰 V3 가격
V2 & V1 인터페이스 설명
Ideogram AI V2 & V1 드로잉 인터페이스는 생성, 리믹스, 편집, 업스케일 및 설명 기능을 포함한 강력한 텍스트-이미지 기능을 제공합니다.- 리믹스: 참조 이미지와 프롬프트를 기반으로 새 이미지를 만듭니다.
- 편집: 프롬프트와 마스크를 사용하여 참조 이미지의 특정 영역을 로컬로 편집합니다.
- 업스케일: 유사성 및 세부 수준을 제어하여 저해상도 이미지를 고해상도로 향상시킵니다.
- 설명: 이미지를 설명하기 위해 프롬프트를 리버스 엔지니어링합니다.
- AUTO: 기본 자동 선택
- GENERAL: 일반 목적
- REALISTIC: 사실적
- DESIGN: 디자인 지향
- RENDER_3D: 3D 렌더링
- ANIME: 애니메이션 스타일
생성
POST https://aihubmix.com/ideogram/generate
주어진 프롬프트와 선택적 매개변수를 기반으로 이미지를 동기적으로 생성합니다. 이미지 링크는 유효 기간이 제한되어 있습니다. 이미지를 보관하려면 다운로드하여 저장해야 합니다.
요청 매개변수
object
필수
이미지 생성을 위한 요청 객체
string
필수
이미지 생성을 위한 프롬프트
string
기본값:"ASPECT_1_1"
이미지 생성을 위한 가로 세로 비율, 해상도를 결정합니다. 해상도 매개변수와 함께 사용할 수 없습니다.사용 가능한 비율:
- ASPECT_1_1
- ASPECT_3_1
- ASPECT_1_3
- ASPECT_3_2
- ASPECT_2_3
- ASPECT_4_3
- ASPECT_3_4
- ASPECT_16_9
- ASPECT_9_16
- SPECT_16_10
- ASPECT_10_16
string
기본값:"V_2"
이미지 생성 또는 편집을 위한 모델. /generate 및 /remix는 모든 모델 유형을 지원하지만 /edit는 V_2 및 V_2_TURBO만 지원합니다.사용 가능한 모델 버전:
- V_1
- V_1_TURBO
- V_2
- V_2_TURBO
- V_2A
- V_2A_TURBO
string
기본값:"AUTO"
프롬프트 향상 옵션. 사용 가능한 매개변수: AUTO, ON, OFF
integer
랜덤 시드, 범위: 0-2147483647
string
기본값:"AUTO"
이미지 생성에 사용되는 스타일 유형, 이 매개변수는 V_2 이상 버전의 모델에만 적용되며 V_1 버전에서는 지정해서는 안 됩니다.사용 가능한 스타일:
- AUTO
- GENERAL
- REALISTIC
- DESIGN
- RENDER_3D
- ANIME
string
이미지에 나타나지 않기를 바라는 내용을 설명합니다. 모델 버전 V_1, V_1_TURBO, V_2 및 V_2_TURBO에만 적용됩니다. 프롬프트의 설명이 부정적인 프롬프트의 설명보다 우선합니다.
integer
기본값:"1"
생성할 이미지 수, 범위 1-8
string
이미지 생성을 위한 해상도(모델 버전 2.0에만 적용, aspect_ratio와 함께 사용할 수 없음), 너비 x 높이로 표현됩니다. 지정하지 않으면 기본적으로 aspect_ratio가 사용됩니다.
예제 호출
응답
이미지가 성공적으로 생성되었습니다.오류 코드
400: 이미지 생성 요청 게시 잘못된 요청 오류401: 이미지 생성 요청 게시 무단 오류422: 이미지 생성 요청 게시 처리할 수 없는 엔터티 오류429: 이미지 생성 요청 게시 너무 많은 요청 오류
편집
POST https://aihubmix.com/ideogram/edit
제공된 마스크를 사용하여 지정된 이미지를 동기적으로 편집합니다. 마스크는 이미지의 어떤 부분을 편집해야 하는지 나타내고, 프롬프트와 선택한 스타일 유형은 편집 방향을 추가로 안내할 수 있습니다. 지원되는 이미지 형식에는 JPEG, PNG 및 WebP가 포함됩니다. 이미지 링크는 유효 기간이 제한되어 있습니다. 이미지를 보관하려면 다운로드하여 저장해야 합니다.
요청 매개변수
file
필수
원본 이미지 파일, JPEG, PNG 및 WebP 형식 지원
file
필수
마스크 이미지, 다음 요구 사항을 충족해야 합니다:
- 검은색과 흰색 픽셀만 포함하며 RGB, RGBA 또는 회색조 이미지 형식 지원
- 원본 이미지와 정확히 동일한 크기
- 검은색 영역은 수정해야 할 부분을 나타내고 흰색 영역은 변경하지 않아야 할 부분을 나타냅니다.
- 순수한 흰색일 수 없음
- 수정된 영역(검은색 부분)은 이미지 영역의 10% 이상을 차지해야 합니다.
string
필수
로컬 편집을 위한 프롬프트
string
필수
이미지 생성 또는 편집을 위한 모델. /generate 및 /remix는 모든 모델 유형을 지원하지만 /edit는 V_2 및 V_2_TURBO만 지원합니다.사용 가능한 모델 버전:
- V_2
- V_2_TURBO
string
기본값:"AUTO"
프롬프트 향상 옵션. 사용 가능한 매개변수: AUTO, ON, OFF
integer
기본값:"1"
생성할 이미지 수, 범위 1-8
integer
랜덤 시드, 범위: 0-2147483647
string
기본값:"AUTO"
이미지 생성에 사용되는 스타일 유형, 이 매개변수는 V_2 이상 버전의 모델에만 적용됩니다.사용 가능한 스타일:
- AUTO
- GENERAL
- REALISTIC
- DESIGN
- RENDER_3D
- ANIME
예제 호출
응답
이미지 편집이 성공적으로 생성되었습니다.오류 코드
400: 이미지 편집 요청 게시 잘못된 요청 오류401: 이미지 편집 요청 게시 무단 오류422: 이미지 편집 요청 게시 처리할 수 없는 엔터티 오류429: 이미지 편집 요청 게시 너무 많은 요청 오류
리믹스
POST https://aihubmix.com/ideogram/remix
제공된 이미지와 주어진 프롬프트 및 선택적 매개변수를 융합합니다. 입력 이미지는 리믹스하기 전에 선택한 가로 세로 비율로 잘립니다. 지원되는 이미지 형식에는 JPEG, PNG 및 WebP가 포함됩니다. 이미지 링크는 유효 기간이 제한되어 있습니다. 이미지를 보관하려면 다운로드하여 저장해야 합니다.
요청 매개변수
object
필수
제공된 이미지와 프롬프트를 사용하여 새 이미지를 생성하는 요청. 제공된 이미지는 선택한 출력 가로 세로 비율과 일치하도록 잘립니다.
string
필수
이미지 생성을 위한 프롬프트
string
기본값:"ASPECT_1_1"
이미지 생성을 위한 가로 세로 비율, 해상도를 결정합니다. 해상도 매개변수와 함께 사용할 수 없습니다.사용 가능한 비율:
- ASPECT_1_1
- ASPECT_3_1
- ASPECT_1_3
- ASPECT_3_2
- ASPECT_2_3
- ASPECT_4_3
- ASPECT_3_4
- ASPECT_16_9
- ASPECT_9_16
- SPECT_16_10
- ASPECT_10_16
integer
기본값:"50"
참조 이미지 가중치, 범위: 1-100
string
기본값:"V_2"
이미지 생성 또는 편집을 위한 모델. /generate 및 /remix는 모든 모델 유형을 지원하지만 /edit는 V_2 및 V_2_TURBO만 지원합니다.
string
이미지에 나타나지 않기를 바라는 내용을 설명합니다. 모델 버전 V_1, V_1_TURBO, V_2 및 V_2_TURBO에만 적용됩니다. 프롬프트의 설명이 부정적인 프롬프트의 설명보다 우선합니다.
string
기본값:"AUTO"
프롬프트 향상 옵션. 사용 가능한 매개변수: AUTO, ON, OFF
integer
기본값:"1"
생성할 이미지 수, 범위: 1-8
string
이미지 생성을 위한 해상도(모델 버전 2.0에만 적용, aspect_ratio와 함께 사용할 수 없음), 너비 x 높이로 표현됩니다. 지정하지 않으면 기본적으로 aspect_ratio가 사용됩니다.
integer
랜덤 시드, 범위: 0-2147483647
string
기본값:"AUTO"
생성된 이미지의 스타일 유형, V_2 이상 버전의 모델에만 적용되며 V_1 버전에서는 지정해서는 안 됩니다.사용 가능한 스타일:
- AUTO
- GENERAL
- REALISTIC
- DESIGN
- RENDER_3D
- ANIME
file
필수
원본 이미지 파일, JPEG, PNG 및 WebP 형식 지원
예제 호출
응답
이미지가 성공적으로 생성되었습니다.오류 코드
400: 이미지 리믹스 요청 게시 잘못된 요청 오류401: 이미지 리믹스 요청 게시 무단 오류422: 이미지 리믹스 요청 게시 처리할 수 없는 엔터티 오류429: 이미지 리믹스 요청 게시 너무 많은 요청 오류
업스케일
POST https://aihubmix.com/ideogram/upscale
제공된 이미지를 선택적 프롬프트와 함께 동기적으로 업스케일합니다. 지원되는 이미지 형식에는 JPEG, PNG 및 WebP가 포함됩니다. 이미지 링크는 유효 기간이 제한되어 있습니다. 이미지를 보관하려면 다운로드하여 저장해야 합니다.
요청 매개변수
object
필수
선택적 프롬프트와 함께 제공된 이미지를 업스케일하기 위한 요청 객체
string
업스케일링 프로세스를 안내하는 선택적 프롬프트
integer
기본값:"50"
유사성, 범위: 1-100
integer
기본값:"50"
세부 정보, 범위: 1-100
string
기본값:"AUTO"
프롬프트 향상 옵션. 사용 가능한 매개변수: AUTO, ON, OFF
integer
기본값:"1"
생성할 이미지 수, 범위: 1-8
integer
랜덤 시드, 범위: 0-2147483647
file
필수
원본 이미지 파일, JPEG, PNG 및 WebP 형식 지원
예제 호출
응답
이미지가 성공적으로 생성되었습니다.오류 코드
400: 이미지 업스케일 요청 게시 잘못된 요청 오류401: 이미지 업스케일 요청 게시 무단 오류422: 이미지 업스케일 요청 게시 처리할 수 없는 엔터티 오류429: 이미지 업스케일 요청 게시 너무 많은 요청 오류
설명
POST https://aihubmix.com/ideogram/describe
업로드된 이미지를 분석하고 설명합니다. 지원되는 이미지 형식에는 JPEG, PNG 및 WebP가 포함됩니다.
요청 매개변수
file
필수
설명할 이미지 파일, JPEG, PNG 및 WebP 형식 지원
예제 호출
응답
설명이 성공적으로 생성되었습니다.오류 코드
400: 설명 요청 게시 잘못된 요청 오류422: 설명 요청 게시 처리할 수 없는 엔터티 오류429: 설명 요청 게시 너무 많은 요청 오류