Seedream 5.0 Lite 이미지 생성

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.0-lite",
  "prompt": "2025년 파리 패션위크 최신 트렌드 스타일의 일러스트를 생성해 주세요",
  "size": "3:4",
  "quality": "2K",
  "model_params": {
    "tools": [
      {
        "type": "web_search"
      }
    ]
  }
}
'

{
  "created": 1757165031,
  "id": "task-unified-1757165031-seedream5lite",
  "model": "doubao-seedream-5.0-lite",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 45
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 1.8,
    "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.0-lite",
    "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"
  }
}

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.0-lite",
  "prompt": "2025년 파리 패션위크 최신 트렌드 스타일의 일러스트를 생성해 주세요",
  "size": "3:4",
  "quality": "2K",
  "model_params": {
    "tools": [
      {
        "type": "web_search"
      }
    ]
  }
}
'

{
  "created": 1757165031,
  "id": "task-unified-1757165031-seedream5lite",
  "model": "doubao-seedream-5.0-lite",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 45
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 1.8,
    "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.0-lite",
    "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.0-lite

필수

이미지 생성 모델 이름

사용 가능한 옵션:

doubao-seedream-5.0-lite

예시:

"doubao-seedream-5.0-lite"

prompt

string

필수

생성하려는 이미지를 설명하거나 입력 이미지 편집 방법을 설명하는 프롬프트, 2000 토큰 제한

Maximum string length: 2000

예시:

"A serene lake reflecting the beautiful sunset"

integer

생성할 최대 이미지 수, [1,15] 사이의 정수 값 지원

참고:

여러 이미지를 생성하려면 프롬프트에 "2개의 다른 이미지 생성"과 같은 내용을 포함하세요
참조 이미지 수 + 최종 생성 이미지 수 ≤ 15개
만약: 참조 이미지 수 + 프롬프트에서 요청한 이미지 수 > 15이고, 프롬프트에서 요청한 이미지 수 ≤ 매개변수 n 값이면, 최종 생성 이미지 = 15 - 참조 이미지 수
각 요청은 n 값을 기준으로 선불 청구되며, 실제 청구는 생성된 이미지 수를 기준으로 합니다

예시:

1

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 높이, 예: 2560x1440, 2048x2048, 4096x4096
총 픽셀 범위: [3686400, 16777216]
종횡비 범위: [1/16, 16]

예시:

"16:9"

quality

enum<string>

기본값:2K

해상도 등급이며 size의 비율 형식과 함께 사용합니다.

비율	2K	3K	4K
`1:1`	2048×2048	3072×3072	4096×4096
`2:3`	1664×2496	2496×3744	3328×4992
`3:2`	2496×1664	3744×2496	4992×3328
`3:4`	1728×2304	2592×3456	3520×4704
`4:3`	2304×1728	3456×2592	4704×3520
`4:5`	1792×2240	2688×3360	3584×4480
`5:4`	2240×1792	3360×2688	4480×3584
`9:16`	1600×2848	2304×4096	3040×5504
`16:9`	2848×1600	4096×2304	5504×3040
`21:9`	3136×1344	4704×2016	6240×2656
`9:21`	1344×3136	2016×4704	2656×6240

사용 가능한 옵션:

2K,

3K,

4K

예시:

"2K"

prompt_priority

enum<string>

기본값:standard

프롬프트 최적화 모드를 설정하는 데 사용되는 프롬프트 최적화 전략

옵션:

standard: 표준 모드, 더 높은 품질 출력, 더 긴 처리 시간

사용 가능한 옵션:

standard

예시:

"standard"

image_urls

string<uri>[]

이미지-이미지 및 이미지 편집 기능을 위한 참조 이미지 URL 목록

참고:

단일 요청 지원 입력 이미지 수: 14개
이미지 크기: 최대 10MB
지원 형식: .jpg, .jpeg, .png, .webp
이미지 URL은 서버에서 직접 접근 가능해야 합니다

Maximum array length: 14

예시:

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

model_params

object

지원되는 매개변수:

output_format: 출력 이미지 형식
tools: 웹 검색 도구

Show child attributes

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-1757165031-seedream5lite"

model

string

실제 사용된 모델 이름

예시:

"doubao-seedream-5.0-lite"

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.0 Pro 이미지 생성 Seedream 4.5 이미지 생성