バージョニング
Direct API のバージョン 1 の中で変わりうること、クライアントが許容すべきこと、モデルの追加と廃止の扱いについて説明します。
バージョンはパスに含まれます: /v1。v1 の中での変更は追加のみです。新しいツール、新しい任意の入力フィールド、新しいレスポンスフィールド、新しいステータス、新しいイベントタイプ、新しいエラーコードが追加されることがあります。
クライアントで対応すべきこと
- 未知のレスポンスフィールドは無視してください。
- 未知の生成ステータスは最終状態ではないものとして扱い、追跡を続けてください。
- 入力スキーマは厳格なままです。未知の入力フィールドは拒否されるため、入力ミスが気付かれないまま無視されることはありません。
互換性のない変更
互換性のない変更は /v2 として提供し、少なくとも 6 か月の並行期間を設け、有効なキーを持つすべての組織に通知します。
モデル
- モデルは随時追加・廃止されます。モデル には常に現在のモデルが掲載されています。
- モデル ID が再利用されたり、受け付けられなくなったりすることはありません。廃止された ID は後継モデルを実行し、レスポンスには実際に実行されたモデルが示されます。
- Morphic がモデル ID の背後にあるエンジンを変更するのは、同じ価格またはより低い価格で改善する場合に限られ、その際はモデルカタログでお知らせします。
何かお困りのことやご質問がありましたら、お気軽にご連絡ください。喜んでお手伝いします。こちらまでご連絡ください support@morphic.com.