Get API

GET API · Migrações compatíveis

Uma migração da API da OpenAI vai além de substituir uma URL

Uma migração básica normalmente aponta a URL base para https://relay-api.getapi.pro/v1, substitui a API Key no servidor e seleciona um modelo atual do catálogo. A migração em produção também deve verificar a compatibilidade dos parâmetros, os eventos de streaming, os erros, o comportamento de tempos limite e novas tentativas e a qualidade da saída. Teste com duas configurações, libere para uma pequena parcela do tráfego e preserve um caminho de reversão imediata.

Estabeleça a requisição mínima compatível

Comece com uma requisição de texto sem streaming e altere apenas a URL base, a credencial e o identificador do modelo. Reintroduza as ferramentas, a saída estruturada e os recursos de mídia um por vez, depois que a autenticação, a estrutura JSON e a análise da resposta estiverem funcionando.

  • Copie o identificador exato do catálogo atualizado
  • Não altere os prompts de negócio ao mesmo tempo
  • Guarde um exemplo fixo de requisição bem-sucedida com os dados sensíveis ocultados

Faça testes de contrato de cada recurso usado pela aplicação

Liste os parâmetros e campos de resposta dos quais seu código depende e teste cada um. Uma estrutura comum de requisição não comprova que recursos específicos do modelo, erros e informações de uso de tokens sejam idênticos aos do caminho anterior.

  • Cubra respostas com e sem streaming
  • Teste erros de tempo limite, limite de requisições e autenticação
  • Verifique os campos de uso e a estrutura da saída

Controle o risco com implantação gradual e reversão

Primeiro, direcione tráfego interno ou de baixo volume pelo novo caminho e compare a qualidade, a taxa de falha, a latência e o custo. Uma mudança de configuração deve devolver o tráfego ao caminho anterior sem exigir uma versão emergencial do código.

  • Defina a parcela de tráfego e a duração da observação
  • Registre a referência de desempenho do caminho anterior
  • Mantenha a reversão independente do caminho do novo provedor

Exemplo de requisição em Python

Instale o pacote openai e execute no terminal local ou no servidor. Use sua própria chave e um modelo disponível; requisições reais podem gerar cobranças. Nunca inclua chaves em uma página web. O exemplo de migração seleciona o provedor por variáveis de ambiente do servidor, sem novas tentativas nem troca automática.

# python -m pip install openai
# Configure these variables in your server's secret manager.
import os
from openai import OpenAI

provider = os.environ["AI_PROVIDER"]  # "getapi" or "openai"
if provider not in ("getapi", "openai"):
    raise ValueError("Choose getapi or openai explicitly")
prefix = "GETAPI" if provider == "getapi" else "OPENAI"
base_url = (
    "https://relay-api.getapi.pro/v1"
    if provider == "getapi" else "https://api.openai.com/v1"
)
with OpenAI(
    base_url=base_url,
    api_key=os.environ[prefix + "_API_KEY"],
    timeout=30.0,
    max_retries=0,
) as client:
    response = client.chat.completions.create(
        model=os.environ[prefix + "_MODEL"],
        messages=[{"role": "user", "content": "Reply with a short greeting."}],
    )
    print(response.choices[0].message.content)

Perguntas frequentes

Quais configurações normalmente mudam primeiro?

A URL base, a API Key no servidor e o identificador do modelo, seguidos da verificação explícita de cada recurso opcional usado pela aplicação.

Por que evitar a mudança de todo o tráfego de uma só vez?

Tarefas reais, falhas e latência podem diferir dos testes. Uma implantação limitada revela problemas antes que seu impacto se amplie.

A aplicação pode voltar à API original da OpenAI?

Sim, quando a configuração do provedor e as credenciais permanecem separadas da lógica de negócio e são controladas por um mecanismo de alternância testado.

Contato comercial: business@honeykid.cn