Gestion des tâches par lots
Soumettez des requêtes groupées asynchrones et inspectez l'état d'exécution.
Soumettez des requêtes groupées asynchrones sur les points de terminaison pris en charge à l'aide de l'API Batch compatible OpenAI.
/openai/v1/batchesCorps de la requête
| Champ | Type | Requis | Description |
|---|---|---|---|
input_file_id | string | Oui | Identifiant du fichier téléversé dont l'usage est défini sur batch. |
endpoint | string | Oui | Point de terminaison cible (/v1/chat/completions, /v1/completions, /v1/responses ou /v1/embeddings). |
completion_window | string | Oui | Fenêtre de réalisation, actuellement fixée à 24h. |
metadata | object | Non | Paires clé-valeur facultatives pour le suivi. |
Les fichiers d'entrée doivent être au format JSONL encodé en UTF-8, comporter au maximum 50 000 éléments et ne pas dépasser 200 Mio. Chaque ligne doit être un objet JSON valide contenant un custom_id unique non vide, la méthode POST, une url correspondant au endpoint du lot et un objet body (avec le champ model obligatoire pour les lots prépayés natifs stricts). Pour les lots prépayés natifs, la passerelle vérifie la somme de contrôle du fichier et les politiques d'exécution de chaque élément avant admission ; toutes les retenues de solde sont engagées de façon atomique avant transmission au fournisseur. En cas de solde insuffisant, HTTP 402 est renvoyé sans traitement partiel. Les configurations de fournisseurs incompatibles ne peuvent pas être scindées au sein d'un même lot et aucun basculement inter-fournisseurs n'est effectué au niveau des éléments.
Cycle de vie du lot
/openai/v1/batches/{batch_id}/openai/v1/batches/{batch_id}/cancelvalidating: Valide le format du fichier d'entrée, la syntaxe JSONL et la conformité au schéma.in_progress: Distribue les éléments vers les identifiants de fournisseur assignés sans basculement entre fournisseurs.finalizing: Agrège les sorties d'inférence et enregistre le règlement de la consommation.completed: Traitement achevé avec succès, générantoutput_file_idet unerror_file_idfacultatif.failed: Défaillance finale si la validation du fichier ou l'orchestration du lot échoue entièrement.cancelling: Interrompt le traitement sur demande et bascule vers l'état annulé.cancelled: Indique que l'exécution du lot a été arrêtée avant son achèvement complet. Les éléments échoués, annulés ou manquants ne garantissent pas un coût fournisseur nul ; le règlement conserve les fonds pour rapprochement avec les relevés du fournisseur. Le statut canonique dans AnyInt estcancelled.expired: Déclenché lorsque le traitement dépasse la fenêtre de 24 heures ; les exécutions non confirmées nécessitent un rapprochement avec les journaux du fournisseur et n'impliquent pas un coût nul.
Opérations par lots et téléchargement des résultats
/openai/v1/batches- Lister les lots :
GET /openai/v1/batchesliste les tâches par lots actives et archivées de l'organisation ou du projet autorisé. - Stockage d'objets et téléchargement : L'admission de fichiers avec l'usage
batchet l'exécution des lots nécessitent un stockage d'objets partagé (OBJECT_STORE_MODE). Une fois le traitement terminé, les fichiers JSONL de résultats et d'erreurs peuvent être récupérés viaGET /openai/v1/files/{file_id}/content.
Alias de compatibilité
- La passerelle accepte
/v1/batchespour la compatibilité descendante. Utilisez/openai/v1/batchespour les nouvelles intégrations.