Introdução
O que este endpoint faz
Gera um SVG a partir de um prompt de texto com Ideogram Vector 1.0. O arquivo é formado por caminhos e gradientes, por isso pode ser redimensionado livremente e aberto como formas editáveis.
Entradas principais
prompt descreve o design. quality permite escolher low, medium ou high. aspect_ratio define o formato da tela entre 17 proporções. reference_image_urls é opcional: até cinco imagens para orientar o estilo.
O que você recebe
Um arquivo .svg por solicitação (MIME image/svg+xml).
| Campo | Valor |
|---|---|
| Entrada | Texto |
| Saída | Imagem |
| Entrada para vetorização | JPEG, PNG ou WebP, até 50 MB |
| Tamanho do prompt | Até 9,500 caracteres |
| Imagens de referência | Até 5 para artes geradas |
Recursos e destaques
Um retrato no café reconstruído com formas de cor chapada
Vetorizamos uma foto de 1024×1536 com detailed. O SVG tinha cerca de 2,000 caminhos e 580 gradientes: cabelo, malha e luz da janela viraram áreas de cor posterizadas que preservam a cena original, em um arquivo de aproximadamente 2 MB.
Um ícone PNG plano vira 17 caminhos limpos
Um ícone de xícara de café exportado em PNG virou um SVG de 6 KB. Os contornos, as curvas do vapor e o emblema de folha correspondem ao bitmap. Cada forma é um caminho separado, então basta um clique no editor vetorial para mudar sua cor.
simple une as formas pequenas
À esquerda está o original; no centro, a vetorização com simple; à direita, com detailed. simple reduziu os caminhos de cerca de 2,000 para menos de 1,000 e o arquivo de 2 MB para 1.1 MB. Os contornos do cabelo e do suéter viraram blocos mais amplos.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Descreva o tema, o estilo (plano, desenho de linhas, geométrico), as cores e o texto que deseja incluir. pelo menos 1 caracteres · no máximo 9500 caracteres |
quality | Não | low, medium (padrão) ou high. Os níveis mais altos adicionam detalhes e levam mais tempo; cada um tem seu próprio preço por SVG. |
aspect_ratio | Não | Formato da tela vetorial, de 1:4 vertical a 4:1 horizontal; o padrão é 1:1. |
reference_image_urls | Não | Opcional: até cinco imagens JPEG, PNG ou WebP de até 10 MB cada, usadas como referência de estilo e composição. A primeira tem mais peso. no máximo 5 itens |
Preços
Cada SVG concluído é cobrado uma única vez pela tarifa do seu nível de qualidade. Imagens de referência só aumentam a tarifa em high. Solicitações que falham ou não retornam um SVG não são cobradas.
| With references | Qualidade: low | Qualidade: medium | Qualidade: high |
|---|---|---|---|
| $0.174 / imagem | $0.216 / imagem | $0.264 / imagem |
| $0.174 / imagem | $0.216 / imagem | $0.432 / imagem |
Casos de uso
Logos e marcas com texto
Peça um símbolo com um nome curto e mantenha as letras como contornos vetoriais, nítidos em um cartão de visita ou na fachada de uma loja.
Recupere um logo de baixa resolução
Vetorize um logo antigo em PNG ou JPEG para SVG e imprima em tamanho grande, mude suas cores ou envie para uma gráfica.
Pôsteres, adesivos e arquivos de corte
Gere um pôster ou adesivo como formas vetoriais, ou vetorize artes para plotters de recorte, gravadoras a laser e programas de bordado que precisam de vetores.
Guia de prompt e dicas práticas
Escolha a operação
Envie prompt para um novo design (text-to-image) ou
image_urlpara vetorizar uma imagem existente (edit). Solicitações comimage_urlsão encaminhadas automaticamente para vetorização.Escolha as configurações
Para uma nova arte, escolha quality e
aspect_ratioe, se quiser, até cinco imagens de referência. Para vetorizar, escolhadetail_level: detailed ou simple.Baixe o SVG
Consulte o status da tarefa e baixe o .svg do armazenamento da plataforma. Abra no Figma, Illustrator ou Inkscape para editar os caminhos e preenchimentos imediatamente.
Introdução
A função de texto para SVG do Ideogram Vector 1.0 desenha um novo arquivo vetorial a partir de uma descrição. É ideal para logos, emblemas, pôsteres, adesivos e ilustrações simples que precisam ficar nítidos em qualquer tamanho.
Recursos e destaques
Saída vetorial nativa
O modelo retorna elementos de caminho e gradiente, sem colocar uma imagem dentro de um SVG. Abra no Figma, Illustrator ou Inkscape para selecionar cada forma.
Letras legíveis
O Ideogram é conhecido pela tipografia. Nos nossos testes, textos curtos como FOXTROT e NORTH SHORE foram escritos corretamente e integrados ao layout.
Três níveis e 17 proporções
low serve para rascunhos rápidos, medium para a maioria dos trabalhos e high para o máximo de detalhes. A tela vai de 1:4 vertical a 4:1 horizontal.
Casos de uso
Comece uma marca
Gere várias propostas de logo e depois refine a escolhida em um editor vetorial.
Pôsteres para eventos e lojas
Crie um pôster com título que possa ser impresso em A2 sem pixelização.
Adesivos e produtos personalizados
Crie designs para recorte de vinil, serigrafia ou bordado, que exigem arquivos vetoriais.
Guia de prompts e dicas
Descreva o estilo com clareza
Termos como plano, geométrico, desenho de linhas, duas cores ou emblema ajudam o modelo a manter as formas simples e editáveis.
Coloque o texto entre aspas ou em maiúsculas
Escreva o texto exato que deseja incluir e limite a poucas palavras.
Indique as cores
Não há controle de paleta, então liste as cores no prompt, como azul-marinho e pêssego.
Início rápido da API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "ideogram/vector-1/text-to-image",
"input": {
"aspect_ratio": "1:1",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"quality": "medium"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulte a referência da API para autenticação, esquema completo, polling e tratamento de erros.
