Chuyển từ OpenRouter

Chuẩn bị tài khoản

Cập nhật cấu hình

Kiểm tra lời gọi API

Xác nhận mức sử dụng

Đăng ký nhận thưởng

Ghi chú nâng cao

Trên trang này

Nền tảng này

Giữ quy trình tương thích OpenAI. Cập nhật địa chỉ API, khóa API và mô hình, sau đó xác minh trước khi chuyển lưu lượng.

Bắt đầu chuyển đổi

Tạo khóa API

Thưởng chuyển từ OpenRouter

Thưởng 10% chi tiêu ròng đã xác minh, tối đa 500 USD. Cấp trong 30 ngày sau khi phê duyệt.

Tìm hiểu thêm

API tương thích OpenAI

Kiểm tra trước khi chuyển

Cần trợ giúp cấu hình ứng dụng?

Tài liệu

Đăng nhập hoặc đăng ký, kiểm tra số dư ví, rồi tạo khóa API đang hoạt động với hạn mức đủ và quyền truy cập mô hình đã chọn. Lưu khóa trong môi trường máy chủ, không đưa vào mã trình duyệt.

Đăng ký

Ví

Mô hình và giá

Đối chiếu cấu hình

Thiết lập

OpenRouter

URL cơ sở

Khóa API

Khóa mới của nền tảng này

ID mô hình

ID chính xác trong danh mục mô hình

Sao chép ID chính xác từ Mô hình và giá hoặc gọi GET /v1/models bằng khóa mới. Không nên cho rằng chỉ xóa tiền tố nhà cung cấp là đủ. URL cơ sở của SDK kết thúc bằng /v1; yêu cầu HTTP trực tiếp chỉ thêm /chat/completions một lần.

Thay YOUR_PLATFORM_API_KEY và YOUR_MODEL_ID. Trước tiên thiết lập biến môi trường bằng cURL trên macOS/Linux hoặc PowerShell trên Windows; Python và Node.js đọc cùng các biến này. Chạy ví dụ trên máy chủ hoặc terminal cục bộ.

Xác nhận yêu cầu văn bản cơ bản trả về HTTP 200 và choices[0].message.content không rỗng.

Kiểm tra mô hình, token và phí trong Nhật ký sử dụng. So sánh giá với cùng mô hình và đơn vị tính phí.

Nhật ký sử dụng

Kiểm tra tương thích

Kiểm tra tính năng riêng của OpenRouter

Xóa các tiêu đề ghi nhận ứng dụng OpenRouter (HTTP-Referer, X-Title và X-OpenRouter-Title). Kiểm tra provider, models, route, transforms, plugins và hậu tố mô hình như :free; quy tắc định tuyến và giá không tự động chuyển sang.

Bắt đầu bằng yêu cầu Chat Completions văn bản thuần. Kiểm tra riêng công cụ, đầu ra JSON, hình ảnh, suy luận và truyền luồng trên mô hình đã chọn. Nếu dùng SDK OpenRouter hoặc cấu hình có sẵn của ứng dụng, hãy chuyển sang ứng dụng tương thích OpenAI hoặc cấu hình nhà cung cấp tùy chỉnh.

Xác minh và chuyển lưu lượng

Bật stream: true và kiểm tra các sự kiện tăng dần cùng việc kết thúc luồng trong ứng dụng.

Chuyển một phần nhỏ lưu lượng trước. Theo dõi lỗi và độ trễ rồi tăng dần. Giữ cấu hình cũ để quay lại khi cần; thu hồi khóa không dùng sau khi xác minh.

Khắc phục sự cố

Dùng khóa do nền tảng này cấp với Authorization: Bearer. Kiểm tra trạng thái, hạn dùng, giới hạn IP và quyền truy cập mô hình của khóa.

Kiểm tra URL cơ sở /v1, ID mô hình chính xác và tham số được hỗ trợ. Xóa trường riêng của OpenRouter và thử lại yêu cầu tối thiểu.

Dựa vào phản hồi lỗi để kiểm tra số dư, hạn mức khóa, giới hạn tốc độ và tính sẵn có của mô hình. Thử lại lỗi tạm thời với thời gian chờ tăng dần; không lặp lại khi khóa sai hoặc thiếu số dư.

Những gì được chuyển?

Hướng dẫn này chuyển cấu hình API. Số dư, khóa, hóa đơn, lịch sử sử dụng và trò chuyện OpenRouter không được nhập. Sao lưu hội thoại trong ứng dụng và xử lý hóa đơn trên nền tảng cũ. Thưởng chuyển đổi cần đăng ký riêng và được xét duyệt.

Tài liệu tham khảo

Nộp bảng kê hoặc hóa đơn OpenRouter, danh sách giao dịch sử dụng, hình ảnh và giải thích bằng văn bản. Chi tiêu ròng đủ điều kiện tối thiểu 100 USD. Nhận 10%, tối đa 500 USD cho mỗi cá nhân hoặc doanh nghiệp, dưới dạng tín dụng trải nghiệm chỉ dùng cho dịch vụ, không hoàn tiền hay rút tiền. Mỗi khách hàng độc lập chỉ tham gia một lần; hồ sơ bị từ chối có thể nộp lại. Tín dụng được cấp trong 30 ngày sau khi phê duyệt.

Chi tiêu ròng không bao gồm hoàn tiền, tín dụng tặng và giảm giá. Tối thiểu 100 USD.

PDF, JPG hoặc PNG. Tối đa 5 tệp, mỗi tệp 10 MB.

URL cơ sở: https://routerra.ai/v1
Khóa API: YOUR_PLATFORM_API_KEY
ID mô hình: 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