Hydracept

Hydracept

Hydracept は、テキスト、推論、画像、音声、動画、3D、ドメイン、コンピューティングなどの外部機能を必要とするソフトウェアや AI エージェント向けの実行制御プレーンです。検出、見積もり、永続ジョブ、成果物、利用証明、予算、BYOK を備えた単一の API を通じて利用できます。ゲームやメディアは一般的なユースケースです。代表的なワークフローは、Cursor または Claude Code から Unity に AI ゲームアセットを取り込むことです（ワークフローの概要）。

料金（概要）： 個人向けの無料プラン（月額 0 ドル）があり、有料プランでは容量が追加されます。BYOK の Hydracept 手数料は 0％です。マネージド推論はプロバイダー料金＋6％のサービス手数料です（実際の使用量に基づき、呼び出しごとの最低料金はありません）。対象となる永続テキストジョブでは、標準のトークン料金の 50％で遅延処理を利用できます。詳細：hydracept.com/pricing および 請求ドキュメント。

インストール

提供形態	コマンド
Python CLI および SDK	pip install -U hydracept
TypeScript	npm install @hydracept/sdk
.NET	dotnet add package Hydracept.Client
Unity（UPM git）	Git URL 経由で com.hydracept.unity — Unity 統合を参照（OpenUPM への掲載はオーナーによる申請待ち）

公開 HTTP API：https://api.hydracept.com · OpenAPI：hydracept-v1.json · エージェントコンテキスト：GET https://api.hydracept.com/v1/agent-context

初期設定

pip install -U hydracept
python -m hydracept init --apply --yes --json
python -m hydracept doctor

Studio（ブラウザー）：app.hydracept.com/login。CI またはヘッドレス環境で使用する場合は、HYDRACEPT_API_KEY を設定し、セットアップ用の権限が必要なときは同じ init コマンドを --ci 付きで実行してください。ワークスペースファイルは .hydracept/ 内に保存されます。認証を参照してください。

最小限の例

画像を一度だけ生成します（ワークスペースを初期設定できる場合は init を組み合わせます）。

python -m hydracept run image.generate.v1 --prompt "transparent 1024x1024 blue slime icon" --json

Python SDK（init によるワークスペースのバインド後）：

from hydracept.client import HydraceptClient

client = HydraceptClient.from_workspace()
job = client.submit_capability_job(
    "image.generate.v1",
    {
        "input": {"prompt": "cute slime icon, flat game art"},
        "execution": {"executionPreference": "automatic"},
        "idempotencyKey": "demo-1",
    },
)
finished = client.wait_for_job(job["jobId"])
receipt = client.get_job_receipt(job["jobId"])

利用可能な機能をその場で検出します（この README のキーをハードコードしないでください）。

python -m hydracept capabilities find "generate an image"
curl -sS -H "Authorization: Bearer $HYDRACEPT_API_KEY" https://api.hydracept.com/v1/capabilities

その他の例：public/examples/。

MCP（Cursor および Claude Code）

プロジェクトのチェックアウトでは、init 後のデフォルトは stdio MCP です。

python -m hydracept init --apply --yes --json   # binds MCP to workspace secrets; reload MCP if prompted
python -m hydracept mcp serve                   # stdio server
python -m hydracept agents install --auto       # Cursor / Claude Code plugin + hooks

• プラグインとインストール用リンク： hydracept.com/plugin
• ホスト型 MCP（リポジトリのチェックアウト不要）： ベアラー HYDRACEPT_API_KEY を使用して https://api.hydracept.com/mcp に接続
• MCP Registry 名： com.hydracept/hydracept

stdio bind が利用可能な場合は、ワークスペース API キーを IDE のプラグイン設定に貼り付けないでください。エージェント向けガイド全文：コーディングエージェント。

ドキュメント

トピック	リンク
ドキュメントのトップページ	docs.hydracept.com
クイックスタート（詳細）	クイックスタート
機能とジョブ	機能、ジョブと利用証明
画像制作	画像制作
Unity	Unity 統合
BYOK と請求	接続／BYOK、請求
LLM 向け概要	hydracept.com/llms.txt
製品マニフェスト	/.well-known/hydracept.json

リポジトリ構成

• clients/python — PyPI パッケージ hydracept（CLI、SDK、ローカル MCP）
• clients/typescript — npm @hydracept/sdk
• clients/csharp — NuGet Hydracept.Client
• packages/unity — Unity Editor パッケージ
• public/docs — docs.hydracept.com のソース（クイックスタートの内容。このルート README は GitHub の入り口です）

ライセンス

MIT — LICENSE を参照してください。PyPI、npm、NuGet のパッケージメタデータにも MIT と記載されています。