Migrer depuis OpenRouter

Préparer votre compte

Mettre à jour la configuration

Tester la connexion

Vérifier l’utilisation

Demander la récompense

Notes avancées

Sur cette page

Cette plateforme

Conservez votre intégration compatible OpenAI. Modifiez l’URL, la clé API et le modèle, puis validez avant de basculer le trafic.

Commencer la migration

Créer une clé API

Récompense de migration OpenRouter

Récompense : 10 % de la consommation nette vérifiée, plafonnée à 500 USD. Crédit sous 30 jours après approbation.

En savoir plus

API compatible OpenAI

Tester avant de basculer

Besoin d’aide pour votre client ?

Documents

Connectez-vous ou inscrivez-vous, vérifiez votre solde, puis créez une clé API active avec un quota suffisant et l’accès au modèle choisi. Conservez-la dans l’environnement du serveur, jamais dans le code du navigateur.

S’inscrire

Portefeuille

Modèles et tarifs

Comparaison des paramètres

Paramètre

OpenRouter

URL de base

Clé API

Nouvelle clé de cette plateforme

ID du modèle

ID exact du catalogue de modèles

Copiez l’ID exact depuis Modèles et tarifs ou appelez GET /v1/models avec votre nouvelle clé. Retirer le préfixe du fournisseur ne suffit pas forcément. L’URL du SDK se termine par /v1 ; pour les requêtes HTTP directes, ajoutez /chat/completions une seule fois.

Remplacez YOUR_PLATFORM_API_KEY et YOUR_MODEL_ID. Configurez d’abord les variables avec cURL sur macOS/Linux ou PowerShell sous Windows ; Python et Node.js utilisent les mêmes variables. Exécutez les exemples sur votre serveur ou dans un terminal local.

Vérifiez le code HTTP 200 et un contenu choices[0].message.content non vide pour la requête texte de base.

Vérifiez le modèle, les tokens et le montant dans les journaux d’utilisation. Comparez les tarifs pour un même modèle et les mêmes unités de facturation.

Journaux d'utilisation

Vérifier la compatibilité

Vérifier les fonctions propres à OpenRouter

Retirez les en-têtes d’attribution OpenRouter (HTTP-Referer, X-Title et X-OpenRouter-Title). Vérifiez provider, models, route, transforms, plugins et les suffixes tels que :free ; les règles de routage et de tarification ne sont pas transférées automatiquement.

Commencez par une requête Chat Completions en texte simple. Testez séparément les outils, le JSON, les images, le raisonnement et le streaming avec le modèle choisi. Si vous utilisez un SDK OpenRouter ou un préréglage client, passez à un client compatible OpenAI ou à une configuration personnalisée.

Valider et basculer le trafic

Activez stream: true et vérifiez les événements progressifs ainsi que la fin du flux dans votre client.

Basculez d’abord une petite part du trafic. Surveillez les erreurs et la latence avant d’augmenter. Conservez l’ancienne configuration pour revenir en arrière ; révoquez les clés inutilisées après validation.

Dépannage

Utilisez une clé de cette plateforme avec Authorization: Bearer. Vérifiez son état, son expiration, les restrictions IP et les autorisations du modèle.

Vérifiez l’URL /v1, l’ID exact du modèle et les paramètres pris en charge. Retirez les champs propres à OpenRouter et réessayez avec une requête minimale.

Vérifiez le solde, le quota, les limites de débit et la disponibilité du modèle dans la réponse d’erreur. Espacez les tentatives en cas de panne temporaire ; ne répétez pas les requêtes avec une clé invalide ou un solde insuffisant.

Que peut-on transférer ?

Ce guide migre la configuration API. Le solde, les clés, les factures, l’historique d’utilisation et les conversations OpenRouter ne sont pas importés. Sauvegardez vos conversations dans le client et gérez les factures sur la plateforme d’origine. Toute récompense de migration nécessite une demande distincte, soumise à examen.

Références

Soumettez des relevés ou factures OpenRouter, le détail de consommation, des images et une explication écrite. La consommation nette admissible doit atteindre 100 USD. Recevez 10 %, jusqu’à 500 USD par particulier ou entreprise, en crédit utilisable uniquement pour les services, non remboursable et non retirable. Chaque client indépendant ne peut participer qu’une fois ; une demande refusée peut être soumise à nouveau. Le crédit est versé sous 30 jours après approbation.

La consommation nette exclut remboursements, crédits offerts et remises. Minimum : 100 USD.

PDF, JPG ou PNG. 5 fichiers maximum, 10 Mo chacun.

URL de base
https://routerra.ai/v1
Clé API
YOUR_PLATFORM_API_KEY
ID du modèle
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