Hydracept

Hydracept

Hydracept 是面向需要外部能力（文本、推理、图像、音频、视频、3D、域名和计算）的软件与 AI Agent 的执行控制平面，通过一个 API 提供发现、报价、持久化任务、制品、回执、预算和 BYOK。游戏和媒体是常见示例；一个典型工作流是从 Cursor 或 Claude Code 将 AI 游戏素材导入 Unity（工作流概览）。

**定价（摘要）：**个人用户可使用免费计划（$0/月）；付费计划增加可用容量。BYOK 不收取 Hydracept 费用；托管推理按供应商成本 + 6% 服务费计费（按实际用量计费，不设单次调用最低费用）。符合条件的持久化文本任务可使用延迟处理，费率为标准 Token 费率的 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 · Agent 上下文：GET https://api.hydracept.com/v1/agent-context

初始化

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

工作室（浏览器）：app.hydracept.com/login。用于 CI 或无头模式时，设置 HYDRACEPT_API_KEY，并在需要设置授权时使用 --ci 运行相同的初始化命令。工作区文件位于 .hydracept/ 下 — 参见身份验证。

最简示例

一次性图像生成（工作区可以初始化时会组合执行初始化）：

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

Python SDK（初始化绑定工作区后）：

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）

在项目检出目录中，初始化后默认使用 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（无需检出仓库）：**使用 bearer HYDRACEPT_API_KEY 访问 https://api.hydracept.com/mcp
• MCP Registry 名称：com.hydracept/hydracept

stdio 绑定可用时，请勿将工作区 API 密钥粘贴到 IDE 插件配置中。完整 Agent 指南：编码 Agent。

文档

主题	链接
文档首页	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。