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

  1. Open https://hydracept.com/start to create a Free account.
  2. Complete project and environment provisioning in onboarding.
  3. 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:

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.

Next