> ## Documentation Index
> Fetch the complete documentation index at: https://www.krea.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Deprecations

> 지원 중단되었거나 종료 예정인 Krea API 모델과 엔드포인트를 각 항목별 대체 권장 사항 및 마이그레이션 안내와 함께 추적하세요.

## 개요

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`과 함께 다음과 같은 구조화된 본문을 반환합니다:

```json theme={null}
{
	"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` 필드는 안정적이며 분기 처리에 안전하게 사용할 수 있습니다. `replacement`와 `migration_url` 필드는 권장 대체 모델이 존재할 때 포함됩니다.

<Note>
  종료는 날짜가 도래하는 시점에 서버 측에서 강제로 적용됩니다. 코드는 모델 엔드포인트에서 반환되는 모든 `410`을
  최종적인 상태로 처리해야 하며 — 재시도는 도움이 되지 않습니다.
</Note>

## 현재 종료된 모델

### seedream3

**2026-05-13에 종료됨.** 이 모델은 ByteDance에 의해 지원 중단되었습니다.

**마이그레이션**: 요청 경로를 `image/bytedance/seedream-3`에서 \*\*`image/bytedance/seedream-5-lite`\*\*로 변경하세요.

```diff theme={null}
- POST /generate/image/bytedance/seedream-3
+ POST /generate/image/bytedance/seedream-5-lite
```

MCP를 통해 API를 호출하는 경우 `model` 인자를 업데이트하세요:

```diff theme={null}
- { "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`\*\*로 변경하세요. 그 외의 요청 및 응답 형식은 호환됩니다.

```diff theme={null}
- POST /generate/video/bytedance/seedance-1.0-lite
+ POST /generate/video/bytedance/seedance-1.0-pro-fast
```

MCP를 통해 API를 호출하는 경우 `model` 인자를 업데이트하세요:

```diff theme={null}
- { "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](/developers/examples/text-to-video) 카탈로그에서 다른 텍스트-투-비디오 모델을 검토해 보세요 — `video/google/veo-3.1`, `video/runway/gen-4.5`, `video/bytedance/seedance-1.0-pro`가 고품질 짧은 클립에 가장 근접한 옵션입니다.

```diff theme={null}
- POST /generate/video/openai/sora-2
+ POST /generate/video/<chosen-replacement>
```

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

`410`에 반응하기보다 종료 이전에 지원 중단을 미리 감지하고 싶다면, 응답에서 `Deprecation: true` 헤더를 감시하여 로그나 알림으로 표시하세요. 최소한의 예시는 다음과 같습니다:

```javascript theme={null}
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_models`와 `get_model_schema`가 반환하는 각 모델의 `deprecation` 필드를 확인하세요.