Imagem de destaque com IA

Sugere um prompt e gera a imagem de destaque do post com inteligência artificial.

Sugerir prompt de imagem

A partir do título (e, se quiser, do texto) do post, a Venddor Intelligence escreve uma descrição de imagem pronta para a rota seguinte. É só uma sugestão: nada é gravado e nada é cobrado.

POST/api/v1/admin/blog/ai/featured-image/suggest-promptAdmin

Sugere um texto para gerar a imagem de destaque

Rota ligada ao módulo blog: com o módulo desligado a resposta é 403. Leitura exige manage_content ou view_content; escrita exige manage_content.

Corpo da requisição

titlestring

Título do post. Envie title ou body.

bodystring

Texto do post, para dar contexto.

Exemplo de requisição (Sugerir prompt)

bash

curl -X POST "$BASE_URL/api/v1/admin/blog/ai/featured-image/suggest-prompt" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "Como escolher o mouse perfeito"
}'

Resposta (Sugerir prompt)

200Prompt sugerido

json

{
  "prompt": "Mouse ergonômico preto sobre mesa de escritório organizada, luz natural, fundo desfocado, estilo fotográfico."
}

Campos da resposta

promptstring

Texto sugerido para usar em generate.

Erros (Sugerir prompt)

Status	Quando	Exemplo de corpo
401	Token ausente, inválido ou expirado.	`{"error":"invalid or expired token"}`
403	O administrador não tem o privilégio exigido.	`{"error":"insufficient privileges","required":"manage_content"}`
400	Nem `title` nem `body` foram enviados.	`{"error":"title or body is required"}`
503	O serviço de inteligência não está disponível nesta loja.	`{"error":"intelligence service unavailable"}`
500	Falha ao gerar a sugestão.	`{"error":"failed to suggest prompt","detail":"..."}`

Cria uma imagem a partir do prompt e a guarda na mídia da loja. A imagem sempre sai em formato de faixa (intenção de 1250 por 400 pixels, ajustada às regras de tamanho do gerador); o tamanho final vem em width e height. A chamada pode levar vários segundos e gera custo, devolvido em cost_centavos. Depois use a url devolvida em featured_image do post.

POST/api/v1/admin/blog/ai/featured-image/generateAdmin

Gera a imagem de destaque de um post com IA

Rota ligada ao módulo blog: com o módulo desligado a resposta é 403. Leitura exige manage_content ou view_content; escrita exige manage_content.

Corpo da requisição

promptstringobrigatório

Descrição da imagem, de 3 a 2000 caracteres. Acima disso a chamada falha com 502.

widthinteger

Aceito, mas ignorado: o tamanho é sempre o da faixa.

heightinteger

Aceito, mas ignorado, como width.

Exemplo de requisição (Gerar imagem)

bash

curl -X POST "$BASE_URL/api/v1/admin/blog/ai/featured-image/generate" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "Mouse ergonômico preto sobre mesa de escritório organizada, luz natural"
}'

Resposta (Gerar imagem)

201Imagem gerada

json

{
  "url": "/uploads/dfe2555e/intelligence/blog-1250x400.png",
  "image_url": "https://...",
  "storage_url": "/uploads/dfe2555e/intelligence/blog-1250x400.png",
  "prompt": "Mouse ergonômico preto...",
  "revised_prompt": "...",
  "provider": "image-provider",
  "cost_centavos": 12,
  "width": 1424,
  "height": 464
}

Campos da resposta

urlstring

Endereço a usar no post (featured_image).

image_urlstring

Endereço original devolvido pelo gerador.

storage_urlstring

Endereço da cópia guardada na mídia da loja.

promptstring

Texto enviado.

revised_promptstring

Texto reescrito pelo gerador, quando houver.

providerstring

Provedor que gerou a imagem.

cost_centavosinteger

Custo da geração em centavos (4990 = R$ 49,90). Pode vir 0 quando o custo ainda não foi apurado.

widthinteger

Largura final em pixels.

heightinteger

Altura final em pixels.

Erros (Gerar imagem)

Status	Quando	Exemplo de corpo
401	Token ausente, inválido ou expirado.	`{"error":"invalid or expired token"}`
403	O administrador não tem o privilégio exigido.	`{"error":"insufficient privileges","required":"manage_content"}`
400	`prompt` ausente ou com menos de 3 caracteres.	`{"error":"prompt is required"}`
502	O gerador de imagens falhou, o `prompt` passou de 2000 caracteres, ou a resposta veio vazia.	`{"error":"failed to generate image","detail":"..."}`
503	O serviço de inteligência não está disponível nesta loja.	`{"error":"intelligence service unavailable"}`

