PRpremai-io
Inference
dev-api

Create a structured decision

Changed on

Answer typed questions (choice, noul, score) about a state. TypeSafe-compatible (SystemOne), so the official SDK can use this endpoint directly. Not end-to-end encrypted.

post/typesafe/v1/systemone

Request

  • Base URL
    https://gateway.prem.io
  • Auth
    HTTP bearer and API key in header Authorization

Headers

X-Queue-Timeoutstring
Example:0

Maximum seconds the request may wait in the inference queue when no capacity is free (decimals allowed). 0 never queues: a saturated model answers 429 immediately. Values above the server budget (10s) are capped; the header can only shorten the wait, never extend it. Invalid values are ignored. A request that cannot be admitted in time gets 429 with Retry-After.

Request body

modelstring required

Model name, as listed by GET /typesafe/v1/models.

questionsobject required

Map of question id to a typed question.

imagesstring[]

Optional. At most one base64 image data URL.

samplesinteger
stepsinteger
providerstring

Optional. Pin the request to one of the model's configured backends. Omit to let the platform choose.

videosstring[]

Optional dgemma extension: one inline MP4, up to 10 MiB, 30 seconds and 1920 x 1080 pixels. Four frames are sampled; audio is not processed. Cannot be combined with images. Use a raw JSON request if your SDK does not expose this field.

Example request

{
  "videos": [
    "data:video/mp4;base64,<base64-encoded-mp4>"
  ]
}

Response

A decision with per-question answers and probabilities.

object required

Changes

  • d46bc3931b34Revision changes
    • warning

      added the new 405.00 enum value to the / response property for the response status

    • warning

      added the new 405.00 enum value to the / response property for the response status

    • warning

      added the new 405.00 enum value to the / response property for the response status

    • warning

      added the new 405.00 enum value to the response property for the response status

    • warning

      added the new 405.00 enum value to the response property for the response status

    • warning

      added the new 405.00 enum value to the response property for the response status

    • warning

      added the new 405.00 enum value to the response property for the response status

    • warning

      added the new 409.00 enum value to the / response property for the response status

    • warning

      added the new 409.00 enum value to the / response property for the response status

    • warning

      added the new 409.00 enum value to the / response property for the response status

    • warning

      added the new 409.00 enum value to the response property for the response status

    • warning

      added the new 409.00 enum value to the response property for the response status

    • warning

      added the new 409.00 enum value to the response property for the response status

    • warning

      added the new 409.00 enum value to the response property for the response status

    • warning

      added the new 500.00 enum value to the / response property for the response status

    • warning

      added the new 500.00 enum value to the / response property for the response status

    • warning

      added the new 500.00 enum value to the / response property for the response status

    • warning

      added the new 500.00 enum value to the response property for the response status

    • warning

      added the new 500.00 enum value to the response property for the response status

    • warning

      added the new 500.00 enum value to the response property for the response status

    • warning

      added the new 500.00 enum value to the response property for the response status

    • info

      added the new optional header request parameter X-Queue-Timeout

  • d5b1beb33be5Revision changes
    • info

      endpoint added