요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
aspect_ratio | 아니요 | 화면 모양: 가로, 정사각형, 세로. auto · 1:1 · 4:3 · 3:4 · 16:9 · 9:16 · 3:2 · 2:3 · 4:5 · 5:4 · 21:9 · 9:21 · 2:1 · 1:2 · 3:1 · 1:3 · 기본값: auto |
background | 아니요 | 배경을 유지, 제거 또는 교체. opaque · transparent · 기본값: opaque |
image_urls | 예 | 편집하거나 합칠 사진. 각 사진의 역할을 프롬프트에 적어 주세요. |
output_format | 아니요 | 결과 파일 형식. jpeg · png · 기본값: jpeg |
prompt | 예 | Describe the image to produce from the references, and what each reference contributes. |
resolution | 아니요 | 출력 크기. 클수록 선명하고 가격도 올라갑니다. 1k · 1.5k · 2k · 기본값: 2k |
가격
가격은 웹사이트에서 쓰는 것과 같은 크레딧으로 표시됩니다(1크레딧 = $0.01). 작업이 접수될 때 먼저 보류되고, 끝나면 실제 요금으로 정산되며, 실패한 작업은 환불됩니다.
| 옵션 | 크레딧 /장 | ≈ USD |
|---|---|---|
| 기본 | 4.35 | US$0.044 |
작업마다 크레딧은 정수로 올림 처리되므로, 가장 낮은 옵션으로 한 번 실행하면 5크레딧/장(US$0.05)입니다.
실행 전에 정확한 금액을 알고 싶다면 같은 본문을 POST /jobs/quote로 보내세요.
API 빠른 시작
Seedream 5.0 Flash API를 3단계로 호출하기
- API 키 만들기. PopNow에 로그인해 API 콘솔에서 키를 만드세요. 키는 sk-popnow-(으)로 시작하며 웹사이트와 같은 크레딧을 씁니다.
- 요청 보내기. POST /jobs/createTask에 model은 bytedance/seedream-5.0-flash/edit, 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-flash/edit",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"image_urls": [
"https://media.popnow.ai/influencer/examples/marco.webp"
],
"aspect_ratio": "auto",
"resolution": "2k",
"output_format": "jpeg",
"background": "opaque"
}
}'
# 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 Flash API 질문
Seedream 5.0 Flash API 요금은 얼마인가요?
Seedream 5.0 Flash 가격은 가장 저렴한 이미지 편집 기준 5크레딧(US$0.05) /장부터입니다. 크레딧은 웹사이트와 같으며(1크레딧 = $0.01), 새 계정에는 30크레딧이 무료로 제공되고, 실패한 작업은 환불됩니다.
API에서 Seedream 5.0 Flash의 모델 이름은 무엇인가요?
POST /jobs/createTask의 model 필드에 이미지 만들기: bytedance/seedream-5.0-flash/text-to-image; 이미지 편집: bytedance/seedream-5.0-flash/edit; 레이어 분리: bytedance/seedream-5.0-flash/layer-decomposition을(를) 넣으세요.
레이어 분해가 무엇인가요?
완성된 이미지를 한 장 보내면, 분리된 요소를 제거하고 배경을 채워 넣은 베이스 이미지와 사람, 헤드라인, 제품, 소품 같은 요소별 투명 PNG 최대 16장을 돌려줍니다. 이후 각 조각을 옮기거나, 크기를 바꾸거나, 교체하거나, 색을 바꾸거나, 빼 버릴 수 있습니다.
레퍼런스 이미지를 여러 장 쓸 수 있나요?
네, 이미지 편집 엔드포인트에서 최대 10장까지 가능합니다. 프롬프트가 첫 번째, 두 번째, 세 번째로 부르기 때문에 순서가 중요합니다. 각각에 역할을 주세요. 예를 들면 얼굴은 이미지 1, 가운은 이미지 2, 장소는 이미지 3처럼요.
결과를 재현할 수 있는 시드가 있나요?
없습니다. Flash는 어느 엔드포인트에도 시드를 제공하지 않으므로 같은 요청도 매번 다른 결과가 나옵니다. 프롬프트와 돌려받은 애셋을 함께 보관하세요.
Seedream 5.0 Flash API의 제한은 무엇인가요?
해상도: 1K · 1.5K · 2K; 화면 비율: auto · 1:1 · 4:3 · 3:4 · 16:9 · 9:16 +10; 참조 이미지: 10; 프롬프트 길이(글자): 5,000; 최대 업로드 크기: 30 MB. 이 범위를 벗어난 요청은 청구되기 전에 거부됩니다.
코드 없이 Seedream 5.0 Flash을(를) 써 볼 수 있나요?
네. Playground에서는 API 키 없이 PopNow 크레딧으로 Seedream 5.0 Flash을(를) 실행할 수 있고, 실행할 때마다 해당 코드를 보여 줍니다.
모든 Seedream 모델
Seedream 5.0 Pro는 질감 디테일에 더 공을 들이는 최종 프레임용이고 2K에서는 더 비싸요. 아이디어를 빠르게 훑어볼 때는 더 빠르고 저렴한 Flash가 좋아요.

