メインコンテンツへスキップ
学習ガイドの章 すべてのドキュメント

Model Training API

合意した目標と準備済みデータ、測定可能な評価に基づき、FusionPointAI トレーニング SDK 内で顧客専用のモデルをファインチューニングします。

まずはこちら:学習の全体像

どの言語版でもコマンドとコードは英語のままです。大文字のプレースホルダーは、ご自身のアカウントと有料ジョブの値に置き換えてください。共有ノートブックやログに実際のキーを貼り付けないでください。

学習の流れ

目標が作業の指針となり、実際の最適化で生徒モデルの重みが変わります。
  1. 目標 タスクと受け入れ基準を定義
  2. 教師モデル 認可された参照素材を準備
  3. 生徒モデル 選択した実行環境で学習
  4. 評価 ベースラインと比較
  5. 提供 独立したモデルまたはアダプターをエクスポート

目標: タスクと受け入れ基準を定義. 教師モデル: 認可された参照素材を準備. 生徒モデル: 選択した実行環境で学習. 評価: ベースラインと比較. 提供: 独立したモデルまたはアダプターをエクスポート

処理が行われる場所

API は調整を行い、顧客の実行環境で重みを学習します。教師モデルの重みは転送されません。
  1. お客様のアプリケーション API キー、目標、承認済みジョブ
  2. FusionPointAI API セッション、参照アクセス、準備済みデータ
  3. 学習実行環境 SDK、生徒モデル、GPU
  4. ローカル出力 モデルパッケージと評価レポート

お客様のアプリケーション: API キー、目標、承認済みジョブ. FusionPointAI API: セッション、参照アクセス、準備済みデータ. 学習実行環境: SDK、生徒モデル、GPU. ローカル出力: モデルパッケージと評価レポート

目標から独立したモデルへ

プロバイダープランと参照モデルを選び、タスクを定義し、生徒モデルと実行環境を設定します。TrainingProject は承認済みの学習素材を教師モデルに要求できます。選択した実行環境で生徒モデルを読み込み、重みを更新します。成果物は教師モデルの重みのコピーではなく、独立したモデルまたはアダプターです。

  • ドイツ語文書の分類など、測定可能な目標から始めます。
  • 教師モデルへのアクセス、生徒モデル、実行環境、評価基準を分けて設定します。
  • TrainingClient は既存の有料ジョブとセッションのワークフローにも引き続き使えます。

3つの要素、それぞれの役割

API キーはサービスへのアクセスを認証するもので、GPU ではありません。API はセッション、準備済みデータ、レポートを調整します。実行環境はメモリ、ストレージ、計算リソースを提供します。SDK はローカルで最適化を行い、出力をパッケージ化します。ホスティングには FusionPointAI、ご自身のデータセンター、または互換性のあるノートブック環境を利用できます。

  • 認証情報をモデルファイルやエクスポートしたパッケージに含めないでください。
  • 教師モデルに送信する目標と学習素材を確認してください。
  • 完了レポートはモデル品質の独立した認証ではありません。

読み進め方を選ぶ

初めて利用する場合は、クイックスタート、概念、モデル、データセット、学習、評価の順に読めます。インテグレーターは API と Python のリファレンスから確認できます。運用担当者は復旧と実行環境のデプロイも読んでください。

  • 計算資源や教師モデルへのリクエストを使う前に計画を確認します。
  • 比較用に未変更のベースラインを保持します。
  • 学習と評価の結果を確認してからエクスポートします。

API リファレンス

