Seedream 5.0 Pro

Seedream 5.0 Pro는 프롬프트로 이미지 한 장을 생성하고, 최대 10개의 참조 이미지를 편집하거나 조합하며, 이미지 한 장을 베이스 이미지와 최대 16개의 투명 레이어로 분리합니다. 1K, 1.5K, 2K 또는 직접 지정한 픽셀 크기로 출력합니다. 모델 상세 정보 및 플레이그라운드에서 확인하세요.

Wan API 연동제목 링크 복사

API 기본 URL은 https://api.wanapi.app입니다. API 키 설정에서 Wan 모델 제품군의 키를 만들고 Authorization: Bearer YOUR_API_KEY로 전송하세요. 키는 서버에 보관하세요. 플레이그라운드는 웹사이트 로그인 세션을 사용하며 같은 계정 잔액에서 요금이 차감됩니다.

GET /v1/models로 해당 키에서 사용할 수 있는 모델을 확인할 수 있습니다. Seedream 5.0 Pro는 OpenAI Images API를 사용합니다. POST /v1/images/generations에는 JSON을, POST /v1/images/edits에는 JSON 또는 multipart 업로드를 사용할 수 있습니다. 이미지가 준비되면 응답을 반환하며, 반복 조회할 작업은 없습니다.

이미지 생성제목 링크 복사

서버에서 WAN_API_KEY를 본인의 키로 설정하세요. 요청은 한 번만 전송하세요. 생성은 보통 1분 이내에 완료되며, 클라이언트 시간 제한은 최소 4분으로 설정하세요.

curl https://api.wanapi.app/v1/images/generations \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "bytedance/seedream-5.0-pro",
  "prompt": "A minimalist magazine cover: a red fox in fresh snow at dawn, the bold serif title \"QUIET WILD\" across the top",
  "size": "1K"
}'

응답은 OpenAI Images 형식을 따릅니다. 아래 값은 예시입니다.

{
  "created": 1792022400,
  "data": [
    {
      "url": "https://cdn.example.com/image-1.jpg",
      "size": "1024x1024",
      "output_format": "jpeg"
    }
  ],
  "usage": {
    "generated_images": 1
  }
}

이미지 URL은 30일 동안 사용할 수 있습니다. 더 오래 보관하려면 파일을 직접 저장하세요. "response_format": "b64_json"을 전송하면 각 이미지를 Base64 형식으로 b64_json에서도 받을 수 있습니다.

Seedream 5.0 Pro 요금제목 링크 복사

생성된 각 이미지는 픽셀 크기에 따라 이미지당 공식 요금보다 30% 낮은 요금으로 과금됩니다. 261만 픽셀 이하(1K 및 1.5K)에는 낮은 요율이, 더 큰 이미지에는 높은 요율이 적용됩니다. 첫 번째 참조 이미지는 무료이며 추가 참조 이미지마다 참조 이미지 요금이 붙습니다. 이미지가 생성되기 전에 거부된 요청에는 요금이 부과되지 않습니다.

레이어 분리는 베이스 이미지와 반환된 모든 레이어에 과금합니다. 반환된 모든 이미지가 261만 픽셀 이하이면 각각 공식 레이어 요금보다 30% 낮은 요금이 적용됩니다. 하나라도 더 크면 모든 이미지에 각자의 크기에 맞는 공식 레이어 요율이 적용됩니다. 2K에서는 항상 더 큰 이미지가 포함됩니다. 잔액은 최대 17장의 비용을 충당할 수 있어야 하며, 실제로 반환된 이미지에만 요금이 부과됩니다.

요청 필드제목 링크 복사

JSON 객체를 전송하세요. model은 필수이며, layer_decomposition이 true인 경우를 제외하면 prompt도 필수입니다. 정의되지 않은 필드는 거부됩니다.

이 모델은 stream, sequential_image_generation, tools, seed, guidance_scale, mask를 지원하지 않으며 해당 필드가 있으면 요청을 거부합니다.

참조 이미지 편집과 조합제목 링크 복사

이미지 한 장과 편집 지시를 보내거나, 조합할 여러 이미지를 보내세요.

{
  "model": "bytedance/seedream-5.0-pro",
  "prompt": "Place the perfume bottle from image 1 on the marble table from image 2, soft window light",
  "image": [
    "https://example.com/bottle.png",
    "https://example.com/table.jpg"
  ],
  "size": "2K",
  "output_format": "png"
}

POST /v1/images/edits는 같은 필드를 받습니다. multipart를 사용할 때는 image 또는 image[] 필드로 파일을 업로드하고 optimize_prompt_options를 JSON 문자열로 전송하세요.

레이어 분리제목 링크 복사

{
  "model": "bytedance/seedream-5.0-pro",
  "prompt": "Separate the title text, the parrot and the background",
  "image": "https://example.com/poster.png",
  "layer_decomposition": true,
  "size": "2K"
}

응답에서는 베이스 이미지가 먼저 나옵니다. 각 레이어에는 쌓임 순서, 위치와 설명이 추가됩니다.

{
  "created": 1792022400,
  "data": [
    { "url": "https://cdn.example.com/image-1.jpg", "size": "2048x2048", "output_format": "jpeg", "z_index": 0 },
    {
      "url": "https://cdn.example.com/image-2.png",
      "size": "1273x265",
      "output_format": "png",
      "z_index": 1,
      "bounding_box": { "absolute": [383, 120, 1655, 384], "normalized": [187, 59, 808, 188] },
      "name": "Title text",
      "description": "Yellow serif title text"
    }
  ],
  "usage": { "input_images": 1, "generated_images": 2 }
}

하나의 레이어라도 실패하면 요청 전체가 실패합니다. 프롬프트에서 제한보다 많은 레이어를 요청하면 일부 레이어 내용이 누락될 수 있습니다.

오류제목 링크 복사

오류는 OpenAI 오류 형식인 {"error": {"message", "type", "code"}}를 사용합니다.

시간 초과가 발생하면 사용 로그를 먼저 확인하지 않은 채 요청을 자동으로 재시도하지 마세요.