Seedream 5.0 Pro
Seedream 5.0 Pro는 정확한 ID doubao-seedream-5-0-pro-260628로 텍스트와 참조 이미지에서 이미지를 만듭니다. 문서에 나온 작업 흐름에는 새로운 장면, 요청한 변경, 여러 참조 이미지의 조합, 연관 이미지 세트가 포함됩니다. 명확한 작업 지시로 각 참조의 역할을 지정한 뒤, 완성된 모든 이미지와 생성 설정을 보관하세요.
모델 소개
이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.
Seedream 5.0 Pro는 별개의 이미지 모델 doubao-seedream-5-0-pro-260628입니다. 문서에 나온 작업에는 새 이미지 생성, 제공된 이미지 변경, 텍스트나 시각적 참조를 바탕으로 한 연관 세트 생성이 포함됩니다. Ailoot Ultra에서는 정확한 model 문자열과 의도한 결과를 설명하는 prompt를 사용해 POST /v1/images/generations의 이미지 메서드를 이용하세요.
새 이미지 작업 지시에는 피사체, 시점, 배치, 조명, 시각적 표현 방식을 지정할 수 있습니다. 이미지를 참고한 변경에서는 수정 사항과 유지해야 할 원본 요소를 설명하세요. 참조가 여러 개라면 역할을 명확히 배분하세요. 한 이미지는 인물이나 제품을 정의하고 다른 이미지는 의상, 배경, 배치를 제공할 수 있습니다. 문서의 URL 작업 흐름에서는 image에 접근 가능한 이미지 URL 문자열의 배열을 제공하세요. 프롬프트에서 역할을 명확히 하면 완성된 이미지가 실제로 어떤 요소를 따랐는지 평가하는 데 도움이 됩니다.
통일된 세트를 만들 때는 sequential_image_generation:auto로 연관 이미지 생성을 활성화하고, disabled로 단일 이미지를 요청합니다. sequential_image_generation_options.max_images는 1에서 15 사이의 정수이며 기본값은 15입니다. 패키징 콘셉트 세트라면 공통 시각적 표현과 각 이미지에 필요한 특정 항목을 명시하고 적절한 상한을 설정하세요. max_images는 상한을 지정하므로 실제 반환 개수를 확인하세요.
Pro 예제는 size:2K를 명시적으로 사용합니다. 선택 항목인 seed의 범위는 -1에서 2147483647이며, 생략하면 시드가 자동으로 선택됩니다. watermark는 불리언이며, 문서의 tools 배열에는 type:web_search가 포함됩니다. 수정을 요청할 때는 유용한 구도를 유지하고 작업 지시에서 눈에 보이는 요구 사항 하나를 변경하여 새 결과를 선택한 이미지와 비교할 수 있게 하세요.
이미지 링크에는 response_format:url을, 인코딩된 이미지 데이터에는 b64_json을 선택하세요. 이 Ailoot 메서드는 스트리밍하지 않는 하나의 JSON 응답으로 전체 이미지 세트를 반환하므로 stream:false를 지정하거나 생략하세요. 모든 data[] 항목을 저장하고 usage.generated_images를 응답과 함께 보관하세요. 모든 b64_json 값을 디코딩하거나 반환된 모든 서명된 Ailoot URL에서 파일을 가져오세요. Ailoot는 완성된 이미지를 소유 미디어 자산으로 저장하며 URL 결과에는 서명된 Ailoot URL을 반환합니다. GET /v1/media/assets?family=image로 자산 기록을 찾고 모든 next_cursor를 따라가세요. 실제 asset_id마다 GET /v1/media/assets/{asset_id}를 호출해 content_url을 읽으세요. 서명된 링크에서 link_expired가 반환되면 같은 자산을 다시 읽어 갱신된 content_url을 받으세요. 전달이 완료되지 않았다면 원래 작업 정보와 반환된 모든 결과를 보관하고, 추가 생성을 시작하기 전에 기존 결과를 확인하세요.
Ailoot Ultra · Images POST /v1/images/generations doubao-seedream-5-0-pro-260628
doubao-seedream-5-0-pro-260628
doubao-seedream-5-0-pro-260628시작하기
Seedream 5.0 Pro는 정확한 ID doubao-seedream-5-0-pro-260628로 텍스트와 참조 이미지에서 이미지를 만듭니다. 문서에 나온 작업 흐름에는 새로운 장면, 요청한 변경, 여러 참조 이미지의 조합, 연관 이미지 세트가 포함됩니다. 명확한 작업 지시로 각 참조의 역할을 지정한 뒤, 완성된 모든 이미지와 생성 설정을 보관하세요.
- 허용 입력
- 텍스트 · 이미지
- 결과
- 이미지
Ailoot에서 사용 가능 · 입력 및 메서드
Ailoot Ultra · Images POST /v1/images/generations
- 입력
text,image- 출력
image- 출력 형식
- 이미지 파일
| 필드 | 유형 | 요건 | 값과 한도 | 기본값 |
|---|---|---|---|---|
필드model | 유형string | 요건필수 | 값과 한도 doubao-seedream-5-0-pro-260628 | 기본값— |
필드prompt | 유형string | 요건필수 | 값과 한도 | 기본값— |
필드image | 유형array | 요건선택 사항 | 값과 한도 | 기본값— |
필드sequential_image_generation | 유형string | 요건선택 사항 | 값과 한도 auto, disabled | 기본값— |
필드sequential_image_generation_options | 유형object | 요건선택 사항 | 값과 한도 | 기본값— |
필드sequential_image_generation_options.max_images | 유형integer | 요건필수 | 값과 한도 | 기본값— |
필드response_format | 유형string | 요건선택 사항 | 값과 한도 | 기본값— |
필드size | 유형string | 요건선택 사항 | 값과 한도 2K, 4K | 기본값— |
필드stream | 유형boolean | 요건선택 사항 | 값과 한도 false | 기본값— |
필드watermark | 유형boolean | 요건선택 사항 | 값과 한도 | 기본값— |
필드seed | 유형integer | 요건선택 사항 | 값과 한도 | 기본값— |
필드tools | 유형array | 요건선택 사항 | 값과 한도 | 기본값— |
메서드 매개변수와 수명 주기
| 매개변수 | 명세 |
|---|---|
매개변수content_type | 명세application/json |
매개변수required | 명세model, prompt |
매개변수optional | 명세image, sequential_image_generation, sequential_image_generation_options, response_format, size, stream, watermark, seed, tools |
매개변수material_types | 명세text, image |
매개변수conditions | 명세Use stream:false or omit stream. The complete buffered JSON result contains all generated images. |
수명 주기: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
요금
최종 요금 계산 방식
표시된 요율은 생성 전 비용을 예상하는 데 사용됩니다. 최종 청구액은 최초 생성에 기록된 비용으로 계산됩니다. 측정된 출력 길이와 예상 수량은 최종 청구 수량이 아닙니다.
요금 정보는 요청 옵션을 추가하지 않습니다. 지원되는 매개변수는 선택한 메서드에 표시됩니다.
- 빠른 모드
- 미지정 빠른 모드를 선택한 경우
- Flex 모드
- 미지정 flex 모드를 선택한 경우
- 최대 추론 수준
- 미지정 최대 추론 수준에 default 조정값을 적용하는 경우
비교용 예상 요금
설정별 가격
각 요금을 표시된 조건과 대조하세요. 서로 대체되는 설정 묶음마다 하나의 요금만 적용하세요.
| 설정 | 요금표 | 예측 수량 | 요금 |
|---|---|---|---|
| 설정기본 토큰 요금 | 요금표기본 요금 | 예측 수량— | 요금 입력 · 입력 토큰 · 비교 전용 추정치 — / 1K 토큰 출력 · 출력 토큰 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 읽기 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 쓰기 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 쓰기, 1시간 · 비교 전용 추정치 — / 1K 토큰 |
| 설정Estimated generation cost | 요금표— | 예측 수량1회 생성 예상치 | 요금 입력 · 예상 생성 비용 · 비교 전용 추정치 $0.09 생성 전 추정치 This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. 금액 확보와 정산 방식 →
요청 예제
Ailoot Ultra · Images
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "doubao-seedream-5-0-pro-260628", "prompt": "A calm studio product photograph with a plain background."}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
결과 수신 및 저장
Ailoot Ultra · Images
반환된 각 이미지를 다운로드하거나 Base64 내용을 저장하세요
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
완료된 결과 모두 보관
완료된 이미지를 모두 저장하세요. 반환된 각 URL에서 가져오거나 Base64 내용을 디코딩하세요.
Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.
원래 응답을 확인해야 할 경우
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
별칭
모델 별칭
Ailoot Ultra doubao-seedream-5-0-pro-260628
메서드 경로 별칭
위에 표시된 메서드 경로를 사용하세요.
관련 호출용 ID
FAQ · Seedream 5.0 Pro
- 어떤 입력과 결과를 사용할 수 있나요?
POST /v1/images/generations·doubao-seedream-5-0-pro-260628:text,image→image- 요청은 어떤 필드를 사용하나요?
POST /v1/images/generations·doubao-seedream-5-0-pro-260628:model,prompt,image,sequential_image_generation,sequential_image_generation_options,response_format,size,stream,watermark,seed,tools