從 OpenRouter 遷移到本平台

準備帳號

更新設定

測試呼叫

確認用量

申請遷移獎勵

進階說明

本頁目錄

本平台

沿用 OpenAI 相容的串接方式。更新 API 位址、金鑰和模型，驗證成功後再切換業務流量。

開始遷移

建立 API 金鑰

OpenRouter 遷移獎勵

獎勵為核定淨消費的 10%，最高 500 美元，審核通過後 30 天內發放。

了解更多

相容 OpenAI API

先驗證，再切換

需要用戶端設定協助？

文件

登入或註冊帳號，檢查錢包餘額，再建立已啟用且額度充足、具備目標模型存取權限的 API 金鑰。將金鑰保存在伺服器環境變數中，不要寫入瀏覽器程式碼。

註冊

錢包

模型與價格

設定對照

設定項目

OpenRouter

API 位址

API 金鑰

本平台新建的金鑰

模型 ID

模型目錄中的完整 ID

從「模型與價格」複製完整模型 ID，或使用新金鑰呼叫 GET /v1/models 查詢。不要認為移除供應商前綴就一定可用。SDK 的 Base URL 以 /v1 結尾；直接傳送 HTTP 請求時只附加一次 /chat/completions。

替換 YOUR_PLATFORM_API_KEY 和 YOUR_MODEL_ID。macOS/Linux 先執行 cURL 範例中的環境變數設定，Windows 先執行 PowerShell 設定；Python 和 Node.js 讀取同一組環境變數。請在伺服器或本機終端機執行範例。

確認基本文字請求回傳 HTTP 200，且 choices[0].message.content 非空。

在「用量日誌」中核對模型、Token 數與扣款。比較價格時使用相同模型和計費單位。

使用日誌

檢查相容性

核對 OpenRouter 專屬功能

移除 OpenRouter 應用歸屬標頭（HTTP-Referer、X-Title 和 X-OpenRouter-Title）。逐項核對 provider、models、route、transforms、plugins 以及 :free 等模型後綴；原平台的路由與定價規則不會自動遷移。

先傳送純文字 Chat Completions 請求，再針對所選模型分別測試工具呼叫、JSON 輸出、圖片、推理和串流回應。如果使用 OpenRouter SDK 或用戶端內建預設，請改用 OpenAI 相容用戶端或自訂供應商設定。

驗證並切換流量

啟用 stream: true，在用戶端確認增量事件與串流結束均正常。

先切換少量流量，監測錯誤和延遲，再逐步擴大。保留舊設定以便回復；驗證完成後撤銷不再使用的金鑰。

常見問題排查

使用本平台簽發的金鑰，透過 Authorization: Bearer 驗證。檢查金鑰狀態、有效期限、IP 限制與模型權限。

檢查 /v1 API 位址、完整模型 ID 與支援的參數。移除 OpenRouter 專屬欄位，以最小請求重試。

依錯誤回應檢查餘額、金鑰額度、速率限制與模型可用性。暫時故障可退避重試；金鑰無效或餘額不足時不要反覆重試。

哪些內容會遷移？

本指南遷移的是 API 設定，不會匯入 OpenRouter 的餘額、金鑰、發票、用量歷史或聊天記錄。請在用戶端備份對話，並在原平台處理帳單。遷移獎勵需另外申請，以審核結果為準。

參考資料

提交 OpenRouter 結算單或發票、消費記錄清單、圖片及文字說明。合格淨消費須至少 100 美元，按 10% 發放體驗額度，每位個人或企業最高 500 美元。額度僅可消費，不可退款或提領。每個獨立客戶限參與一次，被拒絕後可重新提交；審核通過後 30 天內發放。

淨消費不含退款、贈送額度和優惠減免，最低為 100 美元。

支援 PDF、JPG、PNG，最多 5 個檔案，每個不超過 10 MB。

API 位址: https://routerra.ai/v1
API 金鑰: YOUR_PLATFORM_API_KEY
模型 ID: YOUR_MODEL_ID

cURL

export OPENAI_BASE_URL='https://routerra.ai/v1'
export OPENAI_API_KEY='YOUR_PLATFORM_API_KEY'
export OPENAI_MODEL='YOUR_MODEL_ID'

curl --fail-with-body "$OPENAI_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d @- <<EOF
{"model":"$OPENAI_MODEL","messages":[{"role":"user","content":"Hello"}]}
EOF

Python

# pip install openai
import os
from openai import OpenAI

client = OpenAI(
    base_url=os.environ["OPENAI_BASE_URL"],
    api_key=os.environ["OPENAI_API_KEY"],
)
response = client.chat.completions.create(
    model=os.environ["OPENAI_MODEL"],
    messages=[{"role": "user", "content": "Hello"}],
)
print(response.choices[0].message.content)

Node.js

// bun add openai
import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: process.env.OPENAI_BASE_URL,
  apiKey: process.env.OPENAI_API_KEY,
});
const response = await client.chat.completions.create({
  model: process.env.OPENAI_MODEL,
  messages: [{ role: 'user', content: 'Hello' }],
});
console.log(response.choices[0].message.content);

PowerShell

$env:OPENAI_BASE_URL = 'https://routerra.ai/v1'
$env:OPENAI_API_KEY = 'YOUR_PLATFORM_API_KEY'
$env:OPENAI_MODEL = 'YOUR_MODEL_ID'

$body = @{
  model = $env:OPENAI_MODEL
  messages = @(@{ role = 'user'; content = 'Hello' })
} | ConvertTo-Json -Depth 5
Invoke-RestMethod -Method Post `
  -Uri "$env:OPENAI_BASE_URL/chat/completions" `
  -Headers @{ Authorization = "Bearer $env:OPENAI_API_KEY" } `
  -ContentType 'application/json' -Body $body