curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "qwen-image-3.0",
  "prompt": "An orange cat wearing an astronaut helmet, cyberpunk neon background",
  "size": "16:9",
  "quality": "2K"
}
'

{
  "created": 1757156493,
  "id": "task-unified-1757156493-imcg5zqt",
  "model": "qwen-image-3.0",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 30
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_image",
    "credits_reserved": 2.2483,
    "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: qwen-image-3.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"
  }
}

Qwen-Image

Qwen 이미지 3.0

Qwen(qwen-image-3.0)은 Qwen 이미지 생성·편집 3.0의 표준 버전으로, 텍스트-이미지 생성(T2I, 참조 이미지 미전달)과 이미지 편집(I2I, 참조 이미지 1-3장 전달)의 두 가지 모드를 동일하게 지원하며 품질과 속도를 함께 고려합니다
요청 매개변수, 크기 기준, 응답 구조는 qwen-image-3.0-pro와 완전히 동일하며, 차이는 생성 품질과 가격뿐입니다
비동기 처리 모드, 반환된 작업 ID로 조회
생성된 이미지 링크는 24시간 동안 유효하며, 즉시 저장해 주세요

과금 안내:

「출력 이미지 장수 × 해상도 등급」으로 과금되며, 표준 버전은 1K와 2K가 동일 가격입니다(2K가 더 비싼 Pro와 다른 점입니다)
참조 이미지를 전달한 경우(I2I) 참조 이미지는 장당 별도로 한 번씩 과금됩니다. 이 비용은 n과 무관하며 출력 장수에 따라 늘어나지 않습니다
단가가 Pro보다 낮으므로 가성비를 중시한다면 본 모델을 우선 선택하세요

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": "qwen-image-3.0",
  "prompt": "An orange cat wearing an astronaut helmet, cyberpunk neon background",
  "size": "16:9",
  "quality": "2K"
}
'

{
  "created": 1757156493,
  "id": "task-unified-1757156493-imcg5zqt",
  "model": "qwen-image-3.0",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 30
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_image",
    "credits_reserved": 2.2483,
    "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: qwen-image-3.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>

기본값:qwen-image-3.0

필수

모델 이름

사용 가능한 옵션:

qwen-image-3.0

예시:

"qwen-image-3.0"

prompt

string

필수

생성하려는 이미지를 설명하는 프롬프트(텍스트-이미지 생성), 또는 입력된 이미지를 어떻게 편집할지 설명하는 프롬프트(이미지 편집). 4500 토큰 제한

Maximum string length: 4500

예시:

"Replace the background of this image"

image_urls

string<uri>[]

참조 이미지 URL 목록(선택 사항). 미전달 또는 빈 배열 = 텍스트-이미지 생성(T2I); 1-3장 전달 = 이미지 편집(I2I)

참고:

단일 요청에서 지원하는 입력 이미지 수: 0-3장, 3장을 초과하면 오류가 발생합니다
공용 http/https 이미지 URL만 지원하며, base64 / data-url은 지원하지 않습니다
이미지의 너비와 높이는 각각 [384-3072] 픽셀 범위 내여야 합니다
지원하는 파일 형식: .jpg, .jpeg, .png, .bmp, .webp, .tiff
이미지 URL은 서버에서 직접 볼 수 있거나, 접근 시 이미지가 바로 다운로드되어야 합니다(일반적으로 이러한 URL은 .png, .jpg처럼 이미지 확장자로 끝납니다)

예시:

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

integer

기본값:1

생성할 이미지 수를 지정합니다, [1,6] 사이의 정수 값을 지원합니다

참고:

각 요청은 n 값에 따라 선불 과금되며, 실제 과금은 생성된 이미지 수를 기준으로 합니다
참조 이미지(image_urls)의 비용은 업로드한 장수만큼만 한 번씩 과금되며 n에 따라 늘어나지 않습니다

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

예시:

1

negative_prompt

string

이미지에서 보고 싶지 않은 콘텐츠를 설명하는 네거티브 프롬프트, 출력을 제한하는 데 사용

참고:

중국어와 영어를 지원하며, 최대 길이 500자, 각 한자/글자는 한 글자로 계산, 초과 시 자동으로 잘림

Maximum string length: 500

예시:

"low resolution, error, worst quality, low quality, mutilated, extra fingers, bad proportions"

size

string

기본값:auto

생성되는 이미지의 크기로, 세 가지 방식을 지원합니다:

방식 1 - 자동(기본값):

auto: 모델이 프롬프트에 따라 적절한 출력 크기를 자동으로 선택합니다(이때 quality는 적용되지 않음)

방식 2 - 비율 형식:

1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, 9:21
quality 매개변수와 함께 사용하며, 시스템이 해당 비율과 해상도에 대응하는 픽셀로 자동 환산하므로 수동으로 지정할 필요가 없습니다

방식 3 - 픽셀 형식:

너비×높이, 예: 1024x1024, 2048x2048, 2720x1530 등
총 픽셀 값 범위: [262144, 4194304](즉 512×512 ~ 2048×2048)
종횡비 값 범위: [1/16, 16], 한 변이 2048px를 초과할 수 있음
너비와 높이 모두 14px보다 커야 합니다

참고:

size와 n은 서로 독립적이며, n>1일 때에도 크기/비율을 지정할 수 있습니다
size를 전달하지 않으면 기본값은 auto입니다

예시:

"16:9"

quality

enum<string>

기본값:1K

해상도 등급으로, size의 비율 형식과 함께 사용하며 기본값은 1K입니다(auto 및 픽셀 형식에서는 적용되지 않음).

비율	1K	2K
`1:1`	1024×1024	2048×2048
`2:3`	832×1248	1664×2496
`3:2`	1248×832	2496×1664
`3:4`	864×1152	1770×2360
`4:3`	1152×864	2360×1770
`4:5`	896×1120	1792×2240
`5:4`	1120×896	2240×1792
`9:16`	800×1424	1530×2720
`16:9`	1424×800	2720×1530
`21:9`	1568×672	3122×1338
`9:21`	672×1568	1338×3122

사용 가능한 옵션:

1K,

2K

예시:

"2K"

prompt_extend

boolean

기본값:false

prompt 지능형 재작성 활성화 여부. 기본값은 false(사용자 prompt를 임의로 재작성하지 않음); true를 명시적으로 전달해야 대규모 모델로 긍정 프롬프트를 최적화하며, 설명이 부족하거나 비교적 단순한 prompt에서 개선 효과가 더 뚜렷합니다

예시:

true

watermark

boolean

기본값:false

이미지 오른쪽 하단에 "Qwen-Image" 워터마크를 추가할지 여부. 기본값은 false입니다

예시:

false

seed

integer

랜덤 시드, 범위 [0, 2147483647], 동일한 seed 매개변수 값을 사용하면 생성 콘텐츠를 비교적 안정적으로 유지할 수 있습니다

참고:

제공하지 않으면 알고리즘이 자동으로 랜덤 시드를 사용합니다
모델 생성 과정은 확률적이므로, 동일한 seed를 사용하더라도 매번 생성 결과가 완전히 동일하다고 보장할 수 없습니다

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

예시:

12345

callback_url

string<uri>

작업 완료 후 HTTPS 콜백 주소

콜백 타이밍:

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

보안 제한:

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

실제 사용된 모델 이름

예시:

"qwen-image-3.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

이미지 시리즈

비디오 시리즈

오디오 시리즈

텍스트 시리즈

계정 관리

작업 관리

파일 관리

Qwen 이미지 3.0

인증

본문

응답