Sign Up
Loading...

OpenRouter commands

Use these commands from an endpoint, server function or event. Choose Add Command → Connector → OpenRouter, select the action, then choose an Account. Selecting an account reveals the remaining inputs. When the command returns a result, open OUTPUT and use Return as to name it for later commands.

All connector references · Connect an account · AI setup and shared results

Generate Text

Generate a text answer from one prompt with OpenRouter. No tools, file inputs, image inputs or streaming controls are exposed by this command.

Inputs

InputTypeHow to use it
AccountAccountSelect an existing OpenRouter connector belonging to this organization. Connect or reconnect the account from the account input menu; never enter a raw API key here.
ModeltextPaste the exact model ID enabled for your OpenRouter account, up to 200 characters; there is no default model. Model access depends on your account. Use List Models where available, then choose a model that supports this operation.
Instructionstext boxOptional nonblank instructions, up to 16,384 characters, such as "Answer in one short paragraph." Leave blank to omit them. Use this field for system guidance rather than adding a system role to Messages.
Inputtext boxRequired nonblank prompt text, up to 32,768 characters. Example: "Summarize this order in one sentence." Files, objects and message lists are not accepted here; use Chat for conversation turns.
OptionsobjectOptional object with only maxOutputTokens (whole number 1–8192; default 1024), temperature (0–2) and topP (greater than 0 and at most 1). Example: {"maxOutputTokens":200}. Omit sampling settings unless the selected model supports them. Unknown keys, tools and response-format settings are rejected.

Result

An object with responseId, outputText, model, finishReason and usage. Use outputText for the answer. finishReason retains the provider status/stop reason. usage has inputTokens, outputTokens and totalTokens; unknown counts are null. A safety stop or token limit can produce empty or shortened text.

Example

Account: select your OpenRouter connection. Model: paste an enabled text-model ID. Instructions: "Answer briefly." Input: "What is a webhook?". Options: {"maxOutputTokens":200}. Save as answer and use answer.outputText.

Errors and limits

A missing, revoked, wrong-provider or inaccessible organization account stops the command. Isolated tests and live debugging do not contact providers; enable Use live data deliberately to test a connected account. Provider permissions, unsupported models/options, billing and rate limits can reject requests. Provider errors are summarized and external requests are not automatically retried. Inputs over the 64 KiB serialized request limit, responses over 2 MiB, or a request exceeding 30 seconds fail instead of returning a partial result.

Chat

Send an ordered text conversation to OpenRouter and return its text answer. Supply the conversation each time; this command does not create a persistent chat session.

Inputs

InputTypeHow to use it
AccountAccountSelect an existing OpenRouter connector belonging to this organization. Connect or reconnect the account from the account input menu; never enter a raw API key here.
ModeltextPaste the exact model ID enabled for your OpenRouter account, up to 200 characters; there is no default model. Model access depends on your account. Use List Models where available, then choose a model that supports this operation.
Instructionstext boxOptional nonblank instructions, up to 16,384 characters, such as "Answer in one short paragraph." Leave blank to omit them. Use this field for system guidance rather than adding a system role to Messages.
MessageslistRequired ordered list of 1–100 objects. Each object must contain only role ("user" or "assistant") and content (nonblank text, at most 32,768 characters). Example: [{"role":"user","content":"Name two primary colors."}]. System/tool roles and multimodal content are not supported.
OptionsobjectOptional object with only maxOutputTokens (whole number 1–8192; default 1024), temperature (0–2) and topP (greater than 0 and at most 1). Example: {"maxOutputTokens":200}. Omit sampling settings unless the selected model supports them. Unknown keys, tools and response-format settings are rejected.

Result

An object with responseId, outputText, model, finishReason and usage. Use outputText for the answer. finishReason retains the provider status/stop reason. usage has inputTokens, outputTokens and totalTokens; unknown counts are null. A safety stop or token limit can produce empty or shortened text.

Example

Account: select your OpenRouter connection. Model: paste an enabled text-model ID. Instructions: "Answer briefly." Messages: [{"role":"user","content":"What is a webhook?"}]. Options: {"maxOutputTokens":200}. Save as answer and use answer.outputText.

Errors and limits

A missing, revoked, wrong-provider or inaccessible organization account stops the command. Isolated tests and live debugging do not contact providers; enable Use live data deliberately to test a connected account. Provider permissions, unsupported models/options, billing and rate limits can reject requests. Provider errors are summarized and external requests are not automatically retried. Inputs over the 64 KiB serialized request limit, responses over 2 MiB, or a request exceeding 30 seconds fail instead of returning a partial result.

List Models

