tongflow-router-openrouter

Official TongFlow plugin for OpenRouter. Exposes OpenRouter's catalog through a per-node model picker — text (free by default), vision, image, audio understanding and transcription.

Formerly tongflow-api-openrouter-free (then tongflow-api-openrouter). "Free" is now just one of the model options; text slots still default to a free model to avoid surprise billing.

Capabilities

Runs locally as a Python process (no GPU). ABI slots:

• Text — gen-text, split-text, combine-text, plus the deterministic arrange-group / drop-video batch helpers.
• Vision / audio → text — image-gen-text, image-describe, video-gen-text, video-describe, audio-describe.
• Image output — image-gen, image-edit (via image-output modalities).
• Transcription — transcribe, transcribe-timestamp.

Each slot has a curated model shortlist (first = default). A per-node model outside the shortlist is still accepted as long as the live /api/v1/models catalog knows it — so weekly model rotations don't break the picker.

Credentials

Add in TongFlow Settings (gear icon, top-right):

Key	Required	Notes
OPENROUTER_API_KEY	✅	Create one at openrouter.ai/keys. Free models still need a key.
OPENROUTER_MODEL	optional	Force a default model when no per-node model is picked (OPENROUTER_FREE_MODEL still works).
OPENROUTER_HTTP_REFERER	optional	Sent as the HTTP-Referer header for attribution.
OPENROUTER_APP_TITLE	optional	Sent as the X-Title header for attribution.

Model ids rotate weekly on OpenRouter — the shortlists are verified 2026-07; the live catalog is the source of truth at runtime.

Values are stored locally and take effect without a restart.