Documentation développeur

API Augure

API de complétions de clavardage compatible OpenAI, avec résidence des données au Canada. Jamais acheminée vers des fournisseurs américains.

URL de base : https://api.augureai.ca

Acheminement et résidence des données

Toutes les requêtes API entrent par notre passerelle à Beauharnois, au Québec. L’inférence s’exécute sur une infrastructure canadienne ainsi que chez des partenaires vérifiés de l’Union européenne, dans le cadre d’ententes de non-conservation des données, et n’est jamais acheminée vers des fournisseurs aux États-Unis. Certains paliers de modèles, ainsi que le basculement lors de pannes ou de périodes de forte demande, sont servis par les partenaires de l’Union européenne; d’autres s’exécutent au Canada. Une réponse qui n’a pas été servie par la capacité principale du modèle l’indique dans _augure.fallback. La lecture d’images et la synthèse vocale s’exécutent sur des serveurs GPU gérés par Augure à Calgary, en Alberta. Les invites sont chiffrées en transit (TLS 1.2+), jamais journalisées par Augure et jamais utilisées pour l’entraînement de modèles.

Les comptes qui exigent que chaque requête reste au Canada peuvent activer l'inférence au Canada seulement dans le tableau de bord développeur (Paramètres) : les requêtes restent alors au Canada ou échouent avec 503 residency_unavailable, sans jamais être servies ailleurs. GET /v1/limits l'indique dans residency.

Passerelle canadienneBasculement UE divulguéJamais de fournisseurs américainsAucune journalisation des invites
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.

Exemple
curl https://api.augureai.ca/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"
Obtenir une clé : Les clés sont en libre-service. Connectez-vous au tableau de bord développeur, ajoutez un mode de paiement, puis générez une clé. Elle n’est affichée qu’une seule fois : conservez-la en lieu sûr. L’utilisation est mesurée et facturée chaque mois en dollars canadiens, et vous pouvez fixer une limite de dépense mensuelle dans l’onglet Facturation du tableau de bord.
REST ou MCP? Cette API sert aux logiciels que vous développez. Si vous voulez utiliser Augure dans un assistant que vous employez déjà (par exemple Claude Code), connectez plutôt le serveur MCP. Les deux sont facturés au même compte développeur, aux mêmes tarifs.

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èleContexteSortie maxIdéal pour
auto——Laisser la passerelle choisir à chaque requête; entrées avec images
ossington-5256K32 768Le plus récent modèle de raisonnement, le plus rapide des paliers de raisonnement. Code, sorties structurées, analyse générale
rosedale-11M32 768Raisonnement haut de gamme, contexte très étendu. Analyse de documents entiers, appel d'outils fiable et boucles d'agent
ossington-4256K32 768Modèle de raisonnement phare. Analyse complexe, synthèse, tâches en plusieurs étapes
ossington-4-1256K32 768Raisonnement haut de gamme sur une infrastructure canadienne. Outils, très bon en anglais et en français
tofino-3256K16 384Palier léger, réflexion toujours désactivée, servi au Canada sans jamais basculer hors du Canada. Traduction, extraction, classification, clavardage
open-glm-5-3256K49 152Augure 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-next256K32 768Augure 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.

Retraits : 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.
Compatibilité OpenAI : les alias gpt-4 et gpt-4o correspondent à ossington-4; gpt-4o-mini et gpt-3.5-turbo correspondent à tofino-3.

Complétions de clavardage

POST/v1/chat/completions

Cré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

ChampTypeRequisDescription
modelstringOuiIdentifiant du modèle (voir Modèles)
messagesarrayOuiObjets message : texte, images ou fichiers (voir plus bas)
streambooleanNonDiffuse la réponse en continu sous forme d'événements SSE. Par défaut : false
stream_optionsobjectNon{"include_usage": true} ajoute un dernier fragment de consommation avant [DONE]
temperaturenumberNonTempérature d'échantillonnage (0,0 à 2,0)
top_pnumberNonSeuil d'échantillonnage par noyau (nucleus sampling)
seednumberNonGraine d’échantillonnage déterministe. temperature: 0 combiné à une seed fixe maximise la reproductibilité d’une exécution à l’autre
max_tokensnumberNonNombre maximal de jetons de sortie (plafond global de 32 768). Omettez-le sur les modèles de raisonnement; voir Raisonnement
reasoning_effortstringNonnone, minimal, low, medium ou high sur les modèles de raisonnement; voir Raisonnement
response_formatobjectNon{"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
stopstring | arrayNonSéquence(s) d'arrêt
toolsarrayNonFonctions que le modèle peut appeler; voir Utilisation d'outils
tool_choicestring | objectNonnone, auto (par défaut lorsque tools est fourni), required, ou une fonction précise
parallel_tool_callsbooleanNonPermet 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
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

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.

Corps de la requête
{
  "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).

Requête en continu
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] :

Événement d'erreur
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 error au premier niveau signifie que le tour a échoué; affichez error.code.
  • Un flux qui se termine sans finish_reason et sans événement d’erreur a perdu sa connexion : traitez-le comme un échec, pas comme une réponse vide.
  • Réessayez quota_exceeded et capacity_exceeded avec un délai croissant; ne réessayez jamais context_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.

Lire une image
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 :

OCR pur
{ "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.

Pièce jointe PDF
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..."
        }}
      ]
    }]
  }'
