APIMart
Seedream5.5 모델 아이콘
이미지

Seedream5.5 API

Seedream5.5 API의 이미지 생성, 정밀 편집, 다국어 텍스트와 다중 이미지 합성 흐름을 살펴보세요. APIMart 작업 공간에서 프롬프트와 참고 이미지를 정리한 뒤 아래 API 예제와 매개변수 표로 설정을 확인하세요.

이미지 생성 및 편집다국어 텍스트정밀한 부분 수정

Seedream5.5 API 작업 공간

  • 1K, 1.5K, 2K, 화면비 및 사용자 지정 픽셀
  • 참조 이미지 최대 10장, 투명 배경이나 레이어 분리는 1장
  • JPEG / PNG, 프롬프트 최적화 및 출력 설정
Input

주제, 구도, 조명, 이미지에 포함할 텍스트를 설명하세요.

참조 이미지

참조 이미지는 최대 10장, 투명 배경이나 레이어 분리는 1장입니다. 로컬 파일은 JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF를 지원하며 장당 최대 30 MB입니다. JSON에는 공개 HTTP(S) URL 또는 완전한 이미지 Data URI를 사용하세요. 로컬 파일은 계속 브라우저 미리보기용으로만 사용됩니다.

참조 이미지의 각 변은 14 px 초과, 가로/세로 비율은 1/16~16, 총 픽셀 수는 36,000,000 이하여야 합니다. 투명 배경에는 알파 채널이 있는 입력 이미지가 필요합니다.

출력

생성된 이미지가 여기에 표시됩니다

Seedream5.5 API로 제작 의도를 명확하게

새 장면이나 부분 편집을 위한 Seedream5.5 API 초안을 준비하세요. 피사체, 조명과 구도를 정한 뒤 변경할 내용과 유지할 세부 사항을 구분해 작성하세요.

Seedream5.5 API 예제: 이미지 생성과 편집

Seedream5.5 API 예제는 프롬프트, 참조 이미지, 크기, 해상도, 출력 옵션을 포함하는 APIMart 공통 비동기 작업 형식을 사용합니다. 반환된 작업 ID로 결과를 별도로 조회하세요.

  1. 1

    API 키 설정

    APIMart API 키를 APIMART_API_KEY에 저장하세요. Seedream5.5 API 예제는 제출과 작업 조회 모두에 Authorization: Bearer <key>를 사용합니다.

  2. 2

    Seedream5.5 API 요청 구성

    예제는 POST /v1/images/generations에 model: seedream-5.5, prompt, size, resolution, output_format을 지정합니다. 편집에는 image_urls를 추가하고 data[0].task_id에서 작업 ID를 읽습니다.

  3. 3

    API 작업 결과 확인

    GET /v1/tasks/{task_id}를 사용하세요. 완료된 작업은 data.result.images[0].url[0]을 읽고, 실패한 작업은 data.error.message를 확인하세요.

    APIMart 인증과 일반적인 API 사용법은 APIMart 문서를 참고하세요.

POST /v1/images/generations
curl -X POST https://api.apimart.ai/v1/images/generations \
  -H "Authorization: Bearer $APIMART_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5.5",
    "prompt": "밝은 나무 테이블 위에 흰색 도자기 컵을 놓은 잡지 스타일 제품 포스터. 부드러운 측면 조명, 상단에 \"아침의 루틴\"이라는 제목, 읽기 쉬운 글자와 넉넉한 여백.",
    "size": "16:9",
    "resolution": "1.5K",
    "output_format": "png"
  }'

Seedream5.5 API 매개변수

매개변수유형필수기본값설명
modelstring필수기본값: seedream-5.5이 Seedream5.5 API 작업 공간과 예제의 모델 설정값: seedream-5.5.
promptstring필수기본값: —Seedream5.5 지시문입니다. 새 이미지 또는 편집 내용과 유지할 세부 사항을 설명하세요. layer_decomposition이 true이면 생략할 수 있습니다.
sizestring선택기본값: 1:1작업 공간 기본값은 1:1입니다. auto, 화면비 1:1·4:3·3:4·16:9·9:16·3:2·2:3·2:1·1:2·21:9, 단계 1K·1.5K·2K 또는 2048x1024 같은 사용자 지정 픽셀을 선택할 수 있습니다. 사용자 지정 크기는 총 픽셀 수 921,600~4,624,220과 가로/세로 비율 1/16~16을 충족해야 합니다.
resolutionstring선택기본값: 1KSeedream5.5 API 초안 해상도는 1K, 1.5K, 2K입니다. size가 화면비나 auto일 때 적용됩니다. 단계 또는 픽셀 크기를 지정하거나 레이어를 분리할 때는 생략합니다.
image_urlsarray선택기본값: —공개 HTTP(S) URL 또는 완전한 base64 이미지 Data URI로 참조 이미지 최대 10장을 지정합니다. JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF를 지원하며 장당 최대 30 MB입니다. 가로/세로 비율은 1/16~16, 각 변은 14 px 초과, 총 픽셀 수는 36,000,000 이하여야 합니다. 투명 배경 또는 레이어 분리에는 참조 이미지가 정확히 1장 필요합니다. 로컬 blob URL은 브라우저 미리보기용입니다.
output_formatstring선택기본값: jpeg출력 형식은 jpeg 또는 png입니다. 양식에서 투명 배경을 선택하면 PNG가 자동 선택됩니다.
backgroundstring선택기본값: opaqueopaque 또는 transparent입니다. 투명 배경에는 알파 채널이 있는 입력 이미지가 정확히 1장 필요하며 PNG로 출력해야 합니다.
layer_decompositionboolean선택기본값: falsePNG 또는 JPEG 참조 이미지 1장을 기본 이미지와 투명 레이어로 분리합니다. 이 모드의 size는 auto, 1K, 1.5K, 2K만 허용하며 prompt는 선택 사항이고 resolution은 생략합니다.
optimize_prompt_optionsobject선택기본값: Omitted선택적 프롬프트 최적화: {"mode":"standard"}. 작업 공간 기본값은 끄기이며, 이 경우 해당 필드를 생략합니다.
watermarkboolean선택기본값: false출력 이미지에 AI 생성 워터마크를 추가할지 지정합니다.
nsfw_checkboolean선택기본값: falseAPI 작업을 처리하기 전에 프롬프트와 입력 이미지를 검토할지 지정합니다.
ninteger선택기본값: 1일반 생성은 이미지 1장을 출력합니다. JSON은 n: 1만 허용하며 작업 공간은 정규화된 설정에서 이 필드를 생략합니다.