ima: modelos personalizados, API Key, URL base e erros
Configure uma API Key, uma URL base e o ID exato do modelo no ima. Confira respostas, resolva falhas e diferencie modelos de chat do acesso à API da base de conhecimento.
Este guia conecta o ima a uma API externa de modelos de chat. Use uma versão com a opção de adicionar modelos personalizados; os menus no computador e no celular podem variar. A API Key e a URL base devem ser do mesmo provedor. Copie o ID exato da lista atual; modelos em capturas antigas são exemplos. Não informe a URL completa de /chat/completions nem repita /v1. Comece com os limites padrão e uma pergunta curta. Salvar a configuração não confirma uma chamada de API bem-sucedida.
ima: modelos personalizados, API Key, URL base e erros
Etapa 1: abra o seletor de modelos
Na parte inferior da interface de conversa do ima copilot, localize o botão “DS Rápido” (destacado em vermelho na figura 1) e toque nele para abrir o menu de seleção de modelos.
A imagem mostra a interface do aplicativo ima no celular, no contexto da…
Etapa 2: acesse “Adicionar modelo personalizado”
No menu de modelos, localize o botão “Adicionar modelo personalizado” e toque nele para abrir a página de configuração de modelos personalizados.
A imagem mostra a interface de adição de um modelo personalizado no celu…
Etapa 3: selecione o fornecedor do modelo (você pode escolher “Personalizado”)
Na página “Adicionar modelo personalizado”, toque no menu suspenso “Fornecedor do modelo” (como na figura 4). Você pode escolher um fornecedor predefinido, como DeepSeek, Kimi ou Zhipu. Para integrar um modelo de terceiros ou hospedado por você, selecione “+ Personalizado” (a opção “Personalizado” já vem selecionada por padrão, então você pode pular esta etapa).
A imagem mostra o menu de seleção do fornecedor durante a adição de um m…
Etapa 4: preencha as principais informações do modelo
Na página de configuração, você precisa preencher 3 itens essenciais (destacados em vermelho na figura 5):
- Endereço da API: insira o endereço da API do modelo (por exemplo,
https://api.llm-token.cn/v1, como mostrado; substitua-o pelo endereço real da API que deseja integrar). - API Key: insira a chave de API do modelo (em um formato como
sk-xxxxxx..., obtida com o provedor do modelo). - Nome do modelo: insira o nome do modelo (por exemplo,
gpt-5.5ouclaude-sonnet-4-6; ele deve corresponder ao nome aceito pela API).
Nas configurações avançadas, mantenha os comprimentos de entrada/saída em “Usar valores padrão”; não é necessário alterá-los.
A imagem mostra a tela usada para configurar um modelo personalizado no…
Etapa 5: salve o modelo personalizado
Depois de preencher os dados, toque no botão “Salvar” no canto superior direito (indicado pela mão na figura 5). O modelo será adicionado automaticamente à lista de “Modelos personalizados” (na figura 6, o novo modelo claude-opus-4-8 foi adicionado e já pode ser selecionado).
Uso posterior: mude para um modelo personalizado
Volte ao menu de seleção de modelos (o botão “DS Rápido” da etapa 1). Na lista de “Modelos personalizados”, você verá o modelo adicionado (como na figura 6); basta tocar nele para começar a usar~
A imagem mostra o menu de seleção de modelos no celular. Na parte superi…
Falhas em solicitações ao modelo personalizado
| Sintoma | Primeira verificação |
|---|---|
| Erro de autenticação ou 401 | Chave completa, válida e emitida pelo provedor dessa URL. |
| Modelo não encontrado ou acesso negado | ID exato na lista atual e permissão dessa chave. |
| 404 ou interface não encontrada | URL base, caminho completo da solicitação e duplicação de /v1/v1. |
| Configuração salva, mas envio falha | Seleção da nova configuração, saldo, estado do serviço e rede. |
| Perguntas curtas funcionam, conteúdo longo falha | Limites de entrada/saída, orçamento de contexto e limites do provedor. |
Ao contatar o suporte, informe horário, ID do modelo, erro completo e ID da solicitação, se disponível. Oculte a API Key.
Modelos de chat e API da base de conhecimento do ima
Esta configuração permite ao ima chamar um modelo de chat externo. Para um agente externo ler ou escrever em uma base ima, verifique separadamente as interfaces oficiais, autenticação e permissões. Salvar um modelo de chat não configura esse acesso.
Confirmar IDs de modelo e preços
Copie o ID exato do catálogo atual do provedor. Confira separadamente os preços de entrada, saída e cache; capturas antigas não confirmam a disponibilidade nem os preços atuais.
Modelos e cobrança atuais
Entrada, saída e entrada em cache podem ter tarifas diferentes. Para imagens, vídeos ou modelos cobrados por solicitação, confira a unidade de cobrança. Consulte IDs e tarifas na página de preços atual; os valores cobrados constam nos registros de faturamento.