Skip to content
OpenRelay is in early access, and the /v1 API is stable. New capabilities ship in the changelog.
Skip to Content
CLICommands

orl responses create

Create a model response (OpenAI Responses), part of the orl CLI for OpenRelay GPU VMs, pods, batches and billing.

orl responses create --input <input> --model <model>

Generates a model response in the OpenAI Responses shape for the OpenAI SDKs and Codex. Check a model's supported_apis on GET /v1/models first.

Stateless: the gateway sends store false and refuses previous_response_id, conversation, background, stored prompts, item references and file inputs (400 unsupported_parameter). Send the full conversation in input on every turn. Client-executed tools (function, custom, namespace, client tool_search) are forwarded; hosted web_search is removed and every other hosted tool is refused (400 unsupported_tool_type).

Requires a funded balance. Set "stream" to true for event-typed Server-Sent Events (response.created, response.output_text.delta, response.completed, and so on); a stream carries no [DONE] line. The request body is capped at 10 MiB.

Flags

FlagTypeRequired
--inputjsonyesThe full conversation: a string, or an array of input items (messages, function_call, function_call_output, reasoning, ...).
--instructionsstringnoThe system prompt.
--max-output-tokensintnoUpper bound on tokens to generate, reasoning included.
--modelstringyesAn OpenRelay public model id.
--storeboolnoIgnored: the gateway always sends false.
--streamboolnoStream the response as event-typed Server-Sent Events.
--bodystringnoa JSON object of request body fields, merged under any of this command's own flags that are also set, e.g. {"key":"value"}
--body-filestringnoread the --body JSON object from a file (- for stdin)

This wraps the createResponse API operation.

On this page