메인 콘텐츠로 건너뛰기
POST
Image editing: edit a reference image or fuse several
🔒 기본적으로 공개되지 않음: Grok Imagine 2는 Default 그룹에 속하지 않습니다. 자체적인 Grok_imagine_Reverse 그룹에 속하며, 이를 호출하려면 먼저 액세스 권한을 요청해야 합니다(이 페이지의 Playground 포함). 권한이 없으면 모든 호출이 503을 반환합니다.이 제품군의 콘텐츠 안전 정책은 플랫폼의 다른 모델과 상당히 다르며 일부 카테고리는 필터링되지 않습니다. 따라서 규정 준수 위험을 제한하기 위해 액세스 권한을 선별적으로 부여합니다. 기존 고객은 누적 결제액이 $1,000 이상인 경우 지원팀에 사용 사례를 설명하여 활성화할 수 있으며, 그 외 사용자는 사용 사례와 적용 중인 콘텐츠 조정 제어 기능을 설명하여 WeCom 지원팀을 통해 신청해야 합니다. 전체 절차는 Grok Imagine 2 개요 - 그룹 설정을 참조하십시오.
오른쪽의 대화형 Playground에서는 로컬 파일을 업로드할 수 있습니다. Authorization에 API Key를 입력하고(형식: Bearer sk-xxx), image 파일을 선택한 다음 prompt 및 model을 입력하고 전송하십시오.
🔴 이 엔드포인트에는 multipart/form-data 파일 업로드가 필요합니다/v1/images/edits에 JSON을 전송하면 항상 400을 반환합니다:
특히 xAI 또는 업스트림 공급업체의 문서를 기반으로 통합하는 경우 중요합니다: 해당 문서에서는 공개 이미지 URL({"image": {"type": "image_url", "url": "..."}})을 포함한 JSON 본문을 설명하지만, 이 형식은 APIYI 게이트웨이를 통해 작동하지 않습니다. 대신 이 페이지의 지침을 따르십시오.장점은 파일 업로드 방식이므로 이미지 호스팅이 필요하지 않다는 것입니다. 로컬 파일만 전송하면 되므로 공개 URL을 준비하는 것보다 간단합니다.파일 필드의 이름은 image 또는 **image[]**이어야 합니다. images / image_file을 사용하면 415가 반환됩니다. prompt은 필수이며, 생략하면 400이 반환됩니다.
이 페이지를 사용하는 경우: 하나의 참조 이미지를 편집하거나 여러 이미지를 융합할 때 사용합니다. 프롬프트만으로 생성하려면 텍스트-이미지 엔드포인트를 사용하십시오.
⚠️ 출력 크기는 첫 번째 참조 이미지를 따르며 변경할 수 없습니다resolution 및 aspect_ratio은 여기에서 오류 없이 허용되지만 효과가 없습니다. 편집된 출력은 항상 첫 번째 참조 이미지의 크기와 일치합니다(입력이 1280x720이면 출력도 1280x720이고, 입력이 1024x1024이면 출력도 1024x1024입니다).이는 융합에도 동일하게 적용됩니다. 참조 이미지 4개의 순서를 바꾸자 출력이 1280x720에서 1024x1024로 변경되었으며, 새로운 첫 번째 이미지를 따랐습니다.출력 크기를 변경하려면 업로드하기 전에 첫 번째 참조 이미지를 자르거나 크기를 조정하십시오.
융합 순서는 중요합니다: image[]은 참조 이미지 1~4개를 허용합니다(측정된 상한은 4개이며, 다섯 번째 이미지를 보내면 400이 반환됩니다). 또한 업로드 순서가 프롬프트에서 말하는 “이미지 1 / 이미지 2 / 이미지 3”의 기준이 됩니다. 예를 들어 “이미지 1의 피사체를 이미지 2의 장면에 배치하고, 이미지 2의 아트 스타일을 유지하십시오”와 같이 명시하십시오.참조 이미지 2개 / 3개 / 4개를 대상으로 측정한 결과, 이미지가 하나 추가될 때마다 해당 피사체가 출력에 추가되었으며, 각 이미지의 고유한 특징도 유지되었습니다. 즉, 융합이 실제로 작동합니다.

