Source: https://ailoot.ai/models/pt-pt/recraft-recraft-v4/ Canonical: https://ailoot.ai/models/pt-pt/recraft-recraft-v4/ Language: pt-pt # Recraft: Recraft V4 [Markdown](https://ailoot.ai/models/pt-pt/recraft-recraft-v4/index.md) · [JSON](https://ailoot.ai/models/pt-pt/recraft-recraft-v4/facts.json) ## [Recraft: Recraft V4](https://ailoot.ai/models/pt-pt/recraft-recraft-v4/) O Recraft V4 gera imagens raster 1K com foco na composição, nas relações de cor e na direção criativa detalhada. Abrange ilustração, cenas fotorrealistas e conceitos de design gráfico, com entradas de estilo opcionais e um fluxo separado de imagem para imagem. - [**Ailoot Ultra · Imagens** `POST /v1/images/generations` `recraft/recraft-v4`](https://ailoot.ai/models/pt-pt/recraft-recraft-v4/#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 é o modelo raster padrão da geração V4 da Recraft. O fabricante destaca o critério de design: composição equilibrada, relações de cor coerentes e pormenores que apoiam a intenção visual. Pode trabalhar com ilustração estilizada, cenas fotográficas e conceitos de design gráfico. Utilize-o quando o briefing pede uma imagem que combine escolhas estéticas com fidelidade à instrução, tanto para explorar um ambiente a partir de uma orientação curta como para especificar detalhadamente uma composição intencional. O código exato do modelo é recraftv4. A referência do fabricante indica saída raster 1K em WebP sem perdas ou PNG. Uma imagem quadrada tem 1024 × 1024 píxeis, 16:9 corresponde a 1344 × 768 e 2:3 a 832 × 1280; outras proporções suportadas utilizam as respetivas dimensões. O V4 Pro é a edição raster 2K separada, enquanto o V4 Vector e o Pro Vector devolvem SVG editável. Selecione a variante V4 exata para a entrega pretendida, em vez de combinar estas diferentes propriedades de saída. O guia do fabricante distingue instruções breves e interpretativas de uma direção criativa estruturada. Uma frase curta pode deixar espaço para explorar a forma, o ambiente e o enquadramento. Um briefing estruturado pode identificar o tema, o cenário, a pose, o material, os elementos secundários, a iluminação e a hierarquia visual. Para uma ilustração narrativa, descreva um ciclista a atravessar uma pequena ponte, formas simplificadas marcantes, cores quentes e suaves e um movimento claro da esquerda para a direita. Estas decisões de conteúdo e composição são mais concretas do que uma longa lista de adjetivos de estilo sem relação entre si. A variedade do V4 inclui ilustração, imagens com volume e imagens fotorrealistas. O guia recomenda descrever a lógica do desenho para a ilustração e os materiais, a luz, a câmara e a profundidade para uma imagem de aparência 3D. Esta continua a ser uma imagem raster, e não uma malha editável. Para um conceito de cartaz ou embalagem, indique quais as palavras principais, onde ficam e como a imagem e a tipografia interagem. O fabricante destaca texto curto e de extensão média legível; examine o texto e a disposição reais na imagem devolvida antes de a utilizar. A geração suporta instruções com até 10 000 caracteres, uma semente aleatória, uma a seis imagens de saída, cores preferidas e uma cor de fundo desejada. Estilos personalizados compatíveis e imagens de referência opcionais podem orientar o tratamento visual através de correspondência flexível ou precisa. Escolha uma referência limpa ou um conjunto pertencente ao mesmo universo visual e deixe que a instrução descreva o novo tema e a cena. A correspondência das cores entre referência e resultado não é garantida, por isso mantenha explícita a paleta exigida e compare o resultado com ela. Para geração com estilo de referência, utilize uma a dez imagens PNG, JPG ou WebP, até 64 MB no total e menos de 20 MB por imagem. Cada referência deve ter um lado mais curto de pelo menos 256 píxeis, um lado mais longo de no máximo 4096 píxeis e uma resolução de no máximo 16 megapíxeis. Utilize estas referências ou um estilo guardado compatível, em vez de ambos. A operação documentada de imagem para imagem combina uma imagem existente e uma instrução, com intensidade entre 0 e 1 a determinar quanto a nova saída se afasta da origem. Não aceita controlos de estilo V4 nessa operação. A referência atual de geração também exclui nomes de estilos predefinidos, negative\_prompt, text\_layout, artistic\_level e no\_text. Prepare uma descrição positiva do resultado desejado e avalie a peça na composição de destino. O V4 padrão oferece uma interpretação raster de design focada, com edição, formato e tamanho de saída específicos. Para imagem para imagem, forneça PNG, JPG, WebP ou SVG com menos de 20 MB, no máximo 16 megapíxeis e ambos os lados entre 256 e 4096 píxeis. **Ailoot Ultra · Imagens** `POST /v1/images/generations` `recraft/recraft-v4` [`recraft/recraft-v4`](https://ailoot.ai/models/pt-pt/#m=recraft%2Frecraft-v4&route=Ultra&caller=recraft%2Frecraft-v4&fmt=images) Recraft /`recraft/recraft-v4` ### Introdução O Recraft V4 gera imagens raster 1K com foco na composição, nas relações de cor e na direção criativa detalhada. Abrange ilustração, cenas fotorrealistas e conceitos de design gráfico, com entradas de estilo opcionais e um fluxo separado de imagem para imagem. Entradas aceites Texto · Imagens Resultados Imagens ### Disponível no Ailoot · entradas e métodos **Ailoot Ultra · Imagens** `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 | Predefinição— | | Campo`prompt` | Tipo`string` | RequisitoObrigatório | Valores e limites Comprimento mínimo: 1 | Predefinição— | | Campo`n` | Tipo`integer` | RequisitoOpcional | Valores e limites Mínimo: 1 Máximo: 6 | Predefinição— | | Campo`aspect_ratio` | Tipo`string` | RequisitoOpcional | Valores e limites 1:1, 4:3, 3:4, 16:9, 9:16, auto | Predefinição— | | Campo`input_references` | Tipo`array` | RequisitoOpcional | Valores e limites Número mínimo de elementos: 0 Número máximo de elementos: 1 | Predefinição— | Combinações de materiais de entrada **Texto para imagem** · Obrigatório: prompt **reference\_guided\_image** · Obrigatório: prompt, actual image reference 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`material_types` | Contratotext, image | | Parâmetro`optional_controls` | Contraton, aspect\_ratio, input\_references | | Parâmetro`n` | Contrato{"minimum":1,"maximum":6} | | Parâmetro`reference_images` | Contrato{"minimum":0,"maximum":1,"source":"material real fornecido pelo cliente"} | | Parâmetro`provider_specific_options` | ContratoApenas style/controls/text\_layout da lista exata guardada de valores permitidos do endpoint; sem estruturas adivinhadas. | Aliases do método: `/v1/images` Ciclo de vida: `synchronous_result_then_owned_library` `GET /v1/media/tasks/{task_id}` · task\_id efetivamente devolvido ou registo na biblioteca de multimédia `GET /v1/media/assets/{asset_id}/content` `GET /v1/media/assets` `GET /v1/media/assets/{asset_id}` O exemplo apenas com instrução conserva a estrutura oficial ImageGenerationRequest. Conserve todas as imagens devolvidas e a resposta completa; a quantidade final de saídas é a real, e não o n solicitado. ### 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çãoUltra | 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.08** 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.08** 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/) #### Detalhes da tarifa de referência As tabelas de referência do modelo não alteram a seleção do método, as cotações ou os custos. Os custos ativos usam as tarifas do método Ailoot selecionado. Configurações de preços de imagens #### Preços por configuração | Configuração | Condições de faturação | Custo | | --- | --- | --- | | ConfiguraçãoImagem de saída | Condições de faturaçãoNão está declarada qualquer variante de preços. | Custo Saída · Imagem de saída **$0.08** por imagem As entradas equivalentes descrevem a mesma cobrança; não acrescentam uma segunda taxa. | ### Exemplos de pedidos #### Ailoot Ultra · Imagens curlPython SDKNode.js SDK ```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={'model': 'recraft/recraft-v4', 'prompt': 'a red panda astronaut floating in space, studio lighting'} 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 python3 - <<'PY_RESULT' import base64, json, os, subprocess from pathlib import Path from urllib.parse import urlsplit, urljoin def save_images(items): if not items: raise SystemExit("No completed images; retain the full response") for index, item in enumerate(items): encoded=item.get("b64_json") uri=item.get("url", "") if not encoded and uri.startswith("data:image/"): header, separator, encoded=uri.partition(",") if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI") if encoded: raw=base64.b64decode(encoded,validate=True) elif uri: uri=urljoin("https://api.ailoot.ai",uri) parsed=urlsplit(uri) if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password: raise SystemExit("Invalid returned image URL") owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content") args=["curl","--fail-with-body","--silent","--show-error",uri] if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]] temporary=Path(f"image-{index}.bin") subprocess.run(args+["-o",str(temporary)],check=True) raw=temporary.read_bytes() temporary.unlink() else: raise SystemExit("Image has neither bytes nor URL") if not raw: raise SystemExit("Empty image result") ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"