Skip to content

[OpenRouter] Base + Components #3205

@harxhist

Description

@harxhist

Description

OpenRouter provides a unified API for many LLM providers (OpenAI, Anthropic, Google, etc.). Add a SuperPlane integration so users can connect to any major LLM with single API-key of openRouter.

Link: https://openrouter.ai/docs


Base integration

  • Connection: API key (header Authorization: Bearer <key>). Create key at openrouter.ai/keys. Requests to https://openrouter.ai/api/v1/.
  • Optional: List models via GET /models for a model resource type (e.g. model picker).
  • No OAuth or webhooks.

Components

1. Text Prompt (Action)

  • Call chat completions API: user prompt + optional system message → single assistant reply.
  • Config: Model (required), Prompt (required), System message, Max tokens, Temperature. Credentials from base.
  • Output: id, model, text, usage, finishReason.
  • Use cases: run summaries, PR analysis, incident summaries, docs.

2. Get Remaining Credits (Action)

  • Return total credits purchased and used for the account.
  • Config: None. Uses base API key (management key required — standard keys get 403).
  • Output: totalCredits, totalUsage, remaining.
  • Use cases: cost tracking, low-credit alerts.

3. Get Current Key Details (Action)

  • Return key metadata: label, usage, limits, tier.
  • Config: None. Uses base API key.
  • Output: label, usage, usageDaily / usageWeekly / usageMonthly, limit, limitRemaining, limitReset, isFreeTier, isManagementKey, expiresAt (if any).
  • Use cases: usage reporting, limit checks.

Acceptance criteria

  • has proper tests
  • has proper documentation
  • passed code quality review
  • passed functionality review
  • passed ui/ux review

Reference

Adhere to contribution guidelines.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    Status

    Backlog

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions