NAKATAKU ENGINE API

NAKATAKU ENGINE API は、動画・画像・音声を ContentSpace に保存し、再構築可能な Index Projection を経て検索・解釈へつなぐための REST API です。

このドキュメントの現在地

初版では ContentSpace、Asset upload、indexing、非同期 Run、Direct Search の schema preview を Public Beta 1 の候補として公開します。 掲載中の operation はすべて schema-only で、現在は一般提供されていません。API key の発行や 実環境での呼び出しは、availability が更新されるまでお待ちください。

最初に読むページ

1. Quickstart で利用の流れを確認します。
2. 認証と環境 で API key と endpoint の境界を確認します。
3. 基本概念 で ContentSpace、AssetVersion、Projection、Run を理解します。
4. Direct Search で検索可能になる条件とresponseを確認します。
5. API Reference で proto から生成された schema を確認します。

設計の原則

• 公開 REST 契約の正本は proto です。OpenAPI は proto から生成されます。
• Asset の履歴は immutable な AssetVersion として保持されます。
• Index は正本ではなく、再構築可能な Projection です。
• 検索結果は Asset ID、開始・終了時刻、transcript、根拠を持ちます。
• Security Context は server が解決し、client が namespace を指定することはありません。

提供状況

Direct Search は Public Beta 1 の公開候補です。Agentic Search、generic Operator、Creative API は この段階の公開対象に含めません。実際に呼び出せる operation は、生成された OpenAPI の x-nakataku-availability が available へ更新されたものだけです。