Python
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.

Rendu des pages en images
{
  "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

GET/v1/models

Renvoie les modèles accessibles avec votre clé.

curl
curl https://api.augureai.ca/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"
Réponse
{
  "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" }
  ]
}
POST/v1/search

Effectue 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.

ChampTypeRequisDescription
querystringOuiRequête de recherche
countnumberNonNombre de résultats, de 1 à 20. Par défaut : 5
langstringNonen ou fr (correspondent à en-CA / fr-CA). Par défaut : en
curl
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" }'
Réponse
{
  "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.

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 :

Extrait de réponse
"_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éthodeCheminCorpsRé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.

Ajouter une mémoire
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.

Requête avec outils
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"]
        }
      }
    }]
  }'
Réponse : le modèle appelle l'outil
{
  "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"
  }]
}
Requête de suivi avec le résultat
{
  "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.

Outils et MCP : l’API ne se connecte pas elle-même aux serveurs MCP; MCP relève du client (l’« hôte MCP »), qui présente ses outils MCP au modèle comme des entrées 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é.

ChampDescription
gateway_regionRégion de la passerelle API (ca-montreal-1, OVHcloud)
inference_regionLieu de l’inférence, p. ex. ca-on-toronto ou ca-ab-calgary
request_idIdentifiant 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_urlsLiens lus; voir Lecture de liens
fallback / fallback_reasonPrésents seulement lorsque le tour n'a pas été servi par la capacité principale du modèle, avec la raison
fallback_contextRare : "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_reasonAvec model: "auto" : le modèle choisi par le routeur, et pourquoi
deprecationSur un modèle dont le retrait est prévu : { model, retires_at, replacement, message }
retiredLorsqu'un identifiant retiré a été servi par son remplaçant (par exemple l'alias gpt-4o-mini)
outbound_filterPrésent seulement lorsque le filtre de liens sortants a retiré quelque chose; nombre d'éléments par règle

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.

Python
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)
JavaScript / TypeScript
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);
Streaming (Python)
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).

PalierRequêtes / min
standard (par défaut)60
elevated200
unlimited1 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 obtenezOù
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 jourTableau 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 futuresTableau de bord → Paramètres → Inférence au Canada seulement
Le contexte long complet de rosedale-1, le même que dans les applicationsAucune configuration
Les jetons de forfait ne sont pas des clés d'équipe : les jetons « Connecter un outil de code » des forfaits Max et Ultra sont personnels : cinq par compte, conçus pour les appareils d’une même personne, et ils puisent tous dans l’allocation hebdomadaire de ce seul abonnement. Pour un groupe, donnez à chaque personne une clé développeur sur le compte de l’équipe, ou son propre siège Max ou Ultra : Ultra est maintenant offert, lui aussi, en siège d’équipe sur Augure pour les équipes.
Claude Code : Augure ne sert pas l’API Messages d’Anthropic. Claude Code atteint Augure par un mandataire LiteLLM avec 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.

Réponse d'erreur
{
  "error": {
    "message": "Invalid API key provided",
    "type": "invalid_request_error",
    "param": null,
    "code": "invalid_api_key"
  }
}
StatutcodeQuandRéessayer?
400invalid_json · missing_field · invalid_value · invalid_attachmentRequête mal formée, ou partie fichier non prise en charge ou trop volumineuseNon : corrigez la requête
400context_length_exceededL'invite dépasse la fenêtre de contexte du modèleNon : réduisez l’entrée ou utilisez rosedale-1
400model_retiredL'identifiant du modèle a été retiré; le message nomme son remplaçantNon
401invalid_api_keyClé API absente ou non reconnueNon
402billing_inactiveLa facturation du compte n'est pas en règle (aucune carte ou paiement en retard)Non
404model_not_found · not_foundModèle ou point de terminaison inconnuNon
413request_too_largeCorps de la requête supérieur à 35 MoNon
429rate_limit_exceeded · quota_exceededDébit par minute dépassé; plafond de dépense ou quota de jetons atteint; ou capacité partagée temporairement épuiséeOui : respectez Retry-After, augmentez le délai
429concurrency_limit_exceededTrop de requêtes en cours pour cette cléOui, quand l'une d'elles se termine
429capacity_exceededLe modèle est à pleine capacité pour votre compte et sa capacité de relève est pleineOui : respectez Retry-After
503residency_unavailableCompte exclusivement canadien : capacité canadienne indisponible, requête servie nulle part ailleursOui : respectez Retry-After
500internal_error · server_errorErreur interneOui, une fois
502upstream_error · empty_completionErreur d'inférence en amont, ou le modèle n'a rien renvoyéOui, avec un délai croissant
504timeoutUne requête sans mode continu a dépassé environ 240 sUtilisez 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.

Prêt à intégrer?

Obtenez votre clé API et commencez à développer avec Augure.

Obtenir l’accès à l’API