Create a message | OpenRouter

Creates a message using the Anthropic Messages API format. Supports text, images, PDFs, tools, and extended thinking.

Authentication

AuthorizationBearer

API key as bearer token in Authorization header

Request

This endpoint expects an object.

modelstringRequired

max_tokensdoubleRequired

messageslist of objectsRequired

systemstring or list of objectsOptional

metadataobjectOptional

stop_sequenceslist of stringsOptional

streambooleanOptional

temperaturedoubleOptional

top_pdoubleOptional

top_kdoubleOptional

toolslist of objectsOptional

tool_choiceobjectOptional

thinkingobjectOptional

service_tierenumOptional

Allowed values:

providerobject or nullOptional

When multiple model providers are available, optionally indicate your routing preference.

pluginslist of objectsOptional

Plugins you want to enable for this request, including their settings.

userstringOptional<=128 characters

A unique identifier representing your end-user, which helps distinguish between different users of your app. This allows your app to identify specific users in case of abuse reports, preventing your entire app from being affected by the actions of individual users. Maximum of 128 characters.

session_idstringOptional<=128 characters

A unique identifier for grouping related requests (e.g., a conversation or agent workflow) for observability. If provided in both the request body and the x-session-id header, the body value takes precedence. Maximum of 128 characters.

modelslist of stringsOptional

Response

Successful response

contentlist of objects

idstring

modelstring

roleenum

Allowed values:

stop_reasonenum or null

stop_sequencestring or null

typeenum

Allowed values:

usageobject

1	curl -X POST https://openrouter.ai/api/v1/messages \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"model": "anthropic/claude-4.5-sonnet-20250929",
6	"max_tokens": 1024,
7	"messages": [
8	{
9	"role": "user",
10	"content": "Hello, how are you?"
11	}
12	],
13	"temperature": 0.7
14	}'

1	{
2	"content": [
3	{
4	"type": "text",
5	"text": "Hello! I'm doing well, thank you for asking.",
6	"citations": null
7	}
8	],
9	"id": "msg_01XFDUDYJgAACzvnptvVoYEL",
10	"model": "claude-sonnet-4-5-20250929",
11	"role": "assistant",
12	"stop_reason": "end_turn",
13	"stop_sequence": null,
14	"type": "message",
15	"usage": {
16	"input_tokens": 12,
17	"output_tokens": 15,
18	"cache_creation_input_tokens": null,
19	"cache_read_input_tokens": null,
20	"cache_creation": null,
21	"server_tool_use": null,
22	"service_tier": "standard"
23	}
24	}

Authentication

Request

Response

Errors