Démarrage rapide
De la clé API à la première réponse d'un modèle, en trois étapes.
Créer une clé API
Depuis la console Oreus, ou via l'API Third-Party avec le scope write:keys :
curl -X POST https://oreus-v1-dev.dev2.dev-id.fr/api/v1/external/keys/model \
-H "Authorization: Bearer $ORGANIZATION_TOKEN" \
-H "Content-Type: application/json" \
-d '{"name":"mon-service","modelIds":["<MODEL_ID>"]}'Une model key donne accès aux modèles listés, une agent key
(POST /keys/agent) aux agents
listés. La clé est renvoyée une seule fois : stockez-la comme un secret,
côté serveur.
Vérifier ce que la clé ouvre
curl https://oreus-v1-dev.dev2.dev-id.fr/api/v1/external/inference/models \
-H "Authorization: Bearer $OREUS_API_KEY"La réponse suit le format OpenAI ({ "object": "list", "data": [ { "id": … } ] }).
Les id sont les valeurs à passer dans model — des modèles pour une model
key, des agents pour une agent key.
Première réponse
Avec le SDK OpenAI, seule la baseURL change :
import OpenAI from 'openai';
const client = new OpenAI({
baseURL: 'https://oreus-v1-dev.dev2.dev-id.fr/api/v1/external/inference',
apiKey: process.env.OREUS_API_KEY,
});
const completion = await client.chat.completions.create({
model: '<MODEL_ID>',
messages: [{ role: 'user', content: 'Résume-moi la théorie de la relativité en trois phrases.' }],
});
console.log(completion.choices[0].message.content);Ou en cURL :
curl https://oreus-v1-dev.dev2.dev-id.fr/api/v1/external/inference/chat/completions \
-H "Authorization: Bearer $OREUS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"<MODEL_ID>","messages":[{"role":"user","content":"Bonjour !"}]}'L'appel est facturé à votre organisation. Pour le facturer à un utilisateur de
votre application, ajoutez son jeton d'organisation en en-tête
x-oreus-user-authorization — voir Qui paie ?.