Skip to main content
POST
Responses API
The /v1/responses endpoint provides an OpenAI Responses API-compatible interface for text generation, tool use, and multi-turn conversations. Use the same request format as the OpenAI Responses API: swap the base URL to https://api.unifically.com and pass any supported model ID in the model field.
Not every model’s upstream serves the Responses API. Those models return a 400 invalid_request_error telling you to use /v1/chat/completions instead. Some models work only here: Grok 4.20 Multi-Agent (xai/grok-4.20-multi-agent-0309) is Responses-only.

Create Response

POST /v1/responses

Request

Request Parameters

string
required
Model identifier in provider/model-name format. See Available LLM Models.
string | array
required
Text prompt, or an array of input items (messages, tool results, etc.) for multi-turn conversations.
string
System-level instructions for the model.
boolean
If true, the response is streamed using server-sent events. Default: false.
number
Sampling temperature between 0 and 2.
integer
Maximum number of output tokens to generate.
array
Tools available to the model. Each tool includes a type and definition.
string | object
Controls tool usage: none, auto, required, or a specific tool.
string
ID of a previous response to continue a multi-turn conversation.
boolean
Whether to store the response for later retrieval. Default: true.

Multi-turn Example

Response

Streaming Response

When stream: true, the API returns server-sent events with partial response objects:

Errors

Errors use the OpenAI shape, {"error": {"message", "type", "code", "param"}}. An error after a stream has started arrives as an error event ({"type": "error", "code", "message", "param", "sequence_number"}), and the stream ends there. See Error Handling.

Supported Models

See individual model pages under LLM Models for details.

SDK Compatibility

Point any OpenAI SDK at Unifically by changing the base URL: