Create a response | OpenRouter

1 import requests 2 3 url = "https://openrouter.ai/api/v1/api/alpha/responses" 4 5 payload = { 6 "model": "anthropic/claude-4.5-sonnet-20250929", 7 "input": [ 8 { 9 "type": "message", 10 "content": "Hello, how are you?", 11 "role": "user" 12 } 13 ], 14 "temperature": 0.7, 15 "top_p": 0.9, 16 "tools": [ 17 { 18 "type": "function", 19 "name": "get_current_weather", 20 "description": "Get the current weather in a given location", 21 "parameters": { 22 "type": "object", 23 "properties": { "location": { "type": "string" } } 24 } 25 } 26 ] 27 } 28 headers = { 29 "Authorization": "Bearer <token>", 30 "Content-Type": "application/json" 31 } 32 33 response = requests.post(url, json=payload, headers=headers) 34 35 print(response.json())

1 { 2 "created_at": 1704067200, 3 "error": {}, 4 "id": "resp-abc123", 5 "incomplete_details": {}, 6 "instructions": {}, 7 "metadata": {}, 8 "model": "gpt-4", 9 "object": "response", 10 "parallel_tool_calls": true, 11 "temperature": {}, 12 "tool_choice": "auto", 13 "tools": [], 14 "top_p": {}, 15 "max_output_tokens": {}, 16 "output": [ 17 { 18 "id": "msg-abc123", 19 "role": "assistant", 20 "type": "message", 21 "status": "completed", 22 "content": [ 23 { 24 "type": "output_text", 25 "text": "Hello! How can I help you today?", 26 "annotations": [] 27 } 28 ] 29 } 30 ], 31 "status": "completed", 32 "usage": { 33 "input_tokens": 10, 34 "input_tokens_details": { 35 "cached_tokens": 0 36 }, 37 "output_tokens": 25, 38 "output_tokens_details": { 39 "reasoning_tokens": 0 40 }, 41 "total_tokens": 35 42 } 43 }

Creates a streaming or non-streaming response using OpenResponses API format

Authentication

AuthorizationBearer

API key as bearer token in Authorization header

Request

This endpoint expects an object.

Response

Successful response

created_atdouble

errorobject

Error information returned from the API

idstring

incomplete_detailsobject

instructionsstring or list of objects or any

metadatamap from strings to strings

Metadata key-value pairs for the request. Keys must be ≤64 characters and cannot contain brackets. Values must be ≤512 characters. Maximum 16 pairs allowed.

modelstring

objectenum

Allowed values:

parallel_tool_callsboolean

temperaturedouble or null

tool_choiceenum or object

toolslist of maps from strings to any or objects

top_pdouble or null

backgroundboolean or null

max_output_tokensdouble or null

max_tool_callsdouble or null

outputlist of objects or null

output_textstring or null

previous_response_idstring or null

promptobject or null

prompt_cache_keystring or null

reasoningobject or null

safety_identifierstring or null

service_tierenum or null

Allowed values:

statusenum or null

storeboolean or null

textobject or null

Text output configuration including format and verbosity

top_logprobsdouble or null

truncationenum or null

Allowed values:

usageobject or null

Token usage information for the response

userstring or null