OpenRouter에서 이전

계정 준비

설정 업데이트

API 호출 테스트

사용량 확인

이전 보상 신청

고급 안내

이 페이지의 내용

이 플랫폼

OpenAI 호환 연동 방식을 유지하세요. 엔드포인트, API 키, 모델을 변경하고 검증한 후 트래픽을 전환합니다.

이전 시작

API 키 만들기

OpenRouter 이전 보상

보상: 확인된 순사용액의 10%, 최대 500 USD. 승인 후 30일 이내에 크레딧이 지급됩니다.

더 알아보기

OpenAI 호환 API

전환 전 테스트

클라이언트 설정에 도움이 필요하신가요?

문서

로그인하거나 가입하고 잔액을 확인한 다음, 충분한 할당량과 대상 모델 접근 권한을 가진 활성 API 키를 만드세요. 키는 서버 환경에 저장하고 브라우저 코드에 넣지 마세요.

가입

지갑

모델 및 가격

설정 비교

설정

OpenRouter

기본 URL

API 키

이 플랫폼에서 발급한 새 키

모델 ID

모델 목록의 정확한 ID

모델 및 가격에서 정확한 모델 ID를 복사하거나 새 키로 GET /v1/models를 호출하세요. 공급자 접두사만 제거하면 된다고 가정하지 마세요. SDK 기본 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가 비어 있지 않은지 확인하세요.

사용량 로그에서 모델, 토큰, 청구 금액을 확인하세요. 같은 모델과 과금 단위로 가격을 비교하세요.

사용 로그

호환성 확인

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 기본 URL, 정확한 모델 ID, 지원 매개변수를 확인하세요. OpenRouter 전용 필드를 제거하고 최소 요청으로 다시 시도하세요.

오류 응답에서 잔액, 키 할당량, 속도 제한, 모델 가용성을 확인하세요. 일시적 오류는 대기 시간을 늘려 재시도하고, 잘못된 인증 정보나 잔액 부족 시 반복하지 마세요.

이전되는 항목

이 가이드는 API 설정을 이전합니다. OpenRouter 잔액, 키, 청구서, 사용 기록, 채팅 기록은 가져오지 않습니다. 클라이언트에서 대화를 백업하고 기존 플랫폼에서 청구를 처리하세요. 이전 보상은 별도 신청과 심사가 필요합니다.

참고 자료

OpenRouter 명세서 또는 청구서, 사용 내역, 이미지 및 서면 설명을 제출하세요. 인정 순사용액은 100 USD 이상이어야 합니다. 개인 또는 사업체당 순사용액의 10%, 최대 500 USD를 사용 전용 크레딧으로 받을 수 있으며, 환불하거나 출금할 수 없습니다. 각 독립 고객은 한 번만 참여할 수 있으며, 거절된 신청은 다시 제출할 수 있습니다. 승인 후 30일 이내에 크레딧이 지급됩니다.

순사용액에는 환불, 프로모션 크레딧 및 할인이 포함되지 않습니다. 최소 100 USD입니다.

PDF, JPG 또는 PNG. 최대 5개 파일, 파일당 10 MB.

기본 URL: 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