curl --request POST \
--url https://api.evolink.ai/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "gpt-image-2-beta",
"prompt": "A beautiful colorful sunset over the ocean"
}
'{
"created": 1757156493,
"id": "task-unified-1757156493-imcg5zqt",
"model": "gpt-image-2-beta",
"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": 2.5,
"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: gpt-image-2-beta",
"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"
}
}GPT Image
GPT Image 2 이미지 생성 Beta
- GPT Image 2 (gpt-image-2-beta) 모델은 텍스트-이미지, 이미지-이미지 및 이미지 편집 모드를 지원합니다
- 비동기 처리 모드, 반환된 작업 ID로 상태 조회
- 생성된 이미지 링크는 24시간 동안 유효하며, 즉시 저장해 주세요
크기 지원:
- 현재
size=auto또는 비율 크기(예:size="1:1")와resolution="1K"조합만 지원합니다 size=auto인 경우resolution필드는 무시되며 1K로 처리됩니다- 현재
resolution="2K"/resolution="4K"및 명시적 픽셀 크기(예:1024x1024)는 지원되지 않습니다 - 2K, 4K 또는 명시적 픽셀 제어가 필요하면 gpt-image-2를 사용하세요
과금 (per_call):
- 1K 단일 티어로 과금됩니다
n은 1로 고정.quality는 이 채널에서 제공되지 않음
POST
/
v1
/
images
/
generations
curl --request POST \
--url https://api.evolink.ai/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "gpt-image-2-beta",
"prompt": "A beautiful colorful sunset over the ocean"
}
'{
"created": 1757156493,
"id": "task-unified-1757156493-imcg5zqt",
"model": "gpt-image-2-beta",
"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": 2.5,
"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: gpt-image-2-beta",
"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"
}
}인증
모든 API는 Bearer Token 인증이 필요합니다
API Key 받기:
API Key 관리 페이지를 방문하여 API Key를 받으세요
요청 헤더에 추가:
Authorization: Bearer YOUR_API_KEY
본문
application/json
이미지 생성 모델 이름
사용 가능한 옵션:
gpt-image-2-beta 예시:
"gpt-image-2-beta"
생성하려는 이미지를 설명하거나 입력 이미지 편집 방법을 설명하는 프롬프트. 2000 토큰 제한
Maximum string length:
2000예시:
"A beautiful colorful sunset over the ocean"
생성 이미지 크기. 두 가지 모드를 지원합니다:
1. auto (기본값)
모델이 출력 크기를 자동으로 결정합니다. 이 경우 resolution 필드는 무시되며 1K로 처리됩니다.
2. 비율 (resolution="1K"와 함께 사용해야 함)
1:1: 정사각형3:2/2:3: 가로 / 세로4:3/3:4: 가로 / 세로5:4/4:5: 가로 / 세로16:9/9:16: 와이드스크린 가로 / 세로21:9/9:21: 울트라와이드 가로 / 세로2:1/1:2: 가로 / 세로3:1/1:3: 파노라마 가로 / 세로 (최대 종횡비)
참고: 명시적 픽셀 크기(예: 1024x1024)는 현재 지원되지 않습니다. 명시적 픽셀 제어가 필요하면 gpt-image-2를 사용하세요.
예시:
"16:9"
해상도 티어. size가 비율일 때만 유효하며 현재 1K만 지원됩니다.
무시되는 조건:
size=auto인 경우 이 필드는 무시되며 1K로 처리됩니다 (이 매개변수를 전달할 필요 없음)
가로/정사각형 출력 크기 (세로 크기는 가로의 너비/높이를 바꾼 값):
| 비율 | 1K |
|---|---|
1:1 | 1024×1024 |
2:1 | 1456×720 |
3:1 | 1776×592 |
3:2 | 1248×832 |
4:3 | 1184×880 |
5:4 | 1152×912 |
16:9 | 1360×768 |
21:9 | 1568×672 |
참고: 현재 2K / 4K는 지원되지 않습니다. 더 높은 해상도가 필요하면 gpt-image-2를 사용하세요.
사용 가능한 옵션:
1K 예시:
"1K"
이미지-이미지 및 이미지 편집 기능을 위한 참조 이미지 URL 목록
참고:
- 요청당 최대
16장의 참조 이미지 - 지원 형식:
.jpeg,.jpg,.png,.webp - 이미지 URL은 서버에서 직접 접근 가능하거나, 접근 시 직접 다운로드를 트리거하는 URL이어야 합니다 (일반적으로
.png,.jpg등 이미지 확장자로 끝나는 URL)
Maximum array length:
16예시:
[
"https://example.com/image1.png",
"https://example.com/image2.png"
]
작업 완료 시 HTTPS 콜백 URL
콜백 시점:
- 작업이 완료, 실패 또는 취소될 때 트리거됩니다
- 과금 확인 후 전송됩니다
보안 제한:
- 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"
응답
이미지 작업이 성공적으로 생성되었습니다
작업 생성 타임스탬프
예시:
1757156493
작업 ID
예시:
"task-unified-1757156493-imcg5zqt"
실제 사용된 모델 이름
예시:
"gpt-image-2-beta"
작업 객체 유형
사용 가능한 옵션:
image.generation.task 작업 진행률 (0-100)
필수 범위:
0 <= x <= 100예시:
0
작업 상태
사용 가능한 옵션:
pending, processing, completed, failed 예시:
"pending"
비동기 작업 정보
Show child attributes
Show child attributes
작업 출력 유형
사용 가능한 옵션:
text, image, audio, video 예시:
"image"
사용량 및 과금 정보
Show child attributes
Show child attributes