Como escrever texto em imagem sem abrir editor
Coloque o preço na foto de um produto, um título em um banner ou o selo Vendido em um anúncio, com o texto gravado nos pixels. Você escolhe a posição, o tamanho, a cor e uma caixa de fundo opcional. Você paga por uso, sem assinatura.
Esta tarefa não está disponível no momento, portanto não pode ser contratada. Nada é cobrado por ela.
Ver a APIÉ o jeito de automatizar peças repetitivas — preço sobre foto de produto, nome sobre certificado, aviso sobre banner — sem abrir editor.
Por que a imagem só fica pronta com o texto
Uma foto de produto sem o preço, um banner sem título ou uma miniatura sem legenda estão pela metade. O que separa uma foto crua de uma arte pronta são poucas decisões pequenas: onde fica o preço, qual o tamanho do título e se o texto precisa de uma caixa de fundo para continuar legível sobre uma foto carregada. Para uma pessoa essas escolhas são fáceis uma vez, mas viram um peso quando se repetem o dia inteiro. Aqui você informa tudo uma vez só, o texto, a posição, o tamanho, a cor e a caixa opcional, e o resultado sai igual em cada imagem.
Onde é usado e um cuidado importante
Marketplaces carimbam o preço atual em cada foto assim que o vendedor muda o valor. Equipes de marketing montam uma semana de banners para redes sociais a partir de um fundo e de uma planilha de títulos e datas. Sites de imóveis marcam as fotos como Disponível, Vendido ou Em negociação conforme o status muda, e agendadores de conteúdo colocam a frase do dia sobre um fundo antes de publicar. Guarde o original limpo: o texto fica desenhado nos pixels, e não em uma camada separada, então para trocar uma palavra é preciso gerar uma nova versão a partir do original.
A mesma arte, mil variações
O caso clássico: você tem um modelo bonito e só o texto muda. Nome do aluno no certificado, preço da oferta da semana, título do post no blog. Fazer isso à mão significa abrir o editor, trocar o texto, exportar e repetir — vinte, cem, mil vezes.
Você controla o resultado
Na chamada vão o conteúdo do texto, a posição sobre a imagem, o tamanho e a cor. A dica de quem faz peça que funciona: contraste antes de estética — texto claro sobre área escura da foto, ou o contrário, e nada de espremer frase longa em espaço pequeno. Acentos e cedilha saem corretos, o que importa bastante quando o texto é “Promoção de inauguração” e não um genérico em inglês.
Casos de uso
Certificados com o nome de cada aluno
Uma escola de cursos online gera o certificado de Carlos Eduardo Souza — e o dos outros 400 formandos — escrevendo o nome de cada um sobre o mesmo modelo, na hora da conclusão do curso.
Oferta da semana sem chamar o designer
A TecnoSul Soluções Digitais atualiza os preços das promoções toda segunda-feira. O sistema pega a arte base e escreve o valor novo em cima — o designer fez o modelo uma vez e nunca mais foi interrompido.
Status carimbado na foto do imóvel
Quando o apartamento é vendido, o portal escreve “Vendido” sobre a foto de capa do anúncio de forma automática. O visitante entende na hora, sem clicar, e a equipe não edita imagem nenhuma.
Perguntas frequentes
Posso usar a mesma imagem de fundo e trocar só o texto?
Sim — é o uso mais comum: o modelo fica fixo e cada chamada escreve um texto diferente sobre ele.
Acentos, til e cedilha aparecem certinhos?
Aparecem. “Ação”, “promoção” e “São Paulo” saem como devem — sem trocar ç por c nem comer o til.
Em que formato a imagem volta?
No mesmo formato do arquivo enviado, dentro dos formatos comuns de foto e arte — pronto para publicar.
O texto pode ir em qualquer posição da imagem?
Pode: a posição é um parâmetro da chamada. Centralizado, no rodapé, no canto — você define e o resultado se repete igual em todas as peças.
As artes que eu envio ficam com vocês?
Ficam apenas o tempo de processar a tarefa e devolver a peça pronta — não são publicadas nem usadas para nada além da sua chamada.
Ferramentas relacionadas
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Um POST autenticado cria a tarefa; o resultado chega por webhook ou por um link assinado. Esta capacidade está disponível pela API, não como ferramenta web interativa.
Chame do seu código
curl -X POST https://api.kit.forhosting.com/image/text-overlay \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"image":"https://ejemplo.com/imagen.jpg","text":"OFERTA"}'const res = await fetch("https://api.kit.forhosting.com/image/text-overlay", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"image": "https://ejemplo.com/imagen.jpg",
"text": "OFERTA"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/image/text-overlay",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"image": "https://ejemplo.com/imagen.jpg",
"text": "OFERTA"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/image/text-overlay", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"image":"https://ejemplo.com/imagen.jpg","text":"OFERTA"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"image":"https://ejemplo.com/imagen.jpg","text":"OFERTA"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/image/text-overlay", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemplo de requisição
{
"image": "https://ejemplo.com/imagen.jpg",
"text": "OFERTA"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "image.text_overlay",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Limites
max_mb | 15 |
max_megapixels | 12 |
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |
Notas técnicas
Escreva texto por cima de qualquer imagem via API: você manda a foto, o texto, a posição e o estilo, e recebe a imagem pronta.
A mesma arte, mil variações
Com a API, o modelo fica fixo e o texto vira um parâmetro da chamada: seu sistema gera cada variação em segundos, sempre alinhada, sempre com o mesmo estilo, sem ninguém tocando em arquivo.
Onde encaixar no seu sistema
Arquivos de até 15 MB e 12 megapixels, nos formatos comuns de imagem; a peça volta pronta para publicar ou mandar por e-mail. A tarefa roda de forma assíncrona: o sistema envia a imagem e o texto, recebe um task_id e coleta a peça pronta na sequência. Isso encaixa em qualquer gatilho — venda concluída que gera comprovante visual, aluno aprovado que recebe certificado, produto cadastrado que ganha banner.
Custo por peça gerada
Não existe mensalidade nem pacote: o custo acompanha exatamente o volume que você gerar no mês, e o preço fica publicado nesta página para você fazer a conta antes de integrar. US$ 0,002 por chamada mais US$ 0,005 por imagem — gerar 300 certificados personalizados custa cerca de US$ 1,50.
Perguntas técnicas
Quanto sai cada imagem gerada?
US$ 0,005 por imagem, mais US$ 0,002 pela chamada. Pague por uso, sem plano fixo.