Plataforma para Desenvolvedores

Execute, monitore e configure sua integração com a Meshy API na Plataforma para Desenvolvedores. Ela tem um Playground para testar endpoints sem escrever código, painéis com todas as requisições de API da sua conta, e gerenciamento de API key e webhook.

No plano gratuito, você só pode testar o Imagem para 3D no Playground, por meio de uma chave integrada para testes. Contas gratuitas não podem criar ou gerenciar chaves de API, e não têm acesso ao Painel de uso nem aos Logs de requisições. Os planos Pro, Premium, Ultra, Studio e Enterprise têm acesso a todos os endpoints do Playground, ao Painel de uso e aos Logs de requisições, além de suas próprias chaves de API.

Visão geral

Abra a Plataforma para Desenvolvedores a partir do aplicativo web. Sua barra lateral tem três grupos:

Build: o Playground, para testar endpoints interativamente.
Monitor: o Painel de uso e os Logs de requisições.
Configure: Chaves de API e Webhooks.

A página Overview guia novas contas por três etapas: criar uma chave, testar uma requisição no Playground e verificar o resultado nos Logs de requisições. Ela também mostra um resumo de 7 dias do uso da sua conta e as entradas mais recentes do registro de alterações.

A página de Visão geral da Plataforma para Desenvolvedores, mostrando o card de três etapas de início, um resumo de uso de 7 dias e as entradas mais recentes do registro de alterações da Meshy API

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

Playground

O Playground é um console interativo para testar endpoints sem escrever código. Escolha um endpoint, preencha seus parâmetros com a orientação embutida e envie a requisição. A tarefa é executada pelo mesmo pipeline assíncrono de uma tarefa de API. Você pode acompanhá-la passar de PENDING para SUCCEEDED, e depois 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 em tempo real, então você não precisa fazer polling.

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

A aba Request mostra um trecho de código pronto para executar em cURL, Python ou JavaScript, e a aba Response mostra o JSON completo. Diferente do espaço de trabalho do aplicativo web, o Playground entrega cada requisição que você monta como código, que você pode copiar para o seu próprio aplicativo.

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 exibe em gráficos toda a atividade de API da sua conta, tanto de chamadas diretas à API quanto do 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 usados. Também mostra o volume de requisições ao longo do tempo, e a taxa de sucesso e a 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 detalhadas por endpoint

Logs de requisições

Os Logs de requisições listam todas as tarefas de API da sua conta, tanto de chamadas diretas à API quanto do Playground. Cada entrada mostra o status, o 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. Isso ajuda a depurar uma chamada sem consultar a API novamente. Para abrir a tarefa no Playground, clique em Open in Playground. Para baixar a lista inteira para relatórios ou conciliação, clique em Export CSV.

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

Gerenciamento de API

API Keys: crie, nomeie e revogue chaves, defina um limite mensal de créditos para cada uma, restrinja cada uma a uma lista de permissões de IP e veja o uso de cada chave.
Webhooks: receba atualizações em tempo real quando suas tarefas de API mudarem de status, em vez de fazer polling. Para as etapas de configuração, requisitos de entrega e exemplos de payload, consulte Webhooks.

Feedback

Toda página da Plataforma para Desenvolvedores tem um botão Feedback. Use-o para relatar um bug, solicitar um recurso ou nos contar o que está confuso. A equipe da Meshy lê todos os envios.

Autenticação e créditos

As requisições do Playground enviam uma chave de API no cabeçalho Authorization: Bearer, assim como uma chamada direta à API. O Playground roda na sua própria conta, então cada requisição usa os créditos do seu plano e conta para seus limites de taxa, como qualquer outra chamada de API. Para mais informações sobre chaves de API e segurança, consulte Autenticação.