{"id":3977,"date":"2025-05-20T15:23:03","date_gmt":"2025-05-20T18:23:03","guid":{"rendered":"https:\/\/www.l2maker.com.br\/documentacao\/?p=3977"},"modified":"2025-05-21T14:04:46","modified_gmt":"2025-05-21T17:04:46","slug":"usando-o-openia-api-no-maker","status":"publish","type":"post","link":"https:\/\/www.l2maker.com.br\/documentacao\/2025\/05\/usando-o-openia-api-no-maker\/","title":{"rendered":"Usando o OpenAI API no Maker (ChatGPT)"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">A API do ChatGPT \u00e9 fornecida pela OpenAI ( <a href=\"https:\/\/openai.com\/api\/\">https:\/\/openai.com\/api\/<\/a> ) \u00e9 necess\u00e1rio ter uma conta e cr\u00e9ditos de uso.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Inicializa\u00e7\u00e3o da conex\u00e3o<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">Para inicializar uma conex\u00e3o com esta API \u00e9 necess\u00e1rio passar os seguintes dados:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>&#8220;<strong>openai.com<\/strong>&#8221; (Letras) &#8211; Valor fixo;<\/li>\n\n\n\n<li>Mapeamento (Variante) contendo os seguintes itens:\n<ul class=\"wp-block-list\">\n<li><strong>ORGANIZATION_ID <\/strong>(Letras) &#8211; Id d organiza\u00e7\u00e3o (obter no site do fornecedor), ver em: <a href=\"https:\/\/platform.openai.com\/settings\/organization\/general\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/platform.openai.com\/settings\/organization\/general<\/a>;<\/li>\n\n\n\n<li><strong>API_KEY <\/strong>(Letas) &#8211; Token de acesso a API (criado no site do fornecedor), ver em: <a href=\"https:\/\/platform.openai.com\/api-keys\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/platform.openai.com\/api-keys<\/a><\/li>\n\n\n\n<li><strong>PROJECT_ID <\/strong>(Letras) &#8211; OPCIONAL.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n\n\n\n<h4 class=\"wp-block-heading\">Listar modelos suportados<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">Utilize a fun\u00e7\u00e3o &#8220;<strong>IA &#8211; Listar Modelos<\/strong>&#8221; que ir\u00e1 retornar os nomes dos modelos dispon\u00edveis. As qualidades\/especialidades e custos de cada modelo devem ser conferidas no site do fornecedor.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Envio de texto ou imagem<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">Para processar texto &#8220;<strong>IA &#8211; Processar Texto<\/strong>&#8221; ou imagens &#8220;<strong>IA &#8211; Processar Imagem<\/strong>&#8220;, no \u00faltimo par\u00e2metro das fun\u00e7\u00f5es \u00e9 poss\u00edvel enviar um mapa com valores opcionais. Entre eles:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>&#8220;<strong>MODELO<\/strong>&#8221; (Letras): Nome do modelo a ser usado;<\/li>\n\n\n\n<li>&#8220;<strong>USUARIO_ID<\/strong>&#8221; (Letras): Identificador \u00fanico do usu\u00e1rio do sistema, permitindo ao OpenAI detectar abusos.<\/li>\n\n\n\n<li>&#8220;<strong>TOKENS_QUANTIDADE_MAXIMA<\/strong>&#8221; (Inteiro):  N\u00famero m\u00e1ximo de tokens (pr\u00f3ximo de &#8216;silabas&#8217;, maiores detalhes na documenta\u00e7\u00e3o do fornecedor);<\/li>\n\n\n\n<li>&#8220;<strong>IMAGEM_NIVEL_DETALHES<\/strong>&#8221; (Letras): N\u00edvel de detalhes da imagem podendo ser &#8220;auto&#8221;, &#8220;low&#8221; e &#8220;high&#8221;.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Fun\u00e7\u00f5es personalizadas (Callback)<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">O OpenAI permite definir fun\u00e7\u00f5es que ser\u00e3o chamadas para concluir ou completar uma a\u00e7\u00e3o. <\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Para tal deve ser utilizado um texto JSON no padr\u00e3o definido pela OpenAI:<br><a href=\"https:\/\/platform.openai.com\/docs\/guides\/function-calling?api-mode=responses&amp;example=send-email#defining-functions\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/platform.openai.com\/docs\/guides\/function-calling?api-mode=responses&amp;example=send-email#defining-functions<\/a><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">OBS: Instru\u00e7\u00f5es sobre defini\u00e7\u00f5es de fun\u00e7\u00f5es fogem do escopo do suporte.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Dicas de uso<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">No envio de imagem voc\u00ea pode pedir pra ele extrair informa\u00e7\u00f5es espec\u00edficas, como por exemplo:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Enviar uma CNH e pedir n\u00famero, nome e data de vencimento;<\/li>\n\n\n\n<li>Enviar uma p\u00e1gina de documento e pedir um resumo;<\/li>\n\n\n\n<li>Enviar uma conta de agua ou energia e pedir total e data de vencimento.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Restri\u00e7\u00f5es de uso<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>A API s\u00f3 aceita JPG, PNG, WEBP em RGB ou RGBA ( <a href=\"https:\/\/platform.openai.com\/docs\/guides\/vision-fine-tuning#image-data-requirements\">https:\/\/platform.openai.com\/docs\/guides\/vision-fine-tuning#image-data-requirements<\/a> );<\/li>\n\n\n\n<li>As pol\u00edticas de uso da OpenAI devem ser seguidas, \u00e9 necess\u00e1rio ter cr\u00e9ditos e uma conta ativa.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Suporte t\u00e9cnico<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">O suporte a API se restringe \u00e0 estrita comunica\u00e7\u00e3o da API com o servidor da <a href=\"https:\/\/platform.openai.com\/docs\/guides\/vision-fine-tuning#image-data-requirements\">openai.com<\/a>. D\u00favidas sobre cria\u00e7\u00e3o de conta, custos, consumo de cr\u00e9ditos devem ser tratados diretamente com a fornecedora.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Instru\u00e7\u00f5es sobre montagem de prompts (perguntas), capacidades e limita\u00e7\u00f5es dos servi\u00e7os de intelig\u00eancia artificial, modelos a serem usados ou treinamento, capacita\u00e7\u00e3o de qualquer tipo fogem do escopo do suporte.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>A API do ChatGPT \u00e9 fornecida pela OpenAI ( https:\/\/openai.com\/api\/ ) \u00e9 necess\u00e1rio ter uma conta e cr\u00e9ditos de uso. Inicializa\u00e7\u00e3o da conex\u00e3o Para inicializar uma conex\u00e3o com esta API \u00e9 necess\u00e1rio passar os seguintes dados: Listar modelos suportados Utilize a fun\u00e7\u00e3o &#8220;IA &#8211; Listar Modelos&#8221; que ir\u00e1 retornar os nomes dos modelos dispon\u00edveis. As [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[411],"tags":[],"class_list":["post-3977","post","type-post","status-publish","format-standard","hentry","category-documentacao-inteligencia-artificial"],"_links":{"self":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/posts\/3977","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/comments?post=3977"}],"version-history":[{"count":11,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/posts\/3977\/revisions"}],"predecessor-version":[{"id":4015,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/posts\/3977\/revisions\/4015"}],"wp:attachment":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/media?parent=3977"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/categories?post=3977"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/tags?post=3977"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}