Recraft: Recraft V4 Styles Pro Vector
O Recraft V4 Styles Pro Vector é a edição SVG Pro da família de imagens da Recraft com consistência de estilo. Cria grafismos vetoriais editáveis a partir de uma descrição textual e de um estilo de referência obrigatório para ilustrações de marca detalhadas, lettering e elementos gráficos coordenados.
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 Styles Pro Vector é o modelo vetorial Pro da família dedicada V4 Styles. O seu objetivo é criar ilustrações SVG novas cujo tratamento visual siga um estilo de referência fornecido. O modelo combina uma descrição textual do que desenhar com referências que estabelecem a aparência pretendida. As utilizações práticas incluem ilustrações de marca, conceitos de lettering e elementos gráficos coordenados nos quais a textura, a representação, a lógica de cores e a composição precisam de uma direção comum.
O código exato de modelo do fabricante é recraftv4_styles_pro_vector, distinto tanto do modelo Styles Vector padrão como do modelo raster Styles Pro. Devolve SVG editável. A referência de tamanhos do fabricante afirma explicitamente que os resultados vetoriais não têm dimensões fixas em píxeis e aceitam apenas proporções; por isso, as dimensões raster 2K do Styles Pro não constituem uma promessa de resolução em píxeis para esta edição Pro Vector. A designação Pro pertence à variante vetorial identificada; prepare a ilustração para a geometria e a utilização pretendidas, em vez de a tratar como um bitmap ampliado.
Cada geração Styles precisa de um estilo. Pode fornecê-lo através de um estilo guardado compatível ou de uma a dez referências PNG, JPG ou WebP; estas duas entradas são alternativas. As referências devem ter menos de 20 MB cada e um total não superior a 64 MB no fluxo documentado. Prefira uma ilustração limpa quando a sua direção já for clara. Se precisar de várias referências, selecione elementos com forma, paleta e representação coerentes, para que o modelo generalize essa linguagem visual em vez de reunir motivos concorrentes. 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 total não superior a 16 megapíxeis.
Escolha a correspondência precise quando o tratamento da referência deva orientar a saída de perto, ou a correspondência flexible padrão quando uma interpretação mais livre for útil. O prompt continua a controlar o novo elemento principal, a disposição, a pose e a cena. Para uma ilustração vetorial editorial detalhada, peça um emblema botânico centrado com três folhas grandes, uma silhueta compacta e um sistema contido de duas cores. Explicite a hierarquia e as relações entre formas; uma referência de estilo, por si só, não descreve essas novas decisões de conteúdo.
O fabricante suporta controlos de cores preferidas e cor de fundo, uma semente aleatória, prompts com até 10,000 caracteres e de um a seis resultados numa geração. O resultado vetorial mantém-se em SVG independentemente de uma definição raster de image_format. A linha dedicada Styles não suporta transformação de imagem para imagem nem inpainting e não aceita os mecanismos mais antigos de estilos selecionados, negative_prompt ou text_layout. A correspondência de referências e a edição de um desenho existente são, por isso, operações diferentes, e não significados intercambiáveis de uma entrada de imagem.
Utilize referências claras e de alta resolução; a reprodução exata das cores não é garantida. Mantenha visível no pedido a utilização pretendida: um logótipo precisa de formas legíveis em tamanho pequeno, enquanto uma ilustração editorial pode admitir mais pormenor. Reveja as letras, o espaçamento, as silhuetas e as regiões de cor do SVG na composição de destino e, depois, aperfeiçoe a descrição textual quando for necessário mudar um elemento principal ou a disposição. Reutilize o mesmo estilo compatível em elementos posteriores, em vez de acrescentar imagens de referência sem relação entre si para forçar variações.
Através da Ailoot, selecione este ID exato do modelo em /v1/images/generations e forneça o prompt criativo. 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-styles-pro-vector
recraft/recraft-v4-styles-pro-vector
recraft/recraft-v4-styles-pro-vectorIntrodução
O Recraft V4 Styles Pro Vector é a edição SVG Pro da família de imagens da Recraft com consistência de estilo. Cria grafismos vetoriais editáveis a partir de uma descrição textual e de um estilo de referência obrigatório para ilustrações de marca detalhadas, lettering e elementos gráficos coordenados.
- 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 |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObrigatório | Valores e limites recraft/recraft-v4-styles-pro-vector Condições: Utilize exatamente este seletor de encaminhamento do Ailoot. | Predefinição— |
Campoprompt | Tipostring | RequisitoObrigatório | Valores e limites Condições: | Predefinição— |
Campon | Tipointeger | RequisitoOpcional | Valores e limites Mínimo: 1 Máximo: 6 Condições: | Predefinição— |
Campoaspect_ratio | Tipostring | RequisitoOpcional | Valores e limites 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, auto Condições: | Predefinição— |
Campooutput_format | Tipostring | RequisitoOpcional | Valores e limites svg Condições: | Predefinição— |
Campoinput_references | Tipoarray | RequisitoObrigatório | Valores e limites Condições: | Predefinição— |
Campoquality | Tipostring | RequisitoOpcional | Valores e limites auto, low, medium, high, xhigh, max Condições: | Predefinição— |
Combinações de materiais de entrada
reference_guided_image
Parâmetros e ciclo de vida do método
| Parâmetro | Contrato |
|---|---|
Parâmetrocontent_type | Contratoapplication/json |
Parâmetrorequired | Contratomodel, prompt, input_references |
Parâmetrooptional | Contraton, aspect_ratio, output_format, quality |
Parâmetromaterial_types | Contratotext, image |
Parâmetroconditions | 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 | Condições de faturação | Custo |
|---|---|---|---|---|---|
| ConfiguraçãoTarifas base por token | Tabela de tarifasTarifa base | Quantidade prevista— | Unidade de faturação— | Condições 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çãoReferência de entrada | Tabela de tarifas— | Quantidade prevista— | Unidade de faturaçãopor pedido | Condições de faturaçãoCriação de estilo ao gerar com referências de estilo; uma vez por pedido, além do preço das imagens de saída. | Custo Entrada · Referência de entrada · Estimativa apenas para comparação $0.01 por pedido Estimativa meramente indicativa; o montante final cobrado é calculado de acordo com a fatura original registada. |
| Configuraçãoimagem de saída | Tabela de tarifas— | Quantidade prevista— | Unidade de faturaçãopor imagem de saída | Condições de faturação— | Custo Saída · imagem de saída · Estimativa apenas para comparação $0.24 por imagem de saída |
| ConfiguraçãoCusto estimado de geração | Tabela de tarifas— | Quantidade previstaestimativa para uma geração | Unidade de faturação— | Condições de faturação— | Custo Saída · Custo estimado de geração · Estimativa apenas para comparação $0.24 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 →
Exemplos de pedidos
Ailoot Ultra · Images
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
: "${AILOOT_IMAGE_URL:?Set an actual customer material or documented value}"
export AILOOT_IMAGE_URL
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "recraft/recraft-v4-styles-pro-vector", "prompt": "A portrait of an Asian woman with neon green lights in the background, shallow depth of field.", "input_references": [{"type": "image_url", "image_url": {"url": "YOUR_ACCESSIBLE_IMAGE_URL"}}]}')
p['input_references'][0]['image_url']['url']=os.environ['AILOOT_IMAGE_URL']
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/assetsGET /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 |
|---|---|
Campodata[].url | Tipostring |
Campodata[].b64_json | Tipostring |
Campousage | 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-styles-pro-vector
Aliases dos caminhos dos métodos
Use os caminhos dos métodos indicados acima.
IDs de chamada relacionados
FAQ · Recraft: Recraft V4 Styles Pro Vector
- Que entradas e resultados estão disponíveis?
POST /v1/images/generations·recraft/recraft-v4-styles-pro-vector:text,image→image- Que campos utiliza o pedido?
POST /v1/images/generations·recraft/recraft-v4-styles-pro-vector:model,prompt,n,aspect_ratio,output_format,input_references,quality- Que limites se aplicam?
POST /v1/images/generations·recraft/recraft-v4-styles-pro-vector:n.minimum:1;n.maximum:6