OpenAI Provider
OpenAI utiliza o transporte compatível com OpenAI compartilhado. A predefinição atual usa gpt-4o, https://api.openai.com/v1, temperature: 0.5 e o teste de conexão models-then-chat. Use esta página quando precisar da semântica exata dos campos; use a visão geral LLM Providers para seleção em nível de categoria.
Isso faz parte do Obsidian Guia de Gestão de Conhecimento de IA.
Configuração
Criar uma chave OpenAI API, adicionar um perfil de provedor OpenAI nas configurações Notemd e manter o Base URL padrão, a menos que esteja apontando intencionalmente para um gateway compatível com OpenAI. O campo do modelo pode permanecer em gpt-4o para trabalhos gerais ou ser substituído por outro ID de modelo OpenAI que sua conta possa chamar.
Use modelos específicos para cada tarefa para controle de custos: mantenha modelos mais poderosos para pesquisa, extração de conceitos e reestruturação de textos longos; use modelos mais baratos ou rápidos para tradução, sugestões de links e resumos curtos.
Endpoint e Autenticação
| Campo | Predefinição atual |
|---|---|
| Transporte | openai-compatible |
| Chave API | Necessário |
| Base URL | https://api.openai.com/v1 |
| Modelo padrão | gpt-4o |
| Temperatura | 0.5 |
| Teste de conexão | /models, depois /chat/completions |
Notemd normaliza os Base URL compatíveis com OpenAI antes de anexar chat/completions ou models. Não inclua um /chat/completions final no Base URL; isso cria um caminho duplicado.
Descoberta de modelos
OpenAI usa o caminho genérico de descoberta de modelos compatível com OpenAI. As configurações UI primeiro perguntam ao /v1/models e depois validam o modelo selecionado com uma solicitação de chat leve. Se a descoberta falhar, mas o chat ainda funcionar, verifique se sua chave tem permissão de lista de modelos ou se um gateway bloqueia a listagem de modelos.
Modelos de raciocínio são tratados como um caso especial de protocolo: Notemd mescla o conteúdo da solicitação do sistema e do usuário para IDs de raciocínio OpenAI que rejeitam um papel separado de system, e exibe apenas o reasoningEffort onde a definição do provedor o permite.
Solução de problemas
401ou403: verifique a chave, o acesso ao projeto, o status de faturamento e se o modelo selecionado está habilitado para a chave.404no chat: o Base URL geralmente está incorreto ou já inclui o/chat/completions.- O modelo aparece nos documentos, mas não no seletor: o acesso à lista de modelos e o acesso ao chat são pontos de falha separados; teste manualmente o ID exato do modelo no perfil do provedor.
- Modelo de raciocínio rejeita mensagens: use um ID de modelo coberto pelo caminho de tratamento de raciocínio OpenAI ou mude para um modelo de chat que não faça raciocínio.
Quando Usar
Use OpenAI quando desejar o caminho hospedado padrão mais previsível, quando a descoberta de /v1/models é importante ou quando um fluxo de trabalho depende da semântica do modelo de raciocínio OpenAI. Prefira um gateway ou provedor local quando roteamento, privacidade ou controle de custos são mais importantes do que o comportamento direto de OpenAI API.
Próximos passos
- LLM Providers -- Configuração completa, modelos por tarefa e lógica de tentativa
- Solução de problemas -- Corrigir erros 401/403 e limitações de taxa