{"status":"ok","ts":1779302690.671844}
curl --location --request GET 'https://zylalabs.com/api/12632/customizable+aperiodic+monotile+generator+api/24455/health+check' --header 'Authorization: Bearer YOUR_API_KEY'
{"patch_engine_semver":"1.0.0","supported_tile_families":["spectre_tile_1_1"],"roadmap":{"tile_families":[{"id":"spectre_tile_1_1","status":"supported","label":"Spectre / Tile(1,1)"},{"id":"einstein_hat_tile","status":"planned","label":"Einstein Hat monotile (same API hooks)"},{"id":"turtle_tile","status":"planned","label":"Companion turtle monotile family"}]},"free_tier_formats":["jpeg","jpg","png"],"supported_masks":["square","rectangle","circle","regular_hexagon","triangle","rounded_rect"],"supported_formats":["svg","csv","json","stl","stl_zip","obj_zip","glb","instance_json","png","jpg","jpeg"],"output_notes":{"glb":"3D tiled scene with one named, movable node per retained tile.","stl":"Whole-panel mesh output.","stl_zip":"Independent STL files, one per tile.","obj_zip":"Independent OBJ files, one per tile."},"boundary_behavior":"clip","visual_styling":{"side_styles":["flat","curvy","wavy","jagged","blocky"],"side_style_aliases":{"curved":"curvy","curve":"curvy"},"side_style_amplitude":{"min":0.0,"max":0.75,"default":0.12},"tile_edge_ratio":{"min":0.25,"max":4.0,"default":1.0,"note":"Anisotropic stretch of export geometry only; substitution placement remains canonical Tile(1,1). Not a true Tile(a,b) two-family substitution."},"side_style_wavy_segments":{"min":4,"max":64,"default":10},"palette_by_label":{"supported":true,"keys_per_label":["fill","stroke","opacity","stroke_width"],"wildcard_label":"*"},"request_fields":["side_style","side_style_amplitude","tile_edge_ratio","side_style_wavy_segments","palette_by_label"]},"limits":{"max_supertile_iterations":26,"max_tiles_per_job":500000,"sync_max_tiles":8000,"svg_max_tiles_hard":25000,"png_max_dimension_px":16000,"png_max_pixels":50000000,"max_output_bytes_soft":32212254719,"max_wall_time_sec":3600.0,"job_gc_hours":24,"stl_tile_instancing_floor":50000,"svg_max_chars":400000000,"redis_url":null},"atlas":{"available":true,"max_canonical_half_side":1544.0511060838514,"max_canonical_full_side":3088.102212167703,"cores":[{"tile_family":"spectre_tile_1_1","iterations":5,"tile_count":34649,"inscribed_half_side":72.85611373427516,"inscribed_center":[180.85884907869263,-190.4637563106116],"patch_version":"0.1.0"},{"tile_family":"spectre_tile_1_1","iterations":6,"tile_count":272791,"inscribed_half_side":197.20129785929603,"inscribed_center":[611.0929636810714,-457.26130132202326],"patch_version":"0.1.0"},{"tile_family":"spectre_tile_1_1","iterations":7,"tile_count":2147679,"inscribed_half_side":516.3669015101796,"inscribed_center":[1297.8529395021253,-1742.7605795910576],"patch_version":"0.1.0"},{"tile_family":"spectre_tile_1_1","iterations":8,"tile_count":16908641,"inscribed_half_side":1544.0511060838514,"inscribed_center":[4553.311273135866,-4060.276908476975],"patch_version":"1.0.0"}]},"coordinate_convention":"Canonical Tile(1,1) planar coordinates (unit-edge reference). Global client scale ∈ ℝ⁺ and rotation_deg are similarity transforms applied after substitution.","operational":{"run_jobs_in_process":false,"rate_limit_post_patch":"30/minute","queue_max_active_jobs":2000,"queue_max_active_jobs_per_key":100,"queue_max_heavy_jobs":300,"queue_max_heavy_jobs_per_key":10,"download_ttl_seconds_max":3600,"artifact_retention_note":"Generated artifacts are kept for roughly one hour after the job completes. Download or copy them to your own storage if you need them longer."}}
curl --location --request GET 'https://zylalabs.com/api/12632/customizable+aperiodic+monotile+generator+api/24456/capabilities' --header 'Authorization: Bearer YOUR_API_KEY'
{"job_id":"bfb87a47-6910-462c-86ec-2bb63ca9bba7","status":"queued","tier":"tier_free","size_class":"small","estimated_seconds":5.0,"request_id":"2c7470cc-b96f-4725-b419-41826e2871e5","queue":{"status":"queued","size_class":"small","position":1,"estimated_wait_seconds":0.0}}
curl --location --request POST 'https://zylalabs.com/api/12632/customizable+aperiodic+monotile+generator+api/24457/create+patch+job' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{
"mask": {"type": "circle", "radius": 16},
"formats": ["png", "jpg"],
"png_width_px": 512,
"png_height_px": 512,
"jpg_width_px": 512,
"jpg_height_px": 512
}'
{"job_id":"bfb87a47-6910-462c-86ec-2bb63ca9bba7","status":"completed","ttl_seconds":900,"urls":{"patch.jpg":"/v1/downloads/bfb87a47-6910-462c-86ec-2bb63ca9bba7/patch.jpg?exp=1779375751&sig=d61d646a3e3893ba4bd7c753a46cb9af2e8eca4178467ec19f62a2481ad3d39a","patch.png":"/v1/downloads/bfb87a47-6910-462c-86ec-2bb63ca9bba7/patch.png?exp=1779375751&sig=c6c4732a4874653588673c05fe14fb4570047b05603da7318d701d7694ec5064"}}
curl --location --request GET 'https://zylalabs.com/api/12632/customizable+aperiodic+monotile+generator+api/24458/get+job+download+urls&job_id=Required' --header 'Authorization: Bearer YOUR_API_KEY'
Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a Gerador de Monotile Aperiódico Personalizável API basta incluir seu token Bearer no cabeçalho Authorization.
| Cabeçalho | Descrição |
|---|---|
Authorization
|
Obrigatório
Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito.
|
Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento. O teste gratuito inclui até 50 requisições.
(Economize 2 meses com cobrança anual 🎉)
Sobre a API
A API do Gerador de Monotile Aperiódico é um serviço REST hospedado para geometria de monotile aperiódico sem lacunas usando Spectre Tile 1,1 (monotile de Einstein). Ela preenche uma região com um revestimento não repetitivo, recorta para uma forma de máscara, atribui IDs e rótulos de tile estáveis, e exporta artefatos prontos para produção. Criada para desenvolvedores e agentes de IA que precisam de revestimentos reais sem executar profundidade de substituição, construção de atlas, ou ferramentas de iteração fractal no cliente. Suporta gráficos computacionais, mundos procedurais, Blender e motores de jogos, Adobe e CAD, impressão 3D, arte generativa, visualização científica, metamateriais, layouts de ondas e acústicos, experimentos de rede adjacentes à criptografia, e pipelines de dados que requerem geometria determinística.
O que esta API recebe e o que sua API fornece (entrada/saída)
Você envia JSON com uma máscara e formatos de saída. As máscaras incluem círculo, retângulo, quadrado, triângulo, hexágono regular e retângulo arredondado, centralizados automaticamente em unidades de tile canônicas. Escalas opcionais, rotação, semente, opções de traço SVG e paleta, dimensões raster, e profundidade de extrusão 3D. Autentique-se com o cabeçalho X-API-Key. O fluxo de trabalho é assíncrono: crie um trabalho de patch, verifique o status do trabalho até ser concluído ou falhar, então busque URLs de download assinadas. Os formatos incluem png, jpg, jpeg, svg, csv, json, stl, glb, stl_zip, obj_zip, e instance_json. O GLB fornece um nó nomeado por tile. STL ZIP e OBJ ZIP fornecem malhas independentes por tile. Chaves gratuitas permitem apenas pequenas prévias raster. Chaves pagas Solo e Comercial desbloqueiam vetores, 3D, pacotes zip, e trabalhos maiores. O cabeçalho opcional Idempotency-Key previne envios duplicados em tentativas. Chame o endpoint de capacidades para inspecionar limites de tier ao vivo, máscaras suportadas, formatos e profundidade da fila antes de grandes trabalhos.
Quais são os casos de uso mais comuns desta API
Anti-moire e amostragem não periódica para renderização e texturas. Malhas procedurais e decoração de mundos em Unity, Godot, e Three.js via GLB. Integração de complementos para Blender e pipeline para superfícies revestidas. Saída vetorial para Illustrator, Inkscape, e fluxos de trabalho de laser ou plotter via SVG. Impressão 3D de painel único com STL ou tiles imprimíveis separados com STL ZIP e OBJ ZIP. Escultura generativa e design ornamental. Pesquisa e educação sobre revestimentos aperiódicos. CSV, JSON, e manifestos de instância para importadores personalizados, indexação espacial, e conjuntos de dados de aprendizado de máquina. Agentes devem iniciar usuários em png ou jpg, mover para svg para ferramentas de design, glb para 3D em tempo real, stl para painéis de fabricação, e stl_zip quando cada tile deve ser um objeto separado.
Existem limitações com seus planos
O nível gratuito é limitado a pequenas prévias de PNG e JPG. Trabalhos pesados, como grandes exportações GLB ou zip, são classificados como pequenos, padrão, ou pesados e podem ser enfileirados; as respostas incluem espera estimada e posição na fila, então os clientes devem consultar em vez de reenviar. URLs de download assinadas expiram; os usuários devem salvar artefatos que consideram importantes. Não pergunte aos usuários finais sobre a família do tile, centro da máscara, modo de retenção, versão do patch, profundidade de substituição, ou extensão de cobertura. Orientação completa e legível por máquina para integração de agentes de IA está disponível no site de documentação do provedor configurado nesta lista.
Cada ponto final retorna dados JSON O ponto final de Verificação de Saúde fornece um status e timestamp O ponto final de Capacidades detalha formatos suportados tipos de máscara e limites de nível O ponto final de Criar Trabalho de Patch retorna status do trabalho e tempos de espera estimados O ponto final de Obter URLs de Download de Trabalho fornece URLs para baixar artefatos gerados
Os campos-chave incluem "status", "job_id", "estimated_seconds" e "urls" Por exemplo a resposta do Criar Job de Patch inclui "job_id" para rastrear o trabalho e "status" para indicar seu estado atual enquanto a resposta do Obter URLs de Download de Job inclui "ttl_seconds" para expiração de URL
Os parâmetros incluem forma da máscara (por exemplo, círculo, retângulo), escala, rotação, paleta de cores e dimensões raster. Os usuários podem personalizar seus pedidos especificando esses parâmetros na carga útil JSON para adaptar os padrões gerados às suas necessidades
Os dados da resposta estão estruturados em pares de chave-valor Por exemplo a resposta do Job de Patch de Criação inclui detalhes de "job_id" "status" e "queue" permitindo que os usuários acessem facilmente as informações do trabalho e acompanhem seu progresso
O endpoint de Capacidades fornece informações sobre formatos de saída suportados, tipos de máscara, limites de nível e configurações de fila Isso ajuda os usuários a entender quais formatos e tamanhos são permissíveis antes de iniciar grandes trabalhos de patch
Os usuários podem utilizar os dados retornados verificando o campo "status" para monitorar o progresso do trabalho e usando os "urls" da resposta Get Job Download URLs para acessar os artefatos gerados Isso permite uma integração eficiente nos fluxos de trabalho
Casos de uso típicos incluem gerar texturas não repetitivas para gráficos, criar malhas procedurais em motores de jogos e produzir arquivos STL para impressão 3D. Os usuários podem aproveitar a API para designs artísticos, visualização científica e fins educacionais
A precisão dos dados é mantida através do uso de algoritmos determinísticos para o revestimento e estrita adesão aos parâmetros de entrada O design da API garante que os padrões gerados sejam consistentes e confiáveis adequados para várias aplicações