Source: https://ailoot.ai/models/pt-pt/recraft-recraft-v4-1-vector/
Canonical: https://ailoot.ai/models/pt-pt/recraft-recraft-v4-1-vector/
Language: pt-pt

# Recraft: Recraft V4.1 Vector

[Markdown](https://ailoot.ai/models/pt-pt/recraft-recraft-v4-1-vector/index.md) · [JSON](https://ailoot.ai/models/pt-pt/recraft-recraft-v4-1-vector/facts.json)

## [Recraft: Recraft V4.1 Vector](https://ailoot.ai/models/pt-pt/recraft-recraft-v4-1-vector/)

O Recraft V4.1 Vector gera logótipos, lettering e ilustrações SVG editáveis a partir de texto, com entradas opcionais de imagem e estilo. É a edição vetorial padrão do V4.1 para grafismos que precisam de geometria escalável e de ajustes de design posteriores.

- [**Ailoot Ultra · Images** `POST /v1/images/generations` `recraft/recraft-v4.1-vector`](https://ailoot.ai/models/pt-pt/recraft-recraft-v4-1-vector/#method-0)

Sobre o modelo

Esta descrição apresenta as capacidades do modelo. As entradas, saídas e opções disponíveis no Ailoot para o método selecionado estão indicadas abaixo.

O Recraft V4.1 Vector é o modelo SVG padrão da família V4.1 da Recraft. Destina-se à criação de ilustrações, logótipos e lettering que possam ser remodelados, recoloridos e utilizados como elementos vetoriais. Aceita um pedido textual e pode trabalhar com entradas de imagem através dos fluxos documentados pelo fabricante de estilo ou de imagem para imagem. O SVG resultante é um resultado diferente de uma imagem raster WebP ou PNG do V4.1; esta edição deve ser identificada pelo formato vetorial, e não por uma indicação de resolução raster.

A variante exata é recraftv4\_1\_vector, distinta de recraftv4\_1\_pro\_vector e dos modelos Utility Vector. O guia de tamanhos indica que todas as variantes vetoriais aceitam catorze proporções entre largura e altura e produzem SVG sem dimensões fixas em píxeis. Utilize essa proporção para estabelecer a composição pretendida, como um ícone quadrado ou um logótipo largo. O tamanho final de apresentação pode depois ser escolhido no fluxo de design, em vez de ser fixado por uma saída raster 1K.

O fabricante posiciona o V4.1 Vector para tipografia expressiva e ilustração limpa. Um pedido útil indica o objeto ou a palavra, o caráter geométrico, a espessura do traço, o tratamento de preenchimento e o sistema de cores. Para um símbolo de padaria, peça um grafismo pequeno com uma única haste curva de cereal, uma silhueta forte e preenchimentos quentes de duas cores. Explicite as relações espaciais importantes, em vez de depender de uma expressão ampla como logótipo moderno. Numa família de ícones, mantenha estáveis as regras estruturais e varie o objeto identificado.

Estilos personalizados opcionais podem orientar o mesmo tratamento visual através de estilos guardados compatíveis ou imagens de referência. O V4.1 suporta cores preferidas, uma cor de fundo pretendida, uma semente aleatória e prompts com até 10,000 caracteres; o fluxo de geração pode devolver de um a seis resultados. Um estilo de referência é opcional neste modelo da linha principal e deve ser compatível com o modelo utilizado para o criar. Utilize referências limpas do mesmo universo visual; a correspondência exata de cores entre referência e saída não é garantida. Para geração com estilo de referência, utilize de uma a dez imagens PNG, JPG ou WebP, com um total não superior a 64 MB e menos de 20 MB cada. Cada referência deve ter o lado mais curto com pelo menos 256 píxeis, o lado mais longo com no máximo 4,096 píxeis e uma resolução não superior a 16 megapíxeis. Utilize estas referências ou um estilo guardado compatível, em vez de ambos. Na geração com estilo de referência, a correspondência flexible permite uma interpretação mais livre, enquanto a correspondência precise segue mais de perto a representação, a paleta, a composição e a iluminação.

A operação separada de imagem para imagem pode devolver SVG quando é escolhido um modelo vetorial V4.1. Forneça uma imagem existente e descreva a alteração pretendida, com strength de 0 a 1 a indicar quanto o resultado se pode afastar da fonte. A operação suporta entrada PNG, JPG, WebP ou SVG com menos de 20 MB, até 16 MP e lados entre 256 e 4096 píxeis. Os controlos de correspondência de estilo V4.1 não são suportados nessa operação de transformação; uma referência de estilo para geração e uma imagem a transformar têm papéis diferentes.

A referência atual V4.1 exclui nomes de estilos selecionados, negative\_prompt, text\_layout, artistic\_level e no\_text. Descreva a disposição e o texto positivos pretendidos, em vez de transferir controlos do V3. Inspecione um logótipo ou uma ilustração gerados como SVG: as letras, as silhuetas, as regiões de cor e os pequenos pormenores precisam de funcionar na composição real. A sua vantagem prática é um ponto de partida vetorial editável que segue um pedido de design específico, e não a suposição de que todos os grafismos devolvidos dispensam acabamentos.

Através da Ailoot, selecione este ID exato do modelo em /v1/images/generations e forneça o prompt criativo. O perfil de imagens de referência indicado pela Ailoot aceita uma matriz input\_references opcional que contenha, no máximo, uma entrada image\_url. Preserve todas as entradas data devolvidas, quer a resposta contenha um URL ou conteúdo de imagem codificado, e guarde os bytes efetivos com o tipo de conteúdo devolvido. Guarde usage e qualquer task\_id de multimédia com o ficheiro e, depois, reveja as formas, as letras e as regiões de cor no design pretendido.

**Ailoot Ultra · Images** `POST /v1/images/generations` `recraft/recraft-v4.1-vector`

[`recraft/recraft-v4.1-vector`](https://ailoot.ai/models/pt-pt/#m=recraft%2Frecraft-v4.1-vector&route=Ultra&caller=recraft%2Frecraft-v4.1-vector&fmt=images)

Outro /`recraft/recraft-v4.1-vector`

### Introdução

O Recraft V4.1 Vector gera logótipos, lettering e ilustrações SVG editáveis a partir de texto, com entradas opcionais de imagem e estilo. É a edição vetorial padrão do V4.1 para grafismos que precisam de geometria escalável e de ajustes de design posteriores.

Entradas aceites

Texto · Imagens

Resultados

Imagens

### Disponível no Ailoot · entradas e métodos

**Ailoot Ultra · Images** `POST /v1/images/generations`

Entrada

`text`, `image`

Saída

`image`

Formato de saída

Ficheiro de imagem

| Campo | Tipo | Requisito | Valores e limites | Predefinição |
| --- | --- | --- | --- | --- |
| Campo`model` | Tipo`string` | RequisitoObrigatório | Valores e limites recraft/recraft-v4.1-vector Condições: Utilize exatamente este seletor de encaminhamento do Ailoot. | Predefinição— |
| Campo`prompt` | Tipo`string` | RequisitoObrigatório | Valores e limites Condições: | Predefinição— |
| Campo`n` | Tipo`integer` | RequisitoOpcional | Valores e limites Mínimo: 1 Máximo: 6 Condições: | Predefinição— |
| Campo`aspect_ratio` | Tipo`string` | RequisitoOpcional | Valores e limites 1:1, 4:3, 3:4, 16:9, 9:16, auto Condições: | Predefinição— |
| Campo`output_format` | Tipo`string` | RequisitoOpcional | Valores e limites svg Condições: | Predefinição— |
| Campo`input_references` | Tipo`array` | RequisitoOpcional | Valores e limites Condições: | Predefinição— |
| Campo`quality` | Tipo`string` | RequisitoOpcional | Valores e limites auto, low, medium, high, xhigh, max Condições: | Predefinição— |

Combinações de materiais de entrada

**Texto para imagem**

Parâmetros e ciclo de vida do método

| Parâmetro | Contrato |
| --- | --- |
| Parâmetro`content_type` | Contratoapplication/json |
| Parâmetro`required` | Contratomodel, prompt |
| Parâmetro`optional` | Contraton, aspect\_ratio, output\_format, input\_references, quality |
| Parâmetro`material_types` | Contratotext, image |
| Parâmetro`conditions` | ContratoUtilize exatamente este seletor de encaminhamento do Ailoot., quality é um controlo comum documentado; os fornecedores sem um ajuste de qualidade ignoram-no. Não se promete uma melhoria de qualidade para cada modelo. |

Ciclo de vida: `synchronous_result_then_owned_library`

`GET /v1/media/tasks/{task_id}` · O task\_id efetivamente devolvido ou o registo selecionado da biblioteca; operation\_id é um identificador independente.

`GET /v1/media/assets`

`GET /v1/media/assets/{asset_id}`

### Tarifários

##### Cálculo do custo final

As tarifas apresentadas permitem estimar o custo antes da geração. O montante final cobrado é calculado a partir do custo registado para a geração original. A duração medida do resultado e as quantidades previstas não correspondem à quantidade final faturável.

As referências tarifárias não acrescentam opções ao pedido. Os parâmetros suportados constam do método selecionado.

Modo rápido

Não especificado Quando o modo rápido está selecionado

Modo flex

Não especificado Quando o modo flex está selecionado

Esforço máximo de raciocínio

Não especificado Quando o esforço máximo de raciocínio usa o ajuste predefinido (default)

#### Tarifas estimadas para comparação

#### Preços por configuração

Associe cada custo às condições apresentadas. Use uma única tarifa para cada conjunto de configurações alternativas.

| Configuração | Tabela de tarifas | Quantidade prevista | Unidade de faturação | Custo |
| --- | --- | --- | --- | --- |
| ConfiguraçãoTarifas base por token | Tabela de tarifasTarifa base | Quantidade prevista— | Unidade de faturação— | Custo Entrada · Tokens de entrada · Estimativa apenas para comparação **—** / 1K tokens Saída · Tokens de saída · Estimativa apenas para comparação **—** / 1K tokens Entrada · Leitura da cache · Estimativa apenas para comparação **—** / 1K tokens Entrada · Escrita na cache · Estimativa apenas para comparação **—** / 1K tokens Entrada · Escrita na cache, 1 hora · Estimativa apenas para comparação **—** / 1K tokens |
| Configuraçãoimagem de saída | Tabela de tarifas— | Quantidade prevista— | Unidade de faturaçãopor imagem de saída | Custo Saída · imagem de saída · Estimativa apenas para comparação **$0.16** por imagem de saída |
| ConfiguraçãoCusto estimado de geração | Tabela de tarifas— | Quantidade previstaestimativa para uma geração | Unidade de faturação— | Custo Saída · Custo estimado de geração · Estimativa apenas para comparação **$0.16** estimativa antes da geração Esta estimativa não é um encargo adicional nem uma tarifa fixa para a geração concluída. |

O Ailoot reserva um montante estimado antes de um pedido. Após o resultado, liquida o custo final com base na utilização medida. No streaming, a liquidação usa o registo final de utilização. [Como funcionam a reserva e a liquidação →](https://ailoot.ai/docs/pt-pt/billing/reserve/)

### Exemplos de pedidos

#### Ailoot Ultra · Images

curl · crie uma única vez e guarde o resultado completo

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "recraft/recraft-v4.1-vector", "prompt": "A portrait of an Asian woman with neon green lights in the background, shallow depth of field."}')

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
```

### Receber e guardar os resultados

#### Ailoot Ultra · Images

Descarregue cada imagem devolvida ou guarde o respetivo conteúdo Base64

- `GET /v1/media/tasks/{task_id}`
- `GET /v1/media/assets`
- `GET /v1/media/assets/{asset_id}`

##### Guardar todos os resultados concluídos

Guarde cada imagem concluída; obtenha cada URL devolvido ou descodifique o respetivo conteúdo Base64.

Conserve a resposta completa e os cabeçalhos, os identificadores originais, todos os resultados reais e todos os campos de utilização/contabilidade. Guarde cada recurso único pertencente ao utilizador e conserve todas as funções que apontam para ele.

##### Se for necessário verificar a resposta original

Mantenha o X-Client-Request-ID original, a resposta e os cabeçalhos. Um resultado desconhecido ou result\_pending\_check não autoriza uma segunda criação.

Campos da resposta

| Campo | Tipo |
| --- | --- |
| Campo`data[].url` | Tipostring |
| Campo`data[].b64_json` | Tipostring |
| Campo`usage` | Tipoobject |

Erros e passos seguintes

| Resposta | Condição | Passo seguinte |
| --- | --- | --- |
| Resposta400 · `invalid_request_error` | CondiçãoUm campo obrigatório, o seletor de modelo, o tipo ou a representação da entrada é inválido. | Passo seguinteAnalise os detalhes de validação devolvidos antes de preparar um pedido separado. |
| Resposta`` | CondiçãoO pedido original ou o respetivo resultado é desconhecido ou requer uma verificação. | Passo seguinteMantenha os identificadores e os cabeçalhos originais; consulte apenas os registos de estado ou da biblioteca suportados. Não volte a enviar o pedido de criação. |

### Aliases

#### Aliases do modelo

**Ailoot Ultra** [`recraft/recraft-v4.1-vector`](https://ailoot.ai/models/pt-pt/#m=recraft%2Frecraft-v4.1-vector&route=Ultra&caller=recraft%2Frecraft-v4.1-vector&fmt=images)

#### Aliases dos caminhos dos métodos

Use os caminhos dos métodos indicados acima.

#### IDs de chamada relacionados

[`recraft/recraft-v4.1-vector`](https://ailoot.ai/models/pt-pt/#m=recraft%2Frecraft-v4.1-vector&route=Ultra&caller=recraft%2Frecraft-v4.1-vector&fmt=images)

FAQ · Recraft: Recraft V4.1 Vector

Que entradas e resultados estão disponíveis?

`POST /v1/images/generations` · `recraft/recraft-v4.1-vector`: `text`, `image` → `image`

Que campos utiliza o pedido?

`POST /v1/images/generations` · `recraft/recraft-v4.1-vector`: `model`, `prompt`, `n`, `aspect_ratio`, `output_format`, `input_references`, `quality`

Que limites se aplicam?

`POST /v1/images/generations` · `recraft/recraft-v4.1-vector`: `n.minimum`: `1`; `n.maximum`: `6`

Ligue o Ailoot ao Claude Code, OpenCode, Hermes ou à sua aplicação.

## A empresa e a sua carteira de projetos

A empresa e a sua carteira de projetos: milhões de clientes; vendas mensais na ordem dos milhares de milhões.

## Compre tokens com desconto.

Desconto por subscrição para trabalho regular. Códigos promocionais — até 50% na compra de tokens.

Subscrição

Escolha um plano com desconto para os pedidos regulares.

Código promocional até 50%

Introduza o código na compra. O preço é recalculado conforme a campanha em vigor.

Custos no histórico

O modelo, os tokens e o montante são guardados para cada pedido.

[Escolher subscrição](https://ailoot.ai/docs/pt-pt/billing/subscriptions/) · [Ver preços dos modelos](https://ailoot.ai/models/pt-pt/)

## Ligue a API ao produto que vende.

SaaS, aplicações e bots — ao abrigo da oferta e do contrato de licença Ailoot. Para revenda, peça uma licença de revendedor.

Aplicação comercial

Integre geração de texto, imagens, vídeo e som nas funcionalidades pagas do seu serviço.

Licença de revendedor

Envie uma descrição do projeto e do modelo de acesso. Peça condições escritas de utilização e revenda.

Documentos no site

A oferta, o contrato de licença e a política de tratamento de dados estão disponíveis antes da ligação.

[Pedir licença de revendedor](mailto:support@ailoot.ai) · [Oferta e contrato de licença](https://ailoot.ai/legal/offer?lang=pt-pt)

## Ailoot · A empresa e a sua carteira de projetos





A Ailoot assenta numa experiência operacional consolidada, numa ampla base de clientes, num serviço estável e no acompanhamento contínuo dos KPI.





A empresa e a sua carteira de projetos: milhões de clientes; vendas mensais na ordem dos milhares de milhões.





A Ailoot aplica essa experiência operacional ao acesso por API a funcionalidades de IA nos produtos dos clientes, agentes, aplicações e automatizações.
