요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
image_url | 예 | 출발점이 되는 이미지. |
output_format | 아니요 | 결과 파일 형식. jpeg · png · 기본값: jpeg |
prompt | 아니요 | Optional: name the elements to separate. Leave empty to let the model pick the main elements. |
resolution | 아니요 | 출력 크기. 클수록 선명하고 가격도 올라갑니다. auto · 1k · 1.5k · 2k · 기본값: 1.5k |
가격
가격은 웹사이트에서 쓰는 것과 같은 크레딧으로 표시됩니다(1크레딧 = $0.01). 작업이 접수될 때 먼저 보류되고, 끝나면 실제 요금으로 정산되며, 실패한 작업은 환불됩니다.
| 옵션 | 크레딧 /장 | ≈ USD |
|---|---|---|
| resolution 1.5K | 6.3 | US$0.063 |
| resolution 1K | 6.3 | US$0.063 |
| resolution 2K | 12.6 | US$0.13 |
| resolution auto | 12.6 | US$0.13 |
작업마다 크레딧은 정수로 올림 처리되므로, 가장 낮은 옵션으로 한 번 실행하면 7크레딧/장(US$0.07)입니다.
실행 전에 정확한 금액을 알고 싶다면 같은 본문을 POST /jobs/quote로 보내세요.
API 빠른 시작
Seedream 5.0 Pro API를 3단계로 호출하기
- API 키 만들기. PopNow에 로그인해 API 콘솔에서 키를 만드세요. 키는 sk-popnow-(으)로 시작하며 웹사이트와 같은 크레딧을 씁니다.
- 요청 보내기. POST /jobs/createTask에 model은 bytedance/seedream-5.0-pro/layer-decomposition, input은 파라미터 표에 맞춰 보내세요. 응답으로 작업 ID가 바로 돌아옵니다.
- 결과 받기. 작업 ID로 GET /jobs/recordInfo를 폴링하거나 callBackUrl을 넘기면 결과를 그 주소로 보내 드립니다. 작업이 성공하면 출력 링크에서 내려받으세요.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "bytedance/seedream-5.0-pro/layer-decomposition",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"resolution": "1.5k",
"output_format": "jpeg"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"프롬프트와 링크는 직접 쓰는 것으로 바꾸세요. 응답, 폴링, 콜백 참고 자료는 API 탭에 있어요.
Seedream 5.0 Pro API 질문
Seedream 5.0 Pro API 요금은 얼마인가요?
Seedream 5.0 Pro 가격은 가장 저렴한 레이어 분리 기준 7크레딧(US$0.07) /장부터입니다. 옵션별 가격: 1.5K 6.3크레딧/장, 1K 6.3크레딧/장, 2K 12.6크레딧/장, auto 12.6크레딧/장. 크레딧은 웹사이트와 같으며(1크레딧 = $0.01), 새 계정에는 30크레딧이 무료로 제공되고, 실패한 작업은 환불됩니다.
API에서 Seedream 5.0 Pro의 모델 이름은 무엇인가요?
POST /jobs/createTask의 model 필드에 이미지 만들기: bytedance/seedream-5.0-pro/text-to-image; 이미지 편집: bytedance/seedream-5.0-pro/edit; 레이어 분리: bytedance/seedream-5.0-pro/layer-decomposition을(를) 넣으세요.
편집 하나에 레퍼런스를 몇 장까지 넣을 수 있나요?
최대 열 장입니다. 프롬프트에서 각각 역할을 지정하세요. 이름 없는 원본은 뭉뚱그려지기 때문입니다. 첫 장을 넘는 레퍼런스마다 제출 전에 보이는 견적이 올라갑니다.
출력 크기나 화면비를 지정할 수 있나요?
네, 다만 자유로운 픽셀 값이 아니라 화면비와 등급으로 지정합니다. aspect_ratio는 1:3부터 3:1까지 열다섯 가지이고, resolution은 1k와 2k 중에서 고릅니다. text-to-image의 기본값은 1:1이고, 편집의 기본값은 첫 번째 레퍼런스에 가장 가까운 지원 화면비를 고르는 auto입니다. 폭*높이 프리셋으로 지정해야 한다면 Seedream 5.0 Lite를 쓰세요.
결과를 재현할 seed가 있나요?
없습니다. 두 엔드포인트 다 노출하지 않아서 같은 요청 두 개가 다른 프레임 두 장을 돌려줍니다. 다시 쓸 애셋 옆에 프롬프트를 보관해 두세요.
JPEG와 PNG 중 뭘 요청해야 하나요?
프레임이 리터치나 합성으로 이어지고 무손실 경계가 중요하면 png, 검토 반복과 바로 납품이면 jpeg입니다. 바뀌는 건 받는 파일이지 생성된 이미지가 아닙니다.
이미지 안에 글자를 그릴 수 있나요?
짧은 문자열은 가끔 맞지만 이 모델의 용도는 아닙니다. 간판과 제호, 포장 문구에는 화면 속 타이포그래피를 위해 만들어진 모델을 쓰세요.
Seedream 5.0 Pro API의 제한은 무엇인가요?
해상도: auto · 1K · 1.5K · 2K; 프롬프트 길이(글자): 5,000; 최대 업로드 크기: 30 MB. 이 범위를 벗어난 요청은 청구되기 전에 거부됩니다.
코드 없이 Seedream 5.0 Pro을(를) 써 볼 수 있나요?
네. Playground에서는 API 키 없이 PopNow 크레딧으로 Seedream 5.0 Pro을(를) 실행할 수 있고, 실행할 때마다 해당 코드를 보여 줍니다.
모든 Seedream 모델
Seedream 5.0 Lite는 2K 고정 크기로 작동해서 시리즈의 일관성을 유지하기 좋고, Seedream 5.0 Flash는 더 빠르고 저렴한 형제 모델이에요. 가장 디테일한 최종 프레임은 Pro로 만드세요.

