cicora.ai
English
API specificationUnified output

Responses API

Use one input object when your application benefits from handling output items and actions in a single data model.

Integration reference: choose parameters and available capabilities from your account API settings and the model catalogue for your environment.

Create a response

A Responses request carries model and input. Input can be a short string or a structured set of items when the workflow requires it.

Design the handler around the output array: text, a tool call, and service items can have different types.

Responses API request
bash
curl --request POST https://cicora.ai/api/v1/responses \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "openai/gpt-5.6-sol",
    "input": "Summarize the incident report for an engineer."
  }'

Control the workflow

  • Keep the response id and associated conversation or session id in your own system.
  • Limit automatic steps in an agent loop on the application side.
  • Check model parameters before adding audio, images, or tools.

Parse the result

Do not rely on the position of one text item. Iterate output, extract recognized types, and retain unknown ones for observability.

When streaming is needed, use the streaming form of the same workflow and combine deltas only by item identifiers.

Continue with