curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "grok-imagine-image-2.0",
  "prompt": "사이버펑크 스타일의 도쿄 밤거리, 젖은 노면에 반사되는 네온 불빛"
}
'

{
  "created": 1757156493,
  "id": "task-unified-1757156493-imcg5zqt",
  "model": "grok-imagine-image-2.0",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 100
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 3.06,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: grok-imagine-image-2.0",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Grok

Grok Imagine Image 2.0 이미지 생성

Grok Imagine Image 2.0(grok-imagine-image-2.0)은 xAI의 이미지 생성 및 편집 모델로, 텍스트-이미지 생성과 이미지 편집이 동일한 모델명을 공유합니다
image_urls를 전달하지 않으면 텍스트-이미지 생성이며, 1~3장의 참조 이미지를 전달하면 자동으로 이미지 편집 모드로 전환됩니다(모델 변경 불필요)
비동기 처리 모드, 반환된 작업 ID로 조회
생성된 이미지 링크는 24시간 동안 유효하며, 즉시 저장해 주세요

POST

images

generations

curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "grok-imagine-image-2.0",
  "prompt": "사이버펑크 스타일의 도쿄 밤거리, 젖은 노면에 반사되는 네온 불빛"
}
'

{
  "created": 1757156493,
  "id": "task-unified-1757156493-imcg5zqt",
  "model": "grok-imagine-image-2.0",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 100
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 3.06,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: grok-imagine-image-2.0",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

인증

Authorization

string

header

필수

##모든 API는 Bearer Token 인증이 필요합니다##

API Key 받기:

API Key 관리 페이지를 방문하여 API Key를 받으세요

요청 헤더에 추가:

Authorization: Bearer YOUR_API_KEY

본문

application/json

model

enum<string>

필수

이미지 생성 모델명. 텍스트-이미지 생성과 이미지 편집이 이 모델명을 공유하며, image_urls 전달 여부에 따라 모드가 자동으로 전환됩니다

사용 가능한 옵션:

grok-imagine-image-2.0

예시:

"grok-imagine-image-2.0"

prompt

string

필수

생성하려는 이미지 또는 전달한 참조 이미지의 편집 방식을 설명하는 프롬프트

다중 이미지 참조 문법:

여러 장의 참조 이미지를 전달할 때 프롬프트에서 <IMAGE_0>, <IMAGE_1>, <IMAGE_2>로 각각 1번째, 2번째, 3번째 참조 이미지를 지정할 수 있습니다
인덱스는 0부터 시작하며 image_urls 배열의 순서와 1:1로 대응합니다
예시: <IMAGE_0>의 인물을 <IMAGE_1>의 장면에 배치해 주세요

예시:

"사이버펑크 스타일의 도쿄 밤거리, 젖은 노면에 반사되는 네온 불빛"

image_urls

string<uri>[]

이미지-이미지 및 이미지 편집 기능을 위한 참조 이미지 URL 목록

참고:

요청당 입력 이미지 수: 0~3개(미전달 = 텍스트-이미지 생성, 1~3개 = 이미지 편집)
공개적으로 직접 접근 가능한 http / https 이미지 URL만 지원하며, base64 및 data URL은 지원하지 않습니다
지원 형식: .jpeg, .jpg, .png, .webp
이미지 URL은 서버에서 직접 접근 가능하거나, 접근 시 직접 다운로드되어야 합니다 (일반적으로 .png, .jpg 등 이미지 확장자로 끝나는 URL)
이미지 편집 시 전달한 참조 이미지에는 추가 비용이 발생하며, 요청당 한 번만 계산되고 n배가 되지 않습니다

Maximum array length: 3

예시:

[
  "https://example.com/person.png",
  "https://example.com/scene.png"
]

size

enum<string>

기본값:auto

생성 이미지의 가로세로 비율, 기본값은 auto

지원하는 비율(13종):

비율	설명
`1:1`	정사각형
`4:3` / `3:4`	전통적인 가로형 / 세로형
`3:2` / `2:3`	표준 가로형 / 세로형
`16:9` / `9:16`	와이드스크린 / 모바일 세로형
`2:1` / `1:2`	초광폭 가로형 / 초장축 세로형
`19.5:9` / `9:19.5`	풀스크린 스마트폰 가로 / 세로
`20:9` / `9:20`	울트라와이드 가로 / 세로

참고:

auto: 모델이 비율을 자동으로 결정하며, 이 파라미터를 전달하지 않으면 auto와 동일합니다(출력은 보통 세로형)
위 표에 없는 값은 지원하지 않습니다

사용 가능한 옵션:

1:1,

4:3,

3:4,

3:2,

2:3,

16:9,

9:16,

2:1,

1:2,

19.5:9,

9:19.5,

20:9,

9:20,

auto

예시:

"16:9"

resolution

enum<string>

기본값:1K

출력 이미지의 픽셀 등급, 기본값은 1K이며 1K와 2K 두 등급을 지원

참고:

본 모델은 4K를 지원하지 않습니다
값은 대소문자를 구분하지 않습니다

사용 가능한 옵션:

1K,

2K

예시:

"1K"

quality

enum<string>

기본값:medium

생성 품질 등급으로 모델의 사고 깊이를 제어하며, 기본값은 medium

값	설명
`low`	생성이 빠르고 비용이 저렴
`medium`	화질과 디테일이 더 우수

참고:

본 모델은 low / medium 두 등급만 지원하며, high 등 다른 값은 지원하지 않습니다
quality(품질 등급)와 resolution(픽셀 등급)은 서로 독립적이며 자유롭게 조합할 수 있습니다
값은 대소문자를 구분하지 않습니다

사용 가능한 옵션:

low,

medium

예시:

"medium"

integer

기본값:1

생성할 이미지 수, 범위는 1~10, 기본값은 1

참고:

이미지마다 개별 과금되며 비용은 n에 비례해 증가합니다
참조 이미지로 인한 추가 비용은 요청당 한 번만 계산되며 n배가 되지 않습니다

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

예시:

1

callback_url

string<uri>

작업 완료 후 HTTPS 콜백 주소

콜백 타이밍:

작업이 완료, 실패 또는 취소될 때 트리거됨
과금 확인 완료 후 전송

보안 제한:

HTTPS 프로토콜만 지원
내부 IP 주소로의 콜백 금지 (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x 등)
URL 길이는 2048자를 초과할 수 없음

콜백 메커니즘:

타임아웃: 10초
실패 시 최대 3회 재시도 (1초/2초/4초 후 재시도)
콜백 응답 본문 형식은 작업 조회 API 응답 형식과 동일
콜백 주소가 2xx 상태 코드를 반환하면 성공으로 간주, 다른 상태 코드는 재시도를 트리거

예시:

"https://your-domain.com/webhooks/image-task-completed"

응답

이미지 작업이 성공적으로 생성되었습니다

created

integer

작업 생성 타임스탬프

예시:

1757156493

string

작업 ID

예시:

"task-unified-1757156493-imcg5zqt"

model

string

실제 사용된 모델 이름

예시:

"grok-imagine-image-2.0"

object

enum<string>

구체적인 작업 유형

사용 가능한 옵션:

image.generation.task

progress

integer

작업 진행률 (0-100)

필수 범위: 0 <= x <= 100

예시:

0

status

enum<string>

작업 상태

사용 가능한 옵션:

pending,

processing,

completed,

failed

예시:

"pending"

task_info

object

비동기 작업 정보

Show child attributes

type

enum<string>

작업 출력 유형

사용 가능한 옵션:

text,

image,

audio,

video

예시:

"image"

usage

object

사용량 및 과금 정보

Show child attributes

이미지 시리즈

비디오 시리즈

오디오 시리즈

텍스트 시리즈

계정 관리

작업 관리

파일 관리

Grok Imagine Image 2.0 이미지 생성

인증

본문

응답