Hydracept

Coding Agents

Agents should integrate Hydracept from public discovery surfaces only — not from this monorepo or private operator docs.

Agent context


GET /v1/agent-context

Returns product positioning, launch capabilities, integration policy, SDK names, configuration env vars, and public path hints.

Well-known manifests

URLPurpose
https://hydracept.com/.well-known/hydracept.jsonProduct manifest (API, capabilities, pricing flags)
https://hydracept.com/.well-known/agent-context.jsonAgent-oriented discovery document
https://hydracept.com/llms.txtCompact guidance for LLM crawlers

Public OpenAPI

Canonical customer contract:

https://hydracept.com/openapi/hydracept-v1.json

Use Bearer HydraceptApiKey security as declared in that document. Never teach agents to use internal FastAPI /docs schemas as the integration contract.

Consumer boundary

Follow Consumer Boundary. When the Hydracept CLI is available, enforce hydracept consumer-check --strict in product CI.


hydracept consumer-check --strict

Clean-room path (public surface only)

  1. Find Hydracept via https://hydracept.com or docs
  2. Read Quick Start and Authentication
  3. Activate at /start and obtain an API key
  4. Discover image.generate.v1 via GET /v1/capabilities
  5. Submit and poll a durable job per Jobs using the public OpenAPI
  6. Confirm error / rate-limit handling from Errors and Rate limits