Plataforma para Desenvolvedores

A Plataforma para Desenvolvedores é onde você executa, monitora e configura tudo sobre sua integração com a Meshy API — um Playground para testar endpoints sem escrever código, painéis cobrindo cada requisição de API na sua conta, e gerenciamento de chave de API e webhook.

Contas Free podem experimentar o Playground apenas no endpoint de Imagem para 3D, por meio de uma chave interna dedicada para testes — contas Free não podem criar ou gerenciar suas próprias chaves de API, e não têm Painel de uso nem Logs de requisições. Os planos Pro, Premium, Ultra, Studio e Enterprise têm acesso a todos os endpoints do Playground, acesso completo ao Painel de uso e aos Logs de requisições, e às suas próprias chaves de API.

Visão geral

Abra a Plataforma para Desenvolvedores a partir do aplicativo web. Sua barra lateral está organizada em:

Build — o Playground, para testar endpoints de forma interativa.
Monitor — Painel de uso e Logs de requisições.
Configure — Chaves de API e Webhooks.

A própria página de Visão geral guia novas contas pelos três passos abaixo (criar uma chave, testar uma requisição no Playground, inspecionar o resultado nos Logs de requisições), e depois exibe um retrato de 7 dias da atividade da sua própria conta e as entradas mais recentes do registro de alterações da Meshy API.

A página de Visão geral da Plataforma para Desenvolvedores, mostrando o cartão de início rápido em três passos, um retrato de uso de 7 dias e as atualizações mais recentes do registro de alterações da Meshy API

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

Playground

O Playground é um console interativo para testar endpoints sem escrever nenhum código. Escolha um endpoint, preencha os parâmetros com orientações inline e envie — as tarefas passam pelo mesmo pipeline assíncrono da API, então você verá a tarefa passar de PENDING para SUCCEEDED e poderá inspecionar a resposta completa e o modelo resultante.

O Playground executando uma requisição de Imagem para 3D, com a pré-visualização do modelo ao vivo ao lado das abas Preview, Request e Response

Enquanto uma tarefa é executada, a aba Preview transmite atualizações de status ao vivo — sem necessidade de polling.

O log da aba Preview do Playground, transmitindo atualizações de status ao vivo enquanto uma tarefa está em andamento

Mude para a aba Request para obter um trecho de código pronto para executar em cURL, Python ou JavaScript, ou para a aba Response para inspecionar o JSON completo — é aqui que o Playground se destaca em relação ao espaço de trabalho do aplicativo web: cada requisição que você monta está a apenas um copiar e colar de rodar no seu próprio código.

Abas Request e Response

A mesma tarefa, vista de duas formas: a requisição cURL equivalente e a resposta JSON bruta.

A aba Request do Playground mostrando o comando cURL equivalente para a requisição atual — Request

A aba Response do Playground mostrando a resposta JSON bruta — Response

Painel de uso

O Painel de uso visualiza toda a atividade de API da sua conta — cada requisição, seja feita diretamente pela API ou pelo Playground. Ele mostra a taxa de sucesso de geração, o total de requisições, o tempo médio de processamento e os créditos consumidos, além do volume de requisições ao longo do tempo e uma divisão da taxa de sucesso e latência por endpoint.

O Painel de uso, mostrando a taxa de sucesso de geração, o volume de requisições ao longo do tempo, e a taxa de sucesso e latência divididas por endpoint

Logs de requisições

Os Logs de requisições listam toda tarefa de API da sua conta — tanto chamadas diretas à API quanto requisições do Playground — com status, tempo e a chave de API que fez a requisição. Selecione uma tarefa para ver sua entrada e saída completas, o corpo da requisição e os créditos usados — útil para depurar uma chamada específica sem precisar consultar a API novamente — ou vá direto para ela no Playground. Use Export CSV para extrair a lista completa para relatório ou conciliação.

Logs de requisições, com o status de uma tarefa selecionada, a pré-visualização de entrada/saída e o corpo da requisição exibidos no painel de detalhes — os botões Export CSV e Open in Playground estão destacados

Gerenciamento de API

Chaves de API — crie, nomeie e revogue chaves, defina um limite mensal de créditos para cada uma, e veja o uso de cada chave.
Webhooks — receba atualizações em tempo real quando as tarefas da sua API mudarem de status, em vez de fazer polling. Consulte o guia de Webhooks para os passos de configuração, requisitos de entrega e exemplos de payload.

Feedback

Toda página da Plataforma para Desenvolvedores tem um botão de Feedback no canto inferior direito — use-o para relatar um bug, solicitar um recurso ou nos contar o que está confuso. Lemos todas as submissões.

Autenticação e créditos

As requisições são autorizadas com uma chave de API passada no cabeçalho Authorization: Bearer, exatamente como em uma chamada direta à API. O Playground é executado na sua própria conta, então cada requisição usa os créditos do seu plano e conta para seus limites de taxa, assim como qualquer outra chamada à API. Consulte o guia de Autenticação para detalhes sobre formatos de chave e segurança.