Seedream 5.0 Flash
Seedream 5.0 Flash image generation and editing. One image per request, up to 10 reference images, 1K/1.5K/2K or exact pixels, transparent-background editing and layer decomposition. One flat price for every size; final billing follows the actual generation charge.
가격
$0.015086/ 호출
엔드포인트
/images/tasks
결과 전달 방식
비동기 작업 수명 주기
가용성
지금 사용 가능
API 문서
요청 구성 및 복사
이 모델이 받는 옵션을 고르세요. 아래 코드는 선택에 따라 바로 바뀝니다.
https://www.aisplice.store/v1/images/tasksBearer API key비동기 작업옵션이 모델에 공개된 옵션만 표시됩니다.
# Requires curl and jq
API_KEY="${API_KEY:-YOUR_API_KEY}"
# 1. Submit once
SUBMITTED=$(curl --fail-with-body -sS https://www.aisplice.store/v1/images/tasks \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: model-docs-$(date +%s)-$$" \\
-d '{
"model": "Seedream 5.0 Flash",
"prompt": "A cinematic scene with careful composition",
"size": "auto",
"resolution": "1K",
"n": 1,
"output_format": "jpeg",
"watermark": false,
"optimize_prompt_options": {
"mode": "standard"
}
}')
TASK_ID=$(printf '%s' "$SUBMITTED" | jq -r '.task_id // .id // empty')
if [ -z "$TASK_ID" ]; then
printf '%s\n' "$SUBMITTED" >&2
exit 1
fi
echo "task_id=$TASK_ID"
# 2. Poll until terminal
while true; do
STATUS_JSON=$(curl --fail-with-body -sS \
"https://www.aisplice.store/v1/images/tasks/$TASK_ID" \
-H "Authorization: Bearer $API_KEY")
STATUS=$(printf '%s' "$STATUS_JSON" | jq -r '.status // empty' | tr '[:upper:]' '[:lower:]')
echo "status=$STATUS"
case "$STATUS" in
completed|succeeded|success) break ;;
failed|failure|cancelled|canceled)
printf '%s\n' "$STATUS_JSON" | jq .
exit 1
;;
esac
sleep 3
done
# 3. Fetch the final result
curl --fail-with-body -sS \
"https://www.aisplice.store/v1/images/tasks/$TASK_ID/content" \
-H "Authorization: Bearer $API_KEY" | jq .- 1작업 제출
- 2상태 폴링
- 3결과 가져오기
프로덕션에서는 공개 미디어 URL을 권장합니다. 먼저 로컬 파일을 업로드한 뒤 모델 요청에 public_url을 넣으세요. 큰 Base64 본문은 피하세요.
업로드 가이드 읽기파라미터 레퍼런스
model이 요청에 사용할 정확한 모델 식별자.
seedream-5-0-flashpromptGeneration/editing instruction. Optional only when layer_decomposition is true. Point and box tags use normalized 0..1000 coordinates.
imagesOptional reference image URLs or data URIs, up to 10. Layer decomposition and transparent editing require exactly one image.
sizeauto, 1K, 1.5K, 2K, a supported aspect ratio (1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 2:1, 1:2, 21:9), or an exact WIDTHxHEIGHT value. Exact pixels must total 921600..4624220. Every size has the same price.
resolution요청할 출력 해상도.
1K1.5K2Kn1응답 흐름
작업 상태, 최종 상태, 결과 응답 예시.
응답 흐름
작업 상태, 최종 상태, 결과 응답 예시.
{
"id": "task_xxx",
"task_id": "task_xxx",
"object": "image.task",
"model": "Seedream 5.0 Flash",
"status": "queued"
}{
"created": 1720000000,
"data": [
{
"url": "https://media.example/result.png"
}
]
}대기 중
queued · submitted · in_progress · processing
성공
completed · succeeded · success
실패
failed · failure · cancelled · canceled
오류 및 프로덕션
재시도 규칙, 멱등성, 최소 프로덕션 체크리스트.
오류 및 프로덕션
재시도 규칙, 멱등성, 최소 프로덕션 체크리스트.
400 / 422요청 필드나 지원되지 않는 옵션을 수정하세요. 그대로 재시도하지 마세요.
401API 키가 있고 활성 상태이며 Bearer 토큰으로 전송되는지 확인하세요.
402계정 잔액이 부족합니다.
409Idempotency-Key가 처리 중이거나 다른 본문에 재사용되었습니다.
429재시도하기 전에 Retry-After에 따라 백오프하세요.
5xx지수 백오프로 재시도하고 원래 Idempotency-Key를 유지하세요.
- 공개 모바일·브라우저 애플리케이션이라면 API 키를 서버에 두세요.
- 과금되는 모든 비동기 요청에 고유한 Idempotency-Key를 설정하세요.
- 재시작 후에도 폴링을 이어 갈 수 있도록 task_id를 저장하세요.
- 모든 HTTP 요청에 타임아웃을 두고, 지원 요청 시 요청 ID를 함께 제공하세요.
- 가격과 지원 옵션을 하드코딩하지 말고 실시간 모델 메타데이터를 읽으세요.
가격 및 요금 구간
공식가 대비 12% 절약요청당 가격
$0.015086/ 호출
$0.017143
구간별 요금
기본 가격 $0.015086
구간별 요금 — 최종 가격은 요청한 옵션에 따라 달라집니다. 나열되지 않은 구간은 기본 가격으로 과금됩니다.
- 1.5k×1$0.015086
- 16:9×1$0.015086
- 1:1×1$0.015086
- 1:2×1$0.015086
- 1k×1$0.015086
- 21:9×1$0.015086
- 2:1×1$0.015086
- 2:3×1$0.015086
- 2k×1$0.015086
- 3:2×1$0.015086
- 3:4×1$0.015086
- 4:3×1$0.015086
- 9:16×1$0.015086
- auto×1$0.015086
- 1.5k×1$0.015086
- 1k×1$0.015086
- 2k×1$0.015086
여기 표시된 가격이 실제 과금 금액입니다 — 실패한 호출은 자동으로 환불됩니다.
관련 모델