2026년 Seedream API 키 발급 방법: BytePlus 단계별 안내, 공식 가격, 키 하나로 쓰는 대안

웹 앱에서 잘 돌아가는 Seedream 프롬프트를 이제 내 코드에서 쓰고 싶다면 API 키가 필요합니다. 방법은 두 가지입니다. ByteDance의 자체 클라우드인 BytePlus ModelArk에서 키를 만들고 모델 ID를 골라 이미지당 요금을 내는 방법, 아니면 Seedream을 다른 모델과 함께 키 하나로 제공하는 API 플랫폼을 쓰는 방법입니다. 이 글은 두 방법의 정확한 단계와 2026년 10월 12일 기준 공식 가격, 그리고 둘의 차이를 정리합니다.

한 줄 결론: BytePlus 콘솔에 로그인해 API keys 페이지를 열고 Create API key를 클릭한 다음, 키를 bearer 토큰으로 사용해 https://ark.ap-southeast.bytepluses.com/api/v3/images/generations를 dola-seedream-5-0-pro-260628 같은 모델 ID로 호출하면 됩니다. Seedream 5.0 Pro는 1.5K 이하 이미지당 $0.045, 그 이상은 $0.09이고, Flash는 $0.018, Lite는 $0.035입니다. BytePlus는 기본적으로 콘텐츠 필터를 적용합니다. SpicyAPI 키는 같은 Seedream 모델 버전을 추가 필터 없이 실행하며, 5.0 Pro는 1K 이미지당 $0.036이고, 같은 키로 영상과 다른 이미지 모델도 호출할 수 있습니다.

• 모델 하나, 공식 계정: BytePlus ModelArk. Seedream 5.0 Flash를 가장 싸게 쓰는 경로입니다.
• 여러 모델, 성인 지향 작업, 더 낮은 Pro 가격: SpicyAPI 같은 API 플랫폼 키.
• "무료 Seedream API 키" 페이지: 공식 가격표에 무료 출력 할당량은 없습니다. 온라인에 공유된 키는 다른 사람의 할당량입니다.

방법 1: BytePlus ModelArk에서 Seedream API 키 발급받기

BytePlus는 ByteDance의 해외 클라우드이고, ModelArk는 그 모델 서비스입니다. Seedream은 여기에서 Seedance 영상 모델, Seed 언어 모델과 함께 제공되는 이미지 모델 중 하나입니다. 계정 하나와 키 하나로 모두 쓸 수 있습니다.

1. BytePlus 계정을 만들고 콘솔에 로그인합니다. 쓰기 전에 결제 수단을 등록해 두세요. 공식 가격 페이지에 따르면 미납 상태가 2시간 동안 이어진 계정은 충전될 때까지 모델 서비스가 중지됩니다.
2. API keys 페이지를 엽니다. 조직에서 프로젝트 스페이스를 쓴다면 먼저 왼쪽 아래에서 알맞은 스페이스로 전환하세요. 키는 자기 프로젝트의 모델에만 접근할 수 있기 때문입니다.
3. Create API key를 클릭하고 이름을 확인한 뒤 Create를 누릅니다. 키는 API keys 목록에 나타납니다. 2026년 9월 17일 이후 만든 키는 새로운 평문 형식을 쓰며, 이전 키도 계속 작동합니다.
4. 키는 코드에 넣지 말고 환경 변수에 저장합니다(공식 문서는 ARK_API_KEY를 사용합니다).

공식 키 발급 절차는 여기까지입니다. 콘솔에는 Model activation 페이지도 있어 속도 제한을 볼 수 있습니다. 서드파티 가이드 여러 곳이 첫 이미지 호출 전에 활성화 단계를 추가하므로, 접근 권한 문제로 호출이 거부되면 이 페이지를 가장 먼저 확인하세요.

이제 모델 ID로 이미지 엔드포인트를 호출합니다.

curl https://ark.ap-southeast.bytepluses.com/api/v3/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ARK_API_KEY" \
  -d '{
    "model": "dola-seedream-5-0-pro-260628",
    "prompt": "An adult woman in her early thirties in a cream silk blouse reads a paperback by a rain-streaked café window at dusk, warm lamp light on her face, city lights blurred outside, a cup of coffee on the marble table, calm and absorbed expression, cinematic photograph, 50mm lens, shallow depth of field, natural skin texture",
    "size": "2K",
    "output_format": "png",
    "watermark": false
  }'

이 호출은 동기 방식입니다. 응답에는 data 배열이 있고, 각 항목의 url이 이미지 한 장의 다운로드 링크입니다. 이 링크는 24시간만 유지되므로 바로 내려받거나 자체 스토리지에 복사하세요. 응답에서 이미지 바이트를 바로 받고 싶다면 response_format을 b64_json으로 설정합니다. watermark의 기본값은 true여서 눈에 보이는 워터마크가 들어가므로, 원하지 않으면 false로 설정하세요.

