APIMart
Seedream 5.5 모델 아이콘
이미지

Seedream 5.5 API

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

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

Seedream5.5 API 작업 공간

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

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

참조 이미지

출력
Model preview

Seedream 5.5 API 요금

숨겨진 수수료 없는 투명한 요금제. 사용한 만큼만 지불하세요.

* 실제 비용은 최종 출력에 따라 달라집니다.

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를 전송합니다. 편집에는 image_urls를 추가하고 응답에서 task_id를 읽습니다. Python 예제는 data로 감싼 응답도 처리합니다.

  3. 3

    API 작업 결과 확인

    GET /v1/tasks/{task_id}로 조회합니다. SUCCESS이면 result.images, FAILURE이면 fail_reason을 확인합니다. 예제는 completed/failed 상태도 처리합니다.

    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선택기본값: 2K기본값 2K. 1K/1.5K/2K, 비율과 resolution 또는 픽셀 크기(921,600–4,624,220픽셀, 비율 1/16–16)를 지원합니다. 레이어: auto/1K/1.5K/2K만 지원. 기본 이미지와 각 레이어는 선택한 해상도 등급으로 출력되며 각 비율을 유지합니다. auto는 입력 크기를 1K~2K 범위로 맞추고 높은 등급으로 선차감합니다. 기본값은 2K입니다. 1K 또는 1.5K를 선택하면 더 저렴합니다. 참조 이미지는 별도 과금됩니다. 이미지 생성에서 auto는 2K와 같습니다.
resolutionstring선택기본값: 2K / auto비율 지정 생성에서는 1K / 1.5K / 2K(기본 2K)를 사용합니다. 레이어 분해는 size가 우선이며 생략한 경우에만 resolution을 사용합니다. 1K / 1.5K / 2K / auto만 지원하며 기본값은 auto입니다.
image_urlsarray선택기본값: —투명 생성도 참조 이미지 최대 10장을 지원합니다. HTTP(S) URL, 이미지 Data URI 또는 로컬 JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF 파일을 사용할 수 있습니다. 장당 최대 30 MiB, 3,600만 픽셀. 로컬 파일은 실행 시 업로드됩니다. 레이어 분해에는 참조 이미지가 정확히 1장 필요합니다. 출력 등급 가격 + 참조 수 × 입력 이미지 가격. 모든 참조 이미지에 요금이 부과됩니다.
output_formatstring선택기본값: png출력 형식은 jpeg 또는 png입니다. 양식에서 투명 배경을 선택하면 PNG가 자동 선택됩니다. 레이어 분리에서는 기본 이미지 형식에만 적용되며, 나머지 레이어는 항상 PNG입니다.
backgroundstring선택기본값: autoauto(기본값), transparent 또는 opaque. 참조 이미지 없이도 투명 생성이 가능하며 PNG가 필요합니다. 레이어 모드에서는 background를 생략합니다.
layer_decompositionboolean선택기본값: false참조 이미지 1장, 프롬프트는 선택 사항입니다. size: auto/1K/1.5K/2K. background는 전송하지 않습니다. max_images × 등급 가격에 참조 이미지 1장 요금을 더해 선차감합니다. 2~100장(기본 30)을 선택하며 실제 출력 수와 픽셀 등급으로 정산합니다. 상한을 낮추면 선차감액이 줄어듭니다.
optimize_prompt_optionsobject선택기본값: standard{"mode":"standard"}. 프롬프트 최적화는 항상 standard이며 끌 수 없습니다. 매개변수를 생략해도 standard가 적용됩니다.
watermarkboolean선택기본값: false출력 이미지에 AI 생성 워터마크를 추가할지 지정합니다.
nsfw_checkboolean선택기본값: falseAPI 작업을 처리하기 전에 프롬프트와 입력 이미지를 검토할지 지정합니다.
ninteger선택기본값: 1일반 생성은 이미지 1장을 출력합니다. JSON은 n: 1만 허용하며 작업 공간은 정규화된 설정에서 이 필드를 생략합니다.
layer_decomposition_options.max_imagesinteger선택기본값: 30max_images × 등급 가격에 참조 이미지 1장 요금을 더해 선차감합니다. 2~100장(기본 30)을 선택하며 실제 출력 수와 픽셀 등급으로 정산합니다. 상한을 낮추면 선차감액이 줄어듭니다. 30장을 초과하면 시간이 더 걸리며, 100장은 약 5분이 걸릴 수 있습니다.
layer_decomposition_options.text_recognitionboolean선택기본값: false지원되는 텍스트 레이어의 문자와 추정 스타일을 반환합니다. 손글씨, 장식 글자, 비텍스트 레이어에는 OCR이 없을 수 있습니다. OCR이 필요하면 프롬프트를 비워 두세요. 프롬프트를 입력하면 인식 결과가 반환되지 않을 수 있습니다.