Introdução
O que este endpoint faz
Chama o Recraft 20B no modo SVG e retorna um arquivo vetorial.
Entradas importantes
prompt indica o tema. style escolhe um dos 21 estilos (padrão: vector_illustration). aspect_ratio pode ser 1:1, 16:9, 9:16, 4:3 ou 3:4.
O que você recebe
Um arquivo .svg (MIME image/svg+xml).
| Campo | Valor |
|---|---|
| Entrada | Texto |
| Saída | Imagem |
| Estilos | 21 (10 de ícones, 11 de ilustrações) |
| Proporções de imagem | 1:1, 16:9, 9:16, 4:3, 3:4 |
Recursos e destaques
Um modelo, dois estilos de ícones
À esquerda: uma xícara de café em icon/colored_outline, com 14 caminhos, contorno marrom e preenchimentos suaves. À direita: um ícone de viagem com montanha e sol em icon/outline, com 13 caminhos feitos apenas de linhas. Usar um único estilo no conjunto mantém os ícones consistentes.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Um único tema fica mais claro, especialmente em ícones: uma xícara de café soltando vapor ou uma montanha com sol nascente. Se quiser cores específicas, descreva-as com palavras. pelo menos 1 caracteres · no máximo 1000 caracteres |
style | Não | Dez estilos de ícones (outline, |
aspect_ratio | Não | 1:1 (padrão) para ícones; 16:9, 9:16, 4:3 ou 3:4 para banners e cenas. Define o formato da tela SVG sem custo adicional. |
Preços
$0.053 / SVG
Cada ícone ou ilustração entregue é cobrado por uma tarifa fixa, independentemente do estilo ou da proporção que você escolher. Se a geração falhar, nada é cobrado.
Casos de uso
Conjuntos de ícones para apps e sites
Gere ícones para menus, recursos e estados vazios em um único estilo. Depois, ajuste as cores para combinar com sua interface.
Artes rápidas para blogs e redes sociais
Crie em segundos uma pequena ilustração cartoon ou kawaii para uma publicação ou newsletter.
Projetos de artesanato e impressão
Use estilos de desenho de linha, gravura ou linogravura para adesivos, carimbos, máquinas de corte e cartões impressos.
Guia de prompt e dicas práticas
Escolha um estilo
Escolha um estilo icon/* para ícones de interface ou vector_illustration/* para cenas. O padrão é
vector_illustration.Descreva um único tema
Os ícones ficam melhores com um único objeto, como uma xícara de café soltando vapor ou uma montanha com sol nascente.
Baixe o SVG
Consulte o status da tarefa periodicamente, baixe o arquivo .svg e adicione-o à sua ferramenta de design ou ao seu código.
Introdução
O Recraft 20B SVG gera ícones e ilustrações vetoriais com rapidez e baixo custo. Em vez de descrever um estilo com palavras, você o escolhe em uma lista de 21 estilos definidos.
Principais recursos e destaques
21 estilos definidos
Os estilos de ícones incluem outline, broken_line, colored_outline, colored_shapes, colored_shapes_gradient, doodle_fill, doodle_offset_fill, offset_fill, outline_gradient e uneven_fill. Os estilos de ilustrações incluem cartoon, doodle_line_art, engraving, flat_2, kawaii, line_art, line_circuit, linocut e seamless.
Resultados rápidos
Nossos testes levaram cerca de 11 segundos cada, o que facilita a criação de ícones em lote.
Arquivos leves
Os ícones gerados tinham 20–25 KB.
Casos de uso
Bibliotecas de ícones para produtos
Gere um conjunto consistente para navegação, configurações e listas de recursos.
Ilustrações para conteúdo
Adicione uma imagem cartoon ou kawaii a um artigo, newsletter ou slide.
Adesivos e carimbos
Use linogravura, gravura ou desenho de linha para impressão e máquinas de corte.
Guia de prompts e dicas práticas
Um objeto por ícone
Prompts curtos, como uma montanha com sol nascente, geram ícones mais limpos que descrições longas de cenas.
Mantenha o estilo do conjunto
Use o mesmo valor de style para todos os ícones de um conjunto.
Deixe o texto fora dos ícones
O modelo tem dificuldade com letras. Adicione os rótulos na sua ferramenta de design.
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": "recraft/20b-svg/text-to-image",
"input": {
"style": "vector_illustration",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1:1"
}
}'
# 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.
