소개
프롬프트에서 제공한 이미지에 번호를 붙이고 교체하거나 바꿀 내용을 명시합니다.
| 항목 | 값 |
|---|---|
| 입력 | 이미지 |
| 출력 | 이미지 |
| 제공사 | 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자로 작성하고 원본을 Image 1, Image 2 등으로 지정합니다. 길이가 달라도 이미지 고정 단가는 유지됩니다. 1자 이상 · 8000자 이하 |
image_urls | 예 | 편집할 원본 이미지 URL 1–5개를 제공합니다. 입력 수에 따른 별도 요금 단계는 없습니다. 1개 이상 · 5개 이하 |
aspect_ratio | 아니요 | 편집은 1:1, 2:3, 3:2, 16:9, 9:16을 지원합니다. 기본값은 1:1이며 모든 화면비의 요금이 같습니다. |
요금
$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 편집은 원본 1~5장과 지시로 시작합니다. 사진이나 디자인의 세부 요소를 유지할 때 사용합니다. 원본이 시작 자료를, 프롬프트가 수정과 유지할 요소를 제공합니다.
차 통 테스트는 평범한 통에 손그림 매화·금박 라벨을 넣고 뚜껑·탁자·조명을 보존했습니다. 유사 변경을 계획할 근거지만 모든 편집이 나머지 요소를 그대로 둠을 입증하지는 않습니다.
입력과 출력 형태
| 파라미터 | 허용 값 | 준비할 지시 |
|---|---|---|
| prompt | 최대 8,000자 | 변경, 참조 역할, 유지 요소 |
image_urls | 원본 URL 1~5개 | Image 1, Image 2 이후와 순서 일치 |
aspect_ratio | 1:1, 2:3, 3:2, 16:9, 9:16 | 출력 비율, 기본 1:1 |
실측 차 통처럼 라벨 수정에는 원본 한 장이면 충분합니다. 기여를 명시할 수 있을 때 참조를 추가합니다. Image 1은 제품 사진, Image 2는 라벨 디자인을 제공하도록 할 수 있지만 실측 결과와 별개인 지시 제안입니다.
aspect_ratio를 편집 구상의 일부로 정합니다. 생성과 같은 형태를 제공하며 문서상 기본은 정사각형입니다. 장면 문장에 맡기지 말고 용도에 맞는 세로·가로 비율을 고릅니다.
편집 지시 작성
참조 역할 구분
원본 위치를 직접 부릅니다. 어느 사진에 통이 있고 어느 사진이 디자인 요소나 장소를 제공할지 적습니다. 제출 전에 image_urls 순서와 확인합니다. 참조가 많아도 관계 설명은 필요합니다.
교체 내용을 구체화
패키지 예시는 금박 포인트가 있는 손그림 매화 라벨로 변경합니다. 막연한 개선 대신 사물과 수정할 디자인·소재·장소를 정합니다.
유지할 세부 나열
변경 뒤에 보존할 부분을 적습니다. 차 통 지시는 뚜껑·탁자·빛을 고정 요소로 정합니다. 결과에서 하나씩 원본과 대조합니다. 바뀌면 다음 지시에서 해당 요소를 명확히 적고 다시 평가합니다.
인물 원본 준비
사용 권한이 있는 성인 사진으로 사칭 없이 편집합니다. 이 페이지의 인물 제안은 30대 이상입니다. 옷·분위기·장소·빛을 설명하고 보존 요청을 허가된 입력 인물과 연결합니다.
편집 테스트의 근거
실측 차 통 결과는 뚜껑·탁자·원래 빛을 보존하며 꽃과 금박 디자인을 추가했습니다. 구체적인 보존 목록의 특정 변경이며 동일 인물, 정확한 글자, 반복 편집을 보장하지 않습니다.
피팅룸 거울은 텍스트 생성 예시로 편집 일관성 테스트가 아닙니다. 인물·두 원본 제품 제안도 새 요청 아이디어입니다. 다른 예시로 해당 구도를 입증했다고 보지 말고 실제 입력과 대조합니다.
과금, 필터, 저장
출력 이미지당 고정 요금으로 aspect_ratio는 비용을 바꾸지 않습니다. 현재 모델 페이지 요금을 확인합니다. 편집 실패는 무료입니다.
배포사 필터가 표시한 요청은 무료 거부입니다. 입력 범위와 글자 한도를 지킵니다. 목록 제어는 prompt, image_urls, aspect_ratio이며 다른 곳의 마스크·품질 설정은 이 표의 파라미터가 아닙니다.
생성 파일은 14일 뒤 삭제됩니다. 그 전에 편집 이미지를 받고 원본, 순서, 채택 지시, 결과를 함께 보관해 다음 변경의 출발점을 분명히 합니다.
다른 엔드포인트가 적합한 경우
유지할 원본 없이 새 장면을 만들면 text-to-image를 사용합니다. 참조가 5장보다 많으면 최대 10장의 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/edit",
"input": {
"aspect_ratio": "1:1",
"image_urls": [
"https://example.com/reference.png"
],
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
}
}'
# 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 레퍼런스에서 확인하세요.











