소개
장면 설명을 보내고 정사각형, 세로형 또는 가로형 구도를 선택합니다.
| 항목 | 값 |
|---|---|
| 입력 | 텍스트 |
| 출력 | 이미지 |
| 제공사 | xAI |
| 모델 식별자 | grok/imagine-image-2.0 |
| 이미지 작업 | 텍스트 이미지 생성과 이미지 편집 |
| 프롬프트 길이 | 두 작업 모두 최대 8,000자 |
| 편집 원본 | image_urls에 1~5장 |
| 참조 이름 | 입력 순서대로 Image 1, Image 2와 이후 번호 |
| 지원 화면비 | 1:1, 2:3, 3:2, 16:9, 9:16 |
| 기본 캔버스 | 생성과 편집 모두 1:1 |
| 요금 기준 | 이미지당 고정, 화면비에 따른 차이 없음, 실패 무료 |
| 파일 이용 기간 | 생성 파일은 14일 뒤 삭제 |
핵심 기능 및 하이라이트
한 피팅룸에 반복되는 반사
2:3 피팅룸 예시는 따뜻한 부티크 빛과 기울어진 거울 사이에서 실크 셔츠를 든 남성을 보여 줍니다. 이 결과에서는 반사가 일관됩니다. 인물, 의상 소품, 방, 조명을 함께 지시하는 참조로 쓰되 모든 배치에서 같다고 가정하지 말고 직접 반사마다 확인합니다.
분재 크기의 이끼 정원사
로봇 정원사 테스트는 이끼 덮인 캐릭터가 분재에 물을 주는 모습을 설득력 있는 매크로 질감으로 표현했습니다. 작은 대상, 명확한 행동, 가까운 사진 시점으로 규모를 전달합니다. 표면과 빛을 설명하고 결과를 평가합니다. 해당 미니어처의 근거이며 일반 품질 점수가 아닙니다.
라벨은 바꾸고 장소는 유지
차 통 테스트는 평범한 디자인을 손그림 매화와 금박 라벨로 대체하며 뚜껑, 탁자, 빛을 유지했습니다. 보존 목표가 있는 집중 편집입니다. 통을 Image 1로 부르고 새 라벨과 남길 주변 요소를 적은 뒤 원본과 대조합니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 장면을 최대 8,000자로 작성합니다. 이 텍스트 필드로 이미지 요금이 달라지지는 않습니다. 1자 이상 · 8000자 이하 |
aspect_ratio | 아니요 | 1:1, 2:3, 3:2, 16:9 또는 9:16을 선택하며 기본값은 1:1입니다. 화면비 5종은 모두 가격이 같습니다. |
요금
$0.028 / 장
Grok 생성 이미지는 화면비와 관계없이 이미지당 고정 요금이 적용됩니다. 생성에 실패하면 비용이 부과되지 않습니다.
활용 사례
부티크 패션 장면 구상
옷, 따뜻한 매장 빛, 기울어진 거울로 인물 사진을 계획합니다. 2:3 피팅룸 샘플은 반사 속 남성을 일관되게 반복해 이 구도의 구체적인 참조가 됩니다.
소재 세부가 있는 작은 세계
관계없는 사물 목록보다 알아볼 수 있는 일을 하는 작은 캐릭터를 설명합니다. 이끼 로봇은 분재에 물을 주며 매크로 장면의 표면 질감을 보여 줬습니다.
기존 통의 패키지 디자인
채택한 제품 사진에서 새 라벨을 요청합니다. 실측 차 통 편집은 뚜껑, 탁자, 조명을 유지하며 손그림 매화와 금박을 추가했습니다.
참조 역할을 지정한 편집
구상에 원본이 여럿 필요하면 최대 5장을 사용합니다. 번호별 기여와 유지 요소를 설명합니다. 입력 수는 제어 항목이며 모든 구도가 참조와 일치한다는 근거는 아닙니다.
세로·가로 콘셉트 배치
용도에 맞는 세로, 정사각형, 가로 캔버스를 먼저 고릅니다. 생성·편집에 화면비 5가지를 제공하며 형태를 바꿔도 이미지 요금은 같습니다.
프롬프트 가이드 및 실전 팁
생성 또는 편집 선택
새 사진은 장면 설명으로, 수정은 원본 1~5장으로 시작합니다. 편집 입력은 사용 권한이 있는 성인 사진이며 사칭하지 않습니다.
장면이나 변경 설명
새 장면의 대상, 행동, 장소, 빛을 적습니다. 편집은 Image 1, Image 2와 이후 입력의 역할을 나누고 보존 요소를 정합니다.
배치에 맞는 형태 설정
구도에 맞춰 1:1, 2:3, 3:2, 16:9, 9:16을 고릅니다. 기본은 정사각형이며 비율은 이미지당 요금을 바꾸지 않습니다.
세부 확인 후 저장
설명과 결과를 대조하며 필요한 반사나 보존 사물을 확인합니다. 14일 이용 기간 안에 내려받아 프롬프트와 함께 보관합니다.
설명으로 새 장면 생성
Grok Imagine Image 2.0 text-to-image는 설명에서 사진을 만듭니다. 기존 사진 없이 장면을 구상할 때 시작합니다. 일하는 작은 로봇과 사진풍 피팅룸 인물은 대상과 주변으로 구상을 구성하는 두 예시입니다.
이 페이지의 생성 제어는 프롬프트와 화면비입니다. 배치할 형태를 고르고 프롬프트로 안에 보일 것을 설명합니다. 채택한 제품 사진의 라벨 등 특정 변경은 image-to-image를 사용합니다.
파라미터와 구도
| 파라미터 | 허용 값 | 사용법 |
|---|---|---|
| prompt | 최대 8,000자의 장면 설명 | 대상, 행동, 소재, 장소, 빛 설명 |
aspect_ratio | 1:1, 2:3, 3:2, 16:9, 9:16 | 기본 1:1의 캔버스 비율 선택 |
세로는 2:3·9:16, 가로는 3:2·16:9를 쓸 수 있습니다. 피팅룸은 인물과 거울 공간을 세로 2:3에 담습니다. aspect_ratio를 그대로 두면 정사각형입니다. 프롬프트에 세로라는 단어가 있어도 이 제어를 직접 선택합니다.
이미지가 따를 수 있는 설명
대상과 행동 연결
중심 대상에 알아볼 행동을 줍니다. 작은 정원사가 분재에 물을 주면 캐릭터·물·식물이 한 활동에 속합니다. 피팅룸에서는 의상 소품을 따로 두기보다 남성이 실크 셔츠를 들도록 합니다. 인물은 30대 이상으로 설정합니다.
표면과 빛의 목적
금속 위 이끼, 맞춤 바지와 실크, 따뜻한 매장의 광택 거울 등 소재로 원하는 외형을 설명합니다. 매크로 규모나 부드러운 부티크 조명을 연결하며 관련 없는 스타일 태그를 쌓기보다 대상에 맞는 구체적인 선택을 합니다.
확인할 배치 설명
거울과 대상의 관계를 적고 반환 반사를 봅니다. 미니어처는 주변 식물과 촬영 거리를 설명해 규모를 전달합니다. 구상 전달법이지 물리적 정확성 보장은 아닙니다. 중요한 세부 사항을 기록해 같은 기준으로 판단합니다.
예시 결과
- 이끼 로봇은 분재에 물을 주며 좋은 매크로 질감을 보였습니다. 해당 소재 구상의 근거이며 모든 작은 사물 장면을 입증하지 않습니다.
- 2:3 피팅룸은 상의 없이 실크 셔츠를 든 남성과 기울어진 거울의 일관된 반사를 반환했습니다.
- 차 통은 뚜껑·탁자·빛을 유지한 라벨 편집입니다. 기존 요소가 출발점이면 편집 엔드포인트를 고릅니다.
갤러리는 관찰 가능한 결과입니다. 미니어처와 반사는 별도 예시이며 다른 프롬프트의 동일 품질을 약속하지 않습니다. 추가 프롬프트는 제안이지 테스트 결과가 아닙니다.
요금과 요청 한도
이미지당 고정 요금으로 화면비를 바꿔도 같습니다. 시작 전 Grok Imagine Image 2.0 모델 페이지의 현재 금액을 확인합니다. 생성 실패는 과금하지 않습니다.
개발사의 콘텐츠 필터에 걸린 요청은 거부되며 요금이 부과되지 않습니다. 글자 한도와 화면비 목록을 지킵니다. 여기에는 해상도·품질 선택기가 없으므로 일반 리뷰의 설정을 가져오지 않습니다.
완료 이미지는 14일간 다운로드 가능하며 이후 삭제됩니다. 채택 파일, 문구, 비율을 함께 보관합니다. 재시도가 필요하면 해당 요구를 명확히 바꾸고 같은 구상과 비교합니다.
다음 작업 선택
유지할 세부가 있는 특정 수정은 image-to-image에 기존 사진을 넣습니다. 다른 캔버스 요건에는 생성 화면비 14가지의 Nano Banana 2 Lite, 제공 문구 중심 포스터에는 제목과 보조 문구를 선명히 재현한 테스트가 있는 Ideogram 4.5를 고려합니다. 일괄 순위 대신 필요한 제어로 고르고 직접 결과를 확인합니다.
API 빠른 시작
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "xai/grok-imagine-image-2.0/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1:1"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.










