2026-09-08

Comment tester une API compatible OpenAI

Guide de production : Comment tester une API compatible OpenAI. Il comprend un artefact déterministe, des limites d’échec, des contrôles de déploiement et des sources vérifiées.

Décider d’abord

Comment tester une API compatible OpenAI est un contrat de production explicite, pas une modification isolée. Définissez réussite, échec terminal et rollback avant de déplacer le trafic ; l’artefact sépare preuve et hypothèse.

Commencez par text, prouvez stream avec un cas déterministe et faites de errors une condition de mise en production.

Artefact réutilisable

Une ligne ne passe que si sa preuve vient de la même requête, fenêtre de test ou version de configuration.

Point de contrôle	Preuve à conserver	Condition de réussite
`text`	`non-stream_response,finish_state,empty_and_Unicode_input`	La valeur est préservée et comparée exactement à la frontière du protocole.
`stream`	`SSE_event_order,terminal_marker,usage_placement,disconnect`	Le relevé relie une requête logique et une tentative précise.
`tools`	`single_and_parallel_calls,argument_schema,call_correlation`	Le relevé relie une requête logique et une tentative précise.
`schema`	`valid_object,refusal,truncation,unsupported_keyword`	La limite est explicite et l’échec est fermé.
`usage`	`input,output,cache_read/write,missing_categories`	Réservation, observation et valeur finale se rapprochent dans un registre durable.
`errors`	`401,403,429,499,5xx_outer_and_embedded_failures`	Owner, source, date et limite sont consignés.

Exemple détaillé

L’exemple est synthétique et déterministe. Utilisez vos valeurs revues, sans secret ni donnée client.

corpus_version: 1
cases:
  - id: text/non_stream_zero_values
    request: { stream: false, temperature: 0 }
    assert: [http_status, response_shape, explicit_zero_preserved]
  - id: stream/disconnect
    action: cancel_after_first_content_delta
    assert: [client_cancelled, upstream_cancelled, terminal_state_recorded]
  - id: tools/two_calls
    assert: [stable_call_ids, arguments_validated, results_correlated]
  - id: errors/rate_limit
    assert: [status_429, retry_after_parsed, attempt_budget_respected]

Procédure de mise en œuvre

Figer requête, réponse, configuration et référence observable.
Exécuter un cas positif déterministe et conserver le résultat complet.
Exécuter le cas négatif ou limite associé.
Relier les tentatives à un ID logique et consigner temps, état final et usage sans contenu sensible.
Déployer sur une cohorte bornée avec critères d’arrêt.
Relire l’état durable et le comportement public ; revenir en arrière si une invariance échoue.

Modes d’échec

Ces échecs invalident le résultat même si le HTTP externe semble réussir :

Une réponse texte est prise pour une preuve complète de compatibilité.
Un 0 ou false explicite disparaît à la sérialisation.
Un champ pratique est lu et les sorties typées, tools, refus ou résultats partiels sont perdus.
Des retries sans budget amplifient la charge.

Limite de Modelflare

Modelflare centralise routage compatible OpenAI, clés, groupes, usage et erreurs, mais une route configurée ne prouve aucune capacité optionnelle. Vérifiez modèle et canal par le protocole natif, conservez les zéros explicites et prenez le règlement durable comme vérité de facturation.

La page parente couvre la décision générale et la documentation la configuration actuelle.

Liste avant publication

Répondre à la question principale avant le contexte.
Nommer un owner pour chaque champ, état, métrique et formule.
N’utiliser que des identifiants synthétiques.
Conserver structure, code, limites et avertissements dans toutes les langues.
Revérifier contrats, support et prix à T-1 ; déplacer la date si un fait change.
Avant l’heure, exclure de l’API publique, des routes et du sitemap.

Sources et date de vérification

Sources vérifiées le 2026-08-07 ; elles ne prouvent pas une route non testée.