Skip to main content
POST

Authorizations

Authorization
string
header
required

Use a bearer key beginning with gf_live_... for protected catalog operations. Keep keys server-side. Aspas Labs does not currently expose a self-service dashboard or key-management page.

Body

application/json

The context and constraints for one structured decision. Exactly one of choices or catalog must be provided.

model
string
required

The Goldenfish model identifier. Select the model in the body instead of changing the route.

Minimum string length: 1
Examples:

"goldenfish-g1"

"goldenfish-g1@REVISION"

input
string
required

The context to classify.

Minimum string length: 1
instruction
string
required

The question or decision instruction.

Minimum string length: 1
choices
string[]
required

Inline valid outcomes. Send 2–300 unique, non-empty strings when you are not using a catalog.

Required array length: 2 - 300 elements
Minimum string length: 1
catalog
string

A reusable catalogue ID.

Minimum string length: 1

Response

Decision completed.

The result of one structured decision request.

id
string
required

The unique decision identifier. Values begin with dec_.

Pattern: ^dec_
Example:

"dec_01K7Y..."

object
any
required

Always decision for this response object.

model
string
required

The model identifier used to produce the result.

Example:

"goldenfish-g1"

output
object
required

The selected choice and the model's probability distribution over the valid outcomes.

usage
object
required

Usage counters for the completed decision request.