gpt-5.1-codex
Model Overview
A specialized edition of GPT 5.1 built for software engineering and coding workflows. It excels in both interactive development sessions and long, autonomous execution of complex engineering tasks. The model can build projects from scratch, develop features, debug, perform large-scale refactoring, and review code.
How to Make a Call
API Schema
Responses Endpoint
This endpoint is currently used only with OpenAI models. Some models support both the /chat/completions and /responses endpoints, while others support only one of them. OpenAI has announced plans to expand the capabilities of the /responses endpoint in the future.
Note: This model can ONLY be called via the /responses endpoint!
Text, image, or file inputs to the model, used to generate a response.
A text input to the model, equivalent to a text input with the user role.
An upper bound for the number of tokens that can be generated for a response, including visible output tokens and reasoning tokens.
The unique ID of the previous response to the model. Use this to create multi-turn conversations.
Whether to store the generated model response for later retrieval via API.
falseIf set to true, the model response data will be streamed to the client as it is generated using server-sent events.
falseThe truncation strategy to use for the model response.
- auto: If the context of this response and previous ones exceeds the model's context window size, the model will truncate the response to fit the context window by dropping input items in the middle of the conversation.
- disabled (default): If a model response will exceed the context window size for a model, the request will fail with a 400 error.
disabledPossible values: How the model should select which tool (or tools) to use when generating a response.
Controls which (if any) tool is called by the model.
none means the model will not call any tool and instead generates a message.
auto means the model can pick between generating a message or calling one or more tools.
required means the model must call one or more tools.
async function main() {
const response = await fetch('https://api.aimlapi.com/v1/responses', {
method: 'POST',
headers: {
'Authorization': 'Bearer <YOUR_API_KEY>',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"model": "openai/gpt-5-1",
"input": "Hello"
}),
});
const data = await response.json();
console.log(JSON.stringify(data, null, 2));
}
main();{
"background": null,
"created_at": 1,
"error": {
"code": "text",
"message": "text"
},
"id": "text",
"incomplete_details": {
"reason": "text"
},
"instructions": "text",
"max_output_tokens": 1,
"metadata": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"model": "text",
"object": "text",
"output": [
{
"role": null,
"type": null,
"content": null
}
],
"output_text": null,
"parallel_tool_calls": true,
"previous_response_id": null,
"prompt": {
"id": "text",
"variables": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"version": null
},
"reasoning": {
"effort": "low",
"summary": "auto"
},
"service_tier": null,
"status": "completed",
"temperature": 1,
"text": {
"format": {
"type": "text"
}
},
"tool_choice": "none",
"tools": [
{
"type": "web_search_preview",
"search_context_size": "low",
"user_location": {
"type": "text",
"city": null,
"country": null,
"region": null,
"timezone": null
}
}
],
"top_p": null,
"truncation": "auto",
"usage": {
"input_tokens": 1,
"input_tokens_details": {
"cached_tokens": 1
},
"output_tokens": 1,
"output_tokens_details": {
"reasoning_tokens": 1
},
"total_tokens": 1
}
}Code Example: Using /responses Endpoint
import requests
import json # for getting a structured output with indentation
response = requests.post(
"https://api.aimlapi.com/v1/responses",
headers={
"Content-Type":"application/json",
# Insert your AIML API Key instead of <YOUR_AIMLAPI_KEY>:
"Authorization":"Bearer <YOUR_AIMLAPI_KEY>",
"Content-Type":"application/json"
},
json={
"model":"openai/gpt-5-1-codex",
"input":"Hello" # Insert your question for the model here, instead of Hello
}
)
data = response.json()
print(json.dumps(data, indent=2, ensure_ascii=False))async function main() {
try {
const response = await fetch('https://api.aimlapi.com/v1/responses', {
method: 'POST',
headers: {
// Insert your AIML API Key instead of <YOUR_AIMLAPI_KEY>
'Authorization': 'Bearer <YOUR_AIMLAPI_KEY>',
'Content-Type': 'application/json',
},
body: JSON.stringify({
model: 'openai/gpt-5-1-codex',
input: 'Hello', // Insert your question here, instead of Hello
}),
});
if (!response.ok) {
throw new Error(`HTTP error! Status ${response.status}`);
}
const data = await response.json();
console.log(JSON.stringify(data, null, 2));
} catch (error) {
console.error('Error', error);
}
}
main();Last updated
Was this helpful?