Plataforma para Programadores

A Plataforma para Programadores é onde executa, monitoriza e configura tudo sobre a sua integração com a Meshy API — um Playground para experimentar endpoints sem escrever código, painéis que cobrem todos os pedidos de API na sua conta, e gestão de chave de API e webhook.

As contas Free podem experimentar o Playground apenas no endpoint Imagem para 3D, através de uma chave integrada dedicada para testes — as contas Free não podem criar ou gerir as suas próprias chaves de API, e não têm Painel de Utilização nem Registos de Pedidos. Os planos Pro, Premium, Ultra, Studio e Enterprise têm acesso a todos os endpoints do Playground, acesso total ao Painel de Utilização e Registos de Pedidos, e às suas próprias chaves de API.

Visão geral

Abra a Plataforma para Programadores a partir da aplicação web. A sua barra lateral está organizada em:

  • Criar — o Playground, para experimentar endpoints de forma interativa.
  • Monitorizar — Painel de Utilização e Registos de Pedidos.
  • Configurar — Chaves de API e Webhooks.

A própria página de Visão Geral guia as novas contas através dos três passos abaixo (criar uma chave, experimentar um pedido no Playground, inspecionar o resultado nos Registos de Pedidos), e depois mostra uma vista geral de 7 dias da atividade da sua própria conta e as entradas mais recentes do registo de alterações da Meshy API.

A página de Visão Geral da Plataforma para Programadores, mostrando o cartão de introdução em três passos, uma vista geral de utilização de 7 dias, e as atualizações mais recentes do registo de alterações da Meshy API

Novo na API? Comece pelo Início rápido.

Playground

O Playground é uma consola interativa para experimentar endpoints sem escrever qualquer código. Escolha um endpoint, preencha os parâmetros com orientação em linha, e submeta — as tarefas passam pelo mesmo pipeline assíncrono que a API, pelo que verá a tarefa passar de PENDING a SUCCEEDED e poderá inspecionar a resposta completa e o modelo resultante.

O Playground a executar um pedido de Imagem para 3D, com a pré-visualização do modelo em direto ao lado dos separadores Preview, Request e Response

Enquanto uma tarefa está em execução, o separador Preview transmite atualizações de estado em tempo real — sem necessidade de fazer polling.

O registo do separador Preview do Playground, transmitindo atualizações de estado em tempo real enquanto uma tarefa está em curso

Mude para o separador Request para obter um excerto pronto a executar em cURL, Python ou JavaScript, ou o separador Response para inspecionar o JSON completo — é aqui que o Playground se destaca face ao espaço de trabalho da aplicação web: cada pedido que constrói está a apenas um copiar-colar de ser executado no seu próprio código.

Separadores Request e Response
A mesma tarefa, vista de duas formas: o pedido cURL equivalente, e a resposta JSON em bruto.
O separador Request do Playground a mostrar o comando cURL equivalente para o pedido atual
Request
O separador Response do Playground a mostrar a resposta JSON em bruto
Response

Painel de utilização

O Painel de Utilização visualiza toda a atividade de API da sua conta — todos os pedidos, quer sejam feitos diretamente através da API ou a partir do Playground. Mostra a taxa de sucesso de geração, o total de pedidos, o tempo médio de processamento e os créditos consumidos, além do volume de pedidos ao longo do tempo e uma discriminação da taxa de sucesso e latência por endpoint.

O Painel de Utilização, mostrando a taxa de sucesso de geração, o volume de pedidos ao longo do tempo, e a taxa de sucesso e latência discriminadas por endpoint

Registos de pedidos

Os Registos de Pedidos listam todas as tarefas de API na sua conta — tanto chamadas diretas à API como pedidos do Playground — com o estado, a temporização, e a chave de API que fez o pedido. Selecione uma tarefa para ver a sua entrada e saída completas, o corpo do pedido, e os créditos utilizados — útil para depurar uma chamada específica sem voltar a consultar a API — ou avance diretamente para ela no Playground. Use Export CSV para extrair a lista completa para relatórios ou reconciliação.

Registos de Pedidos, com o estado de uma tarefa selecionada, a pré-visualização de entrada/saída, e o corpo do pedido mostrados no painel de detalhes — os botões Export CSV e Open in Playground estão destacados

Gestão da API

  • Chaves de API — crie, atribua um nome e revogue chaves, defina um limite mensal de créditos em cada uma, e veja a utilização de cada chave.
  • Webhooks — receba atualizações em tempo real quando as suas tarefas de API mudam de estado, em vez de fazer polling. Consulte o guia Webhooks para os passos de configuração, requisitos de entrega, e exemplos de payloads.

Feedback

Todas as páginas da Plataforma para Programadores têm um botão Feedback no canto inferior direito — utilize-o para reportar um erro, pedir uma funcionalidade, ou dizer-nos o que não está claro. Lemos todas as submissões.

Autenticação e créditos

Os pedidos são autorizados com uma chave de API passada no cabeçalho Authorization: Bearer, exatamente como numa chamada direta à API. O Playground funciona sobre a sua própria conta, pelo que cada pedido utiliza os créditos do seu plano e conta para os seus limites de taxa, tal como qualquer outra chamada à API. Consulte o guia de Autenticação para detalhes sobre formatos de chave e segurança.