Passer au contenu

Guides API TextCortex

Déplacez votre intégration Fireworks AI vers TextCortex.

Migrez les appels d'API Fireworks AI vers TextCortex. Mettez à jour le point de terminaison, la clé API et les identifiants de modèle, puis acheminez les requêtes entre les familles de modèles prises en charge.

Déplacez votre intégration Fireworks AI vers TextCortex.

À retenir pour votre équipe

Conservez votre candidature. Élargissez son accès au modèle.

Déplacez une charge de travail de modèle vers l'API compatible OpenAI de TextCortex sans reconstruire le produit autour d'un nouveau client fournisseur. Mappez les modèles et demandez le comportement explicitement avant de changer de trafic.

1. Inventaire de l'intégration actuelle

Séparez vos demandes d'inférence sans serveur de tout déploiement dédié ou dépendance de modèle personnalisé. Le passage à une API de modèle commun ne transfère pas automatiquement un déploiement.

Enregistrez les identifiants du modèle, les paramètres de requête, les outils, le comportement de streaming et les formats de sortie sur lesquels repose votre application. Conservez une copie de la configuration client existante pour la restauration.

2. Cartographier les identifiants du modèle de destination

Récupérez le catalogue TextCortex à l’aide de GET /models. Faites correspondre chaque tâche d'application à un modèle disponible, y compris l'itinéraire hébergé dans l'UE, si nécessaire.

Un identifiant spécifique au fournisseur n'est pas portable par défaut. Définissez explicitement l'identifiant de destination et examinez tous les paramètres de raisonnement ou de génération spécifiques au modèle.

3. Configurez le client TextCortex

Créez un Compte TextCortex et générez une clé API dans les paramètres du compte. Installez le package Python OpenAI sur votre serveur. Stockez la clé dans TEXTCORTEX_API_KEY et définissez TEXTCORTEX_MODEL sur un identifiant renvoyé par GET /models.

Cet exemple conserve les informations d'identification dans les variables d'environnement. La même configuration client fonctionne lorsque vous choisissez un autre modèle pris en charge. Lisez le Référence API pour connaître les paramètres spécifiques au point final.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["TEXTCORTEX_API_KEY"],
    base_url="https://api.textcortex.com/v1",
)

for model in client.models.list():
    print(model.id)

response = client.chat.completions.create(
    model=os.environ["TEXTCORTEX_MODEL"],
    messages=[{"role": "user", "content": "Hello"}],
)
print(response.choices[0].message.content)

4. Rejouer un ensemble de requêtes représentatives

Exécutez des entrées de test synthétiques ou approuvées via les deux intégrations. Gardez les actions externes telles que les e-mails ou les achats désactivées pendant le test.

  • Comparez la qualité des réponses et la validité des résultats structurés.
  • Vérifiez les morceaux de streaming, les arguments de l'outil et l'annulation.
  • Exercez les erreurs d’authentification, les limites de débit et les délais d’attente.
  • Mesurez l’utilisation et la latence dans les conditions de concurrence attendue.

5. Changez progressivement et conservez l'itinéraire précédent

Introduisez une petite part du trafic éligible une fois les contrôles d’acceptation réussis. Suivez les échecs et l’utilisation du modèle par itinéraire afin de pouvoir identifier rapidement les régressions.

Conservez une configuration de restauration jusqu'à ce que la période de surveillance soit terminée. Supprimez uniquement les informations d’identification et les services qui ne sont plus utilisés. Utilisez le guide d'itinéraire pour organiser les futurs choix de modèles.

Questions

Réponses à vos prochaines questions.

Qu'est-ce qui change lorsque je migre une intégration existante ?

Mettez à jour l'URL de base, la clé API et les identifiants du modèle. Examinez les paramètres spécifiques au fournisseur et testez le streaming, les outils, la sortie structurée et la gestion des erreurs utilisés par votre application. Gardez votre configuration d'origine disponible pendant le déploiement.

Puis-je utiliser un client compatible OpenAI ?

Oui. Configurez le client avec l'URL de base et la clé API TextCortex. Utilisez un identifiant de modèle TextCortex et les paramètres pris en charge par ce modèle. La découverte de modèles, les achèvements de chat et les réponses sont documentés dans la référence de l'API.

Tous les modèles du catalogue sont-ils hébergés dans l’UE ?

TextCortex propose des itinéraires modèles hébergés dans l'UE et un catalogue multi-fournisseurs plus large. Sélectionnez le déploiement hébergé dans l'UE requis par votre application ; L'adhésion au catalogue ne permet pas à elle seule d'établir où une demande particulière est traitée.

TextCortex AI

Une intégration. Votre choix de modèles.

Inscrivez-vous à TextCortex, créez une clé API et commencez à créer avec les modèles dont votre application a besoin.

Sources et documentation

Documentation produit et sources des fournisseurs utilisées pour ce guide. Vérifiées le 5 octobre 2026.