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-pro",
  "prompt": "An orange cat wearing an astronaut helmet, cyberpunk neon background"
}
'

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

🚧 이 모델은 아직 제공되지 않습니다. 기대해 주세요

Qwen (qwen-image-3.0-pro) 모델은 텍스트-이미지 생성(T2I, 참조 이미지 미전달)과 이미지 편집(I2I, 참조 이미지 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": "qwen-image-3.0-pro",
  "prompt": "An orange cat wearing an astronaut helmet, cyberpunk neon background"
}
'

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

필수

모델 이름

사용 가능한 옵션:

qwen-image-3.0-pro

예시:

"qwen-image-3.0-pro"

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 값에 따라 선불 과금되며, 실제 과금은 생성된 이미지 수를 기준으로 합니다

필수 범위: 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

생성 이미지의 크기, 기본값 auto:

auto(기본값): 모델이 적절한 출력 크기를 자동으로 선택
너비x높이: 예 1024x1024, 1024x1536, 1536x1024 등, 너비와 높이의 범위는 각각 [512, 2048] 픽셀

참고:

크기를 명시적으로 지정하는 것은 출력 이미지 수 n이 1일 때만 사용 가능하며, 그렇지 않으면 오류가 발생합니다; auto는 이 제한을 받지 않습니다

예시:

"1024x1024"

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-pro"

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

Z Image Turbo 이미지 생성 Qwen 이미지 편집 Plus

이미지 시리즈

비디오 시리즈

오디오 시리즈

텍스트 시리즈

계정 관리

작업 관리

파일 관리

Qwen 이미지 3.0 Pro

인증

본문

응답