Guides de développement

Une fois l’API opérationnelle, trouvez le guide correspondant à ce que vous voulez faire. Chaque guide fournit des exemples exécutables ; les protocoles couverts sont indiqués dans chaque page.

Fonctionnalités de base

Définissez « comment le modèle répond » : affichage progressif, appel de vos fonctions, réponse dans un format fixe, compréhension des images.

Je veux…	Guide	Points clés
Afficher la réponse au fil de l’eau, sans attendre la génération complète	Réponses en streaming	Diffusion SSE ; inclut la reconnexion et l’appel de fonctions en streaming
Faire appeler mes fonctions ou des API externes par le modèle	Appel de fonctions	Définir `tools` ; appels parallèles et `tool_choice` pris en charge
Obtenir une sortie toujours au format JSON	Sortie structurée	Contraintes JSON Mode et JSON Schema
Faire analyser des images par le modèle	Compréhension visuelle	URL d’image ou Base64, comparaison de plusieurs images possible

Coûts et stabilité

Payer moins pour les mêmes requêtes et éviter les interruptions en cas de problème.

Je veux…	Guide	Points clés
Réduire le coût de longs prompts envoyés de façon répétée	Cache de prompts	Mise en cache des préfixes répétés, moins de coûts en tokens et de latence
Réutiliser un long contexte Gemini d’une requête à l’autre	Cache explicite Gemini	Créer et référencer activement des cachedContents, pour des hits plus déterministes
Choisir le fournisseur qui traite la requête	Routage des fournisseurs	Routage automatique par défaut ; `provider.type` pour imposer un fournisseur
Basculer automatiquement vers un modèle de secours en cas d’erreur du modèle principal	Repli automatique	`provider.fallback`, jusqu’à 3 modèles de secours

En cas d’erreur

Commencez ici lorsqu’une requête échoue, est limitée ou est bloquée.

Je rencontre…	Guide	Points clés
Une erreur, et je veux savoir comment la traiter et s’il faut réessayer	Gestion des erreurs	Codes d’état, format des erreurs, backoff exponentiel et délais d’expiration
429 Too Many Requests	Limites de débit	100 RPM par défaut, cumulés par équipe ; lire les en-têtes de réponse pour savoir combien de temps attendre
Une requête bloquée ou suspendue par la sécurité des contenus	Sécurité des contenus	Règles de déclenchement, durée de suspension et reprise

SDK et frameworks

Intégrez OfoxAI dans votre code avec un SDK ou un framework existant : seules l’URL de l’API et la clé changent.

J’utilise…	Guide
Le SDK officiel OpenAI (migration d’un projet existant)	OpenAI SDK
LangChain	LangChain
LlamaIndex	LlamaIndex