Skip to main content

概要

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 を返します:
{
	"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.1video/runway/gen-4.5video/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_models および get_model_schema が返す各モデルの deprecation フィールドを確認してください。