Coding Agents
Integrate Hydracept from public discovery surfaces—the published docs, OpenAPI, and agent-context endpoints. Do not rely on this monorepo or private operator docs.
Hydracept gives game tools and backends one stable API for AI generation.
Agent context
GET /v1/agent-context
Returns product positioning, available capabilities, ordered onboarding steps, managed smoke flags, SDK names, configuration environment variables, and public path hints. Prefer this document over guessing install flows.
Well-known manifests
| URL | Purpose |
|---|---|
| https://hydracept.com/.well-known/hydracept.json | Product manifest (API, capabilities, pricing flags) |
| https://hydracept.com/.well-known/agent-context.json | Agent-oriented discovery document |
| https://hydracept.com/llms.txt | Compact guidance for LLM crawlers |
Public OpenAPI
Canonical customer contract:
https://hydracept.com/openapi/hydracept-v1.json
Authenticate requests with Authorization: Bearer <HYDRACEPT_API_KEY> as declared in the OpenAPI document.
Consumer boundary
For products that use Hydracept for generation, follow the Consumer Boundary. Run python -m hydracept consumer-check --strict in product CI.
python -m hydracept consumer-check --strict
MCP
Hydracept exposes an MCP server for tool-using agents. Follow the live MCP setup published with the public release.
Clean-room path (public surface only)
- Read
GET /v1/agent-context(includes ordered onboarding steps) - Human activates at https://hydracept.com/start — copy the agent setup block
python -m hydracept quickstart --token <key> --json --smoke(agents) orlogin→configure→doctor→smoke(humans)- Connect BYOK for sustained inference
- For image production (Sheet & Slice, transparency, variants), read Image production
- For Unity 6 Editor integration, read Unity integration
- Submit and poll a durable job per Jobs using the public OpenAPI
- Confirm error / rate-limit handling from Errors and Rate limits
If the user asks for game image features
| User intent | Hydracept surface |
|---|---|
| Transparent sprite / icon PNG | image.generate.v1 + requestTransparentOutput: true |
| Sprite sheet / contact sheet → individual frames | sheet.slice, sheet.rows, sheet.columns, optional sheet.animation |
| Unity 6 Editor import with provenance | Unity integration — hydracept integrations install unity |
| Multiple icon takes to pick from | variantCount 2–4 |
| Automated art pipeline / CI | POST /v1/capabilities/image.generate.v1/jobs + artifact download |
Do not invent Studio-only endpoints. Prefer the public capability job contract above.