O Recraft V3 é um modelo de geração de imagens concebido para design gráfico, bem como para cenas fotográficas e ilustradas. Um briefing escrito descreve o tema, o cenário e a composição; o resultado é uma imagem. O V3 desenvolve a renderização de texto e o fotorrealismo da Recraft, mantendo a consistência de estilo a partir de imagens de exemplo sem novo treino.
O V3 trabalha com texto dentro da imagem, incluindo textos mais longos e letras de tamanho médio. A Recraft descreve uma etapa de composição que estabelece as palavras e as suas posições antes da geração da imagem. A composição pode ser produzida automaticamente a partir do briefing ou organizada manualmente no ambiente de design da Recraft. Isto ajuda a ligar um título, uma ilustração e texto de apoio numa única composição. O fabricante também documenta coordenadas explícitas de disposição de texto, expressas relativamente à imagem, em vez de numa grelha fixa de píxeis. Cada elemento de texto contém uma única palavra e quatro pontos de canto em coordenadas normalizadas: (0, 0) é o canto superior esquerdo e (1, 1) o canto inferior direito. As coordenadas podem ultrapassar esse intervalo e, nesse caso, a forma é recortada. As palavras da disposição explícita de texto têm de cumprir as restrições de caracteres documentadas.
Para um cartaz ou uma capa, forneça o texto exato e descreva a sua hierarquia: qual a linha principal, onde fica e como a imagem a apoia. Verifique a ortografia e o espaçamento renderizados ao selecionar um resultado.
O V3 inclui estilos predefinidos de fotografia, ilustração e emblemas, além de uma biblioteca separada de estilos vetoriais. Recraft V3 Raw é o estilo predefinido do modelo raster; Vector art é a predefinição da variante vetorial. O fotorrealismo visa uma aparência fotográfica, enquanto a ilustração abrange texturas estilizadas, sombreamento e transições de cor mais complexas. Os estilos vetoriais privilegiam formas, paletas limitadas e preenchimentos planos ou gradientes simples.
Os estilos personalizados podem ser criados a partir de imagens de referência, estilos compatíveis existentes ou uma combinação. Proporcionam uma direção visual reutilizável numa série de imagens. Os controlos de mistura documentados permitem atribuir pesos separados às referências e aos estilos de origem; o número de pesos corresponde ao de fontes. PaletteMatch e MaxWeight são as duas políticas de mistura indicadas. O fabricante permite até 10 imagens de referência de estilo e utiliza o modo regular de correspondência de estilo para o V3. Um estilo personalizado guardado e referências de estilo diretas são entradas alternativas e um estilo personalizado tem de corresponder ao modelo utilizado na geração.
As cores preferidas e uma cor de fundo orientam a paleta. Estão documentadas até 10 cores RGB, com cada componente entre 0 e 255. Os pesos relativos opcionais variam entre 0 e 1; têm de ser fornecidos para todas as cores ou para nenhuma e o seu total não pode exceder 1. O nível artístico varia entre 0, para um tratamento estático e limpo, e 5, para composições mais dinâmicas e excêntricas. Uma instrução negativa descreve elementos indesejados; um controlo separado de ausência de texto desativa as disposições de texto incorporadas. Está disponível uma semente aleatória para reprodutibilidade. Estes controlos oferecem diferentes formas de orientar a cena, o estilo e a disposição visual.
A Recraft documenta duas variantes V3. O modelo raster produz WebP sem perdas ou PNG e adequa-se a pormenores fotográficos, sombreamento e ilustração com textura. O Recraft V3 Vector produz SVG: caminhos e formas que podem ser redimensionados sem uma resolução fixa em píxeis. Adequa-se a pictogramas, conceitos de logótipos, distintivos e trabalhos vetoriais detalhados. A conversão de raster para vetor é uma operação separada da geração direta de trabalhos vetoriais.
As duas variantes têm identidade própria. Uma imagem com aparência vetorial e uma saída SVG real são escolhas diferentes. Selecione a saída pretendida ao preparar um fluxo de design, em vez de tratar o nome V3 partilhado como prova de que todas as operações devolvem o mesmo tipo de ficheiro.
A documentação V3 da Recraft indica geração de imagem para imagem, inpainting, outpainting e substituição ou geração de fundo. O trabalho de imagem para imagem combina uma imagem existente com um novo briefing. O inpainting regenera a região selecionada utilizando uma imagem e uma máscara correspondente; o outpainting acrescenta conteúdo para além do enquadramento original. As operações de fundo tratam a envolvente de um tema.
O conjunto de ferramentas associado também inclui apagar, remoção de fundo, vetorização e duas abordagens de ampliação. A ampliação criativa pode introduzir novos pormenores; a ampliação nítida visa uma versão maior e mais definida do conteúdo existente. São operações distintas com as suas próprias entradas e resultados, e não significados adicionais do nome do modelo raster ou vetorial.
A especificação de geração V3 do fabricante aceita uma instrução com até 1000 caracteres e 1–6 imagens por pedido. Suporta 14 proporções: 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 6:10, 14:10, 10:14, 16:9 e 9:16. Os exemplos raster documentados incluem 1024x1024, 1820x1024 e 1024x1820. As dimensões raster exatas têm de pertencer à lista suportada; o SVG utiliza proporções sem tamanho fixo em píxeis. Quando o tamanho é omitido, o sistema do fabricante seleciona-o a partir da instrução.
Para operações com entrada de imagem, o fabricante indica PNG, JPG e WebP, com SVG quando a operação específica o permite. Os ficheiros devem ter menos de 20 MB, no máximo 16 MP e um lado mais longo de até 4096 píxeis. O lado mais curto deve ter pelo menos 256 píxeis, com uma exceção de 32 píxeis para ampliação nítida. As máscaras correspondem ao tamanho da imagem e utilizam preto e branco puros; as referências de estilo têm um limite combinado de 64 MB.
Para um projeto com a API Ailoot, transforme a tarefa num briefing de imagem focado: o texto exato, a disposição dos objetos, o estilo visual e a composição desejada. Um cartaz, uma cena de produto e uma série de ícones exigem briefings diferentes; preserve as distinções relevantes entre variantes e operações V3 ao decidir como utilizar cada resultado.
", "aboutText": "O Recraft V3 é um modelo de geração de imagens concebido para design gráfico, bem como para cenas fotográficas e ilustradas. Um briefing escrito descreve o tema, o cenário e a composição; o resultado é uma imagem. O V3 desenvolve a renderização de texto e o fotorrealismo da Recraft, mantendo a consistência de estilo a partir de imagens de exemplo sem novo treino.\n\n### Texto como parte da composição\n\nO V3 trabalha com texto dentro da imagem, incluindo textos mais longos e letras de tamanho médio. A Recraft descreve uma etapa de composição que estabelece as palavras e as suas posições antes da geração da imagem. A composição pode ser produzida automaticamente a partir do briefing ou organizada manualmente no ambiente de design da Recraft. Isto ajuda a ligar um título, uma ilustração e texto de apoio numa única composição. O fabricante também documenta coordenadas explícitas de disposição de texto, expressas relativamente à imagem, em vez de numa grelha fixa de píxeis. Cada elemento de texto contém uma única palavra e quatro pontos de canto em coordenadas normalizadas: (0, 0) é o canto superior esquerdo e (1, 1) o canto inferior direito. As coordenadas podem ultrapassar esse intervalo e, nesse caso, a forma é recortada. As palavras da disposição explícita de texto têm de cumprir as restrições de caracteres documentadas.\n\nPara um cartaz ou uma capa, forneça o texto exato e descreva a sua hierarquia: qual a linha principal, onde fica e como a imagem a apoia. Verifique a ortografia e o espaçamento renderizados ao selecionar um resultado.\n\n### Estilo, paleta e direção artística\n\nO V3 inclui estilos predefinidos de fotografia, ilustração e emblemas, além de uma biblioteca separada de estilos vetoriais. Recraft V3 Raw é o estilo predefinido do modelo raster; Vector art é a predefinição da variante vetorial. O fotorrealismo visa uma aparência fotográfica, enquanto a ilustração abrange texturas estilizadas, sombreamento e transições de cor mais complexas. Os estilos vetoriais privilegiam formas, paletas limitadas e preenchimentos planos ou gradientes simples.\n\nOs estilos personalizados podem ser criados a partir de imagens de referência, estilos compatíveis existentes ou uma combinação. Proporcionam uma direção visual reutilizável numa série de imagens. Os controlos de mistura documentados permitem atribuir pesos separados às referências e aos estilos de origem; o número de pesos corresponde ao de fontes. PaletteMatch e MaxWeight são as duas políticas de mistura indicadas. O fabricante permite até 10 imagens de referência de estilo e utiliza o modo regular de correspondência de estilo para o V3. Um estilo personalizado guardado e referências de estilo diretas são entradas alternativas e um estilo personalizado tem de corresponder ao modelo utilizado na geração.\n\nAs cores preferidas e uma cor de fundo orientam a paleta. Estão documentadas até 10 cores RGB, com cada componente entre 0 e 255. Os pesos relativos opcionais variam entre 0 e 1; têm de ser fornecidos para todas as cores ou para nenhuma e o seu total não pode exceder 1. O nível artístico varia entre 0, para um tratamento estático e limpo, e 5, para composições mais dinâmicas e excêntricas. Uma instrução negativa descreve elementos indesejados; um controlo separado de ausência de texto desativa as disposições de texto incorporadas. Está disponível uma semente aleatória para reprodutibilidade. Estes controlos oferecem diferentes formas de orientar a cena, o estilo e a disposição visual.\n\n### Imagens raster e uma variante SVG separada\n\nA Recraft documenta duas variantes V3. O modelo raster produz WebP sem perdas ou PNG e adequa-se a pormenores fotográficos, sombreamento e ilustração com textura. O Recraft V3 Vector produz SVG: caminhos e formas que podem ser redimensionados sem uma resolução fixa em píxeis. Adequa-se a pictogramas, conceitos de logótipos, distintivos e trabalhos vetoriais detalhados. A conversão de raster para vetor é uma operação separada da geração direta de trabalhos vetoriais.\n\nAs duas variantes têm identidade própria. Uma imagem com aparência vetorial e uma saída SVG real são escolhas diferentes. Selecione a saída pretendida ao preparar um fluxo de design, em vez de tratar o nome V3 partilhado como prova de que todas as operações devolvem o mesmo tipo de ficheiro.\n\n### Edição e acabamento de trabalhos existentes\n\nA documentação V3 da Recraft indica geração de imagem para imagem, inpainting, outpainting e substituição ou geração de fundo. O trabalho de imagem para imagem combina uma imagem existente com um novo briefing. O inpainting regenera a região selecionada utilizando uma imagem e uma máscara correspondente; o outpainting acrescenta conteúdo para além do enquadramento original. As operações de fundo tratam a envolvente de um tema.\n\nO conjunto de ferramentas associado também inclui apagar, remoção de fundo, vetorização e duas abordagens de ampliação. A ampliação criativa pode introduzir novos pormenores; a ampliação nítida visa uma versão maior e mais definida do conteúdo existente. São operações distintas com as suas próprias entradas e resultados, e não significados adicionais do nome do modelo raster ou vetorial.\n\n### Limites de instrução, tamanho e imagem de origem\n\nA especificação de geração V3 do fabricante aceita uma instrução com até 1000 caracteres e 1–6 imagens por pedido. Suporta 14 proporções: 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 6:10, 14:10, 10:14, 16:9 e 9:16. Os exemplos raster documentados incluem 1024x1024, 1820x1024 e 1024x1820. As dimensões raster exatas têm de pertencer à lista suportada; o SVG utiliza proporções sem tamanho fixo em píxeis. Quando o tamanho é omitido, o sistema do fabricante seleciona-o a partir da instrução.\n\nPara operações com entrada de imagem, o fabricante indica PNG, JPG e WebP, com SVG quando a operação específica o permite. Os ficheiros devem ter menos de 20 MB, no máximo 16 MP e um lado mais longo de até 4096 píxeis. O lado mais curto deve ter pelo menos 256 píxeis, com uma exceção de 32 píxeis para ampliação nítida. As máscaras correspondem ao tamanho da imagem e utilizam preto e branco puros; as referências de estilo têm um limite combinado de 64 MB.\n\nPara um projeto com a API Ailoot, transforme a tarefa num briefing de imagem focado: o texto exato, a disposição dos objetos, o estilo visual e a composição desejada. Um cartaz, uma cena de produto e uma série de ícones exigem briefings diferentes; preserve as distinções relevantes entre variantes e operações V3 ao decidir como utilizar cada resultado.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "934b5ad80c11917457d6eccdfe197c01eef6415ad2dd145e28916fad25608d3c", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "pt-pt", "methods": [ { "html": "recraft/recraft-v3O Recraft V3 cria fotografias, ilustrações e composições gráficas com composição sensível ao texto e controlos de estilo. As suas variantes raster e SVG distintas adequam-se a cartazes, conjuntos de imagens de marca, ícones e designs em que o texto e a estrutura visual têm de funcionar em conjunto.
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 V3 é um modelo de geração de imagens concebido para design gráfico, bem como para cenas fotográficas e ilustradas. Um briefing escrito descreve o tema, o cenário e a composição; o resultado é uma imagem. O V3 desenvolve a renderização de texto e o fotorrealismo da Recraft, mantendo a consistência de estilo a partir de imagens de exemplo sem novo treino.
O V3 trabalha com texto dentro da imagem, incluindo textos mais longos e letras de tamanho médio. A Recraft descreve uma etapa de composição que estabelece as palavras e as suas posições antes da geração da imagem. A composição pode ser produzida automaticamente a partir do briefing ou organizada manualmente no ambiente de design da Recraft. Isto ajuda a ligar um título, uma ilustração e texto de apoio numa única composição. O fabricante também documenta coordenadas explícitas de disposição de texto, expressas relativamente à imagem, em vez de numa grelha fixa de píxeis. Cada elemento de texto contém uma única palavra e quatro pontos de canto em coordenadas normalizadas: (0, 0) é o canto superior esquerdo e (1, 1) o canto inferior direito. As coordenadas podem ultrapassar esse intervalo e, nesse caso, a forma é recortada. As palavras da disposição explícita de texto têm de cumprir as restrições de caracteres documentadas.
Para um cartaz ou uma capa, forneça o texto exato e descreva a sua hierarquia: qual a linha principal, onde fica e como a imagem a apoia. Verifique a ortografia e o espaçamento renderizados ao selecionar um resultado.
O V3 inclui estilos predefinidos de fotografia, ilustração e emblemas, além de uma biblioteca separada de estilos vetoriais. Recraft V3 Raw é o estilo predefinido do modelo raster; Vector art é a predefinição da variante vetorial. O fotorrealismo visa uma aparência fotográfica, enquanto a ilustração abrange texturas estilizadas, sombreamento e transições de cor mais complexas. Os estilos vetoriais privilegiam formas, paletas limitadas e preenchimentos planos ou gradientes simples.
Os estilos personalizados podem ser criados a partir de imagens de referência, estilos compatíveis existentes ou uma combinação. Proporcionam uma direção visual reutilizável numa série de imagens. Os controlos de mistura documentados permitem atribuir pesos separados às referências e aos estilos de origem; o número de pesos corresponde ao de fontes. PaletteMatch e MaxWeight são as duas políticas de mistura indicadas. O fabricante permite até 10 imagens de referência de estilo e utiliza o modo regular de correspondência de estilo para o V3. Um estilo personalizado guardado e referências de estilo diretas são entradas alternativas e um estilo personalizado tem de corresponder ao modelo utilizado na geração.
As cores preferidas e uma cor de fundo orientam a paleta. Estão documentadas até 10 cores RGB, com cada componente entre 0 e 255. Os pesos relativos opcionais variam entre 0 e 1; têm de ser fornecidos para todas as cores ou para nenhuma e o seu total não pode exceder 1. O nível artístico varia entre 0, para um tratamento estático e limpo, e 5, para composições mais dinâmicas e excêntricas. Uma instrução negativa descreve elementos indesejados; um controlo separado de ausência de texto desativa as disposições de texto incorporadas. Está disponível uma semente aleatória para reprodutibilidade. Estes controlos oferecem diferentes formas de orientar a cena, o estilo e a disposição visual.
A Recraft documenta duas variantes V3. O modelo raster produz WebP sem perdas ou PNG e adequa-se a pormenores fotográficos, sombreamento e ilustração com textura. O Recraft V3 Vector produz SVG: caminhos e formas que podem ser redimensionados sem uma resolução fixa em píxeis. Adequa-se a pictogramas, conceitos de logótipos, distintivos e trabalhos vetoriais detalhados. A conversão de raster para vetor é uma operação separada da geração direta de trabalhos vetoriais.
As duas variantes têm identidade própria. Uma imagem com aparência vetorial e uma saída SVG real são escolhas diferentes. Selecione a saída pretendida ao preparar um fluxo de design, em vez de tratar o nome V3 partilhado como prova de que todas as operações devolvem o mesmo tipo de ficheiro.
A documentação V3 da Recraft indica geração de imagem para imagem, inpainting, outpainting e substituição ou geração de fundo. O trabalho de imagem para imagem combina uma imagem existente com um novo briefing. O inpainting regenera a região selecionada utilizando uma imagem e uma máscara correspondente; o outpainting acrescenta conteúdo para além do enquadramento original. As operações de fundo tratam a envolvente de um tema.
O conjunto de ferramentas associado também inclui apagar, remoção de fundo, vetorização e duas abordagens de ampliação. A ampliação criativa pode introduzir novos pormenores; a ampliação nítida visa uma versão maior e mais definida do conteúdo existente. São operações distintas com as suas próprias entradas e resultados, e não significados adicionais do nome do modelo raster ou vetorial.
A especificação de geração V3 do fabricante aceita uma instrução com até 1000 caracteres e 1–6 imagens por pedido. Suporta 14 proporções: 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 6:10, 14:10, 10:14, 16:9 e 9:16. Os exemplos raster documentados incluem 1024x1024, 1820x1024 e 1024x1820. As dimensões raster exatas têm de pertencer à lista suportada; o SVG utiliza proporções sem tamanho fixo em píxeis. Quando o tamanho é omitido, o sistema do fabricante seleciona-o a partir da instrução.
Para operações com entrada de imagem, o fabricante indica PNG, JPG e WebP, com SVG quando a operação específica o permite. Os ficheiros devem ter menos de 20 MB, no máximo 16 MP e um lado mais longo de até 4096 píxeis. O lado mais curto deve ter pelo menos 256 píxeis, com uma exceção de 32 píxeis para ampliação nítida. As máscaras correspondem ao tamanho da imagem e utilizam preto e branco puros; as referências de estilo têm um limite combinado de 64 MB.
Para um projeto com a API Ailoot, transforme a tarefa num briefing de imagem focado: o texto exato, a disposição dos objetos, o estilo visual e a composição desejada. Um cartaz, uma cena de produto e uma série de ícones exigem briefings diferentes; preserve as distinções relevantes entre variantes e operações V3 ao decidir como utilizar cada resultado.
POST /v1/images/generationstext, imageimage| Campo | Tipo | Requisito | Valores e limites | Predefinição |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObrigatório | Valores e limites recraft/recraft-v3 | Predefinição— |
Campoprompt | Tipostring | RequisitoObrigatório | Valores e limites Comprimento mínimo: 1 | Predefinição— |
Campon | Tipointeger | RequisitoOpcional | Valores e limites Mínimo: 1 Máximo: 6 | Predefinição— |
Campoaspect_ratio | Tipostring | RequisitoOpcional | Valores e limites 1:1, 4:3, 3:4, 16:9, 9:16, auto | 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— |
Texto para imagem · Obrigatório: prompt
| Parâmetro | Contrato |
|---|---|
Parâmetrocontent_type | Contratoapplication/json |
Parâmetrorequired | Contratomodel, prompt |
Parâmetromaterial_types | Contratotext, image |
Parâmetrooptional_controls | Contratoaspect_ratio, n, input_references |
Parâmetroexact_supported_parameters | Contrato{"aspect_ratio":{"type":"enum","values":["1:1","4:3","3:4","16:9","9:16","auto"]},"n":{"type":"range","min":1,"max":6},"input_references":{"type":"range","min":0,"max":1}} |
Parâmetroreference_material_rule | ContratoApenas referências reais de imagens do cliente; aplicam-se as condições do endpoint do fornecedor. |
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}
Utilize o modelo exato e os campos de entrada documentados.
Conserve a resposta completa, todos os resultados reais e os IDs originais devolvidos.
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çã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 →
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çã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. |
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-v3', '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\nfrom openai import OpenAI\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")\n\nrequest={'model': 'recraft/recraft-v3', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.images.generate(**request)\nPath("sdk-result.txt").write_text(str(result),encoding="utf-8")\nsave_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])\nimport OpenAI from "openai";\nimport { readFileSync, writeFileSync } from "node:fs";\nconst key=process.env.AILOOT_API_KEY;\nif(!key) throw new Error("Set your actual Ailoot API key");\nconst client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});\nconst request={"model": "recraft/recraft-v3", "prompt": "a red panda astronaut floating in space, studio lighting"};\nconst result=await client.images.generate(request);\nwriteFileSync("sdk-result.json",JSON.stringify(result,null,2));\nif(!result.data?.length) throw new Error("No completed images");\nfor(let index=0;index<result.data.length;index++) {\n const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;\n if(!encoded && uri.startsWith("data:image/")) {\n const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");\n encoded=uri.slice(comma+1);\n }\n if(encoded) {\n if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");\n raw=Buffer.from(encoded,"base64");\n } else if(uri) {\n const u=new URL(uri,"https://api.ailoot.ai");\n if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");\n const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");\n const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});\n if(!response.ok) throw new Error("Image content download failed: "+response.status);\n raw=Buffer.from(await response.arrayBuffer());\n } else throw new Error("Image has neither bytes nor URL");\n if(!raw.length) throw new Error("Empty image result");\n const ext=raw.subarray(0,4).equals(Buffer.from([137,80,78,71]))?"png":raw[0]===255&&raw[1]===216?"jpg":raw.toString("ascii",0,4)==="RIFF"&&raw.toString("ascii",8,12)==="WEBP"?"webp":raw.toString("utf8").trimStart().startsWith("<svg")||raw.toString("utf8").trimStart().startsWith("<?xml")?"svg":"bin";\n writeFileSync(`image-${index}.${ext}`,raw);\n}\nconsole.log("Every returned image saved; sdk-result.json retains complete metadata");\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}Guarde cada imagem concluída; obtenha cada URL devolvido ou descodifique o respetivo conteúdo Base64.
Conserve todos os elementos de dados e a utilização completa; assegure a propriedade e guarde todas as imagens efetivamente devolvidas. Sem URLs ou IDs inventados.
Se o resultado de uma geração ou edição de imagem requerer verificação, guarde o operation_id/X-Client-Request-ID original e as informações do resultado devolvidas. Recupere os resultados existentes que lhe pertencem através da biblioteca de multimédia, usando valores task_id ou asset_id reais. Não volte a enviar o pedido de geração/edição nem construa um URL de consulta periódica a partir de operation_id.
| Campo | Tipo |
|---|---|
Campocreated | Tipointeger |
Campodata[].url | Tipostring |
Campodata[].b64_json | Tipobase64 string |
Campousage | Tipoobject |
Ailoot Ultra recraft/recraft-v3
/v1/images