Guide
Journal des modifications
Historique des réorganisations du manuel et des modifications de la documentation des interfaces
Journal des modifications
Cette page consigne les réorganisations du manuel d'utilisation et les modifications de la documentation des interfaces, afin de permettre aux développeurs déjà intégrés de vérifier les changements.
La documentation ne décrit que le comportement actuellement en vigueur ; en cas d'incohérence avec votre implémentation historique, le présent manuel et le résultat en temps réel de GET /v1/models font foi.
Mise à jour actuelle (normalisation de la documentation)
Structure de navigation
Le manuel est désormais organisé par parcours d'utilisation, en six sections :
| Section | Contenu |
|---|---|
| Démarrage rapide | Démarrage rapide, guide des fonctionnalités des plateformes, place de marché des modèles et facturation, intégration des outils courants |
| Vue d'ensemble des plateformes | Positionnement, fonctionnalités et questions fréquentes des quatre plateformes |
| Intégration API | Règles d'authentification, vue d'ensemble des interfaces, texte, image, vidéo, audio, codes d'erreur |
| Bibliothèque de ressources | Guide de la bibliothèque de ressources, interfaces de la bibliothèque de ressources, processus de portrait, vidéo de référence |
| Création web | Atelier et Agent de Creation, génération vidéo et nouvelles tentatives, questions fréquentes |
| Aide et référence | Récapitulatif des questions fréquentes, facturation et relevés, limitation de débit et quotas, journal des modifications, glossaire |
Les onglets supérieurs et la barre latérale sont mis à jour en conséquence. Toutes les adresses existantes restent inchangées ; les liens déjà partagés avec des clients continuent de fonctionner.
Ajouts
- Ajout de la section « Aide et référence » : récapitulatif des questions fréquentes, facturation et relevés, limitation de débit et quotas, journal des modifications, glossaire ;
- Ajout d'une page dédiée à l'interface de synthèse vocale ;
- Complément des listes de fonctionnalités, des flux de travail typiques et des questions fréquentes des quatre pages de plateforme ;
- Ajout, sur la page Canvas, des types de nœuds, des opérations courantes, des raccourcis clavier et d'un exemple complet de flux de création ;
- Ajout des interfaces audio et de l'entrée vers la vue d'ensemble des plateformes dans l'index de la documentation.
Corrections
- Correction d'un lien mort sur la page Canvas pointant vers une page non publiée ;
- Correction du lien vers les interfaces vidéo dans l'entrée principale de la documentation, désormais dirigé directement vers la page de création de tâche ;
- Correction de l'entrée des interfaces audio omise dans l'index de la documentation, désormais cohérente avec la vue d'ensemble des interfaces.
Clarifications conceptuelles
Les comportements suivants sont explicitement précisés dans le manuel ; prêtez-y une attention particulière lors de l'intégration :
| Sujet | Explication |
|---|---|
| Décompte à l'achèvement | Les tâches asynchrones sont décomptées à l'achèvement ; la soumission ne fait qu'accepter la tâche, sans pré-autorisation |
| L'interrogation n'est pas facturée | Interroger l'état d'une tâche ne génère pas de frais ; seule la création d'une tâche est facturée |
| Pas de fusion des requêtes en double | Une soumission répétée avec des paramètres identiques crée de nouvelles tâches, chacune facturée ; la plateforme ne fusionne pas automatiquement |
| Une ressource ne s'importe qu'une fois | L'ID de ressource reste identique d'un modèle à l'autre ; pour changer de modèle, modifiez uniquement le champ model |
| Les ressources de portrait ne sont pas dégradées | Lors du passage à un modèle ne prenant pas en charge les ressources de portrait, elles ne sont pas automatiquement converties en images de référence ordinaires |
| Autorisation d'instantané de requête | Le contenu de la requête et le JSON de requête ne sont visibles que par les administrateurs ; ils ne sont pas renvoyés lors d'une interrogation par un utilisateur ordinaire |
Comment vérifier le comportement actuel
La documentation décrit le comportement prévu ; la portée réelle des modèles visibles doit être vérifiée sur les résultats en temps réel :
curl "$LOCOPAL_BASE_URL/v1/models" \
-H "Authorization: Bearer $LOCOPAL_API_KEY"Le catalogue de modèles évolue selon les autorisations du compte, l'adresse d'accès et la disponibilité de la plateforme. Il est recommandé de l'interroger à nouveau au démarrage du service, lorsque l'utilisateur change de modèle, ou lorsque le message « modèle indisponible » apparaît, sans coder en dur les noms de modèles.