Read one bounded page of OpenRouter model identifiers without generating text. This lists model metadata; it does not prove access to every model or operation.

Inputs

InputTypeHow to use it
AccountAccountSelect an existing OpenRouter connector belonging to this organization. Connect or reconnect the account from the account input menu; never enter a raw API key here.
CursortextLeave blank. This provider does not accept a model-pagination cursor in this command; a nonempty value is rejected.

Result

An object with models (each has id and name), nextCursor, hasMore and truncated. At most 500 model entries are returned; paginating providers request up to 100 per page. nextCursor is null when unavailable. If truncated is true with no nextCursor, the remaining catalogue cannot be fetched with this command.

Example

Account: select your OpenRouter connection. Cursor: blank. Save the result as model_catalog and read model_catalog.models; select a suitable returned model ID for a text or embedding command.

Errors and limits

A missing, revoked, wrong-provider or inaccessible organization account stops the command. Isolated tests and live debugging do not contact providers; enable Use live data deliberately to test a connected account. Provider permissions, unsupported models/options, billing and rate limits can reject requests. Provider errors are summarized and external requests are not automatically retried. Inputs over the 64 KiB serialized request limit, responses over 2 MiB, or a request exceeding 30 seconds fail instead of returning a partial result.

Create Embeddings

Convert a list of texts into numeric vectors with a compatible OpenRouter embedding model. Use vectors for similarity search or matching; this does not store them in a database.

Inputs

InputTypeHow to use it
AccountAccountSelect an existing OpenRouter connector belonging to this organization. Connect or reconnect the account from the account input menu; never enter a raw API key here.
ModeltextPaste the exact model ID enabled for your OpenRouter account, up to 200 characters; there is no default model. Model access depends on your account. Use List Models where available, then choose a model that supports this operation.
InputlistRequired list of 1–32 nonblank text values, each at most 8,192 characters. Example: ["Red apple","Green pear"]. Keep the whole serialized request within 64 KiB; output index matches the original input position.
OptionsobjectOptional object. The only supported setting for this provider is dimensions: a whole number from 1 to 3072, for models that support a custom vector size. Leave blank or {} to use the model default. Example: {"dimensions":256}.

Result

An object with model, data and usage. data contains one {index, embedding} entry per input in original order; embedding is a list of finite numbers. usage has inputTokens, outputTokens and totalTokens; unknown counts are null. Vector length depends on the model and supported settings.

Example

Account: select your OpenRouter connection. Model: paste an enabled embedding-model ID. Input: ["Red apple","Green pear"]. Options: {}. Save as vectors and use vectors.data[0].embedding for the first text.

Errors and limits

A missing, revoked, wrong-provider or inaccessible organization account stops the command. Isolated tests and live debugging do not contact providers; enable Use live data deliberately to test a connected account. Provider permissions, unsupported models/options, billing and rate limits can reject requests. Provider errors are summarized and external requests are not automatically retried. Inputs over the 64 KiB serialized request limit, responses over 2 MiB, or a request exceeding 30 seconds fail instead of returning a partial result.

Test safely

Isolated tests and live debugging do not call connected providers. Enable Use live data only when you intend to contact the account. Writes, messages and AI requests can change real data or incur provider charges. A successful connection check does not prove access to every action. These examples explain the command contract; they are not evidence of a completed live provider request.

Related Topics

Cohere commands

Use these commands from an endpoint, server function or event. Choose Add Command → Connector → Cohere, select the action, then choose an Account. Selecting an account reveals the remaining inputs. When the command returns a result, open OUTPUT and use Return as to name it for later commands. [All c...

SendGrid commands

Use these commands from an endpoint, server function or event. Choose Add Command → Connector → SendGrid, select the action, then choose an Account. Selecting an account reveals the remaining inputs. When the command returns a result, open OUTPUT and use Return as to name it for later commands. [All...

Dropbox commands

Use these commands from an endpoint, server function or event. Choose Add Command → Connector → Dropbox, select the action, then choose an Account. Selecting an account reveals the remaining inputs. When the command returns a result, open OUTPUT and use Return as to name it for later commands. [All ...

Calendly commands

Use these commands from an endpoint, server function or event. Choose Add Command → Connector → Calendly, select the action, then choose an Account. Selecting an account reveals the remaining inputs. When the command returns a result, open OUTPUT and use Return as to name it for later commands. [All...

Together AI commands

Use these commands from an endpoint, server function or event. Choose Add Command → Connector → Together AI, select the action, then choose an Account. Selecting an account reveals the remaining inputs. When the command returns a result, open OUTPUT and use Return as to name it for later commands. [...