Skip to main content

Deployments

Deployment とは、学習済みアダプタ(または素のベースモデル)を専用サブドメイン https://<slug>.arkor.app/v1/chat/completions に公開する仕組みです。OpenAI Chat Completions のワイヤーフォーマットで応答するので、OpenAI 互換クライアント(公式 openai SDK、LangChain など)の baseURL を向けるだけで使えます。 CloudApiClient はこれらの deployment をプログラムで管理(作成、API キーのローテーション、削除)する型付きエントリポイントです。Studio ダッシュボード(Endpoints)が共通操作を対話的にカバーしますが、SDK はその下に位置する低レベル面で、次のような場面で使います:
  • CI / IaC: 他のインフラと一緒に deployment をプロビジョニング。学習済み job の final アダプタが、1 ステップのスクリプトで「保存済みチェックポイント」から「ライブ URL」に。
  • 独自ダッシュボード: 自前の管理 UI に deployment 管理を組み込む。
  • 一括操作: インシデント後に多数の deployment のキーをまとめて revoke + 再発行する。
  • SDK 限定の操作: 既存 deployment の target 差し替え、デフォルト以外の run retention 設定など。Studio は今のところ公開していません。
defaultArkorCloudApiUrl(credentials) は credentials が認証された control plane に追従させます。匿名認証情報は signup 時、OAuth 認証情報は arkor login 時に URL を保存しています。API キーの平文も作成時にのみ返り、以降の listDeploymentKeys() ではラベルと表示用 prefix だけが返ります。

リファレンス

完全なメソッド一覧、リクエスト / レスポンスの形、target 判別共用体、run retention 設定、エラーコード、公開 / 内部のエクスポート契約は CloudApiClient リファレンス を参照してください。