非周期性瓦片创建 API API ID: 12630

通过非周期性瓷砖创建API生成独特的非重复瓷砖图案用于创意项目
通过 MCP 从您的 AI 代理使用此 API
支持 OpenClaw、Claude Code/Desktop、Cursor、Windsurf、Cline 以及任何兼容 MCP 的 AI 客户端。
文档和设置
通过封装此 MCP 创建技能: https://mcp.zylalabs.com/mcp?apikey=YOUR_ZYLA_API_KEY

关于API

非周期单嵌块生成器API是一个托管的REST服务,使用Spectre Tile 1,1(爱因斯坦单嵌块)进行无缝非周期单嵌块几何填充。它用非重复的铺砖填充区域,裁剪成遮罩形状,分配稳定的瓦片ID和标签,并输出生产就绪的工件。旨在为需要真正铺砖的开发者和人工智能代理提供支持,而无需在客户端运行替代深度、图集构建或分形迭代工具。支持计算机图形学、程序世界、Blender和游戏引擎、Adobe和CAD、3D打印、生成艺术、科学可视化、超材料、波动和声学布局、与密码学相关的格实验,以及需要确定性几何的数据管道。

该API接收什么以及您的API提供什么(输入/输出)

您发送包含遮罩和输出格式的JSON。遮罩包括圆形、矩形、正方形、三角形、正六边形和圆角矩形,自动在规范瓦片单位中心对齐。可选的缩放、旋转、种子、SVG描边和调色板选项、光栅维度和3D挤出深度。使用头部X-API-Key进行身份验证。工作流程为异步:创建一个补丁作业,轮询作业状态直到完成或失败,然后获取签名下载URLs。格式包括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的最常见用例是什么

反摩尔纹和非周期采样用于渲染和纹理。通过GLB在Unity、Godot和Three.js中生成程序网格和世界装饰。Blender插件和管道集成用于铺砖表面。通过SVG输出适用于Illustrator、Inkscape、激光或绘图工作流程的矢量。使用STL进行单面3D打印或使用STL ZIP和OBJ ZIP进行单独可打印瓦片的打印。生成雕塑和装饰设计。进行非周期铺砖的研究和教育。CSV、JSON和实例清单用于自定义导入程序、空间索引和机器学习数据集。代理应从png或jpg开始用户,用svg移至设计工具,用glb进行实时3D,用stl进行制造面板,当每个瓦片必须是一个独立对象时则使用stl_zip。

您的计划是否存在限制

免费层限于小型PNG和JPG预览。重型作业如大型GLB或压缩包导出被分类为小型、标准或重型并可能排队;响应中包含估计等待时间和队列位置,因此客户端应轮询而不是重新提交。签名下载URLs过期;用户必须保存他们关心的工件。不要询问最终用户的瓦片系列、遮罩中心、保留模式、补丁版本、替代深度或覆盖范围。针对AI代理的完整机器可读集成指导可在本列表配置的提供者文档网站上获得。

API 文档

端点


返回 JSON,其中状态为 ok 并包含时间戳,表明 API 进程处于活动状态。使用此方法验证 Zyla 是否能在测试补丁或作业端点之前访问后端


                                                                            
GET https://docs.zylalabs.com/api/12630/aperiodic+tile+creation+api/24447/health+check
                                                                            
                                                                        

剩余免费测试请求:3 / 3。

此端点不需要任何输入参数。


API 示例响应

{"status":"ok","ts":1779302690.671844}

健康检查 - 代码片段


curl --location --request GET 'https://zylalabs.com/api/12630/aperiodic+tile+creation+api/24447/health+check' --header 'Authorization: Bearer YOUR_API_KEY' 


    

返回与您的API密钥相关的实时支持的输出格式、掩码类型、层级限制、队列设置和图集摘要 在进行大型补丁作业之前调用此接口,以便代理知道允许什么格式和大小



                                                                            
GET https://docs.zylalabs.com/api/12630/aperiodic+tile+creation+api/24448/capabilities
                                                                            
                                                                        

剩余免费测试请求:3 / 3。

此端点不需要任何输入参数。


API 示例响应