이 위에 서비스를 만들기 전에 알아둘 점이 세 가지 더 있습니다.

• 키마다 제한을 거세요. 키는 특정 모델 ID와 특정 IP 주소로 제한할 수 있습니다. 계정 하나에 키를 최대 50개까지 둘 수 있으니, 앱마다 제한된 키를 따로 두면 유출에 대비하는 저렴한 보험이 됩니다.
• 속도 제한에 유의하세요. Seedream 5.0 Pro와 Flash는 계정당 모델 버전별로 분당 500장까지 허용하며, 초과하면 호출이 오류를 반환합니다.
• 콘텐츠 검열이 기본으로 켜져 있습니다. ModelArk의 콘텐츠 사전 필터는 성적·잔혹 콘텐츠를 다루며 새 엔드포인트에서 활성화되어 있습니다. 엔드포인트별로 끌 수는 있지만 BytePlus 콘텐츠 정책의 기본선은 계속 적용됩니다. 차단된 이미지는 과금되지 않습니다.

BytePlus의 Seedream 모델 ID

BytePlus는 현재 5.0 Pro와 Flash를 "Dola Seedream"이라고 부릅니다. 같은 모델 계열입니다. 새 스냅샷이 나오면 날짜 접미사가 바뀌므로, ID를 추측하지 말고 모델 목록에서 복사하세요.

Seedream API 공식 가격

ModelArk 가격 페이지 기준, 2026년 10월 12일 확인:

가격표에 무료 출력 할당량은 없습니다. 2K Seedream 5.0 Pro 이미지 1,000장은 $90, Flash 이미지 1,000장은 $18입니다.

방법 2: SpicyAPI 키 하나로 Seedream 쓰기

API 플랫폼은 여러 모델을 키 하나로 제공하고, 뒤에 있는 공급사 계정은 대신 관리해 줍니다. SpicyAPI에서의 단계는 다음과 같습니다.

1. 가입하고 콘솔에서 API keys를 엽니다.
2. 키를 만듭니다. 일별, 월별, 전체 기간 한도를 설정할 수 있고, 호출 가능한 모델도 제한할 수 있습니다.
3. 카드, Apple Pay, Google Pay 또는 암호화폐로 잔액을 충전합니다. 미국 달러 잔액이며 구독이 없고, 충전한 잔액은 만료되지 않습니다.
4. 모델 이름으로 태스크 엔드포인트를 호출합니다.

curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  --data '{
    "model": "bytedance/seedream-5.0-pro/text-to-image",
    "input": {
      "prompt": "An adult woman in her early thirties in a cream silk blouse reads a paperback by a rain-streaked café window at dusk, warm lamp light on her face, city lights blurred outside, a cup of coffee on the marble table, calm and absorbed expression, cinematic photograph, 50mm lens, shallow depth of field, natural skin texture",
      "resolution": "2k",
      "aspect_ratio": "16:9"
    }
  }'

이 호출은 비동기 방식으로, 태스크 ID를 즉시 반환합니다. 태스크가 끝날 때까지 GET https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=<id>를 폴링하거나, 생성할 때 콜백 URL을 넘기세요. 완성된 이미지는 SpicyAPI 자체 스토리지에 서명된 링크로 최대 14일간 보관되므로 24시간 만료에 쫓기지 않아도 됩니다. 필드는 API 레퍼런스에, 참조 이미지를 쓰는 편집과 레이어 분해를 포함한 전체 입력 스키마는 Seedream 5.0 Pro 페이지에 있습니다.

2026년 10월 12일 기준 이미지당 가격:

Pro는 두 크기 모두 공식 가격보다 20% 저렴합니다. 단, SpicyAPI는 1K와 2K를 제공하고 1.5K는 없습니다. Lite와 4.0은 거의 같은 가격입니다. Flash는 BytePlus보다 SpicyAPI가 더 비쌉니다. Flash만 필요하고 콘텐츠가 BytePlus 정책에 맞는다면 공식 키가 더 저렴한 선택입니다.

더 큰 차이는 결과물입니다. SpicyAPI는 Seedream에 콘텐츠 필터를 추가하지 않습니다. 9월 테스트에서 Seedream 5.0 Pro는 성인 지향 텍스트-투-이미지와 편집 34건 중 33건을 생성했고, Lite는 34건 전부를 생성했으며, Flash는 수위가 센 요청 몇 건을 순화했습니다. 전체 결과는 Seedream은 무검열일까?에 있습니다. 무엇을 그릴지는 어디까지나 모델이 정하며, 등장인물이 성인이어야 한다는 점과 편집하는 사진의 권리는 사용자의 책임입니다.

어떤 키를 받아야 할까?

둘을 함께 써도 됩니다. 일반 작업은 가장 저렴한 BytePlus로, 나머지는 플랫폼 키로 처리하는 방식입니다.

"무료 Seedream API 키"는?

