---
title: "Perguntas frequentes sobre acesso à API"
description: "Encontre rapidamente perguntas frequentes sobre URL base, modelos, streaming, clientes, tempo limite e monitoramento de disponibilidade."
headingIds: {"Endereço, chaves e modelos":"section-1","Requisições e clientes":"section-2","Status do serviço e ajuda":"section-3"}
---

<aside className="docs-publication" data-pagefind-ignore>

Documentação mantida por [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Fontes e correções](https://1zheai.com/en/editorial/).

Encontrou um erro? [Contate o suporte](mailto:support@1zheai.com) com o endereço da página e uma descrição. Não envie chaves de API ou credenciais de conta.

</aside>
## Endereço, chaves e modelos

<AccordionGroup>
<Accordion title="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](/pt/docs/base-url/).

</Accordion>
<Accordion title="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.

</Accordion>
<Accordion title="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](/pt/docs/api-models/).

</Accordion>
<Accordion title="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](/pt/docs/migration/) para os passos de migração.

</Accordion>
</AccordionGroup>

## Requisições e clientes

<AccordionGroup>
<Accordion title="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.

</Accordion>
<Accordion title="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.

</Accordion>
<Accordion title="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](/pt/docs/streaming/) para detalhes.

</Accordion>
<Accordion title="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](/pt/docs/retries/).

</Accordion>
<Accordion title="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.

</Accordion>
</AccordionGroup>

## Status do serviço e ajuda

<AccordionGroup>
<Accordion title="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.

</Accordion>
<Accordion title="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](/pt/docs/troubleshooting/).

</Accordion>
</AccordionGroup>