Sur cette page
Authentification
Tous les points de terminaison exigent un jeton Bearer. Incluez votre clé API dans l’en-tête Authorization de chaque requête.
curl https://api.augureai.ca/v1/models \
-H "Authorization: Bearer YOUR_API_KEY"Modèles
Sept modèles, plus un alias auto qui achemine chaque requête vers le meilleur modèle disponible. Le contexte est la fenêtre d’entrée; la sortie max est le plafond de jetons de complétion propre à chaque modèle.
| Modèle | Contexte | Sortie max | Idéal pour |
|---|---|---|---|
auto | — | — | Laisser la passerelle choisir à chaque requête; entrées avec images |
ossington-5 | 256K | 32 768 | Le plus récent modèle de raisonnement, le plus rapide des paliers de raisonnement. Code, sorties structurées, analyse générale |
rosedale-1 | 1M | 32 768 | Raisonnement haut de gamme, contexte très étendu. Analyse de documents entiers, appel d'outils fiable et boucles d'agent |
ossington-4 | 256K | 32 768 | Modèle de raisonnement phare. Analyse complexe, synthèse, tâches en plusieurs étapes |
ossington-4-1 | 256K | 32 768 | Raisonnement haut de gamme sur une infrastructure canadienne. Outils, très bon en anglais et en français |
tofino-3 | 256K | 16 384 | Palier léger, réflexion toujours désactivée, servi au Canada sans jamais basculer hors du Canada. Traduction, extraction, classification, clavardage |
open-glm-5-3 | 256K | 49 152 | Augure Open (aperçu) : poids ouverts de GLM-5.3, messages transmis au modèle tels qu'envoyés, texte seulement, Canada seulement |
open-qwen-3.8-flash-next | 256K | 32 768 | Augure Open (aperçu) : poids ouverts de Qwen3.8-Flash-Next, messages transmis au modèle tels qu'envoyés, texte seulement, Canada seulement |
ossington-4-1 : si son infrastructure canadienne est indisponible, la requête est servie par ossington-5 et la réponse l’indique (_augure.fallback est présent et model nomme le modèle qui a répondu). Les comptes exclusivement canadiens restent au Canada ou échouent proprement.
La fenêtre de 1M de rosedale-1 est offerte à toutes les clés développeur. Utilisez stream: true pour les très grosses entrées : une invite proche de la limite peut prendre quelques minutes avant le premier jeton.
ossington-3 a été retiré le 2026-10-15 et remplacé par rosedale-1. tofino-2.5 a été retiré le 2026-09-19 et remplacé par tofino-3. Après la date de retrait, une clé développeur qui demande l’ancien identifiant reçoit 400 model_retired, avec le nom du remplaçant dans le message. Voir Cycle de vie des modèles.gpt-4 et gpt-4o correspondent à ossington-4; gpt-4o-mini et gpt-3.5-turbo correspondent à tofino-3.Complétions de clavardage
/v1/chat/completionsCrée une complétion de clavardage. Accepte le même format de requête que le point de terminaison de complétions de clavardage d’OpenAI.
Paramètres
| Champ | Type | Requis | Description |
|---|---|---|---|
model | string | Oui | Identifiant du modèle (voir Modèles) |
messages | array | Oui | Objets message : texte, images ou fichiers (voir plus bas) |
stream | boolean | Non | Diffuse la réponse en continu sous forme d'événements SSE. Par défaut : false |
stream_options | object | Non | {"include_usage": true} ajoute un dernier fragment de consommation avant [DONE] |
temperature | number | Non | Température d'échantillonnage (0,0 à 2,0) |
top_p | number | Non | Seuil d'échantillonnage par noyau (nucleus sampling) |
seed | number | Non | Graine d’échantillonnage déterministe. temperature: 0 combiné à une seed fixe maximise la reproductibilité d’une exécution à l’autre |
max_tokens | number | Non | Nombre maximal de jetons de sortie (plafond global de 32 768). Omettez-le sur les modèles de raisonnement; voir Raisonnement |
reasoning_effort | string | Non | none, minimal, low, medium ou high sur les modèles de raisonnement; voir Raisonnement |
response_format | object | Non | {"type": "json_object"} ou {"type": "json_schema", ...}. Sur les modèles de raisonnement, il est appliqué au moyen d’une directive dans l’invite : validez le résultat analysé et réessayez une fois en cas d’échec. Incompatible avec tools sur ces modèles |
stop | string | array | Non | Séquence(s) d'arrêt |
tools | array | Non | Fonctions que le modèle peut appeler; voir Utilisation d'outils |
tool_choice | string | object | Non | none, auto (par défaut lorsque tools est fourni), required, ou une fonction précise |
parallel_tool_calls | boolean | Non | Permet plusieurs appels d'outils dans un même tour. Par défaut : true |
Chaque message a un role (system, user, assistant ou tool) et un content qui est une chaîne, un tableau de parties (texte, image_url, file), ou null lorsque le message de l’assistant contient tool_calls.
Fenêtres de contexte. Chaque modèle de clavardage accepte un contexte de 256K jetons; rosedale-1 accepte jusqu’à 1M (1 048 576 jetons). max_tokens ne plafonne que la sortie. Une invite qui dépasse la fenêtre du modèle renvoie 400 context_length_exceeded. Vérifiez toujours finish_reason : "length" signifie que le budget de sortie est épuisé et que la réponse est tronquée.
Exemple de requête
curl -X POST https://api.augureai.ca/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "ossington-5",
"messages": [
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "What is the Civil Code of Quebec?"}
]
}'Exemple de réponse
{
"id": "chatcmpl-a9adf17e-5ff3-4804-b01e-f7cbd30ae996",
"object": "chat.completion",
"created": 1771286577,
"model": "ossington-5",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "The Civil Code of Quebec (Code civil du Québec) is..."
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 24,
"completion_tokens": 150,
"total_tokens": 174
},
"_augure": {
"gateway_region": "ca-montreal-1",
"inference_region": "ca-on-toronto",
"request_id": "a9adf17e-5ff3-4804-b01e-f7cbd30ae996"
}
}Consommation et coût
Chaque réponse contient un objet usage avec prompt_tokens, completion_tokens et total_tokens; multipliez ces valeurs par les tarifs de chaque modèle indiqués sur la page développeurs pour établir le coût d’un appel. Votre tableau de bord développeur affiche les mêmes chiffres par modèle, par jour et par clé, avec le coût en dollars canadiens. Le texte extrait d’un PDF joint compte comme jetons d’entrée, comme toute autre entrée.
Raisonnement
ossington-5, ossington-4, ossington-4-1 et rosedale-1 réfléchissent avant de répondre. La réflexion est renvoyée séparément dans reasoning_content (delta.reasoning_content en mode continu), de sorte que content reste une réponse finale propre. Les clients qui ne reconnaissent pas reasoning_content peuvent simplement l’ignorer.
La réflexion consomme l’essentiel du budget de sortie : un max_tokens trop serré peut tronquer la réponse visible. Omettez max_tokens sur ces modèles, ou fixez-le au maximum du modèle.
Désactiver la réflexion
Pour les tâches mécaniques courtes (correction, extraction, classification, reformatage), envoyez "reasoning_effort": "none" sur ossington-5, ossington-4 ou ossington-4-1. Le modèle répond immédiatement, sans reasoning_content, habituellement de 10 à 50 fois plus vite, et seuls les jetons de la réponse visible sont facturés.
{
"model": "ossington-5",
"reasoning_effort": "none",
"messages": [
{"role": "user", "content": "Fix the typos: 'Teh contract was sined on Tuesady.'"}
]
}Sur rosedale-1, envoyez plutôt "low" : ce modèle n’offre pas de véritable mode sans réflexion, et un "none" est traité comme "low". Pour un raisonnement difficile en plusieurs étapes, n’indiquez pas ce champ. tofino-3 fonctionne toujours sans réflexion et ignore ce champ.
Réponse en continu (streaming)
Indiquez "stream": true pour recevoir des événements SSE (Server-Sent Events). Chaque événement est un fragment JSON dont l’objet delta contient le contenu incrémental; le flux se termine par data: [DONE]. Ajoutez "stream_options": {"include_usage": true} pour recevoir, juste avant, un dernier fragment contenant l’objet usage (avec choices vide).
curl -N -X POST https://api.augureai.ca/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "tofino-3",
"messages": [{"role": "user", "content": "Hello"}],
"stream": true,
"stream_options": {"include_usage": true}
}'Erreurs à l’intérieur d’un flux
Une réponse en continu confirme HTTP 200 avant la fin de la génération; un échec en cours de route est donc transmis à l’intérieur du flux sous forme d’un événement d’erreur, suivi de data: [DONE] :
data: {"error":{"message":"This conversation is too long for the model. Start a new session or shorten your message, then try again.","type":"upstream_error","code":"context_length_exceeded"}}
data: [DONE]- Tout événement qui contient un objet
errorau premier niveau signifie que le tour a échoué; affichezerror.code. - Un flux qui se termine sans
finish_reasonet sans événement d’erreur a perdu sa connexion : traitez-le comme un échec, pas comme une réponse vide. - Réessayez
quota_exceededetcapacity_exceededavec un délai croissant; ne réessayez jamaiscontext_length_exceeded(réduisez l’entrée). Une erreur reçue avant tout contenu signifie que rien n’a été généré : un nouvel essai est alors toujours sans risque. - Les longues invites peuvent produire des lignes de commentaire SSE (
: keepalive); les analyseurs SSE standard les ignorent.
Images et documents
content peut être un tableau de parties. En plus des parties text, un message utilisateur peut contenir des parties image_url et file, chacune sous forme d’URL de données (data URL) en base64. Les requêtes restent en JSON simple : il n’existe aucun point de terminaison multipart/form-data.
Images
Les images fonctionnent avec n’importe quel modèle. Avec model: "auto", la passerelle achemine l’image vers notre moteur de vision, qui s’exécute sur des serveurs exploités par Augure à Calgary (inference_region: ca-ab-calgary). Si vous choisissez un autre modèle, l’image est d’abord convertie en texte, puis transmise à ce modèle. Les formats PNG, JPEG, WebP et GIF (première image seulement) sont acceptés, plusieurs par message. N’envoyez pas d’image dans une partie file : elle serait refusée avec 400 invalid_attachment.
curl -X POST https://api.augureai.ca/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "auto",
"messages": [{
"role": "user",
"content": [
{"type": "text", "text": "Extract all text from this image, preserving layout as Markdown."},
{"type": "image_url", "image_url": {"url": "data:image/jpeg;base64,/9j/4AAQSkZJRg..."}}
]
}]
}'Pour obtenir uniquement le texte, mot pour mot, sans description, ajoutez "augure_ocr": true à la partie image :
{ "type": "image_url", "image_url": { "url": "data:image/png;base64,iVBOR..." }, "augure_ocr": true }PDF et feuilles de calcul
Une partie file transporte un PDF, qui est lu par la passerelle : la couche texte est extraite directement, et les documents numérisés passent automatiquement par l’OCR. Envoyez le PDF lui-même plutôt que de le convertir en image : vous conservez le texte exact, et cela fonctionne avec tous les modèles.
curl -X POST https://api.augureai.ca/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "ossington-5",
"messages": [{
"role": "user",
"content": [
{"type": "text", "text": "Extract the invoice number, date, vendor and total as JSON."},
{"type": "file", "file": {
"filename": "invoice-2041.pdf",
"file_data": "data:application/pdf;base64,JVBERi0xLjQK..."
}}
]
}]
}'import base64
from openai import OpenAI
client = OpenAI(api_key="YOUR_API_KEY", base_url="https://api.augureai.ca/v1")
pdf = base64.b64encode(open("invoice-2041.pdf", "rb").read()).decode()
response = client.chat.completions.create(
model="ossington-5",
messages=[{
"role": "user",
"content": [
{"type": "text", "text": "Extract the invoice number, date, vendor and total as JSON."},
{"type": "file", "file": {
"filename": "invoice-2041.pdf",
"file_data": f"data:application/pdf;base64,{pdf}",
}},
],
}],
)
print(response.choices[0].message.content)Lorsque la mise en page, les tableaux, les signatures ou les tampons comptent, indiquez "augure_render": "image" dans la partie fichier avec model: "auto" : chaque page est convertie en image et transmise au moteur de vision (50 pages au maximum; ce mode consomme nettement plus de jetons que le mode texte). Un modèle de clavardage choisi explicitement revient à l’extraction de texte.
{
"type": "file",
"file": {
"filename": "contract.pdf",
"file_data": "data:application/pdf;base64,JVBERi0xLjQK...",
"augure_render": "image"
}
}Chaque PDF peut atteindre 25 Mo et 200 pages, dans la limite d’un corps de requête de 35 Mo (après l’encodage base64). Une partie file accepte aussi les feuilles de calcul (URL de données .xlsx ou .csv; les 100 premières lignes de chaque feuille). La passerelle ne conserve aucune copie d’un fichier une fois la requête terminée.
Liste des modèles
/v1/modelsRenvoie les modèles accessibles avec votre clé.
curl https://api.augureai.ca/v1/models \
-H "Authorization: Bearer YOUR_API_KEY"{
"object": "list",
"data": [
{ "id": "auto", "object": "model", "owned_by": "augure" },
{ "id": "rosedale-1", "object": "model", "owned_by": "augure" },
{ "id": "ossington-4-1", "object": "model", "owned_by": "augure" },
{ "id": "ossington-5", "object": "model", "owned_by": "augure" },
{ "id": "ossington-4", "object": "model", "owned_by": "augure" },
{ "id": "tofino-3", "object": "model", "owned_by": "augure" }
]
}Recherche Web
/v1/searchEffectue une recherche sur le Web public au moyen de la recherche autohébergée d’Augure. Il s’agit d’un point de terminaison autonome : /v1/chat/completions ne l’appelle pas, et il n’existe aucun outil intégré de recherche Web. Pour ancrer un modèle dans des résultats à jour, appelez vous-même /v1/search et transmettez les résultats dans votre message suivant.
| Champ | Type | Requis | Description |
|---|---|---|---|
query | string | Oui | Requête de recherche |
count | number | Non | Nombre de résultats, de 1 à 20. Par défaut : 5 |
lang | string | Non | en ou fr (correspondent à en-CA / fr-CA). Par défaut : en |
curl -X POST https://api.augureai.ca/v1/search \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "query": "Quebec Law 25 enforcement 2026", "count": 5, "lang": "en" }'{
"results": [
{ "title": "…", "url": "https://…", "description": "…" }
]
}Erreurs : 400 requête vide ou absente · 503 recherche non configurée · 502 / 504 erreur ou délai dépassé en amont.
Lecture de liens
Lorsque votre dernier message utilisateur contient une URL, Augure récupère la page côté serveur et en transmet le texte au modèle : vous pouvez ainsi poser une question sur une page sans en coller le contenu. Le HTML est converti en Markdown propre; le texte des PDF liés est extrait (avec l’OCR en solution de rechange). La lecture de liens suit les URL que vous fournissez; elle n’effectue pas de recherche.
Les liens lus sont signalés sous _augure.fetched_urls, ce qui permet à un client d’afficher ses sources :
"_augure": {
"fetched_urls": [
{ "url": "https://…", "title": "…", "ok": true, "kind": "html" }
]
}La récupération est encadrée (quelques URL par message, plafonds de taille et de durée) et échoue en douceur : un lien illisible ne fait jamais échouer la requête; le modèle est simplement informé que la page n’a pas pu être lue.
Mémoires
Un espace de mémoire à long terme par utilisateur, la même mémoire que celle des applications Augure. Ces points de terminaison exigent une clé associée à un compte utilisateur; une clé sans utilisateur associé renvoie 401.
| Méthode | Chemin | Corps | Résultat |
|---|---|---|---|
GET | /v1/memories | — | { "memories": [ { "id", "content", "createdAt", ... } ] } |
POST | /v1/memories | { "content": "…" } | { "success": true, "id": "…" } |
PATCH | /v1/memories | { "id": "…", "content": "…" } | { "success": true } |
DELETE | /v1/memories | { "id": "…" } | { "success": true } |
Le contenu d’une mémoire compte de 1 à 2 000 caractères.
curl -X POST https://api.augureai.ca/v1/memories \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "content": "Client prefers responses in French." }'Utilisation d'outils
Augure accepte le schéma tools (appel de fonctions, ou function calling) compatible avec OpenAI, avec ou sans mode continu. Pour un appel d’outils structuré et fiable et pour les boucles d’agent, utilisez rosedale-1, avec reasoning_effort: "low" lorsque vous voulez des appels d’outils avec un minimum de réflexion. ossington-4-1 appelle aussi très bien les outils lorsque vous avez besoin d’une analyse plus approfondie dans la boucle. tofino-3 convient aux appels simples en une seule étape, pas aux boucles d’agent en plusieurs étapes. Si votre application pilote une boucle d’agent, choisissez explicitement rosedale-1 plutôt que de vous fier à auto.
Lorsque le modèle appelle un outil, finish_reason vaut "tool_calls" et le message de l’assistant contient tool_calls[]. Exécutez la fonction vous-même, ajoutez un message role: "tool" avec le résultat, puis appelez l’API de nouveau.
curl -X POST https://api.augureai.ca/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "rosedale-1",
"reasoning_effort": "low",
"messages": [
{"role": "user", "content": "What grants is my client eligible for?"}
],
"tools": [{
"type": "function",
"function": {
"name": "search_grant_programs",
"description": "Search the grant database by client profile",
"parameters": {
"type": "object",
"properties": {
"discipline": {"type": "string"},
"province": {"type": "string"}
},
"required": ["discipline"]
}
}
}]
}'{
"choices": [{
"index": 0,
"message": {
"role": "assistant",
"content": null,
"tool_calls": [{
"id": "call_abc123",
"type": "function",
"function": {
"name": "search_grant_programs",
"arguments": "{\"discipline\":\"visual arts\",\"province\":\"QC\"}"
}
}]
},
"finish_reason": "tool_calls"
}]
}{
"model": "rosedale-1",
"messages": [
{"role": "user", "content": "What grants is my client eligible for?"},
{"role": "assistant", "content": null, "tool_calls": [/* ...from previous response... */]},
{"role": "tool", "tool_call_id": "call_abc123", "name": "search_grant_programs", "content": "[{\"id\":\"CALQ-2026\",\"name\":\"...\"}]"}
],
"tools": [/* same tools array */]
}En mode continu : les appels d’outils arrivent sous forme de deltas dans choices[0].delta.tool_calls[], avec un champ index; concaténez les fragments function.arguments pour chaque index, puis lancez l’appel lorsque finish_reason: "tool_calls" arrive. Les appels parallèles sont activés par défaut; indiquez parallel_tool_calls: false pour un seul appel par tour.
tools ordinaires. Tout client compatible MCP qui accepte une URL de base personnalisée compatible OpenAI fonctionne avec Augure. Pour utiliser les outils d’Augure dans un assistant, consultez le serveur MCP.Métadonnées Augure
Chaque réponse contient un bloc _augure qui fournit des renseignements d’acheminement et de traçabilité.
| Champ | Description |
|---|---|
gateway_region | Région de la passerelle API (ca-montreal-1, OVHcloud) |
inference_region | Lieu de l’inférence, p. ex. ca-on-toronto ou ca-ab-calgary |
request_id | Identifiant unique de la requête, aussi dans l’en-tête X-Request-ID. Consignez-le : le soutien technique s’en sert pour retrouver une requête qui a échoué |
fetched_urls | Liens lus; voir Lecture de liens |
fallback / fallback_reason | Présents seulement lorsque le tour n'a pas été servi par la capacité principale du modèle, avec la raison |
fallback_context | Rare : "truncated" lorsqu’une conversation de plus de 256K a été servie avec une partie du contenu central omise; traitez la réponse comme partielle |
auto_routed / auto_route_reason | Avec model: "auto" : le modèle choisi par le routeur, et pourquoi |
deprecation | Sur un modèle dont le retrait est prévu : { model, retires_at, replacement, message } |
retired | Lorsqu'un identifiant retiré a été servi par son remplaçant (par exemple l'alias gpt-4o-mini) |
outbound_filter | Présent seulement lorsque le filtre de liens sortants a retiré quelque chose; nombre d'éléments par règle |
Filtre de liens sortants
Un texte que le modèle lit mais que vous n’avez pas écrit (une pièce jointe, une page récupérée, un tour précédent) peut tenter de lui faire produire une image ou un lien dont l’URL transporte des données de la conversation. La passerelle réécrit donc la sortie de l’assistant : les images distantes hors des domaines d’Augure deviennent [image removed: external image], et les liens dont l’URL contient un identifiant tiré de la conversation ou un long jeton opaque deviennent [link removed: may contain conversation data]. Les liens ordinaires, et ceux que vous avez collés vous-même, sont renvoyés tels quels. Si votre intégration a besoin d’images distantes dans la sortie du modèle (par exemple depuis votre propre CDN), communiquez avec le soutien technique pour faire autoriser un hôte.
Bibliothèques client
Utilisez n’importe quel SDK compatible OpenAI. Indiquez https://api.augureai.ca/v1 comme URL de base.
from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://api.augureai.ca/v1"
)
response = client.chat.completions.create(
model="ossington-5",
messages=[
{"role": "user", "content": "Explain Quebec privacy law"}
]
)
print(response.choices[0].message.content)import OpenAI from "openai";
const client = new OpenAI({
apiKey: "YOUR_API_KEY",
baseURL: "https://api.augureai.ca/v1",
});
const response = await client.chat.completions.create({
model: "tofino-3",
messages: [{ role: "user", content: "Summarize PIPEDA" }],
});
console.log(response.choices[0].message.content);stream = client.chat.completions.create(
model="rosedale-1",
messages=[{"role": "user", "content": "Hello"}],
stream=True
)
for chunk in stream:
content = chunk.choices[0].delta.content
if content:
print(content, end="", flush=True)Limites de débit et quotas
Débit de requêtes, par clé API. Les réponses aux clés développeur contiennent les en-têtes X-RateLimit-Limit et X-RateLimit-Remaining; une réponse 429 contient aussi Retry-After (en secondes).
| Palier | Requêtes / min |
|---|---|
standard (par défaut) | 60 |
elevated | 200 |
unlimited | 1 000 |
ossington-4 est en plus soumis à un plafond strict de 10 requêtes par minute, quel que soit le palier. Communiquez avec nous pour faire passer une clé à un palier supérieur.
Concurrence. Chaque clé développeur peut avoir 20 requêtes en cours à la fois par défaut (429 concurrency_limit_exceeded au-delà), et chaque compte dispose d’une part de la capacité principale de chaque modèle, calculée sur l’ensemble de ses clés. Au-delà de cette part, une requête est servie par la capacité de relève du modèle lorsqu’il y a de la place, ou refusée avec 429 capacity_exceeded et Retry-After.
Plafond de dépense quotidien. Les clés développeur ont un plafond strict de 100 $ CA par jour (25 $ CA par jour jusqu’au premier paiement réussi du compte), pondéré selon le modèle. Au-delà du plafond, les requêtes renvoient 429 quota_exceeded. Le compteur est remis à zéro à 00 h 00 UTC; communiquez avec le soutien technique pour le relever.
Limites
Corps de la requête
35 Mo max
Pièce jointe PDF
25 Mo / 200 pages
Messages par requête
256 max
Jetons de sortie max
32 768 (tofino-3 : 16 384)
Temps de réponse, sans mode continu
~240 s, puis 504
Traitement de l'invite, en continu
jusqu'à 12 min
Pour les grosses entrées, utilisez stream: true : une réponse en continu reste active grâce aux signaux de maintien (keepalive) pendant le traitement d’une longue invite.
Équipes et laboratoires
Un seul compte développeur sert toute une équipe. Le ou la titulaire du compte crée une clé par personne, l’utilisation et le coût s’affichent par clé, et une seule limite de dépenses mensuelle couvre l’ensemble. La facturation est à l’usage, en dollars canadiens, sans frais par siège ni minimum. Sur un compte avec un forfait Ultra, les clés puisent dans l’allocation partagée de ce forfait au lieu d’être facturées à l’usage, et s’arrêtent lorsqu’elle est épuisée.
| Ce que vous obtenez | Où |
|---|---|
| Une clé nommée par personne (jusqu'à 50 clés actives par compte) | Tableau de bord → Aperçu |
| L'utilisation et le coût par clé, par modèle et par jour | Tableau de bord → Utilisation |
| Une limite de dépenses mensuelle pour le compte, avec avertissements à 75, 90 et 100 % | Tableau de bord → Facturation |
| Le traitement au Canada seulement, appliqué une fois au niveau du compte à toutes les clés, présentes et futures | Tableau de bord → Paramètres → Inférence au Canada seulement |
Le contexte long complet de rosedale-1, le même que dans les applications | Aucune configuration |
rosedale-1; le guide IDE donne la configuration. OpenCode, Continue et Cline se connectent directement.Erreurs
Toutes les erreurs renvoient un objet JSON avec un champ error, selon le format d’erreur d’OpenAI. param nomme le champ fautif s’il y a lieu.
{
"error": {
"message": "Invalid API key provided",
"type": "invalid_request_error",
"param": null,
"code": "invalid_api_key"
}
}| Statut | code | Quand | Réessayer? |
|---|---|---|---|
| 400 | invalid_json · missing_field · invalid_value · invalid_attachment | Requête mal formée, ou partie fichier non prise en charge ou trop volumineuse | Non : corrigez la requête |
| 400 | context_length_exceeded | L'invite dépasse la fenêtre de contexte du modèle | Non : réduisez l’entrée ou utilisez rosedale-1 |
| 400 | model_retired | L'identifiant du modèle a été retiré; le message nomme son remplaçant | Non |
| 401 | invalid_api_key | Clé API absente ou non reconnue | Non |
| 402 | billing_inactive | La facturation du compte n'est pas en règle (aucune carte ou paiement en retard) | Non |
| 404 | model_not_found · not_found | Modèle ou point de terminaison inconnu | Non |
| 413 | request_too_large | Corps de la requête supérieur à 35 Mo | Non |
| 429 | rate_limit_exceeded · quota_exceeded | Débit par minute dépassé; plafond de dépense ou quota de jetons atteint; ou capacité partagée temporairement épuisée | Oui : respectez Retry-After, augmentez le délai |
| 429 | concurrency_limit_exceeded | Trop de requêtes en cours pour cette clé | Oui, quand l'une d'elles se termine |
| 429 | capacity_exceeded | Le modèle est à pleine capacité pour votre compte et sa capacité de relève est pleine | Oui : respectez Retry-After |
| 503 | residency_unavailable | Compte exclusivement canadien : capacité canadienne indisponible, requête servie nulle part ailleurs | Oui : respectez Retry-After |
| 500 | internal_error · server_error | Erreur interne | Oui, une fois |
| 502 | upstream_error · empty_completion | Erreur d'inférence en amont, ou le modèle n'a rien renvoyé | Oui, avec un délai croissant |
| 504 | timeout | Une requête sans mode continu a dépassé environ 240 s | Utilisez stream: true ou une entrée plus petite |
Les requêtes en mode continu transmettent les échecs survenus en cours de génération à l’intérieur du flux, avec ces mêmes codes; voir Erreurs à l’intérieur d’un flux.
Versions
L’API est versionnée par le préfixe de chemin /v1. Les changements additifs (nouveaux champs de réponse, nouveaux modèles, nouveaux paramètres facultatifs) sont publiés sans changement de version; les clients doivent donc ignorer les champs qu’ils ne reconnaissent pas. Tout changement incompatible serait publié sous un nouveau préfixe et annoncé à l’avance aux développeurs inscrits.
Consultez le journal des modifications pour les changements datés, et le cycle de vie des modèles pour les dates de retrait et les remplaçants.