Contas e acesso
| Termo | Significado | Aplica-se a |
|---|---|---|
| Administrador | Uma função do espaço de trabalho que gerencia as configurações exclusivas de administradores, como orçamentos, regras de gastos, guardrails e políticas de confiança, e lê o registro de auditoria. | API, Painel, CLI, MCP |
| Espaço de trabalho | Um contêiner que mantém as próprias chaves de API, configurações de roteamento, predefinições, guardrails e acesso de administração separados de outros espaços de trabalho. | API, Painel, CLI |
| Membro | Uma função do espaço de trabalho que usa o espaço de trabalho e pode ver as regras de gastos dele, mas não pode alterar configurações exclusivas de proprietários e administradores. | API, Painel, CLI, MCP |
| Proprietário | Uma função do espaço de trabalho que gerencia as mesmas configurações de um administrador e recebe os e-mails para proprietários, como alertas de descontinuação de modelos. | API, Painel, CLI, MCP |
Chaves e autenticação
| Termo | Significado | Aplica-se a |
|---|---|---|
| Alternativa de BYOK | Uma configuração do espaço de trabalho que decide se uma solicitação BYOK que falhou pode ser repetida com créditos do Phaseo. | API, Painel |
| App OAuth | Um app que faz o login das pessoas com o Phaseo OAuth e age em nome delas dentro dos escopos e do espaço de trabalho que elas aprovam. | API, Painel, CLI, MCP |
| BYOK | Bring your own key: o Phaseo roteia as solicitações com a chave de API do seu provedor, e o provedor cobra o uso do modelo. | API, Painel |
| Chave de API | Um segredo que começa com phaseo_v1_sk_, enviado como token bearer para autenticar solicitações de modelos e de geração. | API, Painel, CLI, SDK, MCP |
| Chave de gerenciamento | Um segredo que começa com phaseo_v1_mk_ para APIs de administração, como chaves, predefinições e guardrails; ela não pode enviar solicitações de inferência. | API, Painel |
| Recurso (capability) | Uma permissão em uma chave de gerenciamento ou em um login OAuth, como keys:write, que decide quais APIs de administração ela pode chamar. | API, Painel, CLI, MCP |
| Workload confiável | Uma implantação ou job de CI que envia o token OIDC de curta duração da plataforma em vez de uma chave de API, reconhecido por uma política de confiança. | API, Painel |
Modelos e provedores
| Termo | Significado | Aplica-se a |
|---|---|---|
| Aposentado (modelo) | A data de aposentadoria já passou; as solicitações funcionam enquanto um provedor servir o modelo e depois falham com 410 model_retired. | API, Painel |
| Descontinuado (modelo) | O laboratório ou o provedor anunciou a aposentadoria do modelo, e as solicitações dele continuam sendo atendidas normalmente. | API, Painel |
| Ícone de status do provedor | O status que o Phaseo define manualmente para uma rota de provedor: Active, Lower priority (só como reserva) ou Disabled. | Painel |
| ID de modelo qualificado por provedor | Um ID de modelo com prefixo de provedor, como baseten:thinking-machines/inkling-small, que roda nesse provedor sem alternativa. | API, SDK |
| ID do modelo | O ID que você envia em model, como openai/gpt-6-astra, mostrado no início rápido de cada página de modelo. | API, Painel, CLI, SDK, MCP |
| Modelo privado | Uma implantação dedicada ou auto-hospedada compatível com OpenAI adicionada ao seu espaço de trabalho, que só o seu espaço de trabalho pode ver ou chamar. | API, Painel |
| Modelo roteável | Um modelo com pelo menos uma rota de provedor ativa no Gateway agora; por padrão, GET /v1/models lista só esses modelos. | API, Painel, MCP |
| Provedor | Uma empresa que hospeda um modelo e define a disponibilidade, os parâmetros aceitos, os preços e o desempenho dele. | API, Painel, SDK, MCP |
| Quantização | Armazenar os pesos de um modelo em um tipo numérico menor, como FP8 ou INT4, que responde mais rápido com alguma perda de qualidade. | API, Painel, SDK |
| Tamanho do contexto | O tamanho de contexto que uma rota de provedor aceita para um modelo, mostrado para cada provedor na página do modelo. | API, Painel |
Solicitações e respostas
| Termo | Significado | Aplica-se a |
|---|---|---|
| Cache de prompts | Manter o início de um prompt igual para que o provedor o leia do cache e o cobre pela tarifa de leitura de cache. | API, SDK |
| Esforço de raciocínio | Quanto um modelo de raciocínio pensa antes de responder, definido com reasoning.effort ou reasoning_effort, de none a max. | API, SDK |
| Gateway | A API do Phaseo em https://api.phaseo.app/v1, que roteia cada solicitação para um provedor que hospeda o modelo. | API, SDK |
| ID de geração | O ID de solicitação que começa com G-, retornado em x-request-id e nos corpos de erro; use-o para logs, consultas e suporte. | API, Painel, SDK |
| ID de sessão | Um session_id que você envia para manter as solicitações de uma conversa em um provedor, por até 24 horas de atividade. | API, Painel, SDK |
| Nível de serviço | Um nível de velocidade e preço para uma solicitação de texto (standard, fast, ultrafast ou flex), atendido só por provedores que o oferecem. | API, SDK |
| Objeto usage | O campo usage em uma resposta, que informa as contagens de tokens de entrada, saída e cache da solicitação. | API, SDK |
| Streaming | Definir stream: true para que o Gateway envie a saída como server-sent events enquanto o modelo a escreve. | API, SDK |
| Tokens | As unidades que um modelo lê como entrada e escreve como saída; cada token aumenta a latência e o custo. | API, Painel, SDK |
| Tokens de raciocínio | Tokens que um modelo de raciocínio gasta antes de responder; eles contam como saída e usam parte do limite de saída. | API, SDK |
| Tokens em cache | Tokens de entrada que o provedor leu do cache de prompts, cobrados pela tarifa de leitura de cache e informados em cached_tokens. | API, SDK |
Roteamento
| Termo | Significado | Aplica-se a |
|---|---|---|
| Alternativa de provedor | Quando o provedor escolhido falha, o Gateway tenta o próximo provedor elegível para o mesmo modelo. | API, SDK |
| Alternativas de modelo | Modelos listados em models, tentados em ordem quando o modelo anterior termina com 429, 500, 502, 503 ou 504. | API, SDK |
| Canais de provedores Alfa e Beta | Opções nas configurações de roteamento para que provedores em prévia só recebam tráfego se você aceitar; provider.include_alpha permite provedores Alfa por solicitação. | API, Painel |
| Ordenação de provedores | Como os provedores são classificados: balanced (padrão, custo por resposta bem-sucedida), price, latency ou throughput. | API, Painel, CLI, SDK |
| Predefinição | Um modelo salvo com prompt de sistema, parâmetros e regras de provedor, que quem chama usa enviando o nome dela, como @support-triage. | API, Painel, SDK |
| Rota dinâmica | Um fluxo versionado de regras associado a chaves de API, que pode ramificar, dividir o tráfego, limitar o uso e trocar de modelo. | API, Painel |
| Roteador gratuito | Envie phaseo/free e o Phaseo executa a solicitação em um modelo gratuito disponível, sem precisar de créditos. | API, SDK |
| Roteamento automático | Envie phaseo/auto e o Phaseo escolhe um modelo para cada solicitação com base na carga de trabalho, no seu objetivo e nos seus limites de preço. | API, Painel, CLI, SDK, Slack |
| Roteamento de modelos aposentados | Uma configuração opcional do espaço de trabalho que envia as solicitações de um modelo que nenhum provedor serve para um substituto aprovado ou escolhido. | API, Painel |
| Roteamento regional | Enviar solicitações de texto para eu.api.phaseo.app ou us.api.phaseo.app para usar só rotas que rodam nessa região. | API, SDK |
| Rótulo de versão da predefinição | Um nome como production que aponta para uma versão publicada de uma predefinição; movê-lo faz as solicitações avançarem ou voltarem de versão. | API, Painel, SDK |
| Template de prompt | Mensagens de uma predefinição com {{variables}}, para que cada solicitação envie só a referência à predefinição e os valores das variáveis. | API, Painel, SDK |
Guardrails e privacidade
| Termo | Significado | Aplica-se a |
|---|---|---|
| Ação de guardrail | O que uma verificação de conteúdo de um guardrail faz quando encontra uma correspondência: Sinalizar, Ocultar ou Bloquear. | API, Painel |
| Guardrail | Uma política em chaves de API ou membros que limita provedores, modelos e tratamento de dados e verifica prompts; ela não limita gastos. | API, Painel |
| Registro de E/S | Uma configuração de privacidade que guarda o prompt e a resposta de cada solicitação, para que você possa vê-los, reexecutá-los ou abri-los no Chat. | API, Painel, Chat |
| Verificação de informações sensíveis | Uma verificação de guardrail que encontra dados como endereços de e-mail, números de telefone e números de cartão antes que a solicitação saia do Phaseo. | API, Painel |
| Verificação de injeção de prompt | Uma verificação de guardrail que procura padrões comuns de injeção de prompt no conteúdo enviado pelo usuário. | API, Painel |
| ZDR | Zero Data Retention: o provedor não guarda prompts nem saídas; exija isso por solicitação, por guardrail ou por espaço de trabalho. | API, Painel, CLI, SDK, MCP |
Ferramentas e saídas
| Termo | Significado | Aplica-se a |
|---|---|---|
| Chamadas de ferramentas | Descrever as suas funções em tools para que o modelo retorne uma chamada que o seu app executa e depois responda com o resultado. | API, SDK |
| Decisions API | POST /v1/decisions, que responde perguntas tipadas (predicate, choice, score) com probabilidades, na ordem em que foram feitas. | API, SDK |
| Ferramenta de servidor | Uma ferramenta phaseo: que o Phaseo executa quando o modelo a chama, como phaseo:web_search, phaseo:web_fetch, phaseo:datetime ou phaseo:advisor. | API, SDK, Chat |
| Reparo de respostas | Um plugin que corrige JSON quase válido, como JSON dentro de um bloco Markdown, antes que ele chegue ao seu parser. | API, SDK |
| Saídas estruturadas | Enviar um JSON Schema para que o modelo retorne JSON nesse formato em vez de texto livre. | API, SDK |
Custos, limites e cobrança
| Termo | Significado | Aplica-se a |
|---|---|---|
| Alerta de gastos | A notificação que uma regra de gastos envia quando os gastos, uma previsão, um pico ou o saldo ultrapassa o limite dela. | API, Painel |
| Créditos | Saldo pré-pago do espaço de trabalho que as solicitações pagas consomem a preços de catálogo; as compras têm uma taxa de 5% (mínimo de $1), e os modelos :free não precisam de créditos. | API, Painel, CLI, MCP |
| Limite de chave | Um teto diário, semanal ou mensal de solicitações ou gastos em uma chave de API, verificado a cada solicitação. | API, Painel, CLI |
| Limite de taxa | O número de solicitações por minuto permitido para cada usuário em cada espaço de trabalho, que aumenta à medida que o espaço de trabalho se consolida. | API, CLI |
| Orçamento | Um teto de gastos do espaço de trabalho (diário, semanal, mensal ou total); solicitações acima dele recebem 429 key_limit_exceeded. | API, Painel |
| Orçamento de departamento | Um teto de gastos diário, semanal ou mensal para as chaves e as solicitações OAuth que contam para um departamento. | API, Painel |
| Regra de gastos | Uma regra que alerta quando os gastos de um escopo ultrapassam um limite e que pode bloquear novas solicitações com 429 spend_rule_blocked. | API, Painel |
Observabilidade
| Termo | Significado | Aplica-se a |
|---|---|---|
| Abrir no Chat | Continua uma solicitação salva ou um turno de sessão como conversa no Chat, com o mesmo modelo ou outro. | Painel, Chat |
| Atribuição do aplicativo | Cabeçalhos como X-App-Id, X-Title e HTTP-Referer que agrupam o uso de uma solicitação sob um app. | API, SDK |
| Broadcast | Envia um trace de cada solicitação do Gateway para uma ferramenta de observabilidade, um webhook, um bucket de armazenamento ou um data warehouse, sem mudar o código. | API, Painel |
| Classificador de solicitações | Uma taxonomia e um modelo que rotulam cada solicitação concluída, salvos como rótulos de solicitação que você pode filtrar. | API, Painel |
| Logs de solicitações | Um registro de cada solicitação com uso, latência, custo, erros e o provedor que a atendeu. | API, Painel, CLI, MCP |
| Registro de auditoria | O registro de quem alterou chaves, membros e outros controles de administração, que só proprietários e administradores podem ler. | API, Painel, CLI |
| Rótulo de solicitação | Um par chave/valor, como team=support, enviado no cabeçalho X-Phaseo-Metadata para filtrar gastos e logs. | API, SDK |
Trabalhos assíncronos
| Termo | Significado | Aplica-se a |
|---|---|---|
| Endpoint de webhook | Uma URL do espaço de trabalho que recebe eventos de status assinados de trabalhos de vídeo e de lote. | API, Painel |
| Lote | Um trabalho da Batch API para grandes cargas de trabalho adiadas, em que cada linha usa um modelo. | API, SDK |
| Trabalho assíncrono | Uma solicitação de vídeo ou de lote que retorna um trabalho na hora; você consulta o trabalho ou aguarda um webhook até ele terminar. | API, SDK |
| Trabalho de vídeo | Uma solicitação da Video API que retorna um trabalho; baixe o vídeo quando o status for completed. | API, SDK |
Enterprise
| Termo | Significado | Aplica-se a |
|---|---|---|
| Complemento de identidade | O complemento do espaço de trabalho necessário para ativar SSO ou SCIM, criar tokens de provisionamento e gerenciar o diretório. | API, Painel |
| Departamento | Um grupo de membros do espaço de trabalho, gerenciado manualmente ou sincronizado do seu diretório, que orçamentos, limites de taxa e regras de gastos podem ter como alvo. | API, Painel |
| Diretório | Os departamentos enterprise do espaço de trabalho e as permissões efetivas de cada membro, gerenciados por proprietários e administradores. | API, Painel |
| SCIM | Provisionamento de membros e departamentos do espaço de trabalho a partir do seu provedor de identidade com um token de provisionamento SCIM. | API, Painel |
| Self Serve Enterprise | Uma assinatura mensal do espaço de trabalho para SSO, SCIM, gerenciamento de diretório, departamentos e suporte prioritário por e-mail. | Painel |
| SSO | Login único para membros do espaço de trabalho via SAML ou um provedor OIDC personalizado. | API, Painel |
CLI, MCP, SDKs e apps
| Termo | Significado | Aplica-se a |
|---|---|---|
| Agente do Slack | O agente do Phaseo no Slack, que responde a menções e mensagens diretas com o modelo escolhido pelo seu espaço de trabalho. | Painel, Slack |
| CLI do Phaseo | O comando phaseo para criar chaves, alterar configurações e automatizar tarefas de administração em um shell ou na CI. | CLI |
| Docs MCP | Um servidor MCP somente leitura em https://phaseo.app/docs/mcp que permite que assistentes de programação pesquisem e leiam esta documentação. | MCP |
| MCP do Phaseo | Um servidor MCP que dá aos clientes de IA dados atualizados de modelos, preços, uso e espaço de trabalho, e que pode opcionalmente gerenciar a sua conta. | MCP |
| SDK de cliente | Um pacote do Phaseo para a sua linguagem com um método por endpoint do Gateway, como @phaseo/sdk ou phaseo. | SDK |
| Skills de agente | Instruções públicas do Phaseo para agentes de programação, que cobrem o Gateway, os SDKs, as predefinições, o roteamento e as migrações. | API, CLI, SDK |
Fases dos recursos
| Termo | Significado | Aplica-se a |
|---|---|---|
| Alfa | Um recurso inicial que pode mudar bastante ou ser removido. | API, Painel, CLI, SDK, MCP, Chat, Slack |
| Beta | Um recurso que funciona para o uso principal, embora alguns detalhes possam mudar; as mudanças são anunciadas no changelog. | API, Painel, CLI, SDK, MCP, Chat, Slack |
| Descontinuado (recurso) | Um recurso que ainda funciona, mas será removido; a página dele mostra a data de remoção quando ela estiver definida. | API, Painel, CLI, SDK, MCP, Chat, Slack |
| Disponibilidade geral | Um recurso estável, mostrado sem selo de fase. | API, Painel, CLI, SDK, MCP, Chat, Slack |
| Prévia de recursos | A página de configurações que mostra se a Video API e a Batch API estão ativadas no seu espaço de trabalho. | Painel |
| Sob solicitação | Um recurso que é ativado por espaço de trabalho; até lá, a página de configurações dele fica oculta e a API dele retorna um erro. | API, Painel |