Skip to main content
Goldenfish is the structured-decision API from Aspas Labs. Send context, an instruction, and a set of valid outcomes. The API returns one selected choice, a confidence score, and probabilities keyed by the original choices. The contract is deliberately small: the model is selected in the request body, decisions use one endpoint, and the response shape stays predictable as the model catalog grows.
Aspas Labs does not have a dashboard or self-service web console yet. Use the HTTP API directly. The free decision and model surface does not require an API key; catalog management is a separate protected surface and requires a bearer key.

​
Choose a starting point

Make your first decision

Send a support-style classification request with cURL and inspect the structured response.

Understand authentication

Learn which endpoints can be called without a key and how to send gf_live_... bearer keys safely.

Use the API reference

Browse the OpenAPI-generated endpoints, parameters, schemas, responses, and interactive examples.

Build a catalog workflow

Create reusable choices once, then send decisions by catalog ID.

​
What the API supports

​
Base URL and versioning

The production base URL is:
Versioned product endpoints use the /v1 prefix. Health endpoints are intentionally unversioned:

​
A few terms

  • Decision — the result of evaluating one input and instruction against a choice set.
  • Choice — one valid output string, such as reset_password or billing.
  • Catalog — a reusable, named choice set stored by the API.
  • Model — the Goldenfish model selected in the request body.
  • Confidence — the probability assigned to the selected choice.
Continue with the quickstart, or jump directly to the API reference.