Skip to main content
POST
Seedream 5.0 Pro

소개

Seedream 5.0 Pro(모델 dola-seedream-5-0-pro-260628)는 텍스트-이미지, 단일 이미지 편집, 다중 이미지 참조/융합을 지원합니다. OpenAI 호환 이미지 생성 API로 동기 호출하며, 현재 요청당 출력은 1장입니다. 여러 참조 이미지는 입력이 여러 장임을 의미하며, 출력이 여러 장인 것은 아닙니다. 여러 결과가 필요하면 요청을 여러 번 보내세요. 전체 모델 비교는 이미지 생성을 참고하세요.

인증

string
필수
Bearer Token, 예: Bearer sk-xxxxxxxxxx
string
필수
application/json
API Key는 플랫폼 API 키 페이지에서 생성하세요. 프론트엔드 코드, 공개 저장소, 클라이언트 패키지에 키를 넣지 마세요.

모델 정보

엔드포인트

요청 파라미터

prompt

원하는 내용을 설명하는 필수 텍스트 지시입니다. 이미지-이미지에서는 참조 이미지를 어떻게 사용·수정할지도 함께 적습니다.

images

플랫폼이 접근 가능한 이미지 URL을 하나 이상 전달합니다:
다중 참조 예시:
  • URL은 서버에서 접근 가능해야 하며, 로컬 브라우저에서만 유효해서는 안 됩니다.
  • 여러 이미지는 참조/융합/편집용이며, 결과는 여전히 1장입니다.
  • 현재 테스트·프로덕션 호출은 images 배열 필드를 사용합니다.
  • 형식, 크기, 개수, 접근성은 업스트림 모델 요구사항을 충족해야 합니다.

size

해상도 티어 또는 커스텀 픽셀 크기를 지원합니다:
일반적인 크기:

호출 예시

성공 응답

플랫폼은 OpenAI 호환 이미지 생성 결과를 반환합니다:

응답 필드

data[].url은 보통 임시 주소입니다. 응답을 받은 후 즉시 다운로드해 자체 스토리지에 보관하세요.

다중 이미지 안내

이 모델은 현재 요청당 1장만 반환합니다. 아래 요청은 참조 이미지 2장을 넣을 수 있지만 결과는 여전히 1장입니다:
독립 결과 3장이 필요하면 n: 3에 의존하지 말고 요청을 3번 보내세요:

오류 처리

요청 실패 시 보통 JSON 오류 객체를 반환합니다:
자주 발생하는 문제: