Capabilities
Integrate against stable capability keys—not provider SDKs or raw model names.
List and describe
GET /v1/capabilities
Authorization: Bearer <HYDRACEPT_API_KEY>
GET /v1/capabilities/{key}
Authorization: Bearer <HYDRACEPT_API_KEY>
Invoke vs durable jobs
| Route | Use when |
|---|---|
POST /v1/capabilities/{key}/invoke | Short synchronous work that fits in one request |
POST /v1/capabilities/{key}/jobs | Work that needs retries, polling, artifacts, or receipts |
Use jobs for image, audio, 3D mesh, and anything that should outlive a single HTTP request.
Audio capabilities (audio.sfx.generate.v1, audio.voice.generate.v1, audio.music.generate.v1) run as durable jobs. Set variantCount (1–4) in job input to request multiple takes. See variant selection when you need to pick one output before the next pipeline step.
3D capabilities (model.generate.3d.v1, model.generate.3d.from-image.v1) run on Meshy. Use model.generate.3d.v1 when you have turnaround view artifacts; use model.generate.3d.from-image.v1 to chain OpenAI turnaround generation from a single concept image. See 5-minute 3D asset.
Available capabilities
These capabilities are currently supported:
text.general.fast.v1text.reasoning.high.v1text.structured.extraction.v1text.creative.longform.v1image.generate.v1image.edit.v1video.generate.v1audio.sfx.generate.v1audio.voice.generate.v1audio.music.generate.v1model.generate.3d.v1model.generate.3d.from-image.v1
Stick to published capability keys in customer integrations.
Example: discover image generation
curl -sS -H "Authorization: Bearer $HYDRACEPT_API_KEY" \
https://api.hydracept.com/v1/capabilities/image.generate.v1
See Durable Jobs & Receipts and Quick Start.
Image production
image.generate.v1 supports transparent output, Sheet & Slice, and variants. See Image production.
Contract source
The public OpenAPI document is the API contract for external integrations:
https://hydracept.com/openapi/hydracept-v1.json
Integrate against that spec—not internal FastAPI schemas or private monorepo routes.