Skip to main content
The TypeScript SDK and docs are currently in beta. Report issues on GitHub.

Example Usage

import { CreateResponsesRequest } from "@openrouter/sdk/models/operations";

let value: CreateResponsesRequest = {
  responsesRequest: {},
};

Fields

FieldTypeRequiredDescriptionExample
httpRefererstring:heavy_minus_sign:The app identifier should be your app’s URL and is used as the primary identifier for rankings.
This is used to track API usage per application.
appTitlestring:heavy_minus_sign:The app display name allows you to customize how your app appears in OpenRouter’s dashboard.
appCategoriesstring:heavy_minus_sign:Comma-separated list of app categories (e.g. “cli-agent,cloud-agent”). Used for marketplace rankings.
xOpenRouterExperimentalMetadatamodels.MetadataLevel:heavy_minus_sign:Opt-in to surface routing metadata on the response under openrouter_metadata. Defaults to disabled.enabled
responsesRequestmodels.ResponsesRequest:heavy_check_mark:N/A{"input": [{"content": "Hello, how are you?","role": "user","type": "message"}
],
“model”: “anthropic/claude-4.5-sonnet-20250929”,
“temperature”: 0.7,
“tools”: [
{"description": "Get the current weather in a given location","name": "get_current_weather","parameters": {"properties": {"location": {"type": "string"}
},
“type”: “object”
},
“type”: “function”
}
],
“top_p”: 0.9
}