"Seedream API key free"와 "Seedream API key generator"는 흔한 검색어입니다. 공식 무료 키는 없습니다. BytePlus는 출력 이미지마다 요금을 받고, 입력 이미지는 무료입니다. GitHub이나 포럼에 올라온 키는 다른 사람의 계정 소유입니다. 주인이 알아차리면 작동을 멈추고, 그 키 위에 만든 것은 함께 무너집니다. 무료 키를 약속하는 생성기 사이트는 접근 권한을 재판매하거나 자기 것이 아닌 키를 나눠주는 곳입니다.

가장 정직하고 저렴한 테스트 방법은 소수의 이미지를 보내보는 것입니다. 1K Seedream 5.0 Pro 이미지 10장은 어느 경로든 50센트도 들지 않습니다. SpicyAPI에서는 실패한 태스크는 보통 과금되지 않고(예외인 모델은 각 모델 페이지에 표시됩니다), 실행 전에 비용이 표시됩니다.

새 키 문제 해결

• 401 또는 "invalid API key": 헤더가 Authorization: Bearer <key> 형식인지, 환경 변수에 끝 공백이나 줄바꿈이 없는지 확인하세요.
• BytePlus의 접근 오류 또는 "model not found": 모델 ID 오타, 키가 다른 모델로 제한되어 있음, 키가 다른 프로젝트 스페이스에 속해 있음 중 하나입니다. 어느 쪽도 아니라면 Model activation 페이지를 확인하세요.
• BytePlus의 콘텐츠 오류: 사전 필터가 프롬프트나 출력을 차단했습니다. 이 경우 과금되지 않습니다. 경계에 있는 일반 콘텐츠라면 표현을 바꿔보면 도움이 될 수 있습니다. 성인 지향 작업이라면 먼저 BytePlus 이용 정책을 읽으세요. 필터를 꺼도 기본 콘텐츠 규칙은 계정 전체에 적용됩니다.
• 다음 날 링크가 작동하지 않음: BytePlus 이미지 URL은 24시간 후 만료됩니다. 응답이 오는 즉시 파일을 저장하세요.
• 며칠 잘 되다가 호출이 멈춤: 계정 잔액을 확인하세요. 2시간 동안 미납 상태인 계정은 충전될 때까지 중지됩니다.

자주 묻는 질문

Seedream API 키는 어디서 찾나요?

BytePlus 콘솔의 API keys 페이지에서 찾습니다. SpicyAPI에서는 Console → API keys입니다. 두 곳 모두 키 목록에서 만든 키를 볼 수 있습니다.

Seedream API는 무료인가요?

아닙니다. BytePlus에서는 출력 이미지마다 과금되며, 5.0 Flash의 $0.018부터 1.5K 초과 5.0 Pro의 $0.09까지입니다. 입력 이미지는 무료이지만, Seedream 5.0 Pro는 첫 장 이후의 입력 이미지마다 $0.003을 청구합니다.

Seedream 5.0의 모델 ID는 무엇인가요?

BytePlus에서는 Pro가 dola-seedream-5-0-pro-260628, Flash가 dola-seedream-5-0-flash-260915, Lite가 seedream-5-0-lite-260128입니다. SpicyAPI에서는 bytedance/seedream-5.0-pro/text-to-image이고, Flash, Lite, 편집도 이에 맞춘 이름을 씁니다.

Seedream API로 NSFW 이미지를 만들 수 있나요?

BytePlus 기본 설정으로는 어렵습니다. 콘텐츠 사전 필터가 성적 콘텐츠를 차단하고, 필터를 꺼도 BytePlus 콘텐츠 정책이 적용됩니다. SpicyAPI에는 추가 필터가 없으며, Seedream 5.0 Pro와 Lite는 우리 성인 지향 테스트 거의 전부를 생성했습니다.

Seedream 4.5와 5.0 중 무엇이 좋나요?

BytePlus에서는 5.0 Lite($0.035)가 4.5($0.04)보다 저렴하고, 5.0 Flash($0.018)는 둘보다도 저렴합니다. 이미지 품질이 가장 중요할 때 돈을 더 낼 만한 것은 Pro입니다. Lite vs Pro vs Flash 비교에서 나란히 놓은 결과를 볼 수 있습니다.

정리

BytePlus에서 Seedream API 키를 받는 데는 몇 분이면 충분합니다. 키를 만들고, 올바른 모델 ID를 쓰고, 이미지는 24시간 안에 저장하고, 잔액을 확인하면 됩니다. Seedream 5.0 Flash를 가장 싸게 쓰는 경로이고, ByteDance와 직접 계정을 둔 일반 작업에 맞는 선택입니다. Seedream을 다른 이미지·영상 모델과 키 하나로 쓰고 싶거나, 더 낮은 Pro 가격, 최대 2주간 유지되는 결과물, 공급사 필터 없는 성인 지향 이미지가 필요하다면 SpicyAPI 키가 이를 해결합니다.

SpicyAPI 키를 만들고 Seedream 5.0 Pro 써보기 →