GPT-5.1-Codex

POST/v1/chat/completions

GPT-5.1-Codex is a specialized version of GPT-5.1 optimized for software engineering and coding workflows. It is designed for both interactive development sessions and long, independent execution of complex engineering tasks. The model supports building projects from scratch, feature development, debugging, large-scale refactoring, and code review. Compared to GPT-5.1, Codex is more steerable, adheres closely to developer instructions, and produces cleaner, higher-quality code outputs. Reasoning effort can be adjusted with the `reasoning.effort` parameter. Read the docs here

Request body

Parameters supported by this model. Values, defaults, and limits are read from the model registry.

stringmodelrequired

Model identifier. Set to openai/gpt-5.1-codex.

Default: openai/gpt-5.1-codex

array<object>messagesrequired

Conversation messages in system, user, or assistant order.

Optional<integer>max_tokens

Maximum number of tokens the model may generate in the response.

Range: −∞ to 128000

Optional<number>temperature

Sampling temperature. Lower values are more deterministic; higher values are more creative.

Range: 0 to 2

Default: 1

Optional<boolean>stream

When true, returns incremental Server-Sent Events instead of one completed response.

Default: false

Optional<array>tools

Tool definitions that the model may call during the response.

Optional<string>tool_choice

Controls whether the model may call a tool and, when supported, which tool it must call.

Optional<object>response_format

Controls the response format, including JSON mode or structured JSON output when supported.

Optional<integer>seed

Seed used to make sampling more reproducible when the provider supports it.

Response Schema

Fields returned by this model API response.

array<object>choicesrequired

Generated completion choices.

stringidrequired

Unique chat completion identifier.

stringmodelrequired

Model that generated the response.

Optional<object>usage

Token usage when available.

Model capabilities

array<string>capability_tagsrequired

Capabilities declared by the model registry.

Default: chat, vision, reasoning, structured_output, function_calling

integercontext_lengthrequired

Maximum context window accepted by this model.

Default: 400000 tokens

stringexecution_moderequired

Execution mode declared by the model registry.

Default: sync

curl -X POST https://api.sandbase.ai/v1/chat/completions \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "openai/gpt-5.1-codex",
  "messages": [
    {
      "role": "user",
      "content": "Describe this product in one sentence."
    }
  ]
}'

Response200 OK

{
  "id": "chatcmpl_abc123",
  "model": "openai/gpt-5.1-codex",
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "A concise product description."
      }
    }
  ]
}