Quick Start
Hydracept is AI execution infrastructure for games. One interface for text, image, audio, and cloud models.
Free for individual developers. BYOK. 0% inference markup.
A Zencode product · © Zencode Consulting Inc.
Activate
- Open https://hydracept.com/start to create a Free account.
- Complete project and environment provisioning in onboarding.
- Save your API URL and API key for machine calls.
Public API: https://api.hydracept.com
Configuration directory (CLI): .hydracept/
Environment variables: HYDRACEPT_API_URL, HYDRACEPT_API_KEY, HYDRACEPT_PROJECT, HYDRACEPT_ENVIRONMENT
<!-- docs:endif -->
HTTP-first integration
Until registry packages ship, integrate with the public HTTP API and OpenAPI. The curl flow below is the supported clean-room path.
Discover capabilities
curl -sS -H "Authorization: Bearer $HYDRACEPT_API_KEY" \
https://api.hydracept.com/v1/capabilities
Launch capabilities:
text.general.fast.v1text.reasoning.high.v1text.structured.extraction.v1text.creative.longform.v1image.generate.v1audio.sfx.generate.v1audio.voice.generate.v1audio.music.generate.v1
See Capabilities for the capability-first contract.
Submit a durable job
JOB_JSON=$(curl -sS -X POST \
-H "Authorization: Bearer $HYDRACEPT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"context": {
"productId": "my-product",
"projectId": "cpr_...",
"environment": "development"
},
"input": { "prompt": "cute slime icon" },
"execution": { "executionPreference": "automatic" },
"idempotencyKey": "demo-1"
}' \
https://api.hydracept.com/v1/capabilities/image.generate.v1/jobs)
echo "$JOB_JSON"
JOB_ID=$(printf '%s' "$JOB_JSON" | python -c "import sys,json; print(json.load(sys.stdin)['jobId'])")
The submit response is a HydraceptJob object. Use jobId from that payload for poll and receipt calls.
Poll the job
curl -sS -H "Authorization: Bearer $HYDRACEPT_API_KEY" \
https://api.hydracept.com/v1/jobs/$JOB_ID
Poll until status is succeeded, failed, or canceled.
Fetch the receipt
curl -sS -H "Authorization: Bearer $HYDRACEPT_API_KEY" \
https://api.hydracept.com/v1/jobs/$JOB_ID/receipt
See Durable Jobs & Receipts for artifacts and outputs.