API de Conclusões do OCI Chat
Use a API de Conclusões de Chat do OCI se você já tiver um código de aplicativo criado em torno da API de Conclusões de Chat ou se precisar de uma interface de chat sem monitoramento de estado mais simples. Para novos aplicativos, recomendamos que você use a API de Respostas do OCI. Se você precisar de um histórico de conversas de várias turnos gerenciado pela OCI, use a API de Respostas juntamente com a API de Conversas.
A API de Conclusões de Chat do OCI usa o mesmo formato da API de Conclusões de Chat do OpenAI com o ponto final compatível com o OCI OpenAI. Para obter detalhes de sintaxe e solicitação, consulte a documentação da API de Conclusões do OpenAI Chat.
Recomendamos que você use a API de Respostas do OCI para que possa usar o suporte à ferramenta mais recente e a API de Conversas.
Use a API de Respostas quando precisar:
- Ferramentas suportadas
- Fluxos de trabalho em várias etapas
- Saídas estruturadas
- Histórico de conversas gerenciadas pela OCI
- Uma interface principal para fluxos de trabalho agênticos
Use a API de Conclusões de Bate-papo quando:
- Já tem código de aplicativo criado em torno de
/chat/completions - Precisa de uma interface de bate-papo sem monitoramento de estado mais simples
- Não precisa de recursos da API de Respostas, como ferramentas suportadas ou estado da conversa gerenciada pelo OCI
Ponto Final de API Suportado
| URL Base | Caminho do Ponto Final | Autenticação |
|---|---|---|
https://inference.generativeai.${region}.oci.oraclecloud.com/openai/v1 |
/chat/completions |
Chave de API ou sessão do IAM |
Substitua ${region} por uma região suportada, como us-chicago-1.
Embora o formato de solicitação seja compatível com OpenAI, a autenticação usa credenciais da OCI, as solicitações são roteadas por meio de pontos finais de inferência da OCI Generative AI e os recursos e a execução permanecem na OCI.
Para saber as etapas a serem executadas antes de usar essa API, consulte o Guia de Início Rápido.
API de Respostas ou Conclusões de Chat?
| Dimensão | API de Respostas do OCI | API do OCI Chat usando a API de Conclusões de Chat |
|---|---|---|
| Uso principal | API unificada para interação de modelo e recursos agênticos | API para interação de modelo |
| Melhor ajuste | Chat interativo, cargas de trabalho ágeis e tarefas de longa execução | Chatbots interativos e conclusão de texto |
| Orquestração | Raciocínio integrado de várias etapas e várias chamadas de ferramentas | Inferência ou geração de etapa única; fluxos de várias etapas exigem orquestração externa |
| Gerenciamento de contexto | Com monitoramento de estado por padrão, com uso sem monitoramento de estado opcional | Sem monitoramento de estado somente quando o cliente gerencia o histórico de conversas |
| Suporte a ferramentas | Ferramentas integradas, como File Search, Code Interpreter e MCP remoto | Limitado a ferramentas do lado do cliente por meio de chamada de função |
| Suporte multimodal | Suporta entradas de texto e imagem e saídas de texto | Principalmente texto, com suporte multimodal dependendo do modelo |
| Streaming | Streaming baseado em eventos com eventos refinados | Streaming baseado em token |
| Saída estruturada | Saídas estruturadas nativas e aplicação de esquema JSON | O modo JSON é suportado, mas é menos composível |
| Integração de arquivos e vetores | Pode ser usado com a API de Arquivos e a API de Armazenamentos de Vetor | Requer orquestração separada |
| Extensibilidade | Projetado para fluxos de trabalho, memória e contêineres habilitados para ferramentas | Projetado principalmente para aplicativos de chat |