Skip to main content

개요

Krea API의 모델이 지원 중단되면, 통합이 자동으로 대응할 수 있도록 세 가지 채널을 통해 이를 알립니다:
  • 지원 중단된 엔드포인트의 모든 성공 응답에 포함되는 HTTP 헤더:
    • Deprecation: true
    • Sunset: Mon, 27 Apr 2026 00:00:00 GMT — 엔드포인트가 요청 수락을 중단하는 시점 (RFC 1123 날짜)
    • Link: <https://docs.krea.ai/developers/deprecations#seedance-1-0-lite>; rel="deprecation"; type="text/html" — 이 페이지의 해당 항목을 가리킵니다
  • OpenAPI: 해당 오퍼레이션은 deprecated: true로 표시되며 설명은 경고 블록으로 시작합니다.
  • MCP list_models: 지원 중단된 모델에는 스키마와 함께 deprecation 객체가 포함됩니다.
종료 날짜가 지나면 엔드포인트는 410 Gone과 함께 다음과 같은 구조화된 본문을 반환합니다:
{
	"error": "model_unavailable",
	"reason": "deprecated",
	"message": "The model 'video/bytedance/seedance-1.0-lite' was deprecated on 2026-04-27. Provider has discontinued this model. Use 'video/bytedance/seedance-1.0-pro-fast' instead.",
	"sunset_date": "2026-04-27",
	"replacement": "video/bytedance/seedance-1.0-pro-fast",
	"migration_url": "https://docs.krea.ai/developers/deprecations#seedance-1-0-lite"
}
error 필드는 안정적이며 분기 처리에 안전하게 사용할 수 있습니다. replacementmigration_url 필드는 권장 대체 모델이 존재할 때 포함됩니다.
종료는 날짜가 도래하는 시점에 서버 측에서 강제로 적용됩니다. 코드는 모델 엔드포인트에서 반환되는 모든 410을 최종적인 상태로 처리해야 하며 — 재시도는 도움이 되지 않습니다.

현재 종료된 모델

seedream3

2026-05-13에 종료됨. 이 모델은 ByteDance에 의해 지원 중단되었습니다. 마이그레이션: 요청 경로를 image/bytedance/seedream-3에서 **image/bytedance/seedream-5-lite**로 변경하세요.
- POST /generate/image/bytedance/seedream-3
+ POST /generate/image/bytedance/seedream-5-lite
MCP를 통해 API를 호출하는 경우 model 인자를 업데이트하세요:
- { "model": "image/bytedance/seedream-3", "input": { ... } }
+ { "model": "image/bytedance/seedream-5-lite", "input": { ... } }

seedance-1-0-lite

2026-04-27에 종료됨. 공급자가 이 모델을 중단했습니다. 마이그레이션: 요청 경로를 video/bytedance/seedance-1.0-lite에서 **video/bytedance/seedance-1.0-pro-fast**로 변경하세요. 그 외의 요청 및 응답 형식은 호환됩니다.
- POST /generate/video/bytedance/seedance-1.0-lite
+ POST /generate/video/bytedance/seedance-1.0-pro-fast
MCP를 통해 API를 호출하는 경우 model 인자를 업데이트하세요:
- { "model": "video/bytedance/seedance-1.0-lite", "input": { ... } }
+ { "model": "video/bytedance/seedance-1.0-pro-fast", "input": { ... } }

sora-2

2026-04-27에 종료됨. 공급자가 이 모델을 중단했습니다. 현재로서는 즉시 대체 가능한 모델이 없습니다. video/openai/sora-2를 사용하고 있었다면, Video 카탈로그에서 다른 텍스트-투-비디오 모델을 검토해 보세요 — video/google/veo-3.1, video/runway/gen-4.5, video/bytedance/seedance-1.0-pro가 고품질 짧은 클립에 가장 근접한 옵션입니다.
- POST /generate/video/openai/sora-2
+ POST /generate/video/<chosen-replacement>

코드에서 지원 중단을 감지하는 방법

410에 반응하기보다 종료 이전에 지원 중단을 미리 감지하고 싶다면, 응답에서 Deprecation: true 헤더를 감시하여 로그나 알림으로 표시하세요. 최소한의 예시는 다음과 같습니다:
const response = await fetch(url, options);
if (response.headers.get('deprecation') === 'true') {
	const sunset = response.headers.get('sunset');
	const link = response.headers.get('link');
	console.warn(`Endpoint deprecated. Sunset: ${sunset}. Migration: ${link}`);
}
MCP 클라이언트의 경우, list_modelsget_model_schema가 반환하는 각 모델의 deprecation 필드를 확인하세요.