Respan Models

Answer typed questions about a state with span-02, Respan's decision model. Each question is choice, noul (yes/no), score or number, and each answer carries its probability distribution and confidence. One request can mix all four types.

Set a thinking deadline with reasoning.budget_ms: span-02 thinks until then and answers with its best decision so far. The body is the System One format, so a System One client works by changing the URL. span-02 runs on Respan credits only and is priced per input and output token; thought tokens aren't billed. Streaming is unsupported.

post/api/v1/decisions

Request

  • Base URL
    https://api.respan.ai
  • URL
    https://api.respan.ai/api/v1/decisions
  • Auth
    HTTP bearer

Request body

modelstring

Use span-02 or respan/span-02. Omit for span-02.

questionsobject required

Your question ids mapped to questions. Answers come back under the same ids.

imagesstring[]

Up to 4 images, as data URIs or base64. span-02 sees them before the text.

respan_paramsobject

Respan parameters for the request log, such as customer_identifier.

Example request

{
  "model": "span-02"
}

Response

Answers keyed by question id. The example is the captured response to the request shown; probabilities can vary slightly between calls.

model'span-02' required

The model that answered.

answersobject required

Answers keyed by the ids in questions.

Changes

    • breaking

      request body became required

    • breaking

      the ////// request property's minItems was increased to 2

    • breaking

      removed subschema #2 from the ////// request property oneOf list

    • breaking

      removed subschema #1 subschema #2 subschema #3 from the /////// request property oneOf list

    • breaking

      removed subschema #1 subschema #2 subschema #3 from the ////// request property oneOf list

    • breaking

      removed subschema #1 subschema #2 subschema #3 from the ////// request property oneOf list

    • breaking

      removed subschema #1 subschema #2 subschema #3 from the ////// request property oneOf list

    • breaking

      removed subschema #1 subschema #2 subschema #3 from the ////// request property oneOf list

    • breaking

      removed subschema #2 subschema #3 from the /////// request property oneOf list

    • breaking

      removed subschema #2 subschema #3 from the request property oneOf list

    • breaking

      the ////// request property type changed from no type to object

    • breaking

      the response property ////// became nullable for the status

    • breaking

      added subschema #2 subschema #3 to the /////// response property oneOf list for the response status

    • breaking

      the ////// response's property format changed from double to no format for status

    • breaking

      the /////// response's property format changed from double to no format for status

    • breaking

      the ////// response's property format changed from double to no format for status

    • breaking

      the ////// response's property format changed from double to no format for status

    • breaking

      the /////// response's property format changed from double to no format for status

    • breaking

      the ////// response's property format changed from double to no format for status

    • breaking

      the ////// response's property format changed from double to no format for status

    • breaking

      the ////// response's property type changed from number null to number, and format from double to no format for status

    • info

      api operation id respanModels_createDecisions removed and replaced with createDecisions

    • info

      api tag Respan Models added

    • info

      api tag respanModels removed

    • info

      added the new optional request property ///////

    • info

      added the new optional request property ///////

    • info

      the request property ////// became nullable

    • info

      added subschema #1 subschema #2 subschema #3 to the /////// request property oneOf list

    • info

      added subschema #1 subschema #2 subschema #3 to the ////// request property oneOf list

    • info

      added subschema #1 subschema #2 subschema #3 to the ////// request property oneOf list

    • info

      added subschema #1 subschema #2 subschema #3 to the ////// request property oneOf list

    • info

      added subschema #1 subschema #2 subschema #3 to the ////// request property oneOf list

    • info

      added subschema #2 subschema #3 to the /////// request property oneOf list

    • info

      added subschema #2 subschema #3 to the request property oneOf list

    • info

      removed subschema #2 subschema #3 from the /////// response property oneOf list for the response status

    • info

      endpoint added