curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "doubao-seedream-5.5",
  "prompt": "A serene lake reflecting the beautiful sunset",
  "size": "16:9",
  "quality": "2K"
}
'

{
  "created": 1757165031,
  "id": "task-unified-1793612886-seedream55",
  "model": "doubao-seedream-5.5",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 45
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_image",
    "credits_reserved": 1.836,
    "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: doubao-seedream-5.5",
    "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"
  }
}

Seedream 5.5

Seedream 5.5 이미지 생성

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

Seedream 5.5 (doubao-seedream-5.5)는 텍스트로 이미지 생성, 이미지로 이미지 생성, 이미지 편집을 지원하며 투명 배경 이미지도 생성할 수 있습니다
비동기 처리입니다. 반환된 작업 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": "doubao-seedream-5.5",
  "prompt": "A serene lake reflecting the beautiful sunset",
  "size": "16:9",
  "quality": "2K"
}
'

{
  "created": 1757165031,
  "id": "task-unified-1793612886-seedream55",
  "model": "doubao-seedream-5.5",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 45
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_image",
    "credits_reserved": 1.836,
    "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: doubao-seedream-5.5",
    "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>

기본값:doubao-seedream-5.5

필수

이미지 생성 모델 이름

사용 가능한 옵션:

doubao-seedream-5.5

예시:

"doubao-seedream-5.5"

prompt

string

필수

생성하려는 이미지를 설명하거나 입력 이미지 편집 방법을 설명하는 프롬프트

지원 언어: 중국어와 영어 외에 Seedream 5.5는 러시아어, 아랍어, 필리핀어, 태국어, 터키어, 한국어, 말레이어, 스페인어, 포르투갈어, 인도네시아어, 프랑스어, 독일어, 베트남어, 일본어도 지원합니다.

길이 제한: 최대 4000 토큰(중국어 약 2,600자, 영어 약 5,000단어)이며, 초과하면 400을 반환하고 과금되지 않습니다.

권장 사항: 중국어 300자, 영어 600단어 이내를 권장합니다. 제한 내라도 너무 길면 정보가 분산되어 모델이 세부 사항을 놓치고 화면 요소가 누락될 수 있습니다.

예시:

"A serene lake reflecting the beautiful sunset"

size

string

기본값:auto

생성 이미지 크기이며 두 가지 형식을 지원합니다:

방법 1 - 비율 형식:

auto, 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, 9:21
quality 매개변수와 함께 사용하면 픽셀을 직접 지정하지 않아도 해당 비율과 해상도의 이미지가 자동으로 생성됩니다

방법 2 - 픽셀 형식:

너비 x 높이, 예: 1024x1024, 2048x2048
총 픽셀 범위: [921600, 4624220]
종횡비 범위: [1/16, 16]
너비와 높이는 모두 14px보다 커야 합니다

size를 생략하면 기본값은 auto입니다. 모델이 프롬프트를 바탕으로 종횡비를 결정하며 출력 해상도는 quality로 지정합니다.

예시:

"16:9"

quality

enum<string>

기본값:1K

출력 해상도이며 size의 비율 형식과 함께 사용합니다. 기본값은 1K입니다.

비율	1K	1.5K	2K
`1:1`	1024×1024	1536×1536	2048×2048
`2:3`	832×1248	1248×1872	1664×2496
`3:2`	1248×832	1872×1248	2496×1664
`3:4`	864×1152	1344×1792	1776×2368
`4:3`	1152×864	1792×1344	2368×1776
`4:5`	896×1120	1344×1680	1792×2240
`5:4`	1120×896	1680×1344	2240×1792
`9:16`	800×1424	1152×2048	1584×2816
`16:9`	1424×800	2048×1152	2816×1584
`21:9`	1568×672	2352×1008	3136×1344
`9:21`	672×1568	1008×2352	1344×3136

사용 가능한 옵션:

1K,

1.5K,

2K

예시:

"2K"

prompt_priority

enum<string>

기본값:standard

프롬프트 최적화 모드입니다. standard만 지원하며 기본값도 standard입니다.

fast를 전달하면 400이 반환되며 과금되지 않습니다.

사용 가능한 옵션:

standard

예시:

"standard"

image_urls

string<uri>[]

이미지로 이미지 생성 및 이미지 편집에 사용하는 참조 이미지 URL 목록

참고:

참조 이미지는 생성 이미지와 별도로 과금됩니다
요청 한 번에 최대 10장의 입력 이미지 지원
이미지 크기: 최대 30MB
지원 형식: .jpeg, .jpg, .png, .webp, .bmp, .tiff, .gif, .heic, .heif
가로세로 비율(너비/높이): [1/16, 16]
너비와 높이는 각각 14px보다 커야 합니다
총 픽셀 수: [196, 6000×6000]
이미지 URL은 서버에서 직접 이미지를 볼 수 있거나 접근 시 바로 다운로드할 수 있어야 합니다(일반적으로 .png, .jpg 같은 이미지 확장자로 끝나는 URL)

Maximum array length: 10

예시:

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

output_format

enum<string>

기본값:png

출력 이미지 형식

옵션:

png: PNG 형식(기본값)
jpeg: JPEG 형식

참고: background=transparent일 때 출력은 png로 고정됩니다. output_format을 생략하면 자동으로 png를 사용하며, jpeg를 지정하면 거부됩니다.

사용 가능한 옵션:

png,

jpeg

예시:

"png"

watermark

boolean

기본값:false

생성된 이미지에 워터마크를 추가할지 여부

예시:

false

background

enum<string>

기본값:auto

출력 이미지의 배경 유형입니다. 기본값은 auto입니다.

옵션:

auto: 프롬프트와 참조 이미지를 바탕으로 모델이 배경을 결정합니다. 작업 상세의 result_data[].background는 실제 배경 유형인 transparent 또는 opaque를 반환합니다
transparent: 투명 채널이 있는 PNG를 생성합니다. 텍스트로 이미지 생성과 이미지로 이미지 생성을 지원합니다
opaque: 불투명 배경 이미지를 생성합니다

transparent 사용 시:

참조 이미지는 선택 사항입니다. 제공하는 경우 최대 10장이며 입력 이미지에 투명 채널이 없어도 됩니다
출력 형식은 png로 고정됩니다. output_format을 생략하면 자동으로 png를 사용하며 jpeg를 전달하면 오류가 반환됩니다

사용 가능한 옵션:

auto,

transparent,

opaque

예시:

"auto"

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

작업 생성 타임스탬프

예시:

1757165031

string

작업 ID

예시:

"task-unified-1793612886-seedream55"

model

string

실제 사용된 모델 이름

예시:

"doubao-seedream-5.5"

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

이미지 시리즈

비디오 시리즈

오디오 시리즈

텍스트 시리즈

계정 관리

작업 관리

파일 관리

Seedream 5.5 이미지 생성

과금 안내

인증

본문

응답