provider::openrouter::abort
Cancel the in-flight upstream stream for a request_id (router::abort fan-out), stopping billed generation immediately.
- request_idstringrequired
- abortedbooleanrequired
provider-openrouter
v0.1.16OpenRouter Chat Completions provider worker; one API key in front of every major vendor. Implements provider::openrouter::stream and provider::openrouter::refresh_models behind llm-router.
Install
bash
iii trigger compose::add worker=provider-openrouterRun in your project with the iii engine running. Exact versions are immutable and digest-pinned.
Functions4
Function
provider::openrouter::on_router_ready
Internal: router::ready subscriber that re-declares this provider and refreshes its catalog.
Empty object
- okbooleanrequired
provider::openrouter::refresh_models
Refresh the OpenRouter catalog slice from GET /api/v1/models — ids, context windows, pricing, and capabilities all come from the live listing — and reconcile it through the router; returns the model count written.
Empty object
- countinteger· uintrequiredmin 0
- okbooleanrequired
provider::openrouter::stream
Stream an OpenRouter chat completion: resolve credentials, call the upstream Chat Completions API, and relay AssistantMessageEvent frames to writer_ref.
- cache_intentany ofany of (2)Variant 1
- surface_digeststringrequired
Variant 2valuenull - max_output_tokensinteger· uint64min 0
- messagesany of[]requiredany of (4)Variant 1
- contentone of[]required
Show 7 nestedHide nested
one of (7)Variant 1- textstringrequired
- typestringrequiredenum text
Variant 2- attachment_idstring
Optional link to the stored original in the session-manager attachment store. Transcript bookkeeping for lazy readers only: the harness clears it before `router::chat`, and no provider mapping reads it. Tolerated here so a block that still carries it deserializes instead of failing the request; omitted on the wire when absent.
- datastringrequired
- mimestringrequired
- typestringrequiredenum image
Variant 3- attachment_idstringrequired
- mimestringrequired
- namestringrequired
- sizeinteger· uint64requiredmin 0
- typestringrequiredenum file
Variant 4- signaturestring
- textstringrequired
- typestringrequiredenum thinking
Variant 5- datastringrequired
- typestringrequiredenum redacted_thinking
Variant 6- argumentsunknownrequired
- function_idstringrequired
- idstringrequired
- typestringrequiredenum function_call
Variant 7- contentunknown[]required
- function_call_idstringrequired
- is_errorboolean
- typestringrequiredenum function_result
- error_kindany of
Show 2 nestedHide nested
any of (2)Variant 1valuestringenum auth_expired, rate_limited, context_overflow, transient, permanentVariant 2valuenull - error_messagestring
- modelstringrequired
- native_stop_reasonstring
- providerstringrequired
- rolestringrequiredenum assistant
- stop_reasonstringrequiredenum end, length, function_call, aborted, error
- timestampinteger· int64required
- usageany of
Show 2 nestedHide nested
any of (2)Variant 1- cache_readinteger· uint64min 0
- cache_writeinteger· uint64min 0
- cost_usdnumber· double
- inputinteger· uint64min 0
- outputinteger· uint64min 0
- reasoninginteger· uint64min 0
Variant 2valuenull - warningsstring[]
Variant 2- contentone of[]required
Show 7 nestedHide nested
one of (7)Variant 1- textstringrequired
- typestringrequiredenum text
Variant 2- attachment_idstring
Optional link to the stored original in the session-manager attachment store. Transcript bookkeeping for lazy readers only: the harness clears it before `router::chat`, and no provider mapping reads it. Tolerated here so a block that still carries it deserializes instead of failing the request; omitted on the wire when absent.
- datastringrequired
- mimestringrequired
- typestringrequiredenum image
Variant 3- attachment_idstringrequired
- mimestringrequired
- namestringrequired
- sizeinteger· uint64requiredmin 0
- typestringrequiredenum file
Variant 4- signaturestring
- textstringrequired
- typestringrequiredenum thinking
Variant 5- datastringrequired
- typestringrequiredenum redacted_thinking
Variant 6- argumentsunknownrequired
- function_idstringrequired
- idstringrequired
- typestringrequiredenum function_call
Variant 7- contentunknown[]required
- function_call_idstringrequired
- is_errorboolean
- typestringrequiredenum function_result
- detailsunknownrequired
- function_call_idstringrequired
- function_idstringrequired
- is_errorbooleanrequired
- rolestringrequiredenum function_result
- timestampinteger· int64required
Variant 3- contentone of[]required
Show 7 nestedHide nested
one of (7)Variant 1- textstringrequired
- typestringrequiredenum text
Variant 2- attachment_idstring
Optional link to the stored original in the session-manager attachment store. Transcript bookkeeping for lazy readers only: the harness clears it before `router::chat`, and no provider mapping reads it. Tolerated here so a block that still carries it deserializes instead of failing the request; omitted on the wire when absent.
- datastringrequired
- mimestringrequired
- typestringrequiredenum image
Variant 3- attachment_idstringrequired
- mimestringrequired
- namestringrequired
- sizeinteger· uint64requiredmin 0
- typestringrequiredenum file
Variant 4- signaturestring
- textstringrequired
- typestringrequiredenum thinking
Variant 5- datastringrequired
- typestringrequiredenum redacted_thinking
Variant 6- argumentsunknownrequired
- function_idstringrequired
- idstringrequired
- typestringrequiredenum function_call
Variant 7- contentunknown[]required
- function_call_idstringrequired
- is_errorboolean
- typestringrequiredenum function_result
- custom_typestringrequired
- detailsunknown
- displaystring
- rolestringrequiredenum custom
- timestampinteger· int64required
Variant 4- contentone of[]required
Show 7 nestedHide nested
one of (7)Variant 1- textstringrequired
- typestringrequiredenum text
Variant 2- attachment_idstring
Optional link to the stored original in the session-manager attachment store. Transcript bookkeeping for lazy readers only: the harness clears it before `router::chat`, and no provider mapping reads it. Tolerated here so a block that still carries it deserializes instead of failing the request; omitted on the wire when absent.
- datastringrequired
- mimestringrequired
- typestringrequiredenum image
Variant 3- attachment_idstringrequired
- mimestringrequired
- namestringrequired
- sizeinteger· uint64requiredmin 0
- typestringrequiredenum file
Variant 4- signaturestring
- textstringrequired
- typestringrequiredenum thinking
Variant 5- datastringrequired
- typestringrequiredenum redacted_thinking
Variant 6- argumentsunknownrequired
- function_idstringrequired
- idstringrequired
- typestringrequiredenum function_call
Variant 7- contentunknown[]required
- function_call_idstringrequired
- is_errorboolean
- typestringrequiredenum function_result
- rolestringrequiredenum user
Single-variant role tags: exact-match on deserialize, correct wire string on serialize, and they let `AgentMessage` be an untagged union.
- timestampinteger· int64required
- modelstringrequired
- model_metaany ofany of (2)Variant 1
- context_windowinteger· uint64requiredmin 0
- display_namestring
- idstringrequired
- input_limitinteger· uint64min 0
- max_output_tokensinteger· uint64requiredmin 0
- pricingany of
Show 2 nestedHide nested
any of (2)Variant 1- cache_readnumber· double
- cache_writenumber· double
- inputnumber· double
- outputnumber· double
Variant 2valuenull - providerstringrequired
- reasoning_effortsobject[]
Show 2 nestedHide nested
- descriptionstring
- effortstringrequired
- speechany of
Set on speech models only; see [`SpeechModel`].
Show 2 nestedHide nested
any of (2)Variant 1- languagesstring[]
BCP-47 tags of the languages the model handles; empty when the provider does not say.
- modalityone ofrequired
What a speech model does. Chat models carry no `speech` block.
Show 2 nestedHide nested
one of (2)Variant 1valuestringenum sttVariant 2valuestringenum tts - streamingboolean
Realtime input (stt) or streamed audio output (tts) is available.
Variant 2valuenull - supports_cacheboolean
- supports_structured_outputboolean
- supports_thinkingboolean
- supports_thinking_offboolean
Whether `thinking_level: off` can switch the model's reasoning off. `Some(true)`: a native off switch exists. `Some(false)`: the model always reasons, or the provider has no switch. `None`: the provider does not know; consoles show the choice disabled.
- supports_toolsboolean
- supports_visionboolean
- supports_xhighboolean
- thinking_budgetsobject
Variant 2valuenull - provider_optionsunknown
- resolution_keystring
- response_formatany ofany of (2)Variant 1
- schemaunknown
- typestringrequired
Variant 2valuenull - session_idstring
Stable conversation identity for provider cache affinity.
- system_promptstring
- system_sectionsobject[]
Ordered sections behind `system_prompt` (always forwarded alongside the flat string, which equals the sections joined with "\n\n").
- cache_boundaryboolean
- textstringrequired
- thinking_levelany ofany of (2)Variant 1valuestringenum off, minimal, low, medium, high, xhighVariant 2valuenull
- toolsobject[]
- descriptionstringrequired
- execution_modestring
- labelstring
- namestringrequired
- parametersunknownrequired
- writer_refobjectrequired
- access_keystringrequired
- channel_idstringrequired
- directionstringrequiredenum read, write
- okbooleanrequired
Triggers0
No triggers registered