Crie conteúdo
O endpoint é usado para gerar todos os tipos de postagens, incluindo vídeos, carrosséis, imagens, citações e memes.
URL de solicitação
- POST https://brain.predis.ai/predis_api/v1/create_content/
Solicitar Carga Útil
Nota - Por favor use "Tipo de Payload" como form-data quando você liga para isso API.
| Nome | Descrição | Formato | Valor padrão | Valores Possíveis | Exigido |
|---|---|---|---|---|---|
brand_id | Identificador único da sua marca. Você pode aprender mais sobre como localizar seu ID de marca visitando o link fornecido aqui.. | Tanga | None | YOUR_BRAND_ID | Sim |
text | Forneça o tópico para o qual você pretende criar a postagem. Certifique-se de que o tópico tenha pelo menos 20 caracteres e consista em no mínimo 3 palavras para garantir um resultado preciso. | Tanga | None | Any String | Sim |
post_type | Especifique o tipo de postagem que deseja gerar. Se você estiver criando um meme or quotes postar, o media_type deve ser definido para single_image.Suportado apenas por model_version 2 | Tanga | generic | generic, meme, quotes | Não |
model_version | Especifique a versão do modelo a ser usada. Versão 4 é muito melhor em termos de qualidade do que a versão 2, mas apenas suporta single_image e carousel | Tanga | 2 | 2, 4 | Não |
n_posts | Especifique o número de postagens que você deseja gerar em uma única solicitação. | Número inteiro | 1 | 1 para 10 | Não |
input_language | Escolha o idioma para sua entrada text campo. | Tanga | english | malay, chinese (traditional), croatian, english, dutch, indonesian, vietnamese, portuguese_br, finnish, french, german, italian, norwegian, polish, romanian, czech, spanish, swedish, turkish, danish, hungarian | Não |
output_language | Escolha o idioma no qual deseja gerar a postagem. | Tanga | english | malay, chinese (traditional), croatian, english, dutch, indonesian, vietnamese, portuguese_br, finnish, french, german, italian, norwegian, polish, romanian, czech, spanish, swedish, turkish, danish, hungarian | Não |
media_type | Forneça essas informações apenas quando desejar um determinado media_type de postagem. Não é necessário quando template_ids são selecionados, mas é necessário de outra forma.Ao model_version is 4, só single_image e carousel é suportado. | Tanga | single_image | single_image, carousel, video | Não |
video_duration | Especifique o tipo do seu video. Este campo não é obrigatório quando template_ids são selecionados. No entanto, é necessário quando o media_type o valor está definido para video. | Tanga | short | short, long | Não |
template_ids | Forneça essas informações somente quando desejar que sua saída seja gerada usando modelos específicos. Você pode fornecer uma lista de IDs de modelos no seguinte formato: Amostra 1: ["template_id1"]Amostra 2: ["template_id1", "template_id2", "template_id3"]Suportado apenas por model_version 2 | Lista de cordas | [] | [] | Não |
author | Forneça essas informações apenas quando o tipo de postagem que você deseja gerar for quotes. | Tanga | None | Any String | Não |
media_urls | Forneça uma lista de URLs para imagens/vídeos que você deseja usar em sua postagem. Aqui estão dois formatos de exemplo: Amostra 1: ["url1"]Amostra 2: ["url1", "url2", "url3"]Suportado apenas por model_version 2 | Lista de cordas | [] | [] | Não |
color_palette_type | Escolha a paleta de cores na qual deseja que seu conteúdo seja gerado. Se você especificou a paleta como marca, mas não definiu as cores da marca, o conteúdo será gerado automaticamente usando o ai_suggested paleta. | Tanga | ai_suggested | brand, ai_suggested | Não |
brand_details | Forneça detalhes da marca para garantir que a IA gere conteúdo apenas com os detalhes da marca fornecidos. | Dicionário | None | Por favor, consulte a Exemplo aqui | Não |
headlines | Forneça esta entrada quando desejar substituir o conteúdo gerado pela IA nas imagens/vídeos gerados. Suportado apenas por model_version 2 | Lista | None | Por favor, consulte a Exemplo aqui | Não |
Exemplo de resposta de sucesso
{
"post_ids": [
"..."
],
"post_status": "inProgress",
"errors": [{"..."}]
}
Exemplo de resposta de erro
{
"errors": [{
"detail": "...",
"solution": "..."
}]
}
Códigos de Resposta
| Código de status HTTP | Erro de código | Mensagem do usuário | Solução recomendada |
|---|---|---|---|
| 429 | 001 | Número máximo de solicitações atingido | Número máximo de solicitações por hora atingido Você foi limitado pela taxa. Aguarde um pouco e tente novamente |
| 400 | 002 | Inválido brand_id fornecido | Você forneceu um inválido brand_id. Forneça um documento válido brand_id e tente novamente. Leia mais aqui. |
| 400 | 003 | Você atingiu seu limite de pós-geração | Você esgotou os créditos disponíveis em seu plano. Atualize para um plano superior ou espere até que o limite seja redefinido |
| 400 | 004 | Você já tem 3 postagens inProgress | Aguarde até que as postagens em andamento sejam concluídas e tente novamente |
| 400 | 005 | Seu método de solicitação é inválido | Por favor, faça um POST solicite e tente novamente |
| 400 | 006 | O texto fornecido é muito pequeno | O texto fornecido deve conter pelo menos 3 palavras e 20 caracteres para melhores resultados |
| 400 | 007 | O valor fornecido para o media_type campo não é válido | Certifique-se de que o valor seja um dos single_image, carousel or video |
| 400 | 008 | O valor fornecido para o input_language or output_language campo não é válido | Certifique-se de que o valor passado seja compatível. Verifique os parâmetros de solicitação na tabela acima para obter mais detalhes |
| 400 | 009 | O valor fornecido para o video_duration campo não é válido | Certifique-se de que o valor seja short or long |
| 400 | 010 | O valor fornecido para o post_type campo não é válido | Certifique-se de que o valor seja generic, meme or quotes |
| 400 | 011 | O valor fornecido para o post_type campo não é válido para o dado media_type | O fornecido post_type e 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.