Perguntas frequentes sobre acesso à API

Encontre rapidamente perguntas frequentes sobre URL base, modelos, streaming, clientes, tempo limite e monitoramento de disponibilidade.

Endereço, chaves e modelos

A Base URL precisa ou não incluir /v1?

No SDK da OpenAI, preencha https://1zheai.com/v1; nos SDKs da Anthropic e no Claude Code, preencha https://1zheai.com. Ao usar curl diretamente, informe o caminho completo da requisição. Algumas ferramentas de desktop completam o caminho automaticamente; consulte a tabela de correspondência de endereços.

Tenho assinatura ChatGPT ou Claude, ainda preciso da chave deste site?

Sim. O acesso a este site usa uma chave de API criada no console deste site; a assinatura de clientes de consumo e as credenciais de API deste site são formas de acesso diferentes. A ferramenta também precisa suportar provedor ou endereço de API personalizado.

O modelo está na lista, por que a chamada ainda falha?

A lista exibe os modelos visíveis para a chave atual, não a taxa de sucesso de inferência em tempo real. Verifique também o protocolo da interface, os parâmetros opcionais e o status do upstream; consulte a interface de consulta de modelos.

Dá para copiar diretamente nomes de modelos de outras plataformas?

Copie o ID completo da lista de modelos deste site. Diferentes provedores podem usar prefixos, apelidos e versões de data diferentes; não tente renomear por suposição. Consulte o guia de migração para os passos de migração.

Requisições e clientes

Chamada bem-sucedida, mas não recebo texto?

Primeiro confirme o protocolo de resposta. Chat Completions lê choices[].message.content; Messages percorre blocos de texto de content; Responses percorre output ou usa output_text do SDK. Respostas de chamadas de ferramentas também podem não conter texto comum.

Por que o conteúdo da rodada anterior não foi lembrado?

Conversas com múltiplas rodadas exigem que o cliente envie o histórico. Reutilizar a mesma chave repetidamente não cria automaticamente uma sessão no servidor. As extensões relacionadas a sessão do Responses precisam ser confirmadas separadamente; não dependa delas por padrão.

Já recebi texto em streaming, conta como sucesso?

Também é necessário confirmar o evento de término ou o estado final. Erros no meio do fluxo, interrupções de streaming e truncamento de saída podem ocorrer depois que parte do texto já foi recebida. Consulte saída em streaming para detalhes.

Após timeout, posso tentar repetidamente?

Não é recomendado. O tempo limite pode ocorrer depois que a requisição já foi processada. Primeiro consulte os logs de chamada e, em seguida, execute as tentativas com número limitado de vezes, backoff e tempo total de espera, evitando que o SDK e a aplicação cada um façam uma rodada de tentativas. Consulte tempo limite e tentativas.

Dá para colocar a chave da API direto no front-end da página?

Não compile a chave em scripts de navegador nem em repositórios públicos. Mantenha as credenciais no seu servidor e chame a interface a partir dele; o navegador conecta apenas ao seu próprio backend. As variáveis de ambiente no código de demonstração são para o servidor ou terminal local.

Status do serviço e ajuda

O monitoramento de tempo de execução está normal, por que o modelo ainda dá erro?

O monitoramento verifica a acessibilidade HTTP do site oficial, do console e da entrada da API; não representa a taxa de sucesso de inferência de cada modelo. O monitoramento é implantado no mesmo servidor que a aplicação; em caso de falha da máquina inteira, o monitoramento também fica pausado; os dados históricos começam a ser acumulados a partir da ativação.

O que preciso preparar ao contatar o suporte?

Forneça a data e o fuso horário do ocorrido, a versão do cliente, o ID do modelo, o caminho completo da requisição, o código de status HTTP, o ID da requisição e as informações de erro com dados sensíveis removidos. Remova chaves, cabeçalhos de autenticação e conteúdo de conversas privadas; você pode organizar as informações conforme o modelo de relato de problemas.