Documentação do Oracle Cloud Infrastructure

Importando um Modelo de Hugging Face

Importe modelos compatíveis de código aberto e de terceiros do Hugging Face para a OCI Generative AI, hospede-os, crie pontos finais e use-os como qualquer outro modelo.

Observação

Para obter uma lista de modelos compatíveis, consulte Modelos Compatíveis para Importação.

  • Na página da lista Importar modelos, selecione Importar modelo. Se precisar de ajuda para localizar a página da lista, consulte Listando Modelos Importados.

    Definição de modelo

    1. (Opcional) Para salvar o modelo importado em um compartimento diferente do listado, selecione outro compartimento.
    2. (Opcional) Informe um nome para o modelo importado. Inicie o nome com uma letra ou sublinhado, seguido de letras, números, hifens ou sublinhados. O comprimento pode ser de 1 a 255 caracteres. Se você não informar um nome, o sistema irá gerar um nome que você poderá alterar posteriormente.
      O nome gerado tem o formato generativeaiimportedmodel<timestamp>. Por exemplo: generativeaiimportedmodel20251107214133
    3. (Opcional) Informe uma descrição para o modelo.
    4. (Opcional) Digite uma versão para o modelo. Se você não informar uma versão, o sistema gerará uma versão que você poderá alterar posteriormente.
      A versão gerada tem o formato v<timestamp>. Por exemplo: v20251107214133
    5. (Opcional) Insira o fornecedor do modelo. Se você não inserir um nome de fornecedor, esse campo permanecerá em branco e você poderá atualizá-lo posteriormente.
    6. (Opcional) Atribua tags a este modelo importado. Consulte Tags de Recursos.
    7. Selecione Próximo.

    Importar configuração

    1. Selecione Aceitando o modelo Face para o local do modelo que você deseja importar.
    2. Informe o ID do Modo.

      O ID do modelo é a string exibida para cada modelo na placa de modelo. Por exemplo, Qwen/Qwen3-4B. Consulte Modelos Compatíveis para Importação.

    3. Selecione o diretório de artefato do modelo.
      Se o diretório contiver o modelo e seus artefatos, o conteúdo do diretório será exibido na seção de visualização do diretório.
    4. Se o conteúdo do diretório estiver correto, selecione Enviar.
    Dica

    Depois de importar o modelo, execute as seguintes tarefas:
    1. Criar um cluster de IA dedicado de hospedagem.
    2. Criar um ponto final.
    3. Use o modelo no playground.

  • Use o comando imported-model create-from-huggingface e os parâmetros necessários para importar um modelo:

    oci generative-ai imported-model create-from-huggingface [OPTIONS]

    Para obter uma lista completa de parâmetros e valores para comandos da CLI, consulte a Referência de Comandos da CLI.

  • Execute a operação CreateImportedModel para importar um modelo.