Responses

Follows OpenAI's Responses format and passes through unchanged. Responses runs statelessly: send the whole conversation in input on every request. Send the key as Authorization: Bearer sk-df-....

Example

curl https://deference.si/v1/responses \
  -H "Authorization: Bearer $DEFERENCE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-5.5",
    "input": "Say hello in one sentence."
  }'

import os
from openai import OpenAI

client = OpenAI(base_url="https://deference.si/v1", api_key=os.environ["DEFERENCE_API_KEY"])

response = client.responses.create(
    model="anthropic/claude-sonnet-5.5",
    input="Say hello in one sentence.",
)
print(response.output_text)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://deference.si/v1",
  apiKey: process.env.DEFERENCE_API_KEY,
});

const response = await client.responses.create({
  model: "anthropic/claude-sonnet-5.5",
  input: "Say hello in one sentence.",
});
console.log(response.output_text);

Request body

modelstringRequired

The model id.

inputstring | arrayRequired

A prompt, or a list of input items for a conversation.

instructionsstring

System-level instructions.

streamboolean

Return server-sent events. Codex sets it.

toolsarray

Tools the model may call.

max_output_tokensinteger

The output limit. Also sets the credit held while the request runs.

reasoningobject

Reasoning settings, for models that support them.

storeboolean

Leave unset or false. Stored responses are not supported and return 400.

previous_response_idstring

Not supported. Send the full conversation in input.

Streaming

A stream ends with response.completed, response.incomplete (the reason is in incomplete_details) or response.failed. Each carries the final response object, with its usage when the provider reports it. Codex waits for response.completed. See Streaming events.

Models

Each model reads Responses requests in its own way. If a model fails with a Codex-style request, try another. See Codex.