Introdução
O que este endpoint faz
Envia um prompt ao Recraft V4 e retorna um SVG nativo.
Entradas importantes
prompt (até 10,000 caracteres) descreve o design. aspect_ratio escolhe um dos sete formatos de tela; o padrão é 1:1.
O que você recebe
Um arquivo .svg (MIME image/svg+xml) composto por caminhos.
| Campo | Valor |
|---|---|
| Entrada | Texto |
| Saída | Imagem |
| Tamanho do prompt | Até 10,000 caracteres |
| Proporções | 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16 |
Recursos e destaques
Um símbolo de raposa e um emblema de padaria, ambos editáveis
À esquerda: um símbolo de raposa de duas cores, composto por 18 formas. À direita: um emblema de padaria em estilo vintage com o nome Rise & Crumb emoldurado por espigas de trigo, composto por 124 formas em creme e marrom. Ambos abriram em um editor vetorial com todos os elementos selecionáveis.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Indique o tema, o formato (símbolo de logo, emblema, ilustração plana), a paleta e qualquer texto do logo entre aspas. Até 10,000 caracteres; a primeira frase tem mais peso. pelo menos 1 caracteres · no máximo 10000 caracteres |
aspect_ratio | Não | 1:1 (padrão), 4:3, 3:4, 3:2, 2:3, 16:9 ou 9:16. Define as proporções da tela do SVG; a proporção não altera o preço. |
Preços
$0.096 / SVG
Uma tarifa fixa por SVG entregue, independentemente da proporção da tela. Solicitações com falha e resultados vazios não têm custo.
Casos de uso
Exploração de logos
Gere vários símbolos para um novo produto ou loja e finalize o melhor em um editor vetorial.
Ilustração editorial plana
Produza ilustrações de apoio para blogs, landing pages e apresentações que continuem nítidas em qualquer tela.
Gráficos prontos para impressão
Crie emblemas, etiquetas e artes de embalagem em vetores que a gráfica possa ampliar sem perda de qualidade.
Guia de prompt e dicas práticas
Escreva o briefing
Descreva o tema, o estilo (símbolo de logo, emblema, ilustração plana) e as cores. Coloque entre aspas qualquer texto que deva aparecer no logo.
Escolha uma proporção
Escolha
aspect_ratio: 1:1 funciona bem para símbolos e emblemas; 3:2 ou 16:9, para cenas e banners.Edite o SVG
Baixe o arquivo .svg e abra no Figma, Illustrator ou Inkscape para ajustar cores, espaçamento e letras.
Introdução
O Recraft V4 Vector transforma um briefing escrito em um arquivo SVG. A Recraft criou o V4 para designers, com atenção à composição, às cores e à geometria limpa. Este endpoint utiliza o modo vetorial do modelo.
Principais recursos e destaques
Geometria limpa e sobreposta
As formas são caminhos separados, então você pode mudar a cor da orelha de uma raposa ou mover a fita de um emblema sem redesenhar nada.
Paletas respeitadas
Nos nossos testes, as paletas indicadas no prompt, como verde-petróleo e coral ou creme e marrom, foram seguidas de perto.
Nomes integrados ao design
Nomes curtos, como Rise & Crumb, são desenhados como parte da arte.
Casos de uso
Rascunhos de identidade visual
Explore símbolos e emblemas para um novo negócio antes de entregar o melhor a um designer.
Ilustrações para sites e aplicativos
Crie ilustrações de destaque e para estados vazios que continuem nítidas em qualquer tela.
Embalagens e etiquetas
Desenhe artes para etiquetas que possam ser ampliadas para impressão.
Guia de prompts e dicas práticas
Comece pelo formato
Comece com símbolo de logo, emblema, distintivo ou ilustração plana para que o modelo defina o nível de detalhe adequado.
Mantenha os símbolos simples
Para logos, peça formas planas ou geométricas e duas ou três cores.
Revise as letras
Confira a grafia e o espaçamento, depois ajuste em um editor vetorial, se necessário.
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/v4-vector/text-to-image",
"input": {
"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.
