Como Usar um Projeto

Use os exemplos de código do projeto para chamar a API compatível com o OCI OpenAI ou criar um sandbox.

  1. Na página de lista Projetos, selecione o projeto que você deseja usar. Se precisar de ajuda para localizar a página da lista, consulte Listando Projetos.
  2. Selecione a guia Como usar.
    Para inferência de modelo, selecione uma das duas opções de autenticação. Substitua os placeholders nos exemplos pelo OCID e pelas credenciais do seu projeto e use um ponto final e um modelo disponíveis na sua região. As chamadas de API de Sandbox usam a autenticação do OCI IAM separadamente.
  3. Se você for acessar os modelos usando a autenticação de Chave de API do Serviço Generative AI, copie o código da opção um.

    Exemplo de código:

    from openai import OpenAI
    
    client = OpenAI(
        base_url="https://inference.generativeai.us-chicago-1.oci.oraclecloud.com/openai/v1",
        api_key="<your-api-key>", # replace with your Generative AI API Key
        project="<project-ocid>",
    )
    
    response = client.responses.create(
        model="openai.gpt-oss-120b",
        input="What is 2x2?"
    )
    
    print(response.output_text) # should output a string like "2 x 2 = **4**."
    
  4. Se você for acessar os modelos usando a autenticação do IAM, copie o código da opção dois.

    Exemplo de código:

    from openai import OpenAI
    from oci_genai_auth import OciSessionAuth
    import httpx
    import os
    
    profile = os.environ.get("OCI_PROFILE", "DEFAULT")
    
    client = OpenAI(
        base_url="https://inference.generativeai.us-chicago-1.oci.oraclecloud.com/openai/v1",
        api_key="not-used",
        project="<project-ocid>",
        http_client=httpx.Client(auth=OciSessionAuth(profile_name=profile)),
    )
    
    response = client.responses.create(
        model="openai.gpt-oss-120b",
        input="What is 2x2?"
    )
    
    print(response.output_text)
    
  5. (Opcional) Para criar um sandbox, copie o comando em Criar Sandbox da CLI ou do SDK.

    Ative sandboxes para o projeto e aguarde o projeto se tornar Ativo antes de executar o comando. Defina profile_name, region e project_id para seus valores:

    oci --profile "$profile_name" --auth security_token --region "$region" \
      generative-ai-sandbox sandbox create \
      --project-id "$project_id" \
      --display-name my-sandbox \
      --runtime python-3.11 \
      --shape SMALL \
      --expiration-duration PT5M

    Este exemplo solicita uma sandbox de cinco minutos. Consulte Criando e Usando um Sandbox para obter pré-requisitos e o workflow completo.