Seedream

Endpoint: POST https://tokenhub-intl.tencentcloudmaas.com/v1/wand/si-image/generation
인증: Tokenhub API Key / Bearer

Seedream Image는 텍스트 생성과 참조 이미지 편집을 지원합니다. 5.0 Pro는 레이어 분해, 5.0 Lite는 그룹 이미지 생성을 지원합니다.

기본 정보

버전별 지원 규격

이미지 생성

API 설명

Seedream 이미지 생성(참조 이미지 기반 이미지 생성) API는 참조 이미지 기반 이미지 생성, 텍스트-이미지 생성, 이미지 편집을 지원합니다. 참조 이미지와 텍스트 프롬프트를 사용해 이미지를 생성하며, 이미지가 제공되지 않으면 텍스트-이미지 생성을 수행합니다.

API: POST https://tokenhub-intl.tencentcloudmaas.com/v1/wand/si-image/generation

요청 파라미터

요청 예시

참조 이미지 기반 이미지 생성

curl -X POST 'https://tokenhub-intl.tencentcloudmaas.com/v1/wand/si-image/generation' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "seedream-image-v5.0-pro",
  "images": [
    "https://mpstestmodel-1315536146.cos.ap-singapore.myqcloud.com/justin/wiki-examples/reference-cup.png"
  ],
  "prompt": "a cat sitting on a windowsill at sunset",
  "size": "2048x2048"
}'

텍스트-이미지 생성(images 미사용)

curl -X POST 'https://tokenhub-intl.tencentcloudmaas.com/v1/wand/si-image/generation' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "seedream-image-v5.0-pro",
  "prompt": "a cat sitting on a windowsill at sunset",
  "size": "2048x2048"
}'

응답 파라미터

응답 예시

{
  "created": 1787309367,
  "data": [
    {
      "output_format": "jpeg",
      "size": "2048x2048",
      "url": "https://xxxxxxx.jpg"
    }
  ],
  "model": "doubao-seedream-5-0-pro-260628",
  "tokenhub_usage": {
    "total_tokens": 60000
  },
  "request_id": "f781d9dc-9792-43d8-82f3-90de51a1ff44"
}

부록

통합 오류 코드

이미지 리소스의 일반 제한

참조 이미지: seedream-image-v5.0-pro는 최대 10개, seedream-image-v5.0-lite는 최대 14개의 이미지를 지원합니다. 이미지 URL 또는 Base64 문자열을 지원합니다(Base64 문자열에는 data:image/png;base64, 접두사가 포함되어야 함). 지원 형식에는 jpeg/png/webp/bmp/tiff/gif/heic/heif가 있습니다. 최소 픽셀 크기는 14 x 14이고, 총 픽셀 수는 36 million을 초과할 수 없으며, 종횡비는 1:16 미만 또는 16:1 초과여야 합니다. 각 이미지는 30 MB를 초과할 수 없으며 POST 본문은 20 MB를 초과할 수 없습니다.

FAQ

1. 텍스트-이미지와 이미지-이미지를 구분하는 방법은 무엇인가요?

동일한 API가 두 모드를 모두 지원합니다. image를 전달하면 이미지의 참조 대상을 기준으로 참조 이미지 기반 이미지 생성이 활성화되고, images를 생략하면 프롬프트만으로 텍스트-이미지 생성을 수행합니다. seedream-image-v5.0-pro는 두 모드를 모두 지원합니다.

2. 생성된 이미지 링크에 만료 시간이 있나요?

생성 결과는 12시간 후 만료되는 임시 주소입니다. 작업 성공 후 즉시 다운로드하세요.