Skip to main content

Prosa

O Prosa é o produto da Magalu Cloud para ativar modelos de linguagem (LLMs) e consumi-los na sua aplicação por meio de uma API compatível com o padrão OpenAI. Em poucos passos você ativa um modelo do catálogo, cria uma chave de API e já pode fazer chamadas — sem precisar provisionar GPUs ou gerenciar infraestrutura.

O Prosa está em Piloto.

Nesta página você vai aprender a:

  • Acessar o Prosa
  • Ativar um modelo do catálogo
  • Ver seus modelos ativos, uso e custos
  • Consultar os detalhes de um modelo
  • Gerenciar chaves de API (criar, exibir, copiar, ativar/inativar)
  • Integrar via Explorar API
  • Testar no Playground
  • Desativar um modelo

Como acessar​

No console da Magalu Cloud (console.magalu.cloud), você abre o Prosa por um destes caminhos:

  • Menu lateral → Prosa (marcado como Preview); ou
  • Página Inicial → card Prosa, que lista seus modelos e traz o botão + Ativar modelo.

Visão geral da tela​

A tela principal do Prosa apresenta:

  • O título Prosa e o link Saiba mais sobre Prosa.
  • O botão + Ativar modelo (canto superior direito).
  • Cards de resumo com o consumo geral:
    • Modelos ativos
    • Total de requisição
    • Tokens usados
    • Custo total
  • Duas abas: Meus Modelos e Playground.

Se você ainda não ativou nenhum modelo, verá o estado “Ative seu primeiro modelo” com um botão para começar.

1. Ativar um modelo​

Clique em + Ativar modelo para abrir o fluxo de ativação, dividido em duas etapas.

Etapa 1 — Modelo​

Em Escolha o modelo base para sua inferência, é exibido o catálogo de modelos disponíveis em uma tabela com:

  • Modelos — nome e provedor (ex.: Google, Meta, NVIDIA, Qwen)
  • Provedor
  • Contexto — janela de contexto (ex.: 256k)
  • Preço

Use o campo Pesquisar para localizar um modelo e selecione-o pelo botão de opção (à esquerda da linha).

Modelos que você já ativou aparecem com a etiqueta Já ativo e não podem ser selecionados novamente.

Etapa 2 — Controle de uso​

Em Defina o valor para o uso mensal, informe o Orçamento mensal (em R$) que deseja permitir para o modelo. Esse campo é opcional.

No painel à direita, Estimativa mensal total mostra o resumo e o valor previsto. Clique em Continuar (ou Ir para a revisão).

Revisão e confirmação​

Na tela de Revisão, confira as Configurações (modelo escolhido, parâmetros e contexto, orçamento mensal). Use Editar para voltar e ajustar. Quando estiver tudo certo, clique em Ativar modelo.

Ao concluir, é exibida a confirmação “Modelo foi ativado com sucesso! Consulte sua API Key para autenticar suas chamadas.” e o modelo passa a aparecer em Meus Modelos.

2. Ver seus modelos (Meus Modelos)​

A aba Meus Modelos lista, em formato de tabela, todos os modelos ativos:

  • Modelo — nome do modelo (clicável, leva aos detalhes)
  • Chaves — quantidade de chaves de API do modelo
  • Requisições — total de requisições
  • Custo — custo acumulado
  • Status — Ativo ou Desativado

Use Pesquisar modelos ativos para filtrar pela lista. No menu de opções (⋮) de cada linha você encontra:

  • Ver detalhes — abre a tela de detalhes do modelo.
  • Desativar modelo — encerra o uso do modelo (veja a seção Desativar um modelo).

3. Detalhes do modelo​

Clique no nome de um modelo em Meus Modelos para abrir os detalhes. A tela traz:

  • Informações do modelo:
    • Modelo e parâmetros
    • RPM e TPM (limites de requisições e tokens por minuto)
    • Limite do modelo (ex.: Uso ilimitado)
  • Métricas de uso: Chaves ativas, Total de requests, Tokens usados e Custo total.
  • No topo, o status do modelo (Ativo / Desativado) — pelo menu desse botão é possível Inativar modelo.
  • A seção API Keys, onde você gerencia as chaves do modelo.

4. Gerenciar chaves de API​

As chaves de API ficam na seção API Keys, dentro dos detalhes do modelo. Cada modelo pode ter várias chaves.

⚠️ As API Keys são individuais. Não as compartilhe e mantenha-as em segurança para evitar acesso não autorizado por terceiros.

