Recraft: Recraft V4.1 Pro

O Recraft V4.1 Pro gera imagens raster 2K detalhadas para fotografia expressiva, ilustração e peças criativas de maior dimensão. Combina o fotorrealismo natural e a interpretação de instruções curtas do V4.1 com referências de estilo opcionais e fluxos de imagem para imagem.

Ailoot Ultra · Imagens POST /v1/images/generations recraft/recraft-v4.1-pro

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 Pro é a edição raster de maior resolução da família de geração expressiva V4.1 da Recraft. O fabricante destaca o fotorrealismo natural, a composição deliberada e os estilos de ilustração que podem ser desenvolvidos a partir de uma orientação criativa curta. O Pro destina-se a trabalhos em que os pormenores mais finos e um resultado raster maior são importantes, incluindo imagens de marketing de grande dimensão e composições para impressão. Distingue-se da apresentação mais simples do Utility Pro e da saída SVG editável do Pro Vector.

O modelo exato é recraftv4_1_pro. A referência do fabricante indica saída 2K em WebP sem perdas ou PNG. O tamanho quadrado é de 2048 × 2048 píxeis; 16:9 corresponde a 2688 × 1536 e 3:4 a 1792 × 2432, com outras proporções permitidas associadas às respetivas dimensões. Utilize uma proporção adequada à composição pretendida ou um tamanho exato da tabela do fabricante. A designação Pro não torna todas as composições quadradas nem transforma uma imagem raster em geometria vetorial.

O V4.1 pode interpretar uma orientação breve e fornecer escolhas de luz, ambiente e composição. Isto é útil para explorar uma fotografia editorial, uma ilustração estilizada ou uma imagem com volume e materiais refletores. Uma aparência 3D renderizada continua a ser uma imagem, e não uma cena tridimensional editável. Quando precisar de uma direção artística específica, descreva o tema e a cena, o enquadramento, o comportamento dos materiais, a direção da luz, o fundo e a hierarquia visual, em vez de esperar que uma instrução aberta resolva todos os pormenores da forma pretendida.

Para uma fotografia editorial, peça uma vista próxima de um candeeiro de metal escovado com luz suave de janela, um interior acolhedor e vivido e uma composição tranquila com espaço para uma legenda. Um briefing mais ilustrativo pode especificar grandes formas de cor, uma pose animada de personagem e um fundo discreto. Indique a utilização prevista e os pormenores que distinguem o tema e examine depois a saída maior quanto aos materiais, à anatomia e à composição. O resultado é uma peça criativa orientada pelo briefing, e não a observação de uma cena real.

A geração aceita instruções com até 10 000 caracteres, cores preferidas, uma cor de fundo desejada, uma semente aleatória e uma a seis imagens de saída. Referências de estilo ou estilos guardados compatíveis opcionais podem proporcionar um tratamento visual repetido, com correspondência flexível ou precisa. Utilize referências coerentes e claras e especifique o conteúdo na instrução; a correspondência exata de cores a partir de uma referência não é garantida. O V4.1 exclui negative_prompt, nomes de estilos predefinidos, text_layout, artistic_level e no_text, pelo que estes controlos não devem ser importados de edições anteriores. 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 separada de imagem para imagem da Recraft suporta a família V4.1 com uma imagem existente, uma instrução e intensidade entre 0 e 1. Pode preservar aspetos da origem e alterar outros; uma intensidade inferior mantém maior proximidade, enquanto uma intensidade superior permite mais alterações. Esta operação não aceita controlos de estilos personalizados V4.1. Prepare a imagem de origem dentro dos limites de imagem documentados e indique tanto a alteração pretendida como os atributos que devem orientar o novo resultado. Para uma peça final, examine a saída na composição real, em especial os pormenores finos, as letras e o recorte. 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.1-pro

recraft/recraft-v4.1-pro

Recraft /recraft/recraft-v4.1-pro

Introdução

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

Campo	Tipo	Requisito	Valores e limites	Predefinição
Campo`model`	Tipo`string`	RequisitoObrigatório	Valores e limites recraft/recraft-v4.1-pro	Predefinição—
Campo`prompt`	Tipo`string`	RequisitoObrigatório	Valores e limites Comprimento mínimo: 1	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`n`	Tipo`integer`	RequisitoOpcional	Valores e limites Mínimo: 1 Máximo: 6	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—
Campo`provider`	Tipo`object`	RequisitoOpcional	Valores e limites	Predefinição—

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

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}

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.42 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.42 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 · Imagens

curl

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.1-pro', '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"<svg",b"<?xml")) else "bin"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT

Receber e guardar os resultados

Ailoot Ultra · Imagens

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

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Outras leituras de conteúdo

Ler os recursos existentes de que é titular

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.

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, todos os resultados efetivamente produzidos, os identificadores originais devolvidos e todos os campos de utilização. Recupere a operação original sem voltar a enviar o pedido de criação.

Se for necessário verificar a resposta original

Guarde o X-Client-Request-ID devolvido para reconciliação. Consulte apenas os valores task_id/asset_id efetivamente devolvidos ou a sua biblioteca de multimédia; nunca construa um URL de tarefa a partir do ID da operação e nunca volte a enviar o pedido de criação.

Campos da resposta

Campo	Tipo
Campo`created`	Tipo
Campo`data[].url`	Tipo
Campo`data[].b64_json`	Tipo
Campo`usage`	Tipo

Aliases

Aliases do modelo

Ailoot Ultra recraft/recraft-v4.1-pro

Aliases dos caminhos dos métodos

/v1/images

IDs de chamada relacionados

recraft/recraft-v4.1-pro

FAQ · Recraft: Recraft V4.1 Pro

Que entradas e resultados estão disponíveis?: POST /v1/images/generations · recraft/recraft-v4.1-pro: text, image → image
Que campos utiliza o pedido?: POST /v1/images/generations · recraft/recraft-v4.1-pro: model, prompt, aspect_ratio, n, input_references, provider
Que limites se aplicam?: POST /v1/images/generations · recraft/recraft-v4.1-pro: n.minimum: 1; n.maximum: 6

Recraft: Recraft V4.1 Pro