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.
", "aboutText": "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.\n\nO 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.\n\nO 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.\n\nPara 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.\n\nA 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.\n\nA 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.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "6b0ab1a8da410856905a1c0169345bba30ce2288ea2e51dbfe355b25848fe3b1", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "pt-pt", "methods": [ { "html": "recraft/recraft-v4.1-proO 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.
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.
POST /v1/images/generationstext, imageimage| Campo | Tipo | Requisito | Valores e limites | Predefinição |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObrigatório | Valores e limites recraft/recraft-v4.1-pro | Predefinição— |
Campoprompt | Tipostring | RequisitoObrigatório | Valores e limites Comprimento mínimo: 1 | Predefinição— |
Campoaspect_ratio | Tipostring | RequisitoOpcional | Valores e limites 1:1, 4:3, 3:4, 16:9, 9:16, auto | Predefinição— |
Campon | Tipointeger | RequisitoOpcional | Valores e limites Mínimo: 1 Máximo: 6 | Predefinição— |
Campoinput_references | Tipoarray | RequisitoOpcional | Valores e limites Número mínimo de elementos: 0 Número máximo de elementos: 1 | Predefinição— |
Campoprovider | Tipoobject | RequisitoOpcional | Valores e limites | Predefinição— |
| Parâmetro | Contrato |
|---|---|
Parâmetrocontent_type | Contratoapplication/json |
Parâmetrorequired | Contratomodel, prompt |
Parâmetromaterial_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}
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.
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 →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'recraft/recraft-v4.1-pro', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n 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"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nDescarregue cada imagem devolvida ou guarde o respetivo conteúdo Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\nGuarde 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.
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.
| Campo | Tipo |
|---|---|
Campocreated | Tipo |
Campodata[].url | Tipo |
Campodata[].b64_json | Tipo |
Campousage | Tipo |
Ailoot Ultra recraft/recraft-v4.1-pro
/v1/images