Ir para o conteúdo principal

Obtenha uma lista de todos os modelos

O endpoint é usado para obter uma lista de todos os modelos do sistema, incluindo modelos de vídeo, carrossel, imagem, cotações e memes. Este é um endpoint paginado e, portanto, você receberá uma resposta paginada.

URL de solicitação

  • ENTRE https://brain.predis.ai/predis_api/v1/get_templates/

Solicitar Parâmetros

NomeDescriçãoFormatoValor padrãoValores PossíveisExigido
brand_idO brand_id serve como identificador exclusivo da sua marca. Usando o brand_id, você também terá acesso aos seus modelos personalizados na primeira página.TangaNoneYOUR_BRAND_IDSim
media_typePara obter modelos de um tipo de mídia específico.Tangasingle_imagesingle_image, carousel, videoNão
post_typePara obter modelos de um tipo específico de postagem. Para meme e no quotes postar media_type deveria estar single_image.Tangagenericgeneric, meme, quotesNão
aspect_ratioPara obter modelos de uma proporção específica.Tangaallsquare, portrait, landscape, allNão
page_nIndique o número da página para recuperar modelos dessa página específica.Número inteiro11, 2, 3...etcNão
items_nIndique o número desejado de modelos para cada página.Número inteiro101, 2, 3...etcNão

Exemplo de resposta de sucesso

{
"templates": [{
"template_id": "...",
"media_type": "..."
}],
"total_pages": 50,
"errors": []
}

Exemplo de resposta de erro

{
"errors": [{
"detail": "...",
"solution": "..."
}]
}

Códigos de Resposta

Código de status HTTPErro de códigoMensagem do usuárioSolução recomendada
429001Número máximo de solicitações atingidoNúmero máximo de solicitações por hora atingido Você foi limitado pela taxa. Aguarde um pouco e tente novamente
400002Inválido brand_id fornecidoVocê forneceu um inválido brand_id. Forneça um documento válido brand_id e tente novamente. Leia mais aqui.
400003Os números de página do número de itens são inválidosCertifique-se de que o valor de page_n e no items_n é inteiro
400004Fornecido aspect_ratio não é suportadoCertifique-se de que o valor de aspect_ratio campo é suportado. Verifique os parâmetros de solicitação na tabela acima para obter mais detalhes
400005O valor fornecido para o media_type campo não é válidoCertifique-se de que o valor seja um dos single_image, carousel or video
400006O valor fornecido para o video_duration campo não é válidoCertifique-se de que o valor seja short or long
400007O valor fornecido para o post_type campo não é válidoCertifique-se de que o valor seja generic, meme or quotes
400008O valor fornecido para o post_type campo não é válido para o dado media_typeO fornecido post_type e no media_type combinação de postagem ainda não é suportada. Verifique os parâmetros de solicitação na tabela acima para obter mais detalhes

Limitação de taxa

Padrão API limites de taxa se aplicam a este ponto final. Leia mais sobre os limites de taxa aqui.