SambaNova Systems Responses API is one of 12 APIs that SambaNova Systems publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Responses. The published artifact set on APIs.io includes an OpenAPI specification.
This API exposes
1 operation
across 1 path,
and defines 44 schemas.
It is described by OpenAPI 3.1.0, at version 0.0.1.
Requests are made against a single base URL, https://chat.sambanova.ai/api.
The identity and technical contract details declared by the specification.
ResponseStreamEvent
Top-level discriminated union of all Server-Sent Events emitted during a streaming POST /responses call. Discriminated by the type field. Events arrive in sequ…
SimpleError
object
other kind of simple schema errors
1 property
1 required
ResponseOutputItemAddedEvent
object
Emitted when a new output item (message, function call, or reasoning) is added to the response output array. The item has status: inprogress and may have empty…
4 properties
4 required
ResponseOutputTextDeltaEvent
object
Emitted for each incremental chunk of assistant message text. Accumulate delta values in order to reconstruct the full output text.
8 properties
8 required
ResponseUsage
object
Token usage statistics for this response.
14 properties
3 required
ResponseReasoningTextDoneEvent
object
Emitted when a reasoning content part has been fully generated. The text field contains the complete accumulated reasoning text (equivalent to concatenating al…
5 properties
5 required
ResponseOutputItem
A single item in the output[] array returned by the model. Can be a message (with text or tool call content), a function call request, or a reasoning trace. Di…
ResponseReasoningContent
object
A single content part within a reasoning item's content[]. Contains the raw reasoning text produced by the model during its internal thinking process.
2 properties
2 required
ResponseToolChoiceOption
Controls which tool (if any) the model calls. String values: "none" disables tool calls; "auto" lets the model decide; "required" forces at least one tool call…
ResponseImageContent
object
An image content part for use inside a ResponseMessage. Supported in input messages (user role). Provide a base64-encoded image as a data URL. external URLs no…
3 properties
2 required
ResponseInputItem
A single item in the input[] array. Can be a message, a function call, a function call result, or a reasoning trace replayed from a prior turn. When building m…
ResponseOutputReasoning
object
A reasoning item emitted in output[] by models that expose their internal chain-of-thought. Contains the raw reasoning text the model produced before generatin…
5 properties
1 required
ResponseFunctionCall
object
A function call item used in both input[] and output[]. When present in output[], the model is requesting a tool call — id and status are always set by the ser…
6 properties
4 required
ResponseFunctionCallArgumentsDeltaEvent
object
Emitted for each incremental chunk of function call arguments JSON generated by the model. Accumulate delta values in order to reconstruct the full arguments s…
5 properties
5 required
ResponseAudioContent
object
An audio content part for use inside a ResponseMessage. Supported in input messages (user role). Provide base64-encoded audio data with the format.
2 properties
2 required
ResponseCreatedEvent
object
Emitted as the first SSE event when a streaming response begins. The embedded response object has status inprogress and an empty output array. Clients can use…
3 properties
3 required
ResponseFormatConfiguration
Controls the format of the model's output for the Responses API text.format field. "text" returns plain text (default). "jsonobject" returns a raw JSON object.…
ResponseTextFormatJSONSchema
object
Specifies that the model should produce structured output conforming to the provided JSON Schema. Unlike the Chat Completions API, the Responses API places nam…
5 properties
2 required
ResponseReasoningTextDeltaEvent
object
Emitted for each incremental chunk of reasoning text generated by the model. Accumulate delta values in order to reconstruct the full reasoning text.
5 properties
5 required
ResponseUrlCitation
object
A URL citation annotation on an output text span. Not currently implemented by SambaNova — included for OpenAI API compatibility.
5 properties
4 required
ResponseMessage
object
A message item. When used as input, id and status are optional. When present in output[], id and status are always set by the server. Role "assistant" with con…
5 properties
3 required
TopLogProbs
object
3 properties
2 required
ResponseCompletedEvent
object
Emitted as the final SSE event when a streaming response has been fully generated. The embedded response object has status: completed, a fully populated output…
3 properties
3 required
ResponseTextContent
object
A plain text content part for use inside a ResponseMessage.
4 properties
2 required
ResponseRequest
object
responses request object
24 properties
2 required
ResponseVideoContent
object
A video content part for use inside a ResponseMessage. Supported in input messages (user role). Provide a URL or base64-encoded video data.
2 properties
2 required
ResponseTextFormatText
object
Specifies that the model should produce output as plain text. This is the default.
1 property
1 required
GeneralError
object
other kind of errors
2 properties
1 required
ResponseResponse
object
A response object returned by POST /responses (non-streaming). Contains the model's output items, echoed input parameters, lifecycle metadata, and token usage.
31 properties
21 required
ResponseInProgressEvent
object
Emitted when the response transitions to the inprogress state, immediately after response.created. The embedded response object still has an empty output array…
3 properties
3 required
ResponseContentPartAddedEvent
object
Emitted when a new content part is added to an output item's content array. The part's text is empty at this point; subsequent response.outputtext.delta or res…
6 properties
6 required
ResponseAnnotation
An annotation on a span of output text. Currently stubbed for OpenAI API compatibility — SambaNova does not produce annotations.
ResponseStreamContentPart
A content part within a streaming event. Discriminated by type: outputtext for assistant message content (reuses ResponseTextContent), reasoningtext for model…
ResponseNamedToolChoice
object
Forces the model to call a specific function. Pass this object as toolchoice to guarantee the model will invoke the named function.
2 properties
2 required
ResponseTool
object
A tool definition passed to the model via the tools[] array. Only type "function" is supported; other tool types are filtered server-side.
5 properties
2 required
ResponseFunctionCallOutput
object
A tool result item used in input[] to return the output of a function call back to the model. Always input-only — the model never outputs functioncalloutput it…
5 properties
3 required
ResponseFunctionCallArgumentsDoneEvent
object
Emitted when a function call's arguments have been fully generated. The arguments field contains the complete JSON arguments string (equivalent to concatenatin…
5 properties
5 required
ResponseContentPartDoneEvent
object
Emitted when a content part has been fully generated. The part field contains the complete content for this part (equivalent to the state after accumulating al…
6 properties
6 required
ResponseOutputItemDoneEvent
object
Emitted when an output item has been fully generated and its status transitions to completed. The item field contains the complete output item including all ac…
4 properties
4 required
ResponseFileCitation
object
A file citation annotation on an output text span. Not currently implemented by SambaNova — included for OpenAI API compatibility.
4 properties
4 required
ResponseOutputTextDoneEvent
object
Emitted when an output text content part has been fully generated. The text field contains the complete accumulated output text (equivalent to concatenating al…
8 properties
8 required
ResponseTextFormatJSONObject
object
Specifies that the model should produce output as a raw JSON object. The model is not constrained to any specific schema.
1 property
1 required
LogProbsContent
object
4 properties
3 required
ResponseContent
A typed content part used in both input and output message content arrays. Discriminated by the "type" field.
The full machine-readable OpenAPI contract behind this narrative.
Other APIs SambaNova Systems publishes across the network.