{"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/12630/aperiodic+tile+creation+api/24448/capabilities' --header 'Authorization: Bearer YOUR_API_KEY' 


    

从 JSON 创建一个不周期性单块贴图,具有可调的边界形状、颜色调色板、比例、边缘样式、边 a/b 比率,支持的格式包括 SVG、GLB、STL 或 PNG

 

mask: 要拼贴的区域,以规范的 Tile(1,1) 单位表示,居中于原点。必须包含类型。支持的类型:正方形(半边长)、圆形(半径)、矩形(宽度,高度)、三角形(边长)、正六边形(外接圆半径)、圆角矩形(宽度,高度,角半径)。示例:{"type":"circle","radius":50}。

formats: 要生成的输出工件格式。允许的值:svg、png、jpg、jpeg、csv、json、stl、stl_zip、obj_zip、glb、instance_json。至少需要一种格式;省略该字段将使用默认列表。

scale: 放置后应用的全局相似缩放比例(必须 > 0)。用于在世界单位中调整整个贴图的大小。

side_style: 导出几何图形的边缘外观:平坦、弯曲、波浪状、锯齿状或块状。接受别名 curved 并映射到 curvy。影响 SVG、PNG/JPG、STL/OBJ ZIP 和 GLB。

side_style_amplitude: 样式边缘的突起强度(0.0–0.75)。当边缘样式为平坦时被忽略。更高的值产生更强的波浪或角落。

tile_edge_ratio: 仅用于导出的瓷砖轮廓的各向异性拉伸(0.25–4.0)。值为 1.0 以外的会拉长或压缩绘制的网格;放置保持规范的 Tile(1,1),而不是实际的 Tile(a,b) 替代。

palette_by_label: 每个瓷砖标签的颜色用于 SVG 和栅格。键是瓷砖标签(例如 Gamma、Delta)或 "*" 作为默认值。每个值可以包含填充、描边、不透明度和透明(布尔值)。示例:{"Gamma":{"fill":"#d94738"},"*":{"opacity":0.95}}。

stl_extrusion_mm: 用于 stl、stl_zip、obj_zip 和 glb 输出的挤出厚度(单位为毫米,必须 > 0)。如果未请求这些格式则无效。

svg_fill: 默认 SVG 填充颜色(例如 #cdd6ea)。

png_width_px: 当 png 为格式时的栅格大小;两个必须一起设置。

png_height_px: 当 png 为格式时的栅格大小;两个必须一起设置。



                                                                            
POST https://docs.zylalabs.com/api/12630/aperiodic+tile+creation+api/24449/create+patch+job
                                                                            
                                                                        

创建补丁作业 - 端点功能

对象 描述
请求体 [必需] Json

剩余免费测试请求:3 / 3。


输入参数


API 示例响应

{"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/12630/aperiodic+tile+creation+api/24449/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 参数:由创建补丁任务返回的任务 UUID



                                                                            
GET https://docs.zylalabs.com/api/12630/aperiodic+tile+creation+api/24450/get+job+download+urls
                                                                            
                                                                        

剩余免费测试请求:3 / 3。


API 示例响应

{"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/12630/aperiodic+tile+creation+api/24450/get+job+download+urls&job_id=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    

API 访问密钥和身份验证

注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 非周期性瓦片创建 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。
标头
标头 描述
授权 [必需] 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。

简单透明的定价

无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。

🚀 企业版

起价
$ 10,000/年


  • 自定义数量
  • 自定义速率限制
  • 专业客户支持
  • 实时 API 监控

客户喜爱的功能

  • ✔︎ 仅支付成功请求
  • ✔︎ 7 天免费试用
  • ✔︎ 多语言支持
  • ✔︎ 一个 API 密钥,所有 API。
  • ✔︎ 直观的仪表板
  • ✔︎ 全面的错误处理
  • ✔︎ 开发者友好的文档
  • ✔︎ Postman 集成
  • ✔︎ 安全的 HTTPS 连接
  • ✔︎ 可靠的正常运行时间

非周期性瓦片创建 API FAQs

每个端点返回JSON数据 健康检查端点确认API状态,而功能端点提供支持的格式、掩码类型和层级限制 创建补丁作业端点返回作业详细信息,包括作业ID和状态 获取作业下载URLs端点提供已完成作业的可下载URLs

关键信息包括`状态`,`作业ID`,`网址`,`预计秒数`和`队列`详情。例如,创建补丁作业的响应包括`作业ID`,`状态`和`大小类别`,而获取作业下载网址的响应则包括`生存时间秒数`和`可下载文件的网址`

参数包括 `mask`、`scale`、`rotation`、`seed`、`palette` 和 `raster dimensions` 用户可以通过指定这些参数来自定义请求,以控制生成图块图案的形状、大小和外观

响应数据以JSON格式组织,包含嵌套对象。例如,创建补丁作业的响应包括一个包含作业详情的顶层对象,而获取作业下载URL的响应则包含一个带有各个文件链接的`urls`对象

能力端点提供支持的输出格式、掩码类型、级别限制和队列设置的信息 这有助于用户理解他们的补丁作业允许哪些格式和大小 确保与他们的项目兼容

用户可以通过检查 `status` 字段来监控作业进度,使用 `job_id` 跟踪特定作业,并访问 `urls` 下载已完成的工件。这使得高效集成到工作流程和项目管道中

典型的用例包括为游戏开发生成纹理 为3D打印创建独特的图案 并为设计应用程序制作矢量图形 该API支持广泛的创意和技术项目 使其在各个行业中都具有多样性

数据准确性通过对API中使用的平铺算法进行严格的测试和验证来维持。API的设计确保生成的图案不重复并符合指定的参数,为用户提供可靠的输出

一般常见问题

Zyla API Hub 就像一个大型 API 商店,您可以在一个地方找到数千个 API。我们还为所有 API 提供专门支持和实时监控。注册后,您可以选择要使用的 API。请记住,每个 API 都需要自己的订阅。但如果您订阅多个 API,您将为所有这些 API 使用相同的密钥,使事情变得更简单。
价格以 USD(美元)、EUR(欧元)、CAD(加元)、AUD(澳元)和 GBP(英镑)列出。我们接受所有主要的借记卡和信用卡。我们的支付系统使用最新的安全技术,由 Stripe 提供支持,Stripe 是世界上最可靠的支付公司之一。如果您在使用卡片付款时遇到任何问题,请通过 [email protected]

此外,如果您已经以这些货币中的任何一种(USD、EUR、CAD、AUD、GBP)拥有有效订阅,该货币将保留用于后续订阅。只要您没有任何有效订阅,您可以随时更改货币。
定价页面上显示的本地货币基于您 IP 地址的国家/地区,仅供参考。实际价格以 USD(美元)为单位。当您付款时,即使您在我们的网站上看到以本地货币显示的等值金额,您的卡片对账单上也会以美元显示费用。这意味着您不能直接使用本地货币付款。
有时,银行可能会因其欺诈保护设置而拒绝收费。我们建议您首先联系您的银行,检查他们是否阻止了我们的收费。此外,您可以访问账单门户并更改关联的卡片以进行付款。如果这些方法不起作用并且您需要进一步帮助,请通过 [email protected]
价格由月度或年度订阅决定,具体取决于所选计划。
API 调用根据成功请求从您的计划中扣除。每个计划都包含您每月可以进行的特定数量的调用。只有成功的调用(由状态 200 响应指示)才会计入您的总数。这确保失败或不完整的请求不会影响您的月度配额。
Zyla API Hub 采用月度订阅系统。您的计费周期将从您购买付费计划的那一天开始,并在下个月的同一日期续订。因此,如果您想避免未来的费用,请提前取消订阅。
要升级您当前的订阅计划,只需转到 API 的定价页面并选择您要升级到的计划。升级将立即生效,让您立即享受新计划的功能。请注意,您之前计划中的任何剩余调用都不会转移到新计划,因此在升级时请注意这一点。您将被收取新计划的全部金额。
要检查您本月剩余多少 API 调用,请参考响应标头中的 "X-Zyla-API-Calls-Monthly-Remaining" 字段。例如,如果您的计划允许每月 1,000 个请求,而您已使用 100 个,则响应标头中的此字段将显示 900 个剩余调用。
要查看您的计划允许的最大 API 请求数,请检查 "X-Zyla-RateLimit-Limit" 响应标头。例如,如果您的计划包括每月 1,000 个请求,此标头将显示 1,000。
"X-Zyla-RateLimit-Reset" 标头显示您的速率限制重置之前的秒数。这告诉您何时您的请求计数将重新开始。例如,如果它显示 3,600,则意味着还有 3,600 秒直到限制重置。
是的,您可以随时通过访问您的账户并在账单页面上选择取消选项来取消您的计划。请注意,升级、降级和取消会立即生效。此外,取消后,您将不再有权访问该服务,即使您的配额中还有剩余调用。
为了让您有机会在没有任何承诺的情况下体验我们的 API,我们提供 7 天免费试用,允许您免费进行最多 50 次 API 调用。此试用只能使用一次,因此我们建议将其应用于您最感兴趣的 API。虽然我们的大多数 API 都提供免费试用,但有些可能不提供。试用在 7 天后或您进行了 50 次请求后结束,以先发生者为准。如果您在试用期间达到 50 次请求限制,您需要"开始您的付费计划"以继续发出请求。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。或者,如果您在第 7 天之前不取消订阅,您的免费试用将结束,您的计划将自动计费,授予您访问计划中指定的所有 API 调用的权限。请记住这一点以避免不必要的费用。
7 天后,您将被收取试用期间订阅的计划的全额费用。因此,在试用期结束前取消很重要。因忘记及时取消而提出的退款请求不被接受。
当您订阅 API 免费试用时,您可以进行最多 50 次 API 调用。如果您希望超出此限制进行额外的 API 调用,API 将提示您执行"开始您的付费计划"。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。
付款订单在每月 20 日至 30 日之间处理。如果您在 20 日之前提交请求,您的付款将在此时间范围内处理。
您可以通过我们的聊天渠道联系我们以获得即时帮助。我们始终在线,时间为上午 8 点至下午 5 点(EST)。如果您在该时间之后联系我们,我们将尽快回复您。此外,您可以通过 [email protected]

相关 API