Skip to content

이미지 생성

POST
/v1/images/generations
  • 모델이 프롬프트 및/또는 입력 이미지를 기반으로 새로운 이미지를 생성합니다.
  • 텍스트-이미지, 이미지 편집, 다중 이미지 합성 등의 시나리오를 지원합니다.
  • seedream-5.0/4.5/4.0/3.0-t2i 및 seededit-3.0-i2i 모델을 지원합니다.

Authorizations

bearer
Type
HTTP (bearer)

Request Body

application/json
object
  • 지원: 텍스트-이미지
    • doubao-seedream-3-0-t2i-250415
  • 지원: 이미지 편집
    • doubao-seededit-3-0-i2i-250628
  • 지원: 텍스트-이미지, 이미지-이미지
    • doubao-seedream-5-0-260128
    • doubao-seedream-4-5-251128
    • doubao-seedream-4-0-250828

이미지 생성을 위한 프롬프트입니다.

생성된 이미지의 반환 형식을 지정합니다. 다음 두 가지 반환 방식을 지원합니다:

  • url: 이미지 다운로드 링크를 반환합니다. 링크는 이미지 생성 후 24시간 동안 유효하므로제때 다운로드해 주세요.
  • b64_json: Base64 인코딩 문자열의 JSON 형식으로 이미지 데이터를 반환합니다.

기본값 url

string

이 매개변수는 doubao-seedream-3.0-t2i/seededit-3.0-i2i만 지원합니다
난수 시드로, 모델이 생성하는 내용의 무작위성을 제어합니다. 값 범위는 [-1, 2147483647]입니다.
참고:

  • 동일한 요청에서 모델이 다른 seed 값을 받으면, 예: seed 값을 지정하지 않거나 seed 값을 -1로 설정(난수로 대체)하거나 수동으로 seed 값을 변경하면,다른 결과를 생성합니다.
  • 동일한 요청에서 모델이 동일한 seed 값을 받으면, 유사한 결과를 생성하지만완전한 일치를 보장하지는 않습니다.

모델 출력 결과와 프롬프트의 일치 정도, 이미지 생성의 자유도, 텍스트 가중치라고도 함; 값이 클수록 모델 자유도가 작아지고, 사용자가 입력한 프롬프트와의 관련성이 높아집니다. 값 범위: [1, 10] 。

  • doubao-seedream-3.0-t2i 기본값 2.5
  • doubao-seededit-3.0-i2i 기본값 5.5
  • doubao-seedream-5.0-lite/4.5/4.0 지원하지 않음

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

  • false: 워터마크를 추가하지 않습니다.
  • true: 이미지 우측 하단에 "AI 생성" 워터마크를 추가합니다.

기본값 true

string |array

입력 이미지 정보로, URL 또는 Base64 인코딩을 지원합니다.

  • 이미지 URL: 이미지 URL에 접근 가능해야 합니다.
  • Base64 인코딩: 이 형식을 따르세요: data:image/<이미지 형식>;base64,<Base64 코드>. 참고: <이미지 형식>은 소문자여야 합니다, 예: data:image/png;base64,<base64_image>.

이 매개변수는 doubao-seedream-5.0-lite/4.5/4.0만 지원합니다
이 매개변수는 doubao-seedream-5.0-lite/4.5/4.0만 지원합니다
시리즈 이미지 기능의 사용 여부를 제어합니다. 입력한 내용을 기반으로하나의 이 연관된 이미지 세트를 생성합니다.

  • auto: 자동 판단 모드, 모델이 사용자가 제공한 프롬프트에 따라여부를 반환할 시리즈와 포함할 이미지 수를 자체판단합니다.
  • disabled: 시리즈 이미지 기능을 비활성화하고, 모델은한 한 장의 이미지만 생성합니다.
    기본값 disabled
object

이 매개변수는 doubao-seedream-5.0-lite/4.5/4.0만 지원합니다
시리즈 이미지 기능의 구성입니다. sequential_image_generation이 auto일 때만작동합니다.

이 매개변수는 doubao-seedream-5.0만 지원합니다
생성된 이미지의 파일 형식을 지정합니다. 선택 가능한 값:

  • png
  • jpeg

기본값 jpeg

Responses

생성된 이미지 데이터를 성공적으로 반환합니다

application/json
object
object[]
Required

Playground

Authorization
Body

Samples