> ## 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.

# 非推奨情報

> 非推奨または廃止予定の Krea API モデルおよびエンドポイントを追跡し、それぞれの代替推奨と移行ガイダンスを確認できます。

## 概要

Krea API のモデルが非推奨になる際、統合機能が自動的に対応できるよう、以下の 3 つのチャネルを通じてお知らせします。

* **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` フィールドを確認してください。
