생성과 편집을 위한 Grok Image API
독립적인 GoEnhance API를 통해 Grok Image를 사용합니다. 텍스트 프롬프트로 생성하거나 최대 9장의 참조 이미지를 전달해 이미지 기반 편집을 수행한 뒤, 폴링 또는 HTTPS 콜백으로 비동기 결과를 받습니다. GoEnhance는 xAI가 아니며 이는 공식 xAI API가 아닙니다.
API 키 만들기
신규 생성과 참조 이미지 편집을 모두 지원하는 단일 엔드포인트
텍스트 기반 이미지 생성
model에 grok-image를 지정하고 1–2,000자 프롬프트를 보낸 다음 2:3, 3:2, 1:1, 9:16, 16:9 중 하나를 선택합니다. 이 비율은 텍스트만 사용하는 요청에 적용됩니다.
참조 이미지 편집
image_list에 접근 가능한 이미지 URL을 1~9개 추가하면 이미지 기반 생성을 실행합니다. 참조 이미지가 있으면 문서에 정의된 비율 필드는 무시됩니다.
문서에 정의된 요청 필드만 사용하고 제출 전에 검증하십시오.
Grok Image API 기능
통합 이미지 엔드포인트
<code>https://api.goenhance.ai/api/v1/images/generations</code>로 JSON을 POST합니다.
정확한 모델 지정
필수 값인 <code>model</code>을 <code>grok-image</code>로 설정합니다.
프롬프트 검증
1자 이상 2,000자 이하의 텍스트 프롬프트를 반드시 제공해야 합니다.
선택적 참조 이미지
이미지 기반 요청에서는 <code>image_list</code>에 URL 객체를 1~9개 전달합니다.
텍스트 전용 화면 비율
참조 이미지 목록을 전달하지 않을 때는 2:3, 3:2, 1:1, 9:16, 16:9 중에서 선택합니다.
비동기 결과 처리
<code>img_uuid</code>를 저장한 다음 작업 상세를 폴링하거나 HTTPS 콜백 이벤트를 처리합니다.
현재 GoEnhance 문서는 생성 이미지 1장마다 고정 요율을 제시합니다.
Grok Image API 가격
이미지당 1.3 토큰
성공한 Grok Image 생성 1건마다 1.3 GoEnhance 토큰이 소모된다고 문서에 명시되어 있습니다.
이미지당 $0.026
문서에 기재된 미국 달러 환산 금액은 생성 이미지 1장당 $0.026입니다.
잔액 관련 응답 처리
HTTP 상태 코드뿐 아니라 JSON 응답의 code도 확인하십시오. 토큰이 부족하면 <code>code: 100</code>이 반환될 수 있습니다.
네 단계로 Grok Image API 연동하기
1
1. API 키 만들기
GoEnhance 키를 만들고 서버에서
Authorization 헤더로 전송합니다. 2
2. 요청 구성하기
model: grok-image와 프롬프트를 담아 POST합니다. 참조 이미지 편집에는 image_list를 추가하고, 텍스트 기반 생성에는 지원되는 비율을 선택합니다. 3
3. 작업을 추적하고 결과 읽기
성공 응답에서
data.img_uuid를 읽어 자체 작업 레코드와 연결합니다. 그런 다음 GET /api/v1/jobs/detail을 폴링하거나 공개적으로 접근 가능한 HTTPS custom_callback_url을 지정하고, 처리 중·성공·실패를 명시적인 상태로 각각 처리합니다.이미 프롬프트, 검토, 배포를 관리하는 제품에 이미지 생성과 편집을 연결합니다.
Grok Image 개발자 활용 사례
기사용 일러스트레이션
기사 기획안에서 독창적인 장면 콘셉트를 생성하고 검토 큐로 보냅니다.
캠페인 크리에이티브 변형
지원되는 세로형, 정사각형, 가로형 비율로 프롬프트 기반 비주얼 방향을 만듭니다.
참조 이미지 기반 리스타일링
승인된 원본 이미지를 사용해 이후 검토할 수 있는 통제된 시각적 변형을 만듭니다.
제품 콘셉트 아트
구조화된 제품 설명과 선택적 참조 이미지를 시각 탐색용 자산으로 전환합니다.
캐릭터 및 배경 아이디어 도출
서술형 프롬프트로 캐릭터, 소품, 배경의 초안 콘셉트를 만듭니다.
자동화된 크리에이티브 파이프라인
비동기 작업을 콜백, 검수, 저장, 승인, 후속 처리와 연결합니다.
가격, 입력, 비율, 연동에 관한 일반적인 질문에 대한 답변입니다.