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 Image Generation Beta

GPT Image 2 (gpt-image-2-beta) model supports text-to-image, image-to-image, and image editing modes
Asynchronous processing mode, use the returned task ID to query status
Generated image links are valid for 24 hours, please save them promptly

Size support:

Currently only supports size=auto, or ratio sizes (such as size="1:1") with resolution="1K"
When size=auto, the resolution field is ignored and treated as 1K
resolution="2K" / resolution="4K" and explicit pixel sizes (such as 1024x1024) are not currently supported
For 2K, 4K, or explicit pixel control, use gpt-image-2

Billing (per_call):

Billed at the 1K tier only
n is fixed at 1; quality is not exposed on this channel

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": "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"
  }
}

Authorizations

Authorization

string

header

required

All APIs require Bearer Token authentication

Get API Key:

Visit API Key Management Page to get your API Key

Add to request header:

Authorization: Bearer YOUR_API_KEY

Body

application/json

model

enum<string>

default:gpt-image-2-beta

required

Image generation model name

Available options:

gpt-image-2-beta

Example:

"gpt-image-2-beta"

prompt

string

required

Prompt describing the image you want to generate, or describing how to edit the input image. Limited to 2000 tokens

Maximum string length: 2000

Example:

"A beautiful colorful sunset over the ocean"

size

string

default:auto

Generated image size. Supports two modes:

1. auto (default)

The model automatically determines the output size. In this mode, the resolution field is ignored and treated as 1K.

2. Ratio (must be used with resolution="1K")

1:1: Square
3:2 / 2:3: Landscape / Portrait
4:3 / 3:4: Landscape / Portrait
5:4 / 4:5: Common social media
16:9 / 9:16: Widescreen landscape / portrait
21:9 / 9:21: Ultra-wide landscape / portrait
2:1 / 1:2: Landscape / Portrait
3:1 / 1:3: Panorama landscape / portrait (maximum aspect ratio)

Note: Explicit pixel sizes (such as 1024x1024) are not currently supported. For explicit pixel control, use gpt-image-2.

Example:

"16:9"

resolution

enum<string>

default:1K

Resolution tier. Effective only when size is a ratio. Currently only 1K is supported.

When ignored:

When size=auto, this field is ignored and treated as 1K (no need to pass this parameter)

Landscape / square output dimensions (portrait dimensions are the landscape width/height swapped):

Ratio	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

Note: 2K / 4K are not currently supported. For higher resolution, use gpt-image-2.

Available options:

1K

Example:

"1K"

image_urls

string<uri>[]

Reference image URL list for image-to-image and image editing features

Notes:

Up to 16 reference images per request
Supported formats: .jpeg, .jpg, .png, .webp
Image URLs must be directly accessible by the server, or URLs that trigger direct download (typically URLs ending with image extensions like .png, .jpg)

Maximum array length: 16

Example:

[
  "https://example.com/image1.png",
  "https://example.com/image2.png"
]

callback_url

string<uri>

HTTPS callback URL for task completion

Callback Timing:

Triggered when task is completed, failed, or cancelled
Sent after billing confirmation

Security Restrictions:

HTTPS protocol only
Internal IP addresses are prohibited (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
URL length must not exceed 2048 characters

Callback Mechanism:

Timeout: 10 seconds
Maximum 3 retries after failure (at 1/2/4 seconds after failure)
Callback response format is consistent with task query API
2xx status code is considered successful, other codes trigger retry

Example:

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

Response

Image task created successfully

created

integer

Task creation timestamp

Example:

1757156493

string

Task ID

Example:

"task-unified-1757156493-imcg5zqt"

model

string

Actual model name used

Example:

"gpt-image-2-beta"

object

enum<string>

Task object type

Available options:

image.generation.task

progress

integer

Task progress percentage (0-100)

Required range: 0 <= x <= 100

Example:

0

status

enum<string>

Task status

Available options:

pending,

processing,

completed,

failed

Example:

"pending"

task_info

object

Async task information

Show child attributes

type

enum<string>

Task output type

Available options:

text,

image,

audio,

video

Example:

"image"

usage

object

Usage and billing information

Show child attributes

GPT Image 2 Image Generation GPT Image 1.5 Image Generation

Image Series

Video Series

Audio Series

Text Series

Account Management

Task Management

File Management

GPT Image 2 Image Generation Beta

Authorizations

All APIs require Bearer Token authentication

Body

Response