Helio-Additive 的 GraphQL API 提供了灵活性和精确定义所需数据的能力。我们提供的 SDK 利用下面列出的 API,以便快速开始;对于我们不支持的语言,可以使用下面列出的 API 文档来创建您自己的方式与我们的服务交互。
GraphQL 请求只是作为 HTTP POST 发送的常规 JSON 请求,包含两个键:query 和 variables。查询是使用 GraphQL 语法定义操作和要发送/接收的变量的字符串,变量是包含要发送/接收的值的对象。下面的简单示例展示了如何使用 cURL 实现这一点。
curl -X POST https://api.helioadditive.com/graphql/sdk \
-H " Content-Type: application/json " \
-H " Authorization: Bearer HELIOADDITIVE_PAT " \
"query": "query Simulation($id: ID!) { simulation(id: $id) { name status } }",
查询类型定义了从服务器检索数据的 GraphQL 操作。
Retrieve a list of FAQ's.
faqs 的参数
名称 描述 page (Int )
The page number to retrieve pageSize (Int )
Page size (default: 20, max: 100)
Retrieve a list of Events.
events 的参数
名称 描述 page (Int )
Page number (1-based index) pageSize (Int )
Page size (default: 20, max: 100)
Retrieve a list of G-Codes.
gcodesV2 的参数
名称 描述 page (Int )
The page number to retrieve pageSize (Int )
Page size (default: 20, max: 100) sortBy (GcodeField )
Field to sort the results by sortDirection (SortDirection )
Direction to sort the results (ascending or descending). filters ([GcodeFilter!] )
List of filters to apply to the Gcode results
Retrieve details of a single G-Code by its ID.
gcodeV2 的参数
名称 描述 id (ID! )
ID of the Gcode to retrieve
{"description": "Retrieve a list of G-Codes.", "removedOn": "2026-06-01T00:00:00Z"}
gcodes 的参数
名称 描述 page (Int )
The page number to retrieve pageSize (Int )
Page size (default: 20, max: 100) sortBy (GcodeField )
Field to sort the results by sortDirection (SortDirection )
Direction to sort the results (ascending or descending). filters ([GcodeFilter!] )
List of filters to apply to the Gcode results
{"description": "Retrieve details of a single G-Code by its ID.", "removedOn": "2026-06-01T00:00:00Z"}
gcode 的参数
名称 描述 id (ID! )
ID of the Gcode to retrieve
Retrieve the current user's free trial claim if they have one.
Check if the current user is eligible to claim a free trial.
Retrieve the default values for system feature flags.
Fetch thermal history asset data.
thermalHistories 的参数
名称 描述 optimizationId (ID! )
(No description provided) layer (Int! )
(No description provided) isOptimized (Boolean! )
(No description provided)
Retrieve login history for the user.
Retrieve personal access tokens for the user.
Retrieve the default simulation parameters.
newsArticle 的参数
名称 描述 id (ID! )
(No description provided)
Retrieve a list of News articles.
newsArticles 的参数
名称 描述 page (Int )
Page number pageSize (Int )
Page size (default: 20, max: 100)
Feedback for a news article.
newsArticleFeedback 的参数
名称 描述 newsArticleId (ID! )
(No description provided)
Retrieve a list of simulations.
simulations 的参数
名称 描述 page (Int )
The page number to retrieve (1-based index). pageSize (Int )
Page size (default: 20, max: 100) sortBy (SimulationField )
Field to sort the results by. sortDirection (SortDirection )
Direction to sort the results (ascending or descending). filters ([SimulationFilter!] )
List of filters to apply to the Simulation results.
Retrieve a list of optimizations.
optimizations 的参数
名称 描述 page (Int )
The page number to retrieve (1-based index). pageSize (Int )
Page size (default: 20, max: 100) sortBy (SimulationField )
Field to sort the results by. sortDirection (SortDirection )
Direction to sort the results (ascending or descending). filters ([SimulationFilter!] )
List of filters to apply to the Optimization results.
Retrieve available print priority options for optimization requests.
printPriorityOptions 的参数
名称 描述 materialId (ID )
(No description provided)
Retrieve the default simulation parameters.
defaultSimulationSettings 的参数
名称 描述 gcodeId (ID! )
The unique identifier of the G-Code for which to get default simulation settings. roomTemperature (Float )
{"description": "Ambient room temperature.", "unit": "K", "min": 0} stabilizedTemperature (Float )
{"description": "Stabilized air temperature.", "unit": "K", "min": 0} constantPlatformTemperature (Float )
{"description": "Constant platform temperature.", "unit": "K", "min": 0}
Retrieve the default simulation parameters.
defaultOptimizationSettings 的参数
名称 描述 gcodeId (ID! )
The unique identifier of the G-Code for which to get default optimization settings.
Retrieve the default simulation parameters.
optimization 的参数
名称 描述 id (ID! )
The unique identifier of the Optimization to retrieve.
Retrieve the default simulation parameters.
simulation 的参数
名称 描述 id (ID! )
The unique identifier of the Simulation to retrieve.
Retrieve a summary of the platform.
Generate a presigned URL for uploading a file.
getPresignedUrl 的参数
名称 描述 fileName (String! )
(No description provided)
Retrieve a list of available subscriptions.
subscriptions 的参数
名称 描述 page (Int )
The page number to retrieve (1-based index). pageSize (Int )
Page size (default: 20, max: 100)
Retrieve a list of available subscriptions.
subscriptionAddOns 的参数
名称 描述 page (Int )
The page number to retrieve (1-based index). pageSize (Int )
Page size (default: 20, max: 100)
Retrieve transaction histories for the currently authenticated user.
transactionHistoriesForUser 的参数
名称 描述 page (Int )
The page number to retrieve (1-based index). pageSize (Int )
Page size (default: 20, max: 100)
Retrieve the currently authenticated user.
material 的参数
名称 描述 id (ID! )
(No description provided)
printers 的参数
名称 描述 page (Int )
(No description provided) pageSize (Int )
(No description provided) sortBy (PrinterField )
(No description provided) sortDirection (SortDirection )
(No description provided) filters ([PrinterFilter!] )
(No description provided)
printer 的参数
名称 描述 id (ID! )
(No description provided)
变更类型定义了在服务器上更改数据的 GraphQL 操作。
Create a new G-Code.
createGcodeV2 的参数
名称 描述 input (CreateGcodeInputV2! )
Input object containing all fields required to create a new G-Code.
Create a new G-Code with multi-material support.
createGcodeV3 的参数
名称 描述 input (CreateGcodeInputV3! )
Input object containing all fields required to create a new G-Code with multi-material support.
Delete an existing G-Code by its ID.
deleteGcode 的参数
名称 描述 id (ID! )
(No description provided)
Delete an existing Optimization by its ID.
deleteOptimization 的参数
名称 描述 id (ID! )
(No description provided)
Claim a one-time 14-day free trial with unlimited optimizations.
Update an existing G-Code.
updateGcodeV2 的参数
名称 描述 id (ID! )
The unique identifier of the G-Code to update. input (UpdateGcodeInputV2! )
Input object containing fields to update for the specified G-Code.
Create a comment on a news article.
createNewsArticleComment 的参数
名称 描述 newsArticleId (ID! )
(No description provided) commentMarkdown (String! )
(No description provided)
{"description": "Create a new simulation based on a G-Code.", "removedOn": "2026-06-01T00:00:00Z"}
Create a new simulation based on a G-Code (V2 - with temperature export controls).
Create a Paddle portal session for managing subscriptions.
Create a new personal access token.
createPersonalAccessToken 的参数
名称 描述 name (String! )
(No description provided) expirationDaysDelta (Int! )
(No description provided)
{"description": "Create a new optimization based on a G-code.", "removedOn": "2026-06-01T00:00:00Z"}
Create a new optimization based on a G-code (V2 - with temperature export controls).
Create a new suggestion for the L-FAM platform.
Redeem a free trial code for the platform.
Send an OTP to the user's email address.
sendOtp 的参数
名称 描述 email (String! )
(No description provided) proceed (Boolean! )
(No description provided)
Stop a running simulation.
stopSimulation 的参数
名称 描述 id (ID! )
(No description provided)
Stop a running optimization.
stopOptimization 的参数
名称 描述 id (ID! )
(No description provided)
Verify the OTP sent to the user's email address.
verifyOtp 的参数
名称 描述 email (String! )
(No description provided) otpCode (String! )
(No description provided)
Update feedback for a news article.
updateNewsArticleFeedback 的参数
Add feedback for a simulation.
addSimulationFeedback 的参数
Add feedback for an optimization.
addOptimizationFeedback 的参数
Update the authenticated user's feature flag settings.
Update the authenticated user's feature flag settings.
Update the authenticated user's feature flag settings (V2 with support interface optimization).
订阅对于实时通知客户端后端数据的更改非常有用,例如创建新对象或更新重要字段。
Represents a news articles comments.
Author 的字段
名称 描述 id (ID! )
name (String! )
Name of the author. position (String! )
Position or title of the author. avatarUrl (String )
URL of the author's avatar image. insertedAt (DateTime! )
Timestamp when the comment was created. updatedAt (DateTime! )
Timestamp when the comment was last updated.
A caveat.
Caveat 的字段
名称 描述 caveatType (CaveatType! )
Caveat Type description (String! )
Description of the caveat
Response object for creating a personal access token.
CreatePatTokenResponse 的字段
An event entry with details such as date, location, and status.
Event 的字段
名称 描述 id (ID! )
Unique identifier for the event. name (String! )
Name of the event. location (String! )
Location where the event takes place. startDate (DateTime! )
Start date and time of the event. endDate (DateTime! )
End date and time of the event. link (String )
Optional URL link with more details or registration for the event. isUpcoming (Boolean! )
Indicates if the event is upcoming based on current date. insertedAt (DateTime! )
Timestamp when the event was created. updatedAt (DateTime! )
Timestamp of the last update to the event.
Frequently Asked Question entry with localized question and answer content.
Faq 的字段
名称 描述 id (ID! )
Unique identifier for the FAQ entry. question (String )
Localized question text shown to users. answer (String )
Localized answer text shown to users. category (FaqCategory )
Category the FAQ belongs to, such as General or Technical. insertedAt (DateTime! )
Timestamp of when the FAQ was created. updatedAt (DateTime! )
Timestamp of the last update to the FAQ.
Default values for system-wide feature flags.
FeatureFlagDefaults 的字段
名称 描述 enableBridgeSpeedSmoothing (Boolean! )
Smooths speed transitions over bridges for improved print quality. enableOptimizeAboveBridge (Boolean! )
Optimizes toolpath strategy for layers printed above bridge structures. enableFanSpeedOptimization (Boolean! )
Enable optimizing fan-speeds. enableAlwaysUseDragonGpu (Boolean! )
Forces all simulations to use Dragon GPU acceleration (experimental). enableApplyOptimumNozzleTemp (Boolean! )
Apply Helio's optimum nozzle temperature recommendations during optimization. enableFanSpeedRampUp (Boolean! )
Enable fan speed ramp-up feature flag. enableKeepVerticalSupportInterface (Boolean! )
Keep vertical support interface settings from original G-code.
Details of a user's 14-day free trial.
FreeTrialClaim 的字段
名称 描述 id (ID! )
Unique identifier for the trial claim. claimedEmail (String! )
Email used to claim the trial. claimedAt (DateTime! )
When the trial was claimed. endsAt (DateTime! )
When the trial period ends. cooldownUntil (DateTime )
When the cooldown period ends. source (String! )
Source of the trial claim (STORE, DASHBOARD). convertedToPaid (Boolean! )
Whether the user converted to a paid subscription. convertedAt (DateTime )
When the user converted to paid. isActive (Boolean! )
Whether the trial is currently active. user (User )
User who claimed the trial. insertedAt (DateTime! )
Timestamp when the trial was created. updatedAt (DateTime! )
Timestamp when the trial was last updated.
Details of free trial codes.
FreeTrialCode 的字段
名称 描述 id (ID! )
Unique identifier for the code. code (String! )
The free trial code itself. isUsed (Boolean! )
Indicates whether the free trial code has been used. group (FreeTrialCodeGroup! )
The group this code belongs to. user (User )
User who redeemed the code, if any. insertedAt (DateTime! )
Timestamp when the free trial code was created. updatedAt (DateTime! )
Timestamp when the free trial code was last updated.
Details of free trial code groups.
FreeTrialCodeGroup 的字段
名称 描述 id (ID! )
Unique identifier for the code group. subscription (HelioSubscription! )
ID of the associated subscription. company (String! )
Company associated with the code group. name (String! )
Name of the code group. expirationDate (DateTime! )
Expiration date of the code group. quantityOfCodes (Int! )
Number of codes in the group. isExpired (Boolean! )
Whether the code group is expired. insertedAt (DateTime! )
Timestamp when the code group was created. updatedAt (DateTime! )
Timestamp when the code group was last updated.
{"description": "Represents parsed data and metadata extracted from a G-code file. Use GcodeV2 instead.", "removedOn": "2026-06-01T00:00:00Z"}
Gcode 的字段
名称 描述 id (ID! )
Unique identifier for the G-code file. name (String! )
Original name of the G-code file. sizeKb (Float! )
Size of the G-code file (Unit: Kilobytes $KB$) height (Float! )
Maximum height reached during the print (Unit: Meters $m$) width (Float! )
Maximum width of the print area (Unit: Meters $m$) depth (Float! )
Maximum depth of the print area (Unit: Meters $m$) platformTemperature (GcodeCustomFloat )
Platform (bed) temperature used during the print. May be overridden or missing (Unit: Kelvin $K$) nozzleTemperatureMin (GcodeCustomFloat! )
Minimum nozzle temperature detected in the G-code (Unit: Kelvin $K$) nozzleTemperatureMax (GcodeCustomFloat! )
Maximum nozzle temperature detected in the G-code (Unit: Kelvin $K$) gcodeUrl (String! )
URL to the G-code file in storage, if available. May be null if not stored. gcodeKey (String )
Key used to access the G-code file in storage. This is not a URL but a unique identifier. roadWidthMin (GcodeCustomFloat! )
Minimum road width specified in the G-code (Unit: Meters $m$) roadWidthMax (GcodeCustomFloat! )
Maximum road width specified in the G-code (Unit: Meters $m$) layerHeightMin (GcodeCustomFloat! )
Minimum layer height specified in the G-code (Unit: Meters $m$) layerHeightMax (GcodeCustomFloat! )
Maximum layer height specified in the G-code (Unit: Meters $m$) speedMin (GcodeCustomFloat! )
Minimum print speed specified in the G-code (Unit: Meters per second $m/s$) speedMax (GcodeCustomFloat! )
Maximum print speed specified in the G-code (Unit: Meters per second $m/s$) fanSpeedMin (GcodeCustomFloat! )
Minimum fan speed used in the G-code as a percentage fanSpeedMax (GcodeCustomFloat! )
Maximum fan speed used in the G-code as a percentage numberOfLayers (Int! )
Total number of layers found in the G-code. slicer (Slicer! )
Slicer software identified from the G-code metadata. flowRatio (Float )
Optional flow ratio specified in the G-code, if available. overrideGcodeParams (OverrideGcodeParams )
Overrides applied to G-code parameters, if any. isSingleShell (Boolean! )
Indicates whether the print is a single-shell structure. maxFlowRate (Float )
Maximum flow rate specified in the G-code, if available (Unit: Meters cubed per second $\frac{m^3}{s}$) layerHeightMode (Float )
Most frequently used layer height in the G-code, if available. (Unit: Meters $m$) lineWidthMode (Float )
Most frequently used line width in the G-code, if available. (Unit: Meters $m$) restrictions ([GcodeRestriction!]! )
List of restrictions generated during G-code parsing. errors ([GcodeError!]! )
List of errors encountered during G-code parsing, if any. printerId (ID! )
ID of the printer associated with this G-code. materialId (ID! )
ID of the material used in this G-code. insertedAt (DateTime! )
Timestamp when the G-code was first processed or uploaded. updatedAt (DateTime! )
Timestamp of the last update to this G-code record.
Represents a float value from a G-code with its override and state metadata.
GcodeCustomFloat 的字段
名称 描述 floatType (FloatType! )
Indicates the nature of the value: regular float, NaN, positive/negative infinity, etc. isOverriden (Boolean! )
True if the value was manually overridden by the user or system. value (Float )
The actual numeric value if valid; otherwise, null for NaN or infinite values.
GcodeErrorV2 的字段
名称 描述 type (GcodeError! )
The type of error that occurred. errorCode (GcodeErrorCode! )
The error code for this error. line (Int )
The line number where the error occurred, if available. received (String )
The actual content that was received and caused the error, if available. expected (String )
An example of the expected format or value, if available.
Metadata for a single material entry associated with a G-code. Includes the material ID used for microservice lookups, an optional display name, and the printer slot/nozzle indices.
GcodeMaterialInfo 的字段
名称 描述 materialId (ID! )
Material ID used for microservice lookups. name (String )
Optional display name for the material. slotIndex (Int! )
Printer slot index for this material. nozzleIndex (Int! )
Printer nozzle index for this material. material (Material! )
The full material resolved from materialId.
GcodeRestrictionInfo 的字段
名称 描述 restriction (GcodeRestriction! )
The type of restriction description (String! )
Description of the restriction, including a link to the policy
Represents parsed data and metadata extracted from a G-code file.
GcodeV2 的字段
名称 描述 id (ID! )
Unique identifier for the G-code file. name (String! )
Original name of the G-code file. sizeKb (Float )
Size of the G-code file in kilobytes. height (Float )
{"description": "Maximum height reached during the print.", "unit": "m"} width (Float )
{"description": "Maximum width of the print area.", "unit": "m"} depth (Float )
{"description": "Maximum depth of the print area.", "unit": "m"} weight (Float )
{"description": "Weight of the print.", "unit": "kg"} status (GcodeStatus! )
Status of the G-code file. progress (Float! )
Progress of the G-code file parsing. platformTemperature (GcodeCustomFloat )
{"description": "Platform (bed) temperature used during the print. May be overridden or missing.", "unit": "K"} nozzleTemperatureMin (GcodeCustomFloat )
{"description": "Minimum nozzle temperature detected in the G-code.", "unit": "K"} nozzleTemperatureMax (GcodeCustomFloat )
{"description": "Maximum nozzle temperature detected in the G-code.", "unit": "K"} gcodeUrl (String! )
URL to the G-code file in storage, if available. May be null if not stored. gcodeKey (String )
Key used to access the G-code file in storage. This is not a URL but a unique identifier. roadWidthMin (GcodeCustomFloat )
{"description": "Minimum road width specified in the G-code.", "unit": "m"} roadWidthMax (GcodeCustomFloat )
{"description": "Maximum road width specified in the G-code.", "unit": "m"} layerHeightMin (GcodeCustomFloat )
{"description": "Minimum layer height specified in the G-code.", "unit": "m"} layerHeightMax (GcodeCustomFloat )
{"description": "Maximum layer height specified in the G-code.", "unit": "m"} speedMin (GcodeCustomFloat )
{"description": "Minimum print speed specified in the G-code.", "unit": "m/s"} speedMax (GcodeCustomFloat )
{"description": "Maximum print speed specified in the G-code.", "unit": "m/s"} fanSpeedMin (GcodeCustomFloat )
{"description": "Minimum fan speed used in the G-code.", "unit": "%", "min": 0, "max": 100} fanSpeedMax (GcodeCustomFloat )
{"description": "Maximum fan speed used in the G-code.", "unit": "%", "min": 0, "max": 100} numberOfLayers (Int )
Total number of layers found in the G-code. slicer (Slicer )
Slicer software identified from the G-code metadata. flowRatio (Float )
Optional flow ratio specified in the G-code, if available. overrideGcodeParams (OverrideGcodeParams )
Overrides applied to G-code parameters, if any. isSingleShell (Boolean! )
Indicates whether the print is a single-shell structure. maxFlowRate (Float )
{"description": "Maximum flow rate specified in the G-code, if available.", "unit": "\\frac{m^3}{s}"} layerHeightMode (Float )
{"description": "Most frequently used layer height in the G-code, if available.", "unit": "m"} lineWidthMode (Float )
{"description": "Most frequently used line width in the G-code, if available.", "unit": "m"} restrictions ([GcodeRestriction!]! )
List of restrictions generated during G-code parsing. restrictionsV2 ([GcodeRestrictionInfo!]! )
List of restrictions generated during G-code parsing. errors ([GcodeError!]! )
Deprecated: This field uses the legacy GcodeError enum which will not receive new error types. Use errorsV2 instead. errorsV2 ([GcodeErrorV2!]! )
List of errors with line numbers encountered during G-code parsing, if any. materialId (ID! )
Material ID associated with the G-code. printerId (ID! )
Printer ID associated with the G-code. insertedAt (DateTime! )
Timestamp when the G-code was first processed or uploaded. updatedAt (DateTime! )
Timestamp of the last update to this G-code record. material (Material! )
printer (Printer! )
G-code representation with multi-material support. Extends GcodeV2 with a materials list that describes each material entry and its associated slot/nozzle metadata.
GcodeV3 的字段
名称 描述 id (ID! )
Unique identifier for the G-code file. name (String! )
Original name of the G-code file. sizeKb (Float )
Size of the G-code file in kilobytes. height (Float )
Maximum height reached during the print (Unit: Meters $m$) width (Float )
Maximum width of the print area (Unit: Meters $m$) depth (Float )
Maximum depth of the print area (Unit: Meters $m$) weight (Float )
Weight of the print (Unit: Kilograms $kg$) status (GcodeStatus! )
Status of the G-code file. progress (Float! )
Progress of the G-code file parsing. platformTemperature (GcodeCustomFloat )
Platform (bed) temperature used during the print. May be overridden or missing. (Unit: Kelvin $K$) nozzleTemperatureMin (GcodeCustomFloat )
Minimum nozzle temperature detected in the G-code. (Unit: Kelvin $K$) nozzleTemperatureMax (GcodeCustomFloat )
Maximum nozzle temperature detected in the G-code. (Unit: Kelvin $K$) gcodeUrl (String! )
URL to the G-code file in storage, if available. May be null if not stored. gcodeKey (String )
Key used to access the G-code file in storage. This is not a URL but a unique identifier. roadWidthMin (GcodeCustomFloat )
Minimum road width specified in the G-code. (Unit: Meters $m$) roadWidthMax (GcodeCustomFloat )
Maximum road width specified in the G-code. (Unit: Meters $m$) layerHeightMin (GcodeCustomFloat )
Minimum layer height specified in the G-code. (Unit: Meters $m$) layerHeightMax (GcodeCustomFloat )
Maximum layer height specified in the G-code. (Unit: Meters $m$) speedMin (GcodeCustomFloat )
Minimum print speed specified in the G-code. (Unit: Meters per second $m/s$) speedMax (GcodeCustomFloat )
Maximum print speed specified in the G-code. (Unit: Meters per second $m/s$) fanSpeedMin (GcodeCustomFloat )
Minimum fan speed used in the G-code as a percentage fanSpeedMax (GcodeCustomFloat )
Maximum fan speed used in the G-code as a percentage numberOfLayers (Int )
Total number of layers found in the G-code. slicer (Slicer )
Slicer software identified from the G-code metadata. flowRatio (Float )
Optional flow ratio specified in the G-code, if available. overrideGcodeParams (OverrideGcodeParams )
Overrides applied to G-code parameters, if any. isSingleShell (Boolean! )
Indicates whether the print is a single-shell structure. maxFlowRate (Float )
Maximum flow rate specified in the G-code, if available. (Unit: Meters cubed per second $\frac{m^3}{s}$) layerHeightMode (Float )
Most frequently used layer height in the G-code, if available. (Unit: Meters $m$) lineWidthMode (Float )
Most frequently used line width in the G-code, if available. (Unit: Meters $m$) restrictions ([GcodeRestriction!]! )
List of restrictions generated during G-code parsing. restrictionsV2 ([GcodeRestrictionInfo!]! )
List of restrictions generated during G-code parsing. errors ([GcodeError!]! )
Deprecated: This field uses the legacy GcodeError enum which will not receive new error types. Use errorsV2 instead. errorsV2 ([GcodeErrorV2!]! )
List of errors with line numbers encountered during G-code parsing, if any. materialId (ID! )
Primary material ID associated with the G-code (first material for multi-material G-codes). printerId (ID! )
Printer ID associated with the G-code. insertedAt (DateTime! )
Timestamp when the G-code was first processed or uploaded. updatedAt (DateTime! )
Timestamp of the last update to this G-code record. materials ([GcodeMaterialInfo!]! )
List of materials used by this G-code with slot and nozzle metadata. For legacy G-codes created before V3, this contains a single entry derived from the primary material ID. material (Material! )
The primary material for this G-code (resolved from materialId). For multi-material G-codes this is the first material in the materials list.
Details of subscriptions.
HelioSubscription 的字段
名称 描述 id (ID! )
Unique identifier for the user. name (String! )
Name of the subscription plan. description (String )
Description of the subscription plan. optsPerMonth (Int! )
Number of optimization runs allowed per month under this subscription. membershipDuration (Int )
Duration of the subscription in months. paddlePriceId (String )
Paddle price ID for the subscription. price (String )
Price of the subscription plan, if applicable. features ([String!]! )
List of features included in the subscription plan. disclaimers ([String!]! )
List of disclaimers or conditions associated with the subscription plan. button (String )
Button text for the subscription plan. category (String )
Category of the subscription plan. insertedAt (DateTime! )
Timestamp when the subscription was created. updatedAt (DateTime! )
Timestamp when the subscription was last updated.
LayerRange 的字段
名称 描述 fromLayer (Int! )
The starting layer number for the specified range (inclusive). toLayer (Int! )
The ending layer number for the specified range (inclusive).
Represents a user's login record.
Login 的字段
名称 描述 id (ID! )
Unique identifier of the login record. loginType (LoginType! )
Type of login method used (e.g. username/password or Auth0). upUsername (String )
Username used for traditional login, if applicable. upPassword (String )
Password hash used for traditional login, if applicable. auth0UserId (String )
Auth0 user ID if the user logged in via Auth0. auth0Email (String )
Email associated with the Auth0 login, if applicable. auth0EmailVerified (Boolean )
Indicates if the Auth0 email has been verified.
Represents a news article.
NewsArticle 的字段
名称 描述 id (ID! )
Unique identifier for the news article. title (String! )
The headline or title of the news article. summary (String! )
A short summary or teaser of the article's content. markdown (String! )
The full article content written in Markdown format. coverUrl (String )
Optional URL to the article's cover image. status (NewsArticleStatus! )
The current publication status of the article. tags ([NewsArticleTag!]! )
List of tags categorizing the article. comments ([NewsArticleComment!]! )
List of comments made on the article. nLikes (Int! )
Number of likes the article has received. nComments (Int! )
Number of comments on the article. author (Author! )
The author of the article, if available. insertedAt (DateTime! )
Timestamp when the article was created. updatedAt (DateTime! )
Timestamp of the last article update.
Represents a news articles comments.
NewsArticleComment 的字段
名称 描述 id (ID! )
user (User )
User associated with this login record. commentMarkdown (String! )
Markdown content of the comment. insertedAt (DateTime! )
Timestamp when the comment was created. updatedAt (DateTime! )
Timestamp when the comment was last updated.
Represents feedback for news articles.
NewsArticleFeedback 的字段
名称 描述 id (ID! )
user (User )
User associated with this login record. isLike (Boolean! )
Indicates if the feedback is a like (True) or dislike (False). isNotImportant (Boolean! )
Indicates if the feedback is marked as not important. isNiceToHave (Boolean! )
Indicates if the feedback is marked as nice to have. isImportant (Boolean! )
Indicates if the feedback is marked as important. isCritical (Boolean! )
Indicates if the feedback is marked as critical. insertedAt (DateTime! )
Timestamp when the comment was created. updatedAt (DateTime! )
Timestamp when the comment was last updated.
Represents an optimization simulation with detailed configuration and results.
Optimization 的字段
名称 描述 id (ID! )
Unique identifier for the optimization simulation. spec (Int! )
Specification version or type used in the simulation. name (String! )
Name of the optimization simulation. index (Int! )
Index or sequence number of the simulation. isOptimization (Boolean! )
Indicates if this is an optimization simulation. progress (Float! )
Progress percentage of the simulation (between 0 and 100) status (SimulationStatus! )
Current status or state of the simulation. originalPreviewImageUrl (String )
URL for the original simulation preview image. optimizedPreviewImageUrl (String )
URL for the optimized simulation preview image. originalReportJsonUrl (String )
Presigned URL for the original simulation report. optimizedReportJsonUrl (String )
Presigned URL for the optimized simulation report. optimizedGcodeUrl (String )
Presigned URL for the optimized G-code. optimizedGcodeWithThermalIndexesUrl (String )
Presigned URL for the optimized G-code annotated with thermal indexes. extrusionPathsAsset (SimulationAsset )
Parquet asset with extrusion path data. originalMeshAsset (SimulationAsset )
Parquet asset of the original public mesh. contactsAsset (SimulationAsset )
Parquet asset with contact data. originalCoordinateAsset (SimulationAsset )
Parquet asset with original coordinates. optimizedMeshAsset (SimulationAsset )
Parquet asset of the optimized public mesh. simulationSettings (SimulationSettings! )
Settings used for the simulation, including overrides for temperatures and fan speeds. optimizationSettings (OptimizationSettings! )
Settings specific to the optimization run, including variable overrides and constraints. optimizationReductionStrategySettings (OptimizationReductionStrategySettings! )
Settings for the reduction strategy used in the optimization run. optimizationResidualStrategySettings (OptimizationResidualStrategySettings! )
Settings for the residual strategy used in the optimization run. featureFlagsUsed (OptimizationFeatureFlags! )
Feature flags that were enabled for this optimization run. gcode (GcodeV2! )
G-code file associated with the optimization run. optimizedThermalIndexStatistics (OptimizedThermalIndexStatistics! )
Statistics related to thermal indices in the optimization run. originalThermalIndexStatistics (ThermalIndexStatistics! )
Statistics related to thermal indices in the original run. optimizeOuterwall (Boolean! )
Whether to optimize the outer wall of the print. printPriority (PrintPriority )
Print priority selection for this optimization. enhanceSurfaceGloss (Boolean! )
Whether to enhance surface gloss for silk/glossy materials. qualityMeanDelta (Float )
Absolute delta in mean quality between the original and optimized runs. qualityMeanDeltaPcnt (Float )
Percentage delta in mean quality between the original and optimized runs. qualityStdDelta (Float )
Absolute delta in standard deviation of quality between the original and optimized runs. qualityStdDeltaPcnt (Float )
Percentage delta in standard deviation of quality between the original and optimized runs. qualityMeanImprovement (OptimizationImprovement )
Improvement category based on absolute delta in mean quality. qualityStdImprovement (OptimizationImprovement )
Improvement category based on absolute delta in standard deviation of quality. originalPrintInfo (PrintInfo )
Information relating to the original print. optimizedPrintInfo (PrintInfo )
Information relating to the optimized print. speedFactor (Float )
How much we can improve the flow rate set materialId (ID! )
Material ID associated with the G-code. printerId (ID! )
Printer ID associated with the G-code. insertedAt (DateTime! )
Timestamp when the simulation was created. updatedAt (DateTime! )
Timestamp when the simulation was last updated. material (Material! )
printer (Printer! )
Feature flags that were enabled for this optimization.
OptimizationFeatureFlags 的字段
名称 描述 useBridgeSpeedSmoothing (Boolean! )
Smooths speed transitions over bridges for improved print quality. useOptimizeAboveBridge (Boolean! )
Optimizes toolpath strategy for layers printed above bridge structures. useFanSpeedOptimization (Boolean! )
Enable optimizing fan-speeds. useGpu (Boolean! )
Forces all optimizations to use Dragon GPU acceleration (experimental). onlyExportCoreAssets (Boolean! )
Exports only core assets for the optimization. applyOptimumNozzleTemp (Boolean! )
Includes Helio's recommended optimum nozzle temperature in the optimization process. fanSpeedRampUp (Boolean! )
Enable fan speed ramp-up during optimization. keepVerticalSupportInterface (Boolean! )
Keep vertical support interface settings from original G-code.
OptimizationFeedback 的字段
名称 描述 id (ID! )
ID of the feedback optimizationId (ID! )
ID of the optimization rating (Float! )
Rating of the optimization comment (String )
Comments about the optimization
OptimizationReductionStrategySettings 的字段
名称 描述 optimizationReductionStrategy (OptimizationReductionStrategy )
Reduction strategy used in the optimization run. optimizationReductionAutolinearDoCriticality (Boolean )
Whether to apply autolinear criticality reduction. optimizationReductionAutolinearDoFitness (Boolean )
Whether to apply autolinear fitness-based reduction. optimizationReductionAutolinearDoInterpolation (Boolean )
Whether to apply interpolation in autolinear reduction. optimizationReductionAutolinearCriticalityMaxNodesDensity (Float )
Max node density for autolinear criticality. optimizationReductionAutolinearCriticalityThreshold (Float )
Threshold value for autolinear criticality. optimizationReductionAutolinearFitnessMaxNodesDensity (Float )
Max node density for autolinear fitness. optimizationReductionAutolinearFitnessThreshold (Float )
Threshold value for autolinear fitness. optimizationReductionAutolinearInterpolationLevels (Int )
Number of interpolation levels in autolinear reduction. optimizationReductionLinearNodesLimit (Int )
Limit on number of nodes in linear reduction strategy.
OptimizationResidualStrategySettings 的字段
名称 描述 optimizationResidualStrategy (OptimizationResidualStrategy )
Residual Strategy used in the optimization run. optimizationResidualExponentialPenaltyLow (Float )
Low value of exponential penalty applied to residuals. optimizationResidualExponentialPenaltyHigh (Float )
High value of exponential penalty applied to residuals.
OptimizationSettings 的字段
名称 描述 minVelocity (Float! )
{"description": "Minimum velocity used during optimization.", "unit": "m/s", "min": 0} maxVelocity (Float! )
{"description": "Maximum velocity allowed during optimization.", "unit": "m/s", "min": 0} minVelocityIncrement (Float! )
{"description": "Minimum velocity increment allowed.", "unit": "m/s", "min": 0} minExtruderFlowRate (Float! )
{"description": "Minimum extruder flow rate during optimization.", "unit": "\\frac{m^3}{s}", "min": 0} maxExtruderFlowRate (Float! )
{"description": "Maximum extruder flow rate during optimization.", "unit": "\\frac{m^3}{s}", "min": 0} tolerance (Float! )
Tolerance value for convergence in optimization. maxIterations (Int! )
Maximum number of iterations in the optimization run. nNodes (Int! )
Number of nodes used in the optimization process. reductionStrategySettings (ReductionStrategySettings! )
Configuration settings for the reduction strategy used during optimization. residualStrategySettings (ResidualStrategySettings! )
Configuration settings for the residual strategy used during optimization. layersToOptimize ([LayerRange!]! )
List of layer ranges to include in the optimization process. optimizer (Optimizer! )
Selected optimization algorithm to use during the simulation process. optimizeOuterwall (Boolean! )
Whether to optimize the outer wall of the print.
OptimizedThermalIndexStatistics 的字段
名称 描述 optimizedThermalIndexCount (Int )
Number of thermal index data points in the optimized simulation. optimizedThermalIndexMean (Float )
Mean value of the optimized thermal index. optimizedThermalIndexStd (Float )
Standard deviation of the optimized thermal index. optimizedThermalIndexMin (Float )
Minimum value of the optimized thermal index. optimizedThermalIndex25 (Float )
25th percentile of the optimized thermal index. optimizedThermalIndex50 (Float )
50th percentile (median) of the optimized thermal index. optimizedThermalIndex75 (Float )
75th percentile of the optimized thermal index. optimizedThermalIndexMax (Float )
Maximum value of the optimized thermal index.
Override values for key G-code parameters used during simulation or optimization.
OverrideGcodeParams 的字段
名称 描述 overrideConstantNozzleTemperature (Float )
{"description": "Constant nozzle temperature override.", "unit": "K", "min": 323} overrideConstantLayerHeight (Float )
{"description": "Constant layer height override.", "unit": "m"} overrideConstantRoadWidth (Float )
{"description": "Constant road width override.", "unit": "m"} overrideConstantPlatformTemperature (Float )
{"description": "Constant platform temperature override.", "unit": "K", "min": 0}
PaddlePortalSessionResponse 的字段
Metadata about the pagination state.
PageInfo 的字段
名称 描述 hasPreviousPage (Boolean! )
Indicates if there is a previous page. hasNextPage (Boolean! )
Indicates if there is a next page.
Paginated list of objects
PaginatedResponse 的字段
Represents a personal access token for user authentication.
PersonalAccessToken 的字段
名称 描述 name (String! )
Name or identifier for the personal access token. expiresOn (DateTime! )
Expiration date and time of the personal access token.
Contains information for uploading a file using a presigned URL.
PresignedUrl 的字段
名称 描述 mimeType (String! )
MIME type of the file associated with the presigned URL. url (String! )
Presigned URL allowing for direct uploads. key (String! )
Key or identifier associated with the file in storage.
Information relating to the print.
PrintInfo 的字段
名称 描述 printOutcome (PrintOutcome! )
Outcome of the print. printOutcomeDescription (String! )
Localized outcome of the print. temperatureDirection (TemperatureDirection! )
Temperature direction associated with the print. temperatureDirectionDescription (String! )
Localized temperature direction associated with the print. caveats ([Caveat!]! )
Caveats associated with the print.
A print priority option for dropdown selection.
PrintPriorityOption 的字段
名称 描述 value (PrintPriority! )
The enum value to send in mutations label (String! )
Human-readable label for the option description (String! )
Detailed description of what this priority does isAvailable (Boolean! )
Whether this option is available for the queried material. False means it should be disabled/greyed out in the UI.
ReductionStrategySettings 的字段
名称 描述 strategy (OptimizationReductionStrategy! )
The strategy used to reduce the number of nodes in the optimization process. autolinearDoCriticality (Boolean! )
Enable automatic linear reduction based on thermal criticality. autolinearDoFitness (Boolean! )
Enable automatic linear reduction based on fitness values. autolinearDoInterpolation (Boolean! )
Enable interpolation during automatic linear reduction. autolinearCriticalityMaxNodesDensity (Float! )
Maximum nodes density for criticality-based auto-linear reduction. autolinearCriticalityThreshold (Float! )
Thermal index threshold for triggering criticality-based reduction. autolinearFitnessMaxNodesDensity (Float! )
Maximum nodes density for fitness-based auto-linear reduction. autolinearFitnessThreshold (Float! )
Fitness threshold for triggering fitness-based reduction. autolinearInterpolationLevels (Int! )
Number of interpolation levels to apply in auto-linear strategy. linearNodesLimit (Int! )
Maximum number of nodes allowed for the linear reduction strategy.
ResidualStrategySettings 的字段
名称 描述 strategy (OptimizationResidualStrategy! )
The residual strategy used for optimization, such as linear or exponential. exponentialPenaltyHigh (Float! )
Penalty applied to residuals above the target range when using exponential strategy. exponentialPenaltyLow (Float! )
Penalty applied to residuals below the target range when using exponential strategy.
Represents a simulation run with associated metadata and results.
Simulation 的字段
名称 描述 id (ID! )
Unique identifier for the simulation. name (String! )
Name or title of the simulation. progress (Float! )
Progress percentage of the simulation (between 0 and 100) status (SimulationStatus! )
Current status or phase of the simulation. meshUrl (SimulationAsset )
Public-facing original mesh asset (Parquet). gcode (GcodeV2! )
G-code used to run the simulation. reportJsonUrl (String )
Presigned URL for downloading the original simulation report. thermalIndexGcodeUrl (String )
Presigned URL to download thermal index G-code. estimatedSimulationDurationSeconds (Float )
Estimated duration of the simulation in seconds. simulationSettings (SimulationSettings! )
thermalIndexStatistics (ThermalIndexStatistics! )
Statistics related to thermal indices in the simulation. featureFlagsUsed (SimulationFeatureFlags! )
Feature flags that were enabled for this simulation run. materialId (ID! )
Material ID associated with the G-code. printerId (ID! )
Printer ID associated with the G-code. printInfo (PrintInfo )
Information relating to the print. speedFactor (Float )
How much we can improve the flow rate set suggestedFixes ([SuggestedFix!]! )
List of suggested fixes for the simulation updatedAt (DateTime! )
Timestamp when the simulation was last updated. insertedAt (DateTime! )
Timestamp when the simulation was created. material (Material! )
printer (Printer! )
Feature flags that were enabled for this simulation.
SimulationFeatureFlags 的字段
名称 描述 useBridgeSpeedSmoothing (Boolean! )
Smooths speed transitions over bridges for improved print quality. useOptimizeAboveBridge (Boolean! )
Optimizes toolpath strategy for layers printed above bridge structures. useFanSpeedOptimization (Boolean! )
Enable optimizing fan-speeds. useGpu (Boolean! )
Forces all simulations to use Dragon GPU acceleration (experimental). onlyExportCoreAssets (Boolean! )
Exports only core assets for the simulation. applyOptimumNozzleTemp (Boolean! )
Includes Helio's recommended optimum nozzle temperature in the simulation process. fanSpeedRampUp (Boolean! )
Enable fan speed ramp-up during simulation. keepVerticalSupportInterface (Boolean! )
Keep vertical support interface settings from original G-code.
SimulationFeedback 的字段
名称 描述 id (ID! )
ID of the feedback simulationId (ID! )
ID of the simulation rating (Float! )
Rating of the simulation comment (String )
Comments about the simulation
SimulationSettings 的字段
名称 描述 airTemperatureAboveBuildPlate (Float! )
{"description": "Ambient air temperature just above the build plate.", "unit": "K", "min": 0} temperatureStabilizationHeight (Float! )
{"description": "Height at which temperature stabilization occurs.", "unit": "m"} stabilizedAirTemperature (Float! )
{"description": "The temperature maintained at the stabilization height.", "unit": "K", "min": 0} constantPlatformTemperature (Float )
{"description": "Optional override for the platform (bed) temperature.", "unit": "K", "min": 0} constantNozzleTemperature (Float )
{"description": "Optional override for the nozzle temperature.", "unit": "K", "min": 0} constantFanSpeed (Float )
{"description": "Optional override for fan speed as a percentage.", "unit": "%", "min": 0, "max": 100} temperatureHistoryDatapointsPerElement (Int )
Controls the density (resolution) of exported temperature data per element. Higher values provide more detailed temperature history. temperatureHistoryLengthMultiplier (Int )
Controls the length (time duration) of exported temperature history data. Higher values extend the time range of recorded temperature data.
Details of subscription add on.
SubscriptionAddOn 的字段
名称 描述 id (ID! )
Unique identifier for the code group. subscriptions ([HelioSubscription!]! )
List of associated subscriptions. name (String! )
Name of the code group. description (String )
Description of add on addOnOptimizationsCount (Int! )
Amount of extra optimizations addOnPriceId (String! )
Price id from paddle price (String )
Price of the subscription add-on, if applicable. features ([String!]! )
List of features included in the subscription add-on. disclaimers ([String!]! )
List of disclaimers or conditions associated with the subscription add-on. button (String )
Button text for the subscription add-on. category (String )
Category of the subscription plan. insertedAt (DateTime! )
Timestamp when the add-on group was created. updatedAt (DateTime! )
Timestamp when the add-on group was last updated.
A suggested fix.
SuggestedFix 的字段
名称 描述 orderIndex (Int )
Order index of the suggested fix category (SuggestedFixCategory! )
Category of the suggested fix fix (String! )
Fix to be applied extraDetails ([String!]! )
Extra details about the suggested fix
Represents a suggestion for the Lfam dashboard.
Suggestion 的字段
Summary 的字段
名称 描述 simulationCount (Int! )
materialCount (Int! )
printerCount (Int! )
ThermalIndexStatistics 的字段
名称 描述 thermalIndexCount (Int )
Number of thermal index values in the original simulation. thermalIndexMean (Float )
Mean of the thermal index values in the original simulation. thermalIndexStd (Float )
Standard deviation of the original thermal index values. thermalIndexMin (Float )
Minimum thermal index value observed. thermalIndex25 (Float )
25th percentile of thermal index values. thermalIndex50 (Float )
Median or 50th percentile of thermal index values. thermalIndex75 (Float )
75th percentile of thermal index values. thermalIndexMax (Float )
Maximum thermal index value observed.
Represents a record of a user's subscription transaction.
TransactionHistory 的字段
名称 描述 id (ID! )
Unique identifier of the transaction record. user (User! )
The user associated with this transaction. name (String! )
Name of the subscription or transaction item. description (String )
Optional description of the transaction. optsPerMonth (Int )
Number of optimizations allowed per month in this transaction. type (TransactionType! )
Type of transaction (e.g., subscription, add-on). subscription (HelioSubscription )
Subscription associated with this transaction, if applicable. addOn (SubscriptionAddOn )
Add-on associated with this transaction, if applicable. addOnOptimizations (Int )
Number of bonus optimizations granted by the add-on, if applicable. subscriptionStartDate (DateTime )
Start date of the subscription associated with this transaction. subscriptionEndDate (DateTime )
End date of the subscription associated with this transaction. paddleBillingStatus (String )
Status of current transaction insertedAt (DateTime! )
Timestamp when the transaction record was created. updatedAt (DateTime! )
Timestamp when the transaction record was last updated.
Details of a user in the system.
User 的字段
名称 描述 id (ID! )
Unique identifier of the user. email (String )
User's email address. handle (String )
Custom user handle or username. type (UserType! )
The user type or role in the system (e.g. Hobbyist, Academic). avatarUrl (String )
URL to the user's avatar image. transactionHistories ([TransactionHistory!]! )
List of the user's transaction history records. remainingOptsThisMonth (Int )
Remaining number of optimizations allowed for the user this month. subscriptionStartDate (DateTime )
Start date of the user's subscription, if active. subscriptionEndDate (DateTime )
End date of the user's subscription, if active. subscription (HelioSubscription )
Subscription details for the user, if any. paddleBillingPeriodStart (DateTime )
Start date of the Paddle billing period. paddleBillingPeriodEnd (DateTime )
End date of the Paddle billing period. paddleNextBilledAt (DateTime )
Next billing date for the Paddle subscription, if applicable. paddleBillingCycleInterval (String )
Interval for Paddle billing cycles (e.g., monthly, yearly). paddleBillingCycleFrequency (Int )
Frequency of Paddle billing cycles (e.g., 1 for monthly, 12 for yearly). paddleBillingStatus (String )
Status of current transaction addOnOptimizations (Int )
Bonus optimizations logins ([Login!]! )
List of user login records. paddleCustomerId (String )
Paddle customer ID associated with the subscription. lastOtpRequestedAt (DateTime )
Timestamp of the last OTP request for this user. enableBridgeSpeedSmoothing (Boolean )
Smooths speed transitions over bridges for improved print quality. enableOptimizeAboveBridge (Boolean )
Optimizes toolpath strategy for layers printed above bridge structures. enableFanSpeedOptimization (Boolean )
Enable optimizing fan-speeds. enableFanSpeedRampUp (Boolean )
Enable gradual fan speed ramp-up feature. enableAlwaysUseDragonGpu (Boolean )
Forces all optimizations to use Dragon GPU acceleration (experimental). enableApplyOptimumNozzleTemp (Boolean )
Apply Helio's optimum nozzle temperature recommendations during optimization. enableKeepVerticalSupportInterface (Boolean )
Keep vertical support interface settings from original G-code. isFreeTrialClaimed (Boolean! )
Whether user has ever claimed a free trial. isFreeTrialActive (Boolean! )
Whether user's free trial is currently active. freeTrialEndsAt (DateTime )
When the free trial ends (if claimed). isFreeTrialConvertedToPaid (Boolean! )
Whether user converted trial to paid subscription. membershipStatus (String! )
Indicates if the user has an active subscription.
AlternativeMaterialNames 的字段
MaterialSummary 的字段
名称 描述 count (Int! )
brands (Int! )
desktopMaterials (Int! )
lfamMaterials (Int! )
experimentalMaterials (Int! )
AlternativePrinterNames 的字段
ClaimFreeTrialInput 的字段
名称 描述 source (TrialSource! ) The source from which the trial is being claimed (STORE or DASHBOARD).
CreateGcodeInputV2 的字段
名称 描述 name (String! ) The name of the gcode. description (String ) The description of the gcode. materialId (ID! ) The ID of the material. printerId (ID! ) The ID of the printer. gcodeKey (String! ) The key of the gcode. isSingleShell (Boolean! ) Whether the gcode is single shell. isMultiMaterial (Boolean ) Whether the gcode is multi-material. isMultiColor (Boolean ) Whether the gcode is multi-color. overrideConstantNozzleTemperature (Float ) {"description": "A constant nozzle temperature to override with.", "unit": "K", "min": 323} overrideConstantLayerHeight (Float ) {"description": "A constant layer height to override with.", "unit": "m", "min": 0} overrideConstantLineWidth (Float ) {"description": "A constant line width to override with.", "unit": "m", "min": 0} overrideConstantPlatformTemperature (Float ) {"description": "A constant platform temperature to override with.", "unit": "K", "min": 0}
CreateGcodeInputV3 的字段
名称 描述 name (String! ) The name of the gcode. description (String ) The description of the gcode. materials ([GcodeMaterialInput!]! ) The list of materials used by this gcode. printerId (ID! ) The ID of the printer. gcodeKey (String! ) The key of the gcode. isSingleShell (Boolean! ) Whether the gcode is single shell. isMultiMaterial (Boolean ) Whether the gcode is multi-material. isMultiColor (Boolean ) Whether the gcode is multi-color. overrideConstantNozzleTemperature (Float ) A constant nozzle temperature to override with (Unit: Kelvin $K$) overrideConstantLayerHeight (Float ) A constant layer height to override with (Unit: Meters $m$) overrideConstantLineWidth (Float ) A constant line width to override with (Unit: Meters $m$) overrideConstantPlatformTemperature (Float ) A constant platform temperature to override with (Unit: Kelvin $K$)
CreateOptimizationInput 的字段
名称 描述 name (String! ) User-defined name for the optimization run. gcodeId (ID! ) Unique identifier of the G-code to optimize. simulationSettings (SimulationSettingsInput ) Settings related to the simulation environment and initial conditions. optimizationSettings (OptimizationSettingsInput ) Parameters and strategy configurations for running the optimization.
CreateOptimizationInputV2 的字段
名称 描述 name (String! ) User-defined name for the optimization run. gcodeId (ID! ) Unique identifier of the G-code to optimize. simulationSettings (SimulationSettingsInputV2 ) Settings related to the simulation environment and initial conditions. optimizationSettings (OptimizationSettingsInput ) Parameters and strategy configurations for running the optimization.
CreateSimulationInput 的字段
名称 描述 name (String! ) User-defined name for the simulation. gcodeId (ID! ) Unique identifier of the G-code to simulate. simulationSettings (SimulationSettingsInput ) Settings related to the simulation environment and parameters.
CreateSimulationInputV2 的字段
名称 描述 name (String! ) User-defined name for the simulation. gcodeId (ID! ) Unique identifier of the G-code to simulate. simulationSettings (SimulationSettingsInputV2 ) Settings related to the simulation environment and parameters.
CreateSuggestionInput 的字段
名称 描述 content (String ) Suggestion.
Input for creating a user.
CreateUserInput 的字段
名称 描述 email (String ) Email address, if possible.
GcodeFilter 的字段
名称 描述 field (GcodeField! ) The field to filter on, e.g., 'name', 'status'. filter (Filter! ) The value or condition to filter the field by, e.g., 'active', 'completed'.
GcodeMaterialInput 的字段
名称 描述 materialId (ID! ) The ID of the material. name (String ) An optional display name for the material. slotIndex (Int! ) The slot index for the material on the printer. nozzleIndex (Int! ) The nozzle index for the material on the printer.
LayerRangeInput 的字段
名称 描述 fromLayer (Int! ) The starting layer number for the specified range (inclusive). toLayer (Int! ) The ending layer number for the specified range (inclusive).
NewsArticleFeedbackInput 的字段
名称 描述 isLike (Boolean ) Indicates if the user liked the article. If None, it means no feedback was given. isNotImportant (Boolean ) Indicates if the user found the article not important. If None, it means no feedback was given. isNiceToHave (Boolean ) Indicates if the user found the article nice to have. If None, it means no feedback was given. isImportant (Boolean ) Indicates if the user found the article important. If None, it means no feedback was given. isCritical (Boolean ) Indicates if the user found the article critical. If None, it means no feedback was given.
OptimizationFeedbackInput 的字段
名称 描述 optimizationId (ID! ) Unique identifier of the optimization. rating (Float! ) Rating given by the user (0.0 - 1.0) comment (String! ) Comment or feedback provided by the user.
OptimizationSettingsInput 的字段
名称 描述 minVelocity (Float ) {"description": "Minimum print head velocity during optimization.", "unit": "m/s", "min": 0} maxVelocity (Float ) {"description": "Maximum print head velocity during optimization.", "unit": "m/s", "min": 0} minVelocityIncrement (Float ) {"description": "Minimum step size to increment velocity values during optimization.", "unit": "m/s", "min": 0} minExtruderFlowRate (Float ) {"description": "Minimum allowed extruder flow rate during optimization.", "unit": "m\u00b3/s", "min": 0} maxExtruderFlowRate (Float ) {"description": "Maximum allowed extruder flow rate during optimization.", "unit": "m\u00b3/s", "min": 0} tolerance (Float ) {"description": "Tolerance threshold for optimization convergence.", "min": 0} maxIterations (Int ) {"description": "Maximum number of iterations allowed during optimization.", "min": 1} reductionStrategySettings (ReductionStrategySettingsInput ) Configuration settings for the reduction strategy used during optimization. residualStrategySettings (ResidualStrategySettingsInput ) Configuration settings for the residual strategy used during optimization. layersToOptimize ([LayerRangeInput!]! ) List of layer ranges to include in the optimization process. optimizer (Optimizer ) Selected optimization algorithm to use during the simulation process. optimizeOuterwall (Boolean ) {"description": "Flag to indicate whether to optimize the outer wall of the print.", "removedOn": "2026-06-01T00:00:00Z"} printPriority (PrintPriority ) Print priority selection for optimization (e.g., Speed & Strength, Preserve Surface Finish, Enhance Surface Gloss).
RedeemFreeTrialCodeInput 的字段
名称 描述 code (String! ) Free trial code to redeem.
ReductionStrategySettingsInput 的字段
名称 描述 strategy (OptimizationReductionStrategy ) The strategy used to reduce the number of nodes in the optimization process. autolinearDoCriticality (Boolean ) Enable automatic linear reduction based on thermal criticality. autolinearDoFitness (Boolean ) Enable automatic linear reduction based on fitness values. autolinearDoInterpolation (Boolean ) Enable interpolation during automatic linear reduction. autolinearCriticalityMaxNodesDensity (Float ) {"description": "Maximum nodes density for criticality-based auto-linear reduction.", "unit": "nodes/m", "min": 0} autolinearCriticalityThreshold (Float ) {"description": "Thermal index threshold for triggering criticality-based reduction.", "min": 0, "max": 1} autolinearFitnessMaxNodesDensity (Float ) {"description": "Maximum nodes density for fitness-based auto-linear reduction.", "unit": "nodes/m", "min": 0} autolinearFitnessThreshold (Float ) {"description": "Fitness threshold for triggering fitness-based reduction.", "min": 0, "max": 1} autolinearInterpolationLevels (Int ) {"description": "Number of interpolation levels to apply in auto-linear strategy.", "min": 1} linearNodesLimit (Int ) {"description": "Maximum number of nodes allowed for the linear reduction strategy.", "min": 1}
ResidualStrategySettingsInput 的字段
名称 描述 strategy (OptimizationResidualStrategy ) The residual strategy used for optimization, such as linear or exponential. exponentialPenaltyHigh (Float ) {"description": "Penalty applied to residuals above the target range when using exponential strategy.", "min": 0} exponentialPenaltyLow (Float ) {"description": "Penalty applied to residuals below the target range when using exponential strategy.", "min": 0}
SimulationFeedbackInput 的字段
名称 描述 simulationId (ID! ) Unique identifier of the simulation. rating (Float! ) Rating given by the user (0.0 - 1.0) comment (String! ) Comment or feedback provided by the user.
SimulationFilter 的字段
名称 描述 field (SimulationField! ) The field to filter on, e.g., 'name', 'status'. filter (Filter! ) The value or condition to filter the field by, e.g., 'active', 'completed'.
SimulationSettingsInput 的字段
名称 描述 roomTemperature (Float ) {"description": "Ambient air temperature in the room.", "unit": "K", "min": 0} airTemperatureAboveBuildPlate (Float ) {"description": "Ambient air temperature just above the build plate.", "unit": "K", "min": 0} temperatureStabilizationHeight (Float ) {"description": "The height at which the air temperature around the print begins to stabilize.", "unit": "m", "min": 0} stabilizedAirTemperature (Float ) {"description": "The temperature maintained at the stabilization height.", "unit": "K", "min": 0} constantPlatformTemperature (Float ) {"description": "Optional override for the platform (bed) temperature.", "unit": "K", "min": 0} constantNozzleTemperature (Float ) {"description": "Optional override for the nozzle temperature.", "unit": "K", "min": 0} constantFanSpeed (Float ) {"description": "Optional override for fan speed as a percentage.", "unit": "%", "min": 0, "max": 100}
SimulationSettingsInputV2 的字段
名称 描述 roomTemperature (Float ) {"description": "Ambient air temperature in the room.", "unit": "K", "min": 0} airTemperatureAboveBuildPlate (Float ) {"description": "Ambient air temperature just above the build plate.", "unit": "K", "min": 0} temperatureStabilizationHeight (Float ) {"description": "The height at which the air temperature around the print begins to stabilize.", "unit": "m", "min": 0} stabilizedAirTemperature (Float ) {"description": "The temperature maintained at the stabilization height.", "unit": "K", "min": 0} constantPlatformTemperature (Float ) {"description": "Optional override for the platform (bed) temperature.", "unit": "K", "min": 0} constantNozzleTemperature (Float ) {"description": "Optional override for the nozzle temperature.", "unit": "K", "min": 0} constantFanSpeed (Float ) {"description": "Optional override for fan speed as a percentage.", "unit": "%", "min": 0, "max": 100} temperatureHistoryDatapointsPerElement (Int ) {"description": "Controls the density (resolution) of exported temperature data per element. Higher values provide more detailed temperature history.", "min": 100, "max": 1000} temperatureHistoryLengthMultiplier (Int ) {"description": "Controls the length (time duration) of exported temperature history data. Higher values extend the time range of recorded temperature data.", "min": 1}
SimulationStatusFilter 的字段
StringFilter 的字段
名称 描述 equalTo (String ) notEqualTo (String ) caseSensitiveContains (String ) caseInsensitiveContains (String ) caseSensitiveStartsWith (String ) caseInsensitiveStartsWith (String ) caseSensitiveEndsWith (String ) caseInsensitiveEndsWith (String ) notCaseSensitiveContains (String ) notCaseInsensitiveContains (String ) notCaseSensitiveStartsWith (String ) notCaseInsensitiveStartsWith (String ) notCaseSensitiveEndsWith (String ) notCaseInsensitiveEndsWith (String )
Input for updating user settings and feature flags.
UpdateFeatureFlags 的字段
名称 描述 enableBridgeSpeedSmoothing (Boolean ) Smooths speed transitions over bridges for improved print quality. enableOptimizeAboveBridge (Boolean ) Optimizes toolpath strategy for layers printed above bridge structures. enableFanSpeedOptimization (Boolean ) Enable optimizing fan-speeds. enableAlwaysUseDragonGpu (Boolean ) Forces all optimizations to use Dragon GPU acceleration (experimental). enableApplyOptimumNozzleTemp (Boolean ) Includes Helio's recommended optimum nozzle temperature in the optimization process. enableFanSpeedRampUp (Boolean ) Enable fan speed ramp-up feature flag.
Input for updating user settings and feature flags (V2).
UpdateFeatureFlagsV2 的字段
名称 描述 enableBridgeSpeedSmoothing (Boolean ) Smooths speed transitions over bridges for improved print quality. enableOptimizeAboveBridge (Boolean ) Optimizes toolpath strategy for layers printed above bridge structures. enableFanSpeedOptimization (Boolean ) Enable optimizing fan-speeds. enableAlwaysUseDragonGpu (Boolean ) Forces all optimizations to use Dragon GPU acceleration (experimental). enableApplyOptimumNozzleTemp (Boolean ) Includes Helio's recommended optimum nozzle temperature in the optimization process. enableFanSpeedRampUp (Boolean ) Enable fan speed ramp-up feature flag. enableKeepVerticalSupportInterface (Boolean ) Keep vertical support interface settings from original G-code.
UpdateGcodeInputV2 的字段
名称 描述 name (String! ) The name of the gcode. materialId (ID! ) The ID of the material. printerId (ID! ) The ID of the printer. isSingleShell (Boolean! ) Whether the gcode is single shell. overrideConstantLayerHeight (Float ) {"description": "The layer height.", "unit": "m", "min": 0} overrideConstantLineWidth (Float ) {"description": "The line width.", "unit": "m", "min": 0} overrideConstantPlatformTemperature (Float ) {"description": "The platform temperature.", "unit": "K", "min": 0} overrideConstantNozzleTemperature (Float ) {"description": "The nozzle temperature.", "unit": "K", "min": 323}
Input for updating user settings and feature flags.
UpdateUserInput 的字段
名称 描述 enableBridgeSpeedSmoothing (Boolean ) Smooths speed transitions over bridges for improved print quality. enableOptimizeAboveBridge (Boolean ) Optimizes toolpath strategy for layers printed above bridge structures. enableFanSpeedOptimization (Boolean ) Enable optimizing fan-speeds. enableAlwaysUseDragonGpu (Boolean ) Forces all optimizations to use Dragon GPU acceleration (experimental).
CaveatType 的值
名称 描述 [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object]
Source of the free trial claim.
TrialSource 的值
名称 描述 [object Object] [object Object] [object Object] [object Object]
Category that classifies the type of FAQ.
FaqCategory 的值
名称 描述 [object Object] [object Object] [object Object] [object Object] [object Object] [object Object]
FloatType 的值
名称 描述 [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object]
Slicer 的值
名称 描述 [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object]
GcodeRestriction 的值
名称 描述 [object Object] [object Object] [object Object] [object Object]
GcodeError 的值
名称 描述 [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object]
Errors encountered during G-code parsing.
GcodeErrorCode 的值
名称 描述 [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object]
GcodeField 的值
名称 描述 [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object]
GcodeStatus 的值
名称 描述 [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object]
LinkingEventType 的值
名称 描述 [object Object] [object Object] [object Object] [object Object]
LoginType 的值
名称 描述 [object Object] [object Object] [object Object] [object Object]
Status of a news article.
NewsArticleStatus 的值
名称 描述 [object Object] [object Object] [object Object] [object Object] [object Object] [object Object]
Tags associated with a news article.
NewsArticleTag 的值
名称 描述 [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object]
Represents the current lifecycle status of a simulation.
SimulationStatus 的值
名称 描述 [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object]
Print priority options for optimization requests.
PrintPriority 的值
名称 描述 [object Object] [object Object] [object Object] [object Object] [object Object] [object Object]
OptimizationImprovement 的值
名称 描述 [object Object] [object Object] [object Object] [object Object] [object Object] [object Object]
OptimizationReductionStrategy 的值
名称 描述 [object Object] [object Object] [object Object] [object Object] [object Object] [object Object]
OptimizationResidualStrategy 的值
名称 描述 [object Object] [object Object] [object Object] [object Object]
Optimizer 的值
名称 描述 [object Object] [object Object] [object Object] [object Object]
PrintOutcome 的值
名称 描述 [object Object] [object Object] [object Object] [object Object] [object Object] [object Object]
TemperatureDirection 的值
名称 描述 [object Object] [object Object] [object Object] [object Object] [object Object] [object Object]
sort direction for paginated queries.
SortDirection 的值
名称 描述 [object Object] [object Object] [object Object] [object Object]
Defines the simulation fields
SimulationField 的值
名称 描述 [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object]
Defines the type or format of a simulation asset.
SimulationAssetType 的值
名称 描述 [object Object] [object Object] [object Object] [object Object]
The category for a suggested fix.
SuggestedFixCategory 的值
名称 描述 [object Object] [object Object] [object Object] [object Object] [object Object] [object Object]
TransactionType 的值
名称 描述 [object Object] [object Object] [object Object] [object Object] [object Object] [object Object]
UserType 的值
名称 描述 [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object]
ApplicationArea 的值
名称 描述 [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object]
Feedstock 的值
名称 描述 [object Object] [object Object] [object Object] [object Object]
HeatedChamberRequirement 的值
名称 描述 [object Object] [object Object] [object Object] [object Object] [object Object] [object Object]
MaterialField 的值
名称 描述 [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object]
ChamberType 的值
名称 描述 [object Object] [object Object] [object Object] [object Object] [object Object] [object Object]
PrinterField 的值
名称 描述 [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object]