{"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'
注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 可定制的非周期单瓷砖生成器 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。
| 标头 | 描述 |
|---|---|
授权
|
必需
应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。
|
无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。
(年度计费可节省 2 个月 🎉)
关于API
不规则单块生成器API是一个托管的REST服务,用于使用Spectre Tile 1,1(爱因斯坦单块)进行无缝不规则单块几何填充。它填充一个区域,使用非重复的铺砖方式,并剪切到一个掩码形状,分配稳定的砖块ID和标签,并导出生产就绪的工件。为需要真实铺砖而不在客户端运行替换深度、图集构建或分形迭代工具的开发者和人工智能代理而构建。支持计算机图形学、程序化世界、Blender和游戏引擎、Adobe和CAD、3D打印、生成艺术、科学可视化、超材料、波和声学布局、与密码学相关的晶格实验,以及需要确定性几何的数据管道。
该API接收什么以及您的API提供什么(输入/输出)
您发送包含掩码和输出格式的JSON。掩码包括圆形、矩形、正方形、三角形、规则六边形和圆角矩形,自动居中于标准砖块单位。可选的缩放、旋转、种子、SVG描边和调色板选项、光栅尺寸以及3D挤出深度。使用头部X-API-Key进行身份验证。工作流程是异步的:创建一个补丁作业,轮询作业状态直到完成或失败,然后获取签名的下载URL。格式包括png、jpg、jpeg、svg、csv、json、stl、glb、stl_zip、obj_zip和instance_json。GLB为每个砖块提供一个命名节点。STL ZIP和OBJ ZIP提供每个砖块的独立网格。免费密钥仅允许小光栅预览。付费的Solo和Commercial密钥解锁矢量、3D、压缩包和更大的作业。可选的Idempotency-Key头可以防止在重试时重复提交。在大作业之前调用功能端点以检查实时层限制、支持的掩码、格式和队列深度。
该API的最常见用例是什么
抗摩尔现象和非周期性采样用于渲染和纹理。在Unity、Godot和Three.js中通过GLB进行程序化网格和世界装饰。Blender插件和管道集成用于镶嵌表面。针对Illustrator、Inkscape及激光或绘图机工作流程的矢量输出,采用SVG格式。使用STL进行单板3D打印或使用STL ZIP和OBJ ZIP打印单独的瓷砖。生成雕塑和装饰设计。对不规则铺砖的研究和教育。用于自定义导入器、空间索引和机器学习数据集的CSV、JSON和实例清单。代理应当让用户从png或jpg开始,转向svg用于设计工具,glb用于实时3D,stl用于制造面板,并在每个砖块必须是单独对象时使用stl_zip。
您的计划是否有任何限制
免费层限于小型PNG和JPG预览。大型作业,如大型GLB或zip导出,分类为小型、标准或大型,可能会排队;响应包括估计的等待时间和队列位置,因此客户端应轮询而不是重新提交。签名下载URL会过期;用户必须保存他们关心的工件。不要向最终用户询问砖块系列、掩码中心、保留模式、补丁版本、替换深度或覆盖范围。针对人工智能代理的全机器可读集成指导可在本列表中配置的提供方文档网站上获得。
每个端点返回JSON数据 健康检查端点提供状态和时间戳 能力端点详细说明支持的格式 掩码类型和级别限制 创建补丁作业端点返回作业状态和预计等待时间 获取作业下载URLs端点提供下载生成的工件的URLs
关键字段包括“状态”、“job_id”、“预计秒数”和“urls”。例如,创建补丁作业响应包括“job_id”来跟踪作业,“状态”指示其当前状态,而获取作业下载链接响应包括“ttl_seconds”用于网址过期
参数包括遮罩形状(例如,圆形、矩形)、缩放、旋转、颜色调色板和光栅尺寸。用户可以通过在JSON有效载荷中指定这些参数来自定义请求,以调整生成的图案以满足他们的需求
响应数据以键值对的形式结构化。例如,创建补丁任务的响应包括“job_id”“status”和“queue”详细信息,允许用户轻松访问任务信息并跟踪其进度
能力端点提供支持的输出格式、遮罩类型、层级限制和队列设置的信息 这帮助用户在启动大型补丁作业之前了解哪些格式和大小是允许的
用户可以通过检查“状态”字段来监控作业进度,并使用获取作业下载 URL 响应中的“urls”来访问生成的工件。这允许有效地集成到工作流中
典型用例包括为图形生成不重复的纹理 在游戏引擎中创建程序化网格以及为3D打印生成STL文件 用户可以利用API进行艺术设计 科学可视化和教育目的
数据准确性通过使用确定性算法进行铺砖和严格遵循输入参数得以保持 API 的设计确保生成的图案一致可靠 适用于各种应用