Criar uma chave​

  1. Na seção API Keys, clique em Criar API Key.
  2. Em Nome da API Key, defina um nome (ex.: minha-api-key). São aceitos apenas letras, números, hifens e pontos.
  3. Clique em Criar API Key.

Após a criação, não é possível editar o nome ou as configurações da chave. A nova chave aparece na lista de API Keys do modelo.

Visualizar e copiar​

Expanda uma chave para ver:

  • Chave — use o ícone de olho para exibir/ocultar e o de cópia para copiar.
  • Base URL — o endpoint a ser usado nas chamadas, também com exibir/copiar.
  • Uso da chave — Criação, Último uso, Latência média, Total de requests, Média de consumo diário e Saldo consumido.

Ativar ou inativar uma chave​

Cada chave tem um status (Ativa / Inativa). Pelo seletor de status você pode Ativar chave ou Inativar chave a qualquer momento — útil para suspender o acesso sem excluir a chave.

5. Integrar com sua aplicação (Explorar API)​

Na seção API Keys, cada chave tem o botão Explorar API, que mostra exemplos de código prontos:

  • Linguagens: Python, Node.js, TypeScript, cURL, Go, Java e .NET.
  • Modos: Rest ou Stream.
  • Botão para copiar o código exibido.

A API é compatível com o padrão OpenAI, então você pode usar os SDKs oficiais da OpenAI apontando para a Base URL e a API Key fornecidas pelo Prosa.

Exemplo em Python:

from openai import OpenAI

client = OpenAI(
    api_key="SUA_API_KEY",       # copie nos detalhes do modelo
    base_url="SUA_BASE_URL/v1"   # copie no campo Base URL da chave
)

response = client.chat.completions.create(
    model="NOME_DO_MODELO",
    messages=[
        {"role": "user", "content": "Olá!"}
    ]
)

print(response.choices[0].message.content)

Exemplo com cURL:

curl -X POST "SUA_BASE_URL/v1/chat/completions" \
  -H "Content-Type: application/json" \
<<<<<<< HEAD
  -H "Authorization: Bearer ${PROSA_API_KEY}" \ # gitleaks:allow
=======
>>>>>>> f782ab7a (prosa - first commit)
  -d '{
    "model": "NOME_DO_MODELO",
    "messages": [
      {"role": "user", "content": "Olá!"}
    ]
  }'

Adicione o cabeçalho de autorização com a sua API Key no seu ambiente de execução antes de enviar a requisição.

6. Testar no Playground​

A aba Playground permite conversar com seus modelos ativos sem escrever código.

  1. Selecione um modelo na lista.
  2. Selecione uma chave ativa do modelo.
  3. Escolha o modo de resposta:
    • Stream — a resposta aparece em tempo real, conforme é gerada.
    • REST — a resposta chega de uma só vez.
  4. Digite sua mensagem e pressione Enter para enviar (use Shift + Enter para quebrar linha).

Para começar do zero, use o menu de opções (⋮) da conversa e clique em Limpar conversa.

Só é possível testar com chaves ativas. Se o modelo não tiver nenhuma chave ativa, crie ou ative uma na tela de detalhes.

7. Desativar um modelo​

Você pode desativar um modelo pelo menu ⋮ em Meus Modelos ou pelo botão de status na tela de detalhes (Inativar modelo).

Será exibida uma confirmação:

Esta ação desativa automaticamente todas as chaves deste modelo. Você pode ativá-lo novamente e criar novas chaves a qualquer momento.

Confirme em Desativar modelo para concluir.

Perguntas frequentes​

Onde encontro minha API Key e a Base URL? Nos detalhes do modelo (clique no nome do modelo em Meus Modelos), seção API Keys. Expanda a chave para exibir e copiar ambas.

Posso ter mais de uma chave por modelo? Sim. Crie quantas chaves precisar em Criar API Key, cada uma com seu próprio nome e métricas de uso.

Como suspendo o acesso sem excluir a chave? Use Inativar chave no seletor de status da chave. Para reativar, use Ativar chave.

Posso usar os SDKs da OpenAI? Sim. A API é compatível com o padrão OpenAI — basta apontar o SDK para a Base URL e a API Key do Prosa.

Como evito gastos inesperados? Defina o Orçamento mensal na etapa Controle de uso ao ativar o modelo. O consumo é pausado automaticamente ao atingir o limite.

Desativei um modelo. Consigo voltar atrás? Sim. A desativação inativa as chaves do modelo, mas você pode reativá-lo e criar novas chaves quando quiser.