Seedream(Doubao) 시리즈
ByteDance의 Doubao 이미지 모델로, 모두 세 가지입니다. OpenAI 호환 엔드포인트 /v1/images/generations로 호출하며, 텍스트로 이미지 생성과 이미지 편집 모두 이 엔드포인트를 사용합니다.
모델 선택
- 1K 크기 지원
- 이미지 세트와 4k 프리셋 미지원
- 이미지 세트와 4K 지원
- 최소 2K
- 이미지 세트와 n 여러 장 지원
- 최소 2K
volcengine/doubao-seedream-5.0-pro플래그십, 1K 지원실시간 가격은 모델 페이지 를 참고하십시오.
텍스트로 이미지 생성
Python
import base64
from openai import OpenAI
client = OpenAI(api_key="YOUR_OFOX_API_KEY", base_url="https://api.ofox.ai/v1", timeout=600)
resp = client.images.generate(
model="volcengine/doubao-seedream-5.0-pro",
prompt="흰 테이블 위에 놓인 빨간 사과 하나",
size="2560x1440",
)
with open("output.jpg", "wb") as f:
f.write(base64.b64decode(resp.data[0].b64_json))출력 형식은 JPEG로 고정되어 있으므로 .jpg 확장자로 저장하십시오. 기본적으로 base64를 반환하며, "response_format": "url"을 전달하면 이미지 링크를 반환합니다.
크기(size)
1k와 1024×1024는 모두 거부됩니다.size는 두 가지 방식으로 지정할 수 있습니다.
- 해상도 단계
1k,2k,4k(대소문자 구분 없음): 해상도만 지정하며, 비율은 모델이 프롬프트에 따라 결정합니다. 실측 결과 4.5에2k를 전달했을 때 2048×2048과 1664×2496이 모두 출력되었습니다. - 정확한 너비와 높이
너비x높이: 비율이 고정되며, 아래 표의 픽셀 범위를 만족해야 합니다.
”—“는 이번에 실측하지 않은 항목이며, Volcano Engine Ark 공식 문서 를 기준으로 하십시오.
자주 쓰는 유효한 너비와 높이(4.5와 5.0 Lite의 최소 픽셀 수 충족):
이미지 편집과 다중 참고 이미지
input_images가 아니라 image 필드를 사용하며, /v1/images/edits는 지원하지 않습니다.Python
import base64
from openai import OpenAI
client = OpenAI(api_key="YOUR_OFOX_API_KEY", base_url="https://api.ofox.ai/v1", timeout=600)
with open("apple.jpg", "rb") as f:
ref = "data:image/jpeg;base64," + base64.b64encode(f.read()).decode()
resp = client.images.generate(
model="volcengine/doubao-seedream-5.0-pro",
prompt="사과를 보라색으로 바꾸고, 나머지는 그대로 두세요",
size="2k",
extra_body={"image": [ref]},
)
with open("apple_purple.jpg", "wb") as f:
f.write(base64.b64decode(resp.data[0].b64_json))image는 배열이며, 각 항목은 이미지 URL 또는data:image/...;base64,로 시작하는 문자열입니다. 참고 이미지가 여러 장이면 순서대로 배열에 넣고, 프롬프트에서 각 이미지의 역할을 설명하십시오.input_images는 Qwen-Image 전용 필드이며 Seedream은 지원하지 않습니다.- Seedream은
/v1/images/edits를 지원하지 않으므로, 편집에는 이 섹션의image필드를 사용하십시오.
이미지 세트와 여러 장 생성
이미지 세트 예시:
{
"model": "volcengine/doubao-seedream-5.0-lite",
"prompt": "독립된 이미지 3장을 생성하세요: 같은 여우가 각각 봄, 여름, 가을에 있는 모습",
"size": "2k",
"sequential_image_generation": "auto",
"sequential_image_generation_options": { "max_images": 3 }
}auto는 생성할 장수를 모델이 결정한다는 뜻이며,max_images는 상한일 뿐입니다. 실측 결과 같은 요청에서 4.5는 세 컷 만화를 한 장에 합쳐 1장만 반환했습니다. 장수를 고정하려면 프롬프트에 “독립된 이미지 N장을 생성하세요”라고 명시하십시오.- 각 이미지는 개별 과금되며,
usage.output_tokens는 모든 이미지의 합계입니다.
워터마크
실측 결과 OfoxAI를 통해 호출하면 기본적으로 워터마크가 없으며, 별도 파라미터를 전달할 필요가 없습니다.
소요 시간
실측 결과 2K는 약 12~40초, 3장짜리 이미지 세트는 약 76초가 걸렸습니다. 클라이언트 타임아웃은 300초 이상으로 설정하는 것을 권장합니다.
자주 발생하는 오류
오류 원문 끝의 Request id: 0217…은 상위 서비스의 요청 번호입니다. 기술 지원에 문의할 때는 응답의 request_id와 함께 보내 주십시오.
오류 원문
The parameter `size` specified in the request is not valid: image size must be at least 3686400 pixels.
The parameter `size` specified in the request are not valid: image area must be at least 921600 pixels.
The parameter `size` specified in the request is not valid: image size must be at most 16777216 pixels.
The parameter `size` specified in the request is not valid: the specified size is not supported for model doubao-seedream-4-5.
The parameter `size` specified in the request are not valid: must be 'WIDTHxHEIGHT' or a supported size preset.
The parameter `size` specified in the request is not valid: size must be one of 'WIDTHxHEIGHT', '1k', '2k', or '4k'.
The parameter `sequential_image_generation` specified in the request are not valid: the parameter `sequential_image_generation` is not supported by the current model.
The parameter `output_format` specified in the request is not valid: the parameter `output_format` is not supported by the current model.공식 문서
공식 문서는 Volcano Engine Ark에 직접 연결할 때의 동작을 설명합니다. OfoxAI를 통해 호출할 때는 이 페이지의 실측 결과를 기준으로 하십시오.
자주 묻는 질문
Seedream에서 image size must be at least 3686400 pixels 오류가 나면 어떻게 합니까?
Seedream 4.5와 5.0 Lite의 최소 크기는 2K, 즉 3,686,400픽셀이며, 1024x1024와 1k는 모두 이를 충족하지 않습니다. 2k 또는 2048x2048, 2560x1440, 1440x2560 등의 크기로 변경하십시오. 더 작은 크기가 필요하면 최소 921,600픽셀(1280x720)이고 1k도 지원하는 5.0 Pro를 사용하십시오.
Seedream으로 이미지를 편집하려면 어떻게 합니까? input_images가 적용되지 않습니까?
Seedream의 참고 이미지 필드는 input_images가 아니라 image(배열이며, 각 항목은 이미지 URL 또는 data:image로 시작하는 base64)입니다. input_images는 Qwen-Image의 필드입니다. 또한 Seedream은 /v1/images/edits를 지원하지 않으므로 편집에도 /v1/images/generations를 사용합니다.
Seedream 이미지 세트로 한 번에 여러 장을 생성하려면 어떻게 합니까?
sequential_image_generation: "auto"와 sequential_image_generation_options.max_images를 전달하십시오. auto는 모델이 장수를 결정한다는 뜻이고 max_images는 상한이므로, 프롬프트에 "독립된 이미지 N장을 생성하세요"라고 명시하면 더 안정적입니다. 5.0 Lite와 4.5는 지원하고 5.0 Pro는 지원하지 않습니다.
Seedream 5.0 Pro에 n을 전달하면 sequential_image_generation is not supported 오류가 납니까?
5.0 Pro는 한 번에 여러 장을 생성하는 기능을 지원하지 않으므로, n과 이미지 세트 파라미터 모두 이 오류를 반환합니다. n을 삭제하고, 여러 장이 필요하면 요청을 여러 번 동시에 보내십시오.
Seedream으로 생성한 이미지에 워터마크가 있습니까?
OfoxAI를 통해 호출하면 실측 결과 기본적으로 워터마크가 없으며, 별도 파라미터를 전달할 필요가 없습니다.
Seedream은 PNG로 출력할 수 있습니까?
없습니다. 출력은 JPEG로 고정됩니다. output_format을 전달하면 400이 반환되므로 해당 파라미터를 삭제하십시오.
Seedream의 size에 2k를 전달하면 왜 비율이 고정되지 않습니까?
1k, 2k, 4k는 해상도만 지정하며, 비율은 모델이 프롬프트에 따라 결정합니다. 비율을 고정하려면 2560x1440처럼 정확한 너비와 높이를 전달하십시오.