Plataforma de Developer

Execute, monitorize e configure a sua integração com a Meshy API na Plataforma de Developer. Tem um Playground para experimentar endpoints sem escrever código, painéis de todos os pedidos de API da sua conta, e gestão de chaves de API e webhooks.

No plano Free, só pode experimentar Imagem para 3D no Playground, através de uma chave incorporada para testes. As contas Free não podem criar ou gerir 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, ao Painel de utilização e Registos de Pedidos, e às suas próprias chaves de API.

Visão geral

Abra a Plataforma de Developer a partir da aplicação web. A barra lateral tem três grupos:

Build: o Playground, para experimentar endpoints de forma interativa.
Monitor: o Painel de utilização e os Registos de Pedidos.
Configure: Chaves de API e Webhooks.

A página Overview guia as novas contas através de três passos: criar uma chave, experimentar um pedido no Playground e verificar o resultado nos Registos de Pedidos. Também mostra um resumo de utilização da conta dos últimos 7 dias e as entradas mais recentes do registo de alterações.

A página Overview da Plataforma de Developer, mostrando o cartão de introdução em três passos, um resumo de utilização de 7 dias e as entradas 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 código. Escolha um endpoint, preencha os seus parâmetros com a orientação incorporada e submeta o pedido. A tarefa é executada através do mesmo pipeline assíncrono de uma tarefa de API. Pode acompanhar a sua evolução de PENDING até SUCCEEDED, e depois 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 tempo real ao lado dos separadores Preview, Request e Response

Enquanto uma tarefa está a decorrer, o separador Preview transmite atualizações de estado em tempo real, pelo que não precisa de fazer polling.

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

O separador Request mostra um excerto pronto a executar em cURL, Python ou JavaScript, e o separador Response mostra o JSON completo. Ao contrário do espaço de trabalho da aplicação web, o Playground dá-lhe todos os pedidos que cria como código, que pode copiar para a sua própria aplicação.

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 apresenta em gráficos toda a atividade de API da sua conta, tanto de chamadas diretas à API como do Playground. Mostra a taxa de sucesso das gerações, o total de pedidos, o tempo médio de processamento e os créditos utilizados. Mostra também o volume de pedidos ao longo do tempo, e a taxa de sucesso e a latência por endpoint.

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

Registos de pedidos

Os Registos de Pedidos listam todas as tarefas de API da sua conta, tanto de chamadas diretas à API como do Playground. Cada entrada mostra o estado, a duraçã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. Isto ajuda-o a depurar uma chamada sem voltar a consultar a API. Para abrir a tarefa no Playground, clique em Open in Playground. Para transferir a lista completa para relatórios ou reconciliação, clique em Export CSV.

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

Gestão 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 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. Para passos de configuração, requisitos de entrega e exemplos de payloads, consulte Webhooks.

Feedback

Todas as páginas da Plataforma de Developer têm um botão Feedback. Utilize-o para reportar um erro, pedir uma funcionalidade ou dizer-nos o que não está claro. A equipa da Meshy lê todas as submissões.

Autenticação e créditos

Os pedidos do Playground enviam uma chave de API no cabeçalho Authorization: Bearer, tal como uma chamada direta à API. O Playground é executado na 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. Para mais informações sobre chaves de API e segurança, consulte Autenticação.