Vai al contenuto

Guide API TextCortex

Sposta la tua integrazione Lyceum su TextCortex.

Migrare le chiamate API Lyceum a TextCortex. Aggiorna l'endpoint, la chiave API e gli identificatori del modello, quindi instrada le richieste tra le famiglie di modelli supportate.

Sposta la tua integrazione Lyceum su TextCortex.

Cosa significa in pratica

Conserva la tua candidatura. Espandi l'accesso al modello.

Sposta il carico di lavoro di un modello sull'API compatibile con OpenAI di TextCortex senza ricostruire il prodotto attorno a un nuovo client del fornitore. Mappare i modelli e richiedere esplicitamente il comportamento prima di cambiare traffico.

1. Inventariare l'integrazione corrente

Lyceum combina carichi di lavoro di calcolo e inferenza. Separa le chiamate API del modello da istanze GPU, contenitori, storage ed endpoint dedicati prima di scegliere cosa migrare.

Registra gli identificatori del modello, i parametri di richiesta, gli strumenti, il comportamento dello streaming e i formati di output su cui fa affidamento la tua applicazione. Conservare una copia della configurazione client esistente per il rollback.

2. Mappare gli identificatori del modello di destinazione

Recupera il catalogo TextCortex utilizzando GET /models. Associa ciascuna attività dell'applicazione a un modello disponibile, incluso il percorso ospitato nell'UE, ove richiesto.

Un identificatore specifico del provider non è trasferibile per impostazione predefinita. Imposta l'identificatore di destinazione in modo esplicito ed esamina eventuali ragionamenti o impostazioni di generazione specifici del modello.

3. Configurare il client TextCortex

Crea uno Conto TextCortex e genera una chiave API nelle impostazioni dell'account. Installa il pacchetto Python OpenAI sul tuo server. Memorizza la chiave in TEXTCORTEX_API_KEY e imposta TEXTCORTEX_MODEL su un identificatore restituito da GET /models.

Questo esempio mantiene le credenziali nelle variabili di ambiente. La stessa configurazione del client funziona quando scegli un altro modello supportato. Leggere Riferimento API per i parametri specifici dell'endpoint.

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. Riprodurre una serie di richieste di rappresentante

Esegui input di test sintetici o approvati attraverso entrambe le integrazioni. Mantieni disabilitate le azioni esterne come e-mail o acquisti durante il test.

  • Confronta la qualità della risposta e la validità dell'output strutturato.
  • Controlla i blocchi di streaming, gli argomenti dello strumento e la cancellazione.
  • Errori di autenticazione degli esercizi, limiti di velocità e timeout.
  • Misura l'utilizzo e la latenza in condizioni di concorrenza prevista.

5. Cambia gradualmente e mantieni il percorso precedente

Introduci una piccola quota di traffico idoneo dopo aver superato i controlli di accettazione. Tieni traccia dei guasti e dell'utilizzo del modello per percorso in modo da poter identificare rapidamente le regressioni.

Conserva una configurazione di rollback fino al completamento del periodo di monitoraggio. Rimuovi solo le credenziali e i servizi che non vengono più utilizzati. Utilizza guida al percorso per organizzare le future scelte dei modelli.

Domande

Le tue prossime domande hanno una risposta.

Cosa cambia quando eseguo la migrazione di un'integrazione esistente?

Aggiorna l'URL di base, la chiave API e gli identificatori del modello. Esamina i parametri specifici del provider e testa lo streaming, gli strumenti, l'output strutturato e la gestione degli errori utilizzati dalla tua applicazione. Mantieni la configurazione originale disponibile durante il lancio.

Posso utilizzare un client compatibile con OpenAI?

Sì. Configura il client con l'URL di base TextCortex e la chiave API. Utilizza un identificatore del modello TextCortex e i parametri supportati da quel modello. La scoperta del modello, i completamenti della chat e le risposte sono documentati nel riferimento API.

Tutti i modelli nel catalogo sono ospitati nell'UE?

TextCortex offre percorsi modello ospitati nell'UE e un catalogo multi-provider più ampio. Seleziona l'implementazione ospitata nell'UE richiesta dalla tua applicazione; l'appartenenza al catalogo da sola non stabilisce dove viene elaborata una particolare richiesta.

TextCortex AI

Una integrazione. La tua scelta di modelli.

Iscriviti a TextCortex, crea una chiave API e inizia a creare con i modelli di cui la tua applicazione ha bisogno.

Fonti e documentazione

Documentazione di prodotto e fonti dei fornitori usate per questa guida. Verificate il 5 ottobre 2026.