API の規約

​

Projects

• API パスは /projects/{alias} で始まります。alias は UI に表示されるプロキシモデル名です。
• 一部のリクエストおよび応答のフィールドでは、以前の名称である task が引き続き使われています。該当するのは task_alias、task_id、task_version で、task_version は project のバージョンを表します。データセットのクエリでは task_version でフィルターし、プロキシのトラフィックから構築されたデータセットでは source が "task" に設定されます。
• 以前の /tasks/... パスは非推奨です。2026 年 10 月 26 日 00:00 UTC までは引き続き使用でき、その応答には置き換え先のパスを示す Deprecation、Sunset、Link ヘッダーが含まれます。この日時以降は HTTP 410 が返され、エラータイプ endpoint_moved と、置き換え先のパスを示すメッセージが含まれます。

{provider-name}/{provider-model-id}

• プロバイダーとルーティングのデプロイ状態が、現在のリビジョンで applied になる必要があります。
• データセットは ready または failed になります。
• 再ラベル付けの実行は completed、failed、または stale になります。
• ファインチューンは deployed または failed になります。
• 評価は進行中のケース数を公開し、失敗したケースを含んだまま完了する場合があります。
• データセットとファインチューンを削除すると、削除操作とともに 202 Accepted が返されます。進行状況を確認するには、DELETE リクエストを再度送信するか、deletion-plan エンドポイントを参照してください。

​

エラー

{
  "error": {
    "message": "Project 'missing' not found in entity 'your-team'",
    "type": "not_found"
  }
}

GET .../entries?page=1&limit=50

• PUT /providers/{name} はプロバイダーを作成またはローテーションします。
• PUT /projects/{alias} はprojectを作成します。projectがすでに存在する場合は競合を返します。
• ルーティングの PUT は、そのバージョンのすべてのターゲットを置換します。
• データセット、ファインチューン、評価の POST リクエストは新しいリソースを作成するため、コンピュートを消費する場合があります。
• データセットとファインチューンの DELETE リクエストは、1 回のリクエストで永続的な削除をキューに登録します。同じリクエストを繰り返した場合は、既存の操作が返されるか、失敗したクリーンアップが再試行されます。リソースがすでに削除済みの場合は 204 No Content が返されます。