エンドポイント目的と動作
POST /api/v1/training/quotes Authorization: Bearer ai:training 利用可能な参照モデル、プラン、設定を検証し、見積もり UUID、通貨、fixed_total、expires_at を返します。任意のクライアント価格ではなく、承認済みプランと条件を満たす生徒モデル設定を使用してください。
GET /api/v1/training/jobs Authorization: Bearer ai:training 認証済み顧客のジョブ一覧を返します。数値 ID を推測せず、返されたコレクションとリソース ID を確認してください。
POST /api/v1/training/jobs Authorization: Bearer ai:training 有効な見積もり UUID からアカウント所有のジョブを作成します。レスポンスにはジョブ ID、ステータス、請求書 ID、タイムスタンプが含まれます。ジョブの作成は支払いの証明ではありません。
GET /api/v1/training/jobs/{job} Authorization: Bearer ai:training ジョブ UUID を指定して、自分が所有する1件のジョブを読み取り、最新の進捗と提供状況を確認します。
GET /api/v1/training/jobs/{job}/artifacts/{file} Authorization: Bearer ai:training この所有ジョブに属する公開済みファイルをダウンロードします。ローカルの SDK ZIP は自動でアップロードされないため、このルートから取得できるとは限りません。
POST /api/v1/training/sessions Authorization: Bearer ai:training 本文:ジョブ UUID、runtime、任意の正の整数 reference_model_id。新規または再利用されたセッションを返します。参照モデルを変更できるのは準備開始前のみです。
GET /api/v1/training/sessions/{session} Authorization: Bearer ai:training 所有するセッションと、その設定、データセット、レポート、状態を読み取ります。状態を読み取っても学習は開始されません。
POST /api/v1/training/sessions/{session}/prepare Authorization: Bearer ai:training 空の JSON オブジェクトを送り、回数を制限した準備バッチを要求します。進展がある間は、リクエスト予算内で準備完了まで繰り返します。
GET /api/v1/training/sessions/{session}/datasets/{split} Authorization: Bearer ai:training train または validation を application/x-ndjson 形式でダウンロードします。そのセッションのマニフェストに照らしてバイト列、SHA-256、行数を検証してください。
POST /api/v1/training/sessions/{session}/events Authorization: Bearer ai:training 実際の状態、step、total_steps、および任意の loss/eval_loss メトリクスを報告します。サポートされている状態とエラーコードのみを使用してください。
POST /api/v1/training/sessions/{session}/complete Authorization: Bearer ai:training artifact_name と実際の学習結果を記載した完全なレポートを送信します。サービスは方式、ベースリビジョン、重みの変更、成果物のダイジェスト、評価基準を検証します。
POST /api/v1/training/sessions/{session}/cancel Authorization: Bearer ai:training 空の JSON オブジェクトを送り、対象となるサービス状態をキャンセルします。必要に応じて GPU プロセスは別途停止してください。一時停止や再開とは異なります。
POST /api/v1/training/projects/authorize Authorization: Bearer ai:training provider と正の整数 reference_model_id を指定して /api/v1/training/projects/authorize に POST します。認証済みアカウントが有料の学習用参照モデルにアクセスできることを再確認し、そのアカウントが所有する job、grant、provider、参照モデル、有効期限を返します。請求書の作成や支払いの変更は行いません。
POST /api/v1/training/projects/teacher Authorization: Bearer ai:training provider、reference_model_id、action(curriculum または lessons)、objective と、任意の topic、count(1~4)、最大8件の approved_examples(各2,000文字以内)を指定して /api/v1/training/projects/teacher に POST します。トピックまたはレッスンのテキスト/トピック行を返します。承認済みの学習素材だけを送り、検証データや最終テストデータは送らないでください。

よくある質問

目標を1つ入力すれば自動ワークフローを始められますか?

設定を開始することはできます。実際のトレーニングは、必要な許可、承認済みデータ、互換性のある生徒モデル、正確な見積もり、支払い、実行条件がすべてそろった後に限り開始されます。

参照モデルの元の重みを受け取れますか?

自動的に移転されることはありません。顧客モデルは別途トレーニングされ、納品物とライセンスは承認済みの見積もりで定められます。

参照モデルとまったく同じ性能になりますか?

無条件の保証はありません。合意した能力目標を、記録されたベンチマークで評価し、実測結果を報告します。

ホスティングの購入は必須ですか?

承認済みの納品物がダウンロード可能な成果物であれば不要です。対応するホスト型デプロイは、一括のトレーニングプロジェクトとは別料金です。

含まれる API アクセスは、その後どうなりますか?

記録されたトレーニング期間の終了時にアクセス権も終了します。その後、別途、提供中の Unlimited API サブスクリプションを選択できます。

1つのプロバイダートレーニングプランで複数の参照モデルを利用できますか?

はい。1つのプランで、有料期間中にそのプロバイダーの利用可能な全参照モデルを利用できます。データセットの準備開始前なら、トレーニングセッションのモデルを選択・変更できます。そのために別のサブスクリプションを購入する必要はありません。アクセスは有効期限に終了し、それ以前に取り消すこともできます。