코드 예제

Python (OpenAI SDK, 단일 이미지)

Python (원시 요청, 단일 이미지)

Python (다중 이미지 융합, 파일 1~4개)

cURL

Node.js (네이티브 fetch + FormData)

브라우저 JavaScript

매개변수 참조

이 제품군은 마스크 인페인팅을 지원하지 않습니다. 변경 범위를 제한하려면 prompt에 구체적으로 설명해야 합니다. 예를 들어 “스카프만 빨간색으로 변경하고 나머지는 모두 정확히 동일하게 유지”라고 지정합니다. 모델은 이러한 제약을 충실히 따릅니다.

편집 동작 및 프롬프트 스타일

편집 엔드포인트는 입력 이미지의 아트 스타일, 구도, 팔레트 및 피사체 정체성을 유지하며, 프롬프트에 지정된 부분만 변경합니다. 안정적인 결과를 얻으려면 다음과 같이 하십시오.
“나머지는 모두 변경하지 않음”이라고 명시하는 것이 이 모델에서 가장 효과적인 단일 기법입니다. 융합의 경우 항상 image[] 업로드 순서에 맞춰 “이미지 1 / 이미지 2”를 언급하십시오.또한 가장 중요한 피사체를 먼저 배치하십시오. 첫 번째 이미지는 출력 크기를 결정할 뿐만 아니라, 테스트에서 순서를 반대로 배치했을 때 보조 피사체의 정체성이 다른 피사체에 섞이는 현상도 발생했습니다.

응답 형식

응답 필드 주의사항
  • 각 data[] 항목에는 response_format에 따라 url 또는 b64_json 중 하나만 포함되며, 둘 다 포함되지는 않습니다.
  • revised_prompt은 반환되지 않으므로 존재한다고 가정하지 마십시오.
  • b64_json은 data:image/...;base64, 접두사가 없는 원시 base64이므로 직접 디코딩하십시오.
  • created은 항상 0이며 타임스탬프로 사용할 수 없습니다.
  • 출력 크기는 입력 이미지에 따라 결정되므로 요청 매개변수로 너비와 높이를 예측하지 마십시오.
usage은 대조에 사용할 수 없습니다: prompt_tokens은 항상 플레이스홀더인 1000 x n입니다. 편집 비용은 이미지당 정액으로 텍스트-이미지 생성과 동일합니다. 실제 청구 금액은 APIYI 콘솔 과금 기록을 사용하여 확인하십시오.

인증

Authorization
string
header
필수

API Key created in the APIYI Console

본문

multipart/form-data
model
enum<string>
기본값:grok-imagine-image
필수

Model ID

사용 가능한 옵션:
grok-imagine-image,
grok-imagine-image-quality
prompt
string
필수

Editing instruction. State what to change and explicitly ask for everything else to stay put, e.g. Change the scarf color to bright RED. Keep everything else exactly the same.

예시:

"Change the scarf color to bright RED. Keep everything else exactly the same."

image
file
필수

Reference image file. For multi-image fusion repeat the image[] field (1-4 files); upload order is what "image 1 / image 2 / image 3" refers to in the prompt, and the first file also determines output dimensions. Each added image contributes a subject in testing. Accepted formats: png / jpg / webp.

n
integer
기본값:1

Number of output images, 1-10. Independent of the number of reference images

필수 범위: 1 <= x <= 10
예시:

1

response_format
enum<string>
기본값:url

Response format. url returns a direct link; b64_json returns raw base64 (no data: prefix)

사용 가능한 옵션:
url,
b64_json
예시:

"url"

응답

Image generated successfully

created
integer

Creation timestamp. Always 0 for this model — do not use it for timing

예시:

0

data
object[]

Array of image results, length equals the requested n

usage
object

Placeholder values — do not use for billing reconciliation. prompt_tokens is always 1000 x n