Veja também

API atual/Referência completa/Blog

Imagem de destaque com IA

Sugere um prompt e gera a imagem de destaque do post com inteligência artificial.

Sugerir prompt de imagem

A partir do título (e, se quiser, do texto) do post, a Venddor Intelligence escreve uma descrição de imagem pronta para a rota seguinte. É só uma sugestão: nada é gravado e nada é cobrado.

POST/api/v1/admin/blog/ai/featured-image/suggest-promptAdmin

Sugere um texto para gerar a imagem de destaque

Rota ligada ao módulo blog: com o módulo desligado a resposta é 403. Leitura exige manage_content ou view_content; escrita exige manage_content.

Corpo da requisição

titlestring

Título do post. Envie title ou body.

bodystring

Texto do post, para dar contexto.

Exemplo de requisição (Sugerir prompt)

bash

curl -X POST "$BASE_URL/api/v1/admin/blog/ai/featured-image/suggest-prompt" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "Como escolher o mouse perfeito"
}'

Resposta (Sugerir prompt)

200Prompt sugerido

json

{
  "prompt": "Mouse ergonômico preto sobre mesa de escritório organizada, luz natural, fundo desfocado, estilo fotográfico."
}

Campos da resposta

promptstring

Texto sugerido para usar em generate.

Erros (Sugerir prompt)

Status	Quando	Exemplo de corpo
401	Token ausente, inválido ou expirado.	`{"error":"invalid or expired token"}`
403	O administrador não tem o privilégio exigido.	`{"error":"insufficient privileges","required":"manage_content"}`
400	Nem `title` nem `body` foram enviados.	`{"error":"title or body is required"}`
503	O serviço de inteligência não está disponível nesta loja.	`{"error":"intelligence service unavailable"}`
500	Falha ao gerar a sugestão.	`{"error":"failed to suggest prompt","detail":"..."}`

Gerar imagem de destaque

POST/api/v1/admin/blog/ai/featured-image/generateAdmin

Gera a imagem de destaque de um post com IA

Rota ligada ao módulo blog: com o módulo desligado a resposta é 403. Leitura exige manage_content ou view_content; escrita exige manage_content.

Corpo da requisição

promptstringobrigatório

Descrição da imagem, de 3 a 2000 caracteres. Acima disso a chamada falha com 502.

widthinteger

Aceito, mas ignorado: o tamanho é sempre o da faixa.

heightinteger

Aceito, mas ignorado, como width.

Exemplo de requisição (Gerar imagem)

bash

curl -X POST "$BASE_URL/api/v1/admin/blog/ai/featured-image/generate" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "Mouse ergonômico preto sobre mesa de escritório organizada, luz natural"
}'

Resposta (Gerar imagem)

201Imagem gerada

json

{
  "url": "/uploads/dfe2555e/intelligence/blog-1250x400.png",
  "image_url": "https://...",
  "storage_url": "/uploads/dfe2555e/intelligence/blog-1250x400.png",
  "prompt": "Mouse ergonômico preto...",
  "revised_prompt": "...",
  "provider": "image-provider",
  "cost_centavos": 12,
  "width": 1424,
  "height": 464
}

Campos da resposta

urlstring

Endereço a usar no post (featured_image).

image_urlstring

Endereço original devolvido pelo gerador.

storage_urlstring

Endereço da cópia guardada na mídia da loja.

promptstring

Texto enviado.

revised_promptstring

Texto reescrito pelo gerador, quando houver.

providerstring

Provedor que gerou a imagem.

cost_centavosinteger

Custo da geração em centavos (4990 = R$ 49,90). Pode vir 0 quando o custo ainda não foi apurado.

widthinteger

Largura final em pixels.

heightinteger

Altura final em pixels.

Erros (Gerar imagem)

Status	Quando	Exemplo de corpo
401	Token ausente, inválido ou expirado.	`{"error":"invalid or expired token"}`
403	O administrador não tem o privilégio exigido.	`{"error":"insufficient privileges","required":"manage_content"}`
400	`prompt` ausente ou com menos de 3 caracteres.	`{"error":"prompt is required"}`
502	O gerador de imagens falhou, o `prompt` passou de 2000 caracteres, ou a resposta veio vazia.	`{"error":"failed to generate image","detail":"..."}`
503	O serviço de inteligência não está disponível nesta loja.	`{"error":"intelligence service unavailable"}`