API do Magnific

API do Magnific

Este artigo é uma tradução. A versão em inglês é a versão de referência e a que prevalece em caso de dúvida.

Integre a biblioteca de conteúdo de stock e as ferramentas com tecnologia de IA do Magnific às suas próprias aplicações

A API do Magnific permite que desenvolvedores integrem o conteúdo e as capacidades de IA do Magnific diretamente em seus próprios produtos, plataformas e fluxos de trabalho. Em vez de usar o site do Magnific manualmente, você pode pesquisar recursos de stock, gerar imagens por IA e vídeos, editar conteúdo e muito mais de forma programática por meio de chamadas de API REST padrão

A referência técnica completa (endpoints, parâmetros, detalhes de autenticação, exemplos de código e esquemas de resposta) encontra-se na documentação da API em docs.magnific.com. Este artigo aborda o essencial para ajudar você a entender o que a API oferece e como começar

Neste artigo

• O que você pode fazer com a API

• Como começar

• Painel da API

• Preços e faturamento

• Limites de taxa

• Regras de uso

• Códigos de erro comuns

• Recursos e atendimento

O que você pode fazer com a API

A API está organizada em diversas áreas de serviço:

Os serviços e modelos disponíveis podem mudar à medida que a Magnific adiciona novas capacidades de IA. Verifique docs.magnific.com para obter a lista de endpoints mais recente

Primeiros passos

Como consumir créditos via API

Passo 1: acesse as configurações
Abra o menu do usuário e vá para as configurações da organização. Lá dentro, você encontrará a seção API Keys

Passo 2: crie uma chave de API
Crie uma nova chave de API com um nome de identificação. O sistema gerará automaticamente:

• A chave de API

• O segredo de assinatura do webhook

Ambos são exibidos apenas uma vez. Certifique-se de copiá-los antes de fechar a janela

Passo 3: gerencie suas chaves

• Você pode renomear qualquer chave a partir do menu Ações sem perder seu segredo ou histórico de consumo

• Você pode desativar temporariamente uma chave (útil para rotação ou emergências) sem perdê-la

• Você pode excluir permanentemente uma chave mediante confirmação

Passo 4 — Auditar uso de crédito
Você pode auditar o consumo do pool de créditos filtrando por uma chave de API específica para ter um controle granular sobre o uso

Contas Enterprise: se você ainda não vê a seção de chaves de API, entre em contato com seu representante Magnific designado para solicitar acesso. Uma vez habilitado, os passos acima se aplicam da mesma forma

Dashboard de API (legado)

O Dashboard de API é sua central para gerenciar tudo relacionado ao seu uso de API. Você pode acessá-lo clicando na sua foto de perfil no canto superior direito e selecionando Dashboard de API, ou acessando diretamente magnific.com/developers/dashboard

A partir do dashboard você pode:

• Visualizar e regenerar sua chave de API

• Acompanhar o uso e monitorar o volume de solicitações em tempo real

• Defina um orçamento mensal para controlar os gastos

• Revise os limites de taxa e os preços de cada serviço

• Gerencie as informações de faturamento e os métodos de pagamento

Painel de administração da API do modelo baseado em créditos

Usuários da API baseada em assinatura podem gerenciar suas contas por meio do painel de administração, localizado dentro do painel de assinatura. A partir daqui, você pode realizar as seguintes ações:

• Criar chaves de API

• Verificar e gerenciar permissões para as chaves de API

• Controlar os créditos gastos por cada chave

Preços e faturamento

A API do Magnific utiliza um sistema de assinatura com um modelo baseado em créditos

Ferramentas de geração de IA

Cada solicitação de geração via API: imagens, vídeos, áudio, upscaling, edição e mais, deduz créditos do seu saldo

Para usar a API, você pode escolher entre os seguintes planos de assinatura:

• Premium: 1 chave de API, 20.000 créditos/mês ou 240.000 créditos/ano

• Premium+: 1 chave de API, 45.000 créditos/mês ou 600.000 créditos/ano

• Pro: 3 chaves de API, 300.000 créditos/mês ou 4.000.000 créditos/ano

• Business: 5 chaves de API, 90.000 créditos/mês ou 1.080.000/ano

• Enterprise: chaves de API ilimitadas, créditos anuais personalizados, escalabilidade conforme o seu uso

Você encontrará os custos detalhados de crédito para cada ferramenta e geração em nossa Central de Ajuda

Todas as assinaturas também permitem que você gere conteúdo diretamente em nosso site

Se o seu plano inclui uso Ilimitado, observe que isso se aplica apenas dentro do app Magnific: chamadas de API sempre consomem créditos

Downloads de conteúdo de stock

• Planos Premium, Premium+ e Pro: downloads de stock via API não consomem créditos, mas são limitados a 100 por dia

• Planos Business e Enterprise: downloads de stock ilimitados, cada um deduzido do seu saldo de créditos como qualquer outra chamada de API

Limites de taxa

A API impõe limites de taxa para garantir estabilidade e uso justo para todos os desenvolvedores. Os limites se aplicam tanto no nível da chave de API quanto no nível do endereço IP

Se você exceder esses limites, as solicitações poderão ser limitadas ou bloqueadas temporariamente até que o limite seja redefinido. Se sua aplicação exigir limites maiores, entre em contato com a equipe de Vendas para discutir um plano personalizado

Regras de uso

A API do Magnific foi projetada para integração em produtos digitais e fluxos de trabalho. Para manter seu acesso à API ativo, siga estas regras:

• Não use a API para mineração de dados, extração de conteúdo ou treinamento de modelo de IA

• Não venda ou redistribua conteúdo do Magnific sem modificação

• Relate os downloads com precisão: acione uma solicitação de download toda vez que um recurso for usado exclusivamente por um usuário. Por exemplo, quando alguém seleciona uma imagem para uma postagem de blog, define-a como cabeçalho ou a usa como plano de fundo

• O cache é permitido desde que você mantenha um plano ativo e relate todos os downloads de forma precisa e imediata

Importante

A violação destas regras resultará na remoção imediata do acesso à API

Códigos de erro comuns

Quando algo dá errado com uma solicitação, a API retorna códigos de status HTTP padrão. Aqui estão os mais comuns:

Para obter a lista completa de códigos de resposta e seus significados, consulte a documentação da API

Recursos e atendimento

Se você encontrar problemas ou tiver dúvidas sobre sua integração com a API, pode entrar em contato com a equipe de atendimento por meio do formulário de contato em magnific.com/api#contact ou pela página geral de atendimento