Seedream 5.0
Seedream 5.0은 텍스트로 작성한 작업 지시로 이미지를 만들며, 이미지를 참고한 변경과 서로 연관된 이미지 세트를 지원합니다. Ailoot Ultra에서는 bytedance-seed/seedream-5-0을 사용하세요. 정확한 별칭 doubao-seedream-5-0-260128도 같은 모델을 선택합니다. 장면이나 변경 사항을 설명하고 각 참조 이미지의 역할을 명확히 지정한 뒤, 반환된 모든 이미지를 검토용으로 저장하세요.
- Ailoot Ultra · Images
POST /v1/images/generationsbytedance-seed/seedream-5-0 - Ailoot Ultra · Images
POST /v1/images/generationsdoubao-seedream-5-0-260128
모델 소개
이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.
Seedream 5.0은 텍스트에서 이미지 생성, 이미지에서 이미지 생성, 연관 이미지 작업 흐름을 제공하는 이미지 생성 모델입니다. Ailoot Ultra에서는 bytedance-seed/seedream-5-0과 별칭 doubao-seedream-5-0-260128로 사용할 수 있습니다. model과 prompt를 포함해 POST /v1/images/generations로 이미지를 요청하세요. 새로운 구도라면 피사체, 배치, 조명, 표현 방식을 설명하고, 변경 작업이라면 원하는 수정 사항과 유지할 원본 세부 요소를 설명하세요.
문서에 나온 이미지 참조 URL 작업 흐름에서는 image에 접근 가능한 이미지 URL 문자열의 배열을 제공하고, 프롬프트에서 각 참조 이미지의 역할을 지정하세요. 예를 들어 한 이미지는 제품을 정의하고 다른 이미지는 원하는 배치를 보여 주도록 한 다음, 프롬프트에 그 역할을 명시할 수 있습니다. 의상 변경 지시에서는 첫 번째 참조의 인물과 두 번째 참조의 의상을 지정할 수 있습니다. 모든 세부 요소가 그대로 유지되었다고 가정하지 말고 결과의 물건, 의상, 피사체를 원본과 대조하세요.
연관 이미지 생성에는 sequential_image_generation을 사용합니다. disabled는 이미지 한 장을 요청하고, auto는 세트가 적절한지 모델이 판단하도록 합니다. sequential_image_generation_options.max_images는 요청 세트의 상한을 1에서 15까지로 지정하며, 문서에 나온 기본값은 15입니다. 사계절 일러스트 시리즈라면 공통 장면, 네 계절의 차이, max_images:4를 지정하세요. 이 값은 상한이므로 실제 반환 항목 수를 확인하세요.
문서의 예제는 size:2K를 사용합니다. 선택 항목인 seed는 -1에서 2147483647 사이의 정수이며, 생략하면 시드가 자동으로 선택됩니다. watermark는 불리언입니다. 모델 문서에는 type:web_search인 tools 항목도 나옵니다. 참조 이미지나 검색 제어를 사용하더라도 장면 요구 사항을 명시하세요. 제품 일러스트라면 어떤 외관 세부 요소를 유지해야 하고 어떤 배경 요소를 바꿀 수 있는지 설명하세요.
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 bytedance-seed/seedream-5-0
bytedance-seed/seedream-5-0bytedance-seed/seedream-5-0doubao-seedream-5-0-260128
시작하기
Seedream 5.0은 텍스트로 작성한 작업 지시로 이미지를 만들며, 이미지를 참고한 변경과 서로 연관된 이미지 세트를 지원합니다. Ailoot Ultra에서는 bytedance-seed/seedream-5-0을 사용하세요. 정확한 별칭 doubao-seedream-5-0-260128도 같은 모델을 선택합니다. 장면이나 변경 사항을 설명하고 각 참조 이미지의 역할을 명확히 지정한 뒤, 반환된 모든 이미지를 검토용으로 저장하세요.
- 허용 입력
- 텍스트 · 이미지
- 결과
- 이미지
Ailoot에서 사용 가능 · 입력 및 메서드
Ailoot Ultra · Images POST /v1/images/generations
- 입력
text,image- 출력
image- 출력 형식
- 이미지 파일
| 필드 | 유형 | 요건 | 값과 한도 | 기본값 |
|---|---|---|---|---|
필드model | 유형string | 요건필수 | 값과 한도 bytedance-seed/seedream-5-0 | 기본값— |
필드prompt | 유형string | 요건필수 | 값과 한도 | 기본값— |
필드stream | 유형boolean | 요건선택 사항 | 값과 한도 false | 기본값false |
필드image | 유형array | 요건선택 사항 | 값과 한도 | 기본값— |
메서드 매개변수와 수명 주기
| 매개변수 | 명세 |
|---|---|
매개변수content_type | 명세application/json |
매개변수required | 명세model, prompt |
매개변수optional | 명세stream, image |
매개변수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": "bytedance-seed/seedream-5-0", "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 bytedance-seed/seedream-5-0, doubao-seedream-5-0-260128
메서드 경로 별칭
위에 표시된 메서드 경로를 사용하세요.
관련 호출용 ID
Ailoot Ultra · Images POST /v1/images/generations doubao-seedream-5-0-260128
doubao-seedream-5-0-260128bytedance-seed/seedream-5-0doubao-seedream-5-0-260128
시작하기
Seedream 5.0은 텍스트로 작성한 작업 지시로 이미지를 만들며, 이미지를 참고한 변경과 서로 연관된 이미지 세트를 지원합니다. Ailoot Ultra에서는 bytedance-seed/seedream-5-0을 사용하세요. 정확한 별칭 doubao-seedream-5-0-260128도 같은 모델을 선택합니다. 장면이나 변경 사항을 설명하고 각 참조 이미지의 역할을 명확히 지정한 뒤, 반환된 모든 이미지를 검토용으로 저장하세요.
- 허용 입력
- 텍스트 · 이미지
- 결과
- 이미지
Ailoot에서 사용 가능 · 입력 및 메서드
Ailoot Ultra · Images POST /v1/images/generations
- 입력
text,image- 출력
image- 출력 형식
- 이미지 파일
| 필드 | 유형 | 요건 | 값과 한도 | 기본값 |
|---|---|---|---|---|
필드model | 유형string | 요건필수 | 값과 한도 doubao-seedream-5-0-260128 | 기본값— |
필드prompt | 유형string | 요건필수 | 값과 한도 | 기본값— |
필드stream | 유형boolean | 요건선택 사항 | 값과 한도 false | 기본값false |
필드image | 유형array | 요건선택 사항 | 값과 한도 | 기본값— |
메서드 매개변수와 수명 주기
| 매개변수 | 명세 |
|---|---|
매개변수content_type | 명세application/json |
매개변수required | 명세model, prompt |
매개변수optional | 명세stream, image |
매개변수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-260128", "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 bytedance-seed/seedream-5-0, doubao-seedream-5-0-260128
메서드 경로 별칭
위에 표시된 메서드 경로를 사용하세요.
관련 호출용 ID
FAQ · Seedream 5.0
- 어떤 입력과 결과를 사용할 수 있나요?
POST /v1/images/generations·bytedance-seed/seedream-5-0:text,image→imagePOST /v1/images/generations·doubao-seedream-5-0-260128:text,image→image- 요청은 어떤 필드를 사용하나요?
POST /v1/images/generations·bytedance-seed/seedream-5-0:model,prompt,stream,imagePOST /v1/images/generations·doubao-seedream-5-0-260128:model,prompt,stream,image