Pular para o conteúdo

Guias da API TextCortex

Mova sua integração OpenRouter para TextCortex.

Migre chamadas de API OpenRouter para TextCortex. Atualize o endpoint, a chave de API e os identificadores de modelo e, em seguida, encaminhe solicitações entre famílias de modelos compatíveis.

Mova sua integração OpenRouter para TextCortex.

O que isso significa na prática

Guarde seu aplicativo. Expanda seu acesso ao modelo.

Mova uma carga de trabalho de modelo para a API compatível com TextCortex do OpenAI sem reconstruir o produto em torno de um novo cliente provedor. Mapeie os modelos e solicite o comportamento explicitamente antes de alternar o tráfego.

1. Faça um inventário da integração atual

OpenRouter já aborda amplo acesso ao modelo. Compare os modelos, controles de roteamento, opções de processamento europeias e termos de conta exigidos pela sua aplicação.

Registre os identificadores de modelo, parâmetros de solicitação, ferramentas, comportamento de streaming e formatos de saída dos quais seu aplicativo depende. Mantenha uma cópia da configuração do cliente existente para reversão.

2. Mapear identificadores do modelo de destino

Recupere o catálogo TextCortex usando GET /models. Combine cada tarefa de aplicação com um modelo disponível, incluindo a rota hospedada na UE, quando necessário.

Um identificador específico do provedor não é portátil por padrão. Defina explicitamente o identificador de destino e revise qualquer raciocínio específico do modelo ou configurações de geração.

3. Configure o cliente TextCortex

Crie um Conta TextCortex e gere uma chave API nas configurações da conta. Instale o pacote OpenAI Python em seu servidor. Armazene a chave em TEXTCORTEX_API_KEY e defina TEXTCORTEX_MODEL para um identificador retornado por GET /models.

Este exemplo mantém credenciais em variáveis de ambiente. A mesma configuração do cliente funciona quando você escolhe outro modelo compatível. Leia o Referência da API para parâmetros específicos do 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. Reproduza um conjunto de solicitações de representante

Execute entradas de teste sintéticas ou aprovadas por meio de ambas as integrações. Mantenha ações externas como e-mails ou compras desativadas durante o teste.

  • Compare a qualidade da resposta e a validade da saída estruturada.
  • Verifique pedaços de streaming, argumentos de ferramentas e cancelamento.
  • Exercite erros de autenticação, limites de taxa e tempos limite.
  • Meça o uso e a latência sob a simultaneidade esperada.

5. Mude gradualmente e mantenha a rota anterior

Introduza uma pequena parcela do tráfego qualificado após a aprovação nas verificações de aceitação. Rastreie falhas e modele o uso por rota para identificar regressões rapidamente.

Mantenha uma configuração de reversão até que o período de monitoramento seja concluído. Remova apenas credenciais e serviços que não são mais usados. Use o guia de roteamento para organizar futuras escolhas de modelos.

Perguntas

Suas próximas perguntas, respondidas.

O que muda quando migro uma integração existente?

Atualize o URL base, a chave de API e os identificadores de modelo. Revise os parâmetros específicos do provedor e teste o streaming, as ferramentas, a saída estruturada e o tratamento de erros usados ​​pelo seu aplicativo. Mantenha sua configuração original disponível durante a implementação.

Posso usar um cliente compatível com OpenAI?

Sim. Configure o cliente com a URL base TextCortex e a chave de API. Use um identificador de modelo TextCortex e os parâmetros suportados por esse modelo. A descoberta do modelo, as conclusões do chat e as respostas estão documentadas na referência da API.

Todos os modelos do catálogo estão hospedados na UE?

TextCortex oferece rotas modelo hospedadas na UE e um catálogo mais amplo de vários provedores. Selecione a implantação hospedada na UE exigida pelo seu aplicativo; a associação ao catálogo por si só não estabelece onde uma solicitação específica é processada.

TextCortex AI

Uma integração. Sua escolha de modelos.

Cadastre-se no TextCortex, crie uma chave de API e comece a construir com os modelos que sua aplicação precisa.

Fontes e documentação

Documentação do produto e fontes dos provedores usadas neste guia. Verificadas em 5 de outubro de 2026.