Construis avec un signal vivant.

01Introduction

Bienvenue dans la documentation de l'API Aura. Cette API te donne accès à un assistant IA polyvalent capable de converser, analyser des images, générer du contenu visuel, transcrire et synthétiser de la parole.

Que tu construises une application mobile, un chatbot web, un outil de productivité ou un agent automatisé — Aura fournit les briques essentielles pour intégrer l'intelligence artificielle en quelques lignes de code.

02Connexion

Connecte-toi ou cree un compte pour generer et gerer tes cles API. Chaque cle est liee a ton compte et peut etre revoquee a tout moment.

03Gestion des cles API

Les cles API sont ton passeport pour acceder a l'API Aura. Chaque cle est unique, liee a ton compte, et peut etre nommee pour identifier le projet ou l'environnement auquel elle est destinee.

Flux recommande pour les developpeurs

1. Cree un compte sur ce portail ou via l'endpoint /api/v1/compte/inscription
2. Genere une cle nommee selon ton environnement (ex: aura-prod, aura-dev)
3. Stocke la cle dans des variables d'environnement cote serveur uniquement
4. Appelle l'API depuis ton backend avec le header X-API-Key
5. Rotation : regenere une nouvelle cle et revoque l'ancienne periodiquement

04Authentification API

Une fois ta cle generee, utilise l'un des deux styles d'authentification selon l'endpoint appele :

05Premier appel

Voici comment faire ton premier appel a l'API Aura en trois langages. Remplace ta_cle_ici par ta cle API reelle.

curl -X POST https://philbuilder-ai.fastapicloud.dev/api/v1/causerie \
  -H "Content-Type: application/json" \
  -H "X-API-Key: ta_cle_ici" \
  -d '{"message": "Bonjour Aura, qui es-tu ?"}'

import httpx

reponse = httpx.post(
    "https://philbuilder-ai.fastapicloud.dev/api/v1/causerie",
    headers={"X-API-Key": "ta_cle_ici"},
    json={"message": "Bonjour Aura, qui es-tu ?"},
    timeout=60.0,
)
print(reponse.json()["reponse"])

const res = await fetch("https://philbuilder-ai.fastapicloud.dev/api/v1/causerie", {
  method: "POST",
  headers: { 
    "Content-Type": "application/json", 
    "X-API-Key": "ta_cle_ici" 
  },
  body: JSON.stringify({ message: "Bonjour Aura, qui es-tu ?" }),
});
const data = await res.json();
console.log(data.reponse);

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    payload := map[string]string{"message": "Bonjour Aura, qui es-tu ?"}
    body, _ := json.Marshal(payload)
    req, _ := http.NewRequest("POST", 
        "https://philbuilder-ai.fastapicloud.dev/api/v1/causerie",
        bytes.NewBuffer(body))
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("X-API-Key", "ta_cle_ici")
    client := &http.Client{}
    resp, _ := client.Do(req)
    // Traiter la reponse...
}

06Compatible OpenAI

Deja habitue au SDK OpenAI, Gemini ou Claude ? Change juste l'URL de base et utilise ta cle Aura. Aucune autre modification necessaire.

from openai import OpenAI

client = OpenAI(
    base_url="https://philbuilder-ai.fastapicloud.dev/v1",
    api_key="ta_cle_ici",
)

reponse = client.chat.completions.create(
    model="aura",
    messages=[{"role": "user", "content": "Bonjour Aura !"}],
    stream=False,
)
print(reponse.choices[0].message.content)

Tu peux aussi utiliser le streaming (Server-Sent Events) :

for chunk in client.chat.completions.create(
    model="aura",
    messages=[{"role": "user", "content": "Raconte une histoire"}],
    stream=True,
):
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

07Reference des endpoints

POST/api/v1/causerie

curl -X POST https://philbuilder-ai.fastapicloud.dev/api/v1/causerie \
  -H "X-API-Key: ta_cle" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Quel est le sujet de notre conversation precedente ?",
    "session_id": "sess_abc123"
  }'

POST/api/v1/vision/analyser

curl -X POST https://philbuilder-ai.fastapicloud.dev/api/v1/vision/analyser \
  -H "X-API-Key: ta_cle" \
  -F "image=@photo.jpg" \
  -F "question=Quels objets vois-tu sur cette image ?"

POST/api/v1/image/generer

curl -X POST https://philbuilder-ai.fastapicloud.dev/api/v1/image/generer \
  -H "X-API-Key: ta_cle" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Un chat astronaute flottant dans l'espace, style realiste",
    "largeur": 1024,
    "hauteur": 1024,
    "style": "realistic"
  }' \
  --output image.png

POST/api/v1/audio/transcrire

curl -X POST https://philbuilder-ai.fastapicloud.dev/api/v1/audio/transcrire \
  -H "X-API-Key: ta_cle" \
  -F "audio=@enregistrement.wav" \
  -F "langue=fr"

POST/api/v1/audio/parler

curl -X POST https://philbuilder-ai.fastapicloud.dev/api/v1/audio/parler \
  -H "X-API-Key: ta_cle" \
  -H "Content-Type: application/json" \
  -d '{"texte": "Bonjour, je suis Aura. Comment puis-je t aider ?"}' \
  --output voix.mp3

POST/v1/chat/completions

curl -X POST https://philbuilder-ai.fastapicloud.dev/v1/chat/completions \
  -H "Authorization: Bearer ta_cle" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "aura",
    "messages": [
      {"role": "system", "content": "Tu es un expert en programmation."},
      {"role": "user", "content": "Explique les closures en JavaScript"}
    ],
    "temperature": 0.5,
    "max_tokens": 1500
  }'

08Limites & quotas

Les limites suivantes sont appliquees pour garantir la stabilite du service pour tous les utilisateurs :

09Codes d'erreur

10SDK & integrations

Bien que l'API soit accessible directement via HTTP, voici quelques patterns d'integration recommandes :

Python — avec retry automatique

import httpx
from tenacity import retry, stop_after_attempt, wait_exponential

@retry(stop=stop_after_attempt(3), wait=wait_exponential(multiplier=1, min=2, max=10))
def ask_aura(message: str, api_key: str, session_id: str = None) -> str:
    payload = {"message": message}
    if session_id:
        payload["session_id"] = session_id

    r = httpx.post(
        "https://philbuilder-ai.fastapicloud.dev/api/v1/causerie",
        headers={"X-API-Key": api_key},
        json=payload,
        timeout=60.0,
    )
    r.raise_for_status()
    return r.json()["reponse"]

Node.js — avec streaming OpenAI

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://philbuilder-ai.fastapicloud.dev/v1",
  apiKey: process.env.AURA_API_KEY,
});

const stream = await client.chat.completions.create({
  model: "aura",
  messages: [{ role: "user", content: "Raconte-moi une histoire" }],
  stream: true,
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content || "");
}