JSON 이미지 편집

요청은 application/json을 사용하며 공개 인터넷에서 접근 가능한 이미지 URL로 단일 또는 여러 이미지 편집 작업을 제출합니다.

POST/v1/images/edits

텍스트 지시에 따라 하나 이상의 참조 이미지를 편집합니다. 요청은 application/json을 사용해야 하며 image 또는 images로 공개 인터넷에서 접근 가능한 이미지 URL을 전달해야 합니다.

이 JSON URL 요청 구조는 Grok 이미지 편집을 지원하는 모델에만 적용됩니다.

/v1/images/edits를 사용하고 /v1/edits는 사용하지 마세요. 여러 이미지 참조에는 images를 사용하며 reference_images는 권장하지 않습니다.

인증

bearerAuth

인증Bearer <token>

Authorization Header에 Bearer your-api-key를 사용합니다.

전달 위치: header

요청 본문

application/json

Grok 이미지 편집 요청 매개변수입니다. image와 images 중 하나 이상이 필요합니다.

TypeScript 타입 정의

TypeScript에서 request body 타입을 사용하세요.

model*string

이미지 편집에 사용할 모델 ID입니다. 이 요청 형식을 지원하는 모델에는 grok-imagine-image와 grok-imagine-image-pro가 포함됩니다. 실제 사용 가능 범위는 현재 API 키가 반환하는 모델 목록과 채널 기능을 따릅니다.

길이1 <= length

prompt*string

이미지 편집 지시입니다. 유지할 대상, 수정할 영역 및 목표 스타일을 명확하게 설명하는 것이 좋습니다.

길이1 <= length

image?|

조건부 필수 항목입니다. 단일 입력 이미지이며 서버와 모델의 상위 서비스 모두 접근할 수 있는 공개 인터넷 이미지 URL을 권장합니다. image와 images 중 하나 이상을 입력해야 하며 둘 다 생략할 수 없습니다.

images?array<>

조건부 필수 항목입니다. 여러 입력 이미지의 공개 인터넷 URL 목록입니다. image와 images 중 하나 이상을 입력해야 하며 둘 다 생략할 수 없습니다.

항목1 <= items

size?string

이미지 크기 또는 가로세로 비율입니다. 예: 1024x1024, 1:1 또는 16:9.

n?integer

생성할 편집 결과 수입니다. 전달하지 않으면 보통 1장으로 처리합니다.

범위1 <= value

기본값1

response_format?string

반환 형식이며 서버와 상위 모델의 실제 기능에 따라 결정됩니다.

응답 본문

`application/json`

curl -X POST "https://example.com/v1/images/edits" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "prompt": "주인공을 유지하면서 이미지를 사이버펑크 야경 스타일로 바꿔 주세요",
    "image": "https://example.com/input.png",
    "size": "1024x1024",
    "n": 1
  }'

{
  "created": 1710000000,
  "data": [
    {
      "url": "https://example.com/result.png"
    }
  ]
}

인증

요청 본문

응답 본문

200application/json

400application/json

401application/json

403application/json

`application/json`

`application/json`

`application/json`

`application/json`