Référence de l’API
Les points de terminaison d’inférence publics et les champs de requête pris en charge. Téléchargez le document OpenAPI pour obtenir les schémas lisibles par machine.
Points de terminaison
| Méthode | Chemin | Finalité |
|---|---|---|
| GET | /v1/models | Lister les modèles activés et approuvés. |
| GET | /v1/models/{model_id} | Consulter un modèle approuvé. |
| POST | /v1/chat/completions | Générer une réponse JSON ou un flux SSE. |
| GET | /health | État de fonctionnement du Worker. |
| GET | /ready | Disponibilité de la base de données et de l’inférence. |
Requête de chat
curl "https://uncensoredlabs.dev/v1/chat/completions" \
-H "Authorization: Bearer $UNCENSOREDLABS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"YOUR_APPROVED_MODEL_ID","messages":[{"role":"user","content":"Hello"}],"max_tokens":256}'Le corps requiert un identifiant de modèle et des messages. Utilisez max_tokens ou max_completion_tokens, pas les deux. Les requêtes de chat sont limitées à 4 MiB ; le fournisseur contrôle le contexte d’entrée et les limites des outils.
Réponse
Les appels sans streaming renvoient une réponse de chat compatible avec OpenAI. Les appels en streaming renvoient des deltas SSE se terminant par data: [DONE]. L’utilisation doit être vérifiée avant le règlement financier définitif.
| En-tête / champ | Finalité |
|---|---|
| Autorisation | Clé d’application Bearer. |
| Content-Type | application/json pour les requêtes. |
| Idempotency-Key | Référence facultative de prévention des doublons. |
| x-request-id | Référence de réponse pour investigation. |
| usage | Nombres de tokens du fournisseur utilisés pour le règlement. |
État de fonctionnement et disponibilité
GET /health vérifie l’état de fonctionnement. GET /ready vérifie également les dépendances et la disponibilité de l’inférence ; il peut renvoyer 503 lorsque le service est indisponible ou soumis aux conditions de lancement. Un Worker sain ne prouve pas à lui seul que l’inférence en production est activée.