Recraft: Recraft V4 Pro Vector
O Recraft V4 Pro Vector gera ilustrações SVG editáveis para composições detalhadas, logótipos e ilustração. É a edição vetorial Pro do V4, que suporta pedidos de geração de texto para imagem e fluxos separados de imagem para imagem, sem atribuir dimensões raster em píxeis ao SVG.
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 Pro Vector é o modelo SVG Pro da geração V4 da Recraft. A família centra-se no critério visual, em relações coerentes entre cores, na composição e na interpretação pormenorizada de um pedido criativo. A linha Pro destina-se a pormenores mais finos e composições mais exigentes, enquanto esta edição Vector fornece ilustrações SVG editáveis. É útil para uma ilustração gráfica, um emblema ou um conceito de lettering que precise de um ficheiro de trabalho vetorial para ajustes de design posteriores.
O código exato do modelo é recraftv4_pro_vector. É distinto do V4 Vector padrão, do modelo raster V4 Pro e da família V4.1 posterior. A referência de tamanhos do fabricante indica que todos os modelos vetoriais aceitam catorze proporções entre largura e altura e que a saída SVG não tem dimensões fixas em píxeis. As dimensões raster de 2048 × 2048 do V4 Pro não constituem, por isso, um limite de resolução em píxeis para esta edição. Escolha a composição pretendida e a forma do elemento, em vez de uma indicação de tamanho raster.
As orientações V4 do fabricante salientam uma lógica gráfica plana para trabalho vetorial e logótipos. Descreva o tipo de grafismo, a geometria, a silhueta, as regras de traço, a paleta e a disposição. Para um emblema portuário, peça um grafismo detalhado com uma silhueta compacta de farol, uma forma de onda grande, espaços interiores generosos e duas cores planas. Especifique que elemento deve dominar e que pormenores devem permanecer secundários. Quando o design deve manter-se plano, uma descrição estrutural é mais útil para um resultado vetorial editável do que linguagem de textura fotográfica ou de materiais.
A referência atual de geração para este modelo exato suporta prompts com até 10,000 caracteres, de um a seis resultados, uma semente aleatória e controlos de cores preferidas ou cor de fundo. Estilos personalizados compatíveis opcionais e imagens de referência podem estabelecer um tratamento visual repetido. A correspondência flexible permite uma interpretação mais livre, e a correspondência precise segue o estilo mais de perto. Utilize referências visualmente coerentes e explicite o sistema de cores pretendido; as cores exatas das referências não são garantidas. 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.
A Recraft documenta a transformação de imagem para imagem para os modelos raster e vetoriais V4. Forneça uma imagem existente e descreva a alteração pretendida, com strength de 0 a 1 a determinar quanto o resultado gerado se afasta da fonte. Um modelo vetorial devolve SVG. Esta operação não aceita controlos de estilo V4, pelo que difere da criação de um grafismo novo com uma referência de estilo. Os requisitos de imagem de entrada permitem PNG, JPG, WebP ou SVG com menos de 20 MB, até 16 MP e lados entre 256 e 4096 píxeis.
O V4 não suporta os controlos V3 negative_prompt, nomes de estilos selecionados, text_layout, artistic_level ou no_text. As orientações do fabricante descrevem frases curtas e de comprimento médio legíveis quando a hierarquia é especificada, mas a tipografia exata continua a precisar de inspeção no SVG concluído. Confira a silhueta, as letras, as regiões de cor e os pormenores finos no tamanho pretendido e, depois, ajuste as formas ou as cores conforme o design exigir. Esta é uma edição de geração vetorial detalhada, com saída e controlos próprios, em vez das propriedades do modelo raster Pro.
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-pro-vector
recraft/recraft-v4-pro-vectorIntrodução
O Recraft V4 Pro Vector gera ilustrações SVG editáveis para composições detalhadas, logótipos e ilustração. É a edição vetorial Pro do V4, que suporta pedidos de geração de texto para imagem e fluxos separados de imagem para imagem, sem atribuir dimensões raster em píxeis ao SVG.
- 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-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, 4:3, 3:4, 16:9, 9:16, auto Condições: | Predefinição— |
Campooutput_format | Tipostring | RequisitoOpcional | Valores e limites svg Condições: | Predefinição— |
Campoinput_references | Tipoarray | RequisitoOpcional | 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
Texto para imagem
Parâmetros e ciclo de vida do método
| Parâmetro | Contrato |
|---|---|
Parâmetrocontent_type | Contratoapplication/json |
Parâmetrorequired | Contratomodel, prompt |
Parâmetrooptional | Contraton, aspect_ratio, output_format, input_references, 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 | 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.6 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.6 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
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "recraft/recraft-v4-pro-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/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-pro-vector
Aliases dos caminhos dos métodos
Use os caminhos dos métodos indicados acima.
IDs de chamada relacionados
FAQ · Recraft: Recraft V4 Pro Vector
- Que entradas e resultados estão disponíveis?
POST /v1/images/generations·recraft/recraft-v4-pro-vector:text,image→image- Que campos utiliza o pedido?
POST /v1/images/generations·recraft/recraft-v4-pro-vector:model,prompt,n,aspect_ratio,output_format,input_references,quality- Que limites se aplicam?
POST /v1/images/generations·recraft/recraft-v4-pro-vector:n.minimum:1;n.maximum:6