c2d2b0ac14
Validado em lote numa worktree combinada com os 9 PRs desta leva sobre o tip de `release/v3.8.51`: `typecheck:core` limpo, `check:provider-consistency` OK (273 entradas REGISTRY, **356** providers canônicos), `check-docs-counts-sync` exit 0 e **300/300** nos testes que a leva toca. O crescimento de arquivo que os PRs empilham uns sobre os outros foi rebaselinado num único registro datado (`_rebaseline_2026_09_03_houminxi_batch`), com a decomposição por arquivo: `providers/page.tsx` +18 (import CSV do #12504 + busca do #12495 no mesmo painel), `accountFallback.ts` +6 (o #12566 sobre o rebaseline que o #12590 já registrou — os dois tocam `checkFallbackError`) e `chatCore.ts` +3 (invalidez de cache de quota no 429 do #12325). As violações restantes (`codex.ts`, `stream.ts`) foram medidas também no tip puro e são drift da base, não desta leva.
1.9 KiB
title
| title |
|---|
| Import providers from a CSV or JSON file |
Import providers from a CSV or JSON file
Dashboard → Providers → Import from file creates API-key connections from a CSV or JSON list. Each row can target a different provider. Partial failure is the contract: valid rows still import when others fail, and the modal lists why the failed rows were rejected.
This import does not create new OpenAI/Anthropic-compatible endpoint nodes. Create those first (Dashboard → Providers → Add OpenAI-Compatible, or omniroute nodes add), then import rows whose provider column is that node's id. A per-row baseUrl can still override the node's URL.
CSV (positional)
Column names are cosmetic. The parser splits each row and destructures by index:
| Index | Field | Required | Notes |
|---|---|---|---|
| 0 | provider |
yes | Existing managed provider id (openai, anthropic, …) or an already-registered OpenAI/Anthropic-compatible node id |
| 1 | name |
yes | Connection display name |
| 2 | apiKey |
yes | API key |
| 3 | baseUrl |
no | Per-row URL override |
| 4 | priority |
no | Integer 1–100 |
A first line whose first column is the literal word provider (any case) is skipped as a header. Blank lines and # comments are skipped.
Download a starter file from the import modal (Download CSV template). Example:
# OmniRoute provider import (positional columns)
provider,name,apiKey,baseUrl,priority
openai,Prod OpenAI,sk-your-openai-key,,1
A made-up id such as openai-compatible-chat-001 is not a node. The API returns Unknown or unsupported provider for that row; the modal shows it next to the row name.
JSON
A JSON array of objects with the same fields (provider, name, apiKey, baseUrl?, priority?). Unlike CSV, JSON keys are named.
[
{ "provider": "openai", "name": "Prod OpenAI", "apiKey": "sk-your-openai-key", "priority": 1 }
]