update Open Source Docs from Roblox internal teams

Author: rbx-open-source-docs[bot]

content/en-us/reference/engine/classes/GenerationService.yaml

@@ -2,25 +2,20 @@ name: GenerationService
 type: class
 memory_category: Instances
 summary: |
-  `GenerationService` is a service that allows developers to generate 3D objects
-  from text prompts utilizing Roblox's
-  [Cube 3D foundation model](https://corp.roblox.com/newsroom/2025/03/introducing-roblox-cube).
+  Service that allows developers to generate 3D objects from text prompts.
 description: |
-  `GenerationService` is a service that allows developers to generate 3D objects
-  from text prompts utilizing Roblox's
-  [Cube 3D foundation model](https://corp.roblox.com/newsroom/2025/03/introducing-roblox-cube).
-
-  Mesh generation is a two step process:
+  `GenerationService` allows developers to generate 3D objects from text
+  prompts. Mesh generation is a two step process:
 
   1. `Class.GenerationService:GenerateMeshAsync()|GenerateMeshAsync()` starts
      the mesh generation process using a text prompt and other required
      parameters. It returns a unique identifier (generation ID) that can be used
      to retrieve the future result.
   2. `Class.GenerationService:LoadGeneratedMeshAsync()|LoadGeneratedMeshAsync()`
      loads the generated mesh into the experience. The mesh is returned as a
-     `Class.MeshPart` containing an `Class.EditableMesh`.
+     `Class.MeshPart` or `Class.Model`.
 
-  Currently, GenerationService only supports the following usage:
+  Currently, `GenerationService` only supports the following usage:
 
   - `Class.GenerationService:GenerateMeshAsync()|GenerateMeshAsync()` must be
     called from server scripts.
@@ -36,13 +31,16 @@ description: |
   `Class.EditableMesh` content and only on the client, it is not replicated to
   any other clients.
 
-  The following code illustrates this design pattern. See
+  The following code samples illustrate this design pattern. See
   [this demo experience](https://www.roblox.com/games/86571743597273/Mesh-Generation-Template)
-  for a more detailed example. Click the **⋯** button and **Edit in
-  Studio**.
+  for a more detailed example (click the **⋯** button and **Edit in
+  Studio**).
 code_samples:
   - GenerationService-ServerSideMeshGeneration
   - GenerationService-ClientSideMeshGeneration
+  - GenerationService-ServerSideMeshGeneration-WithSuggestedSize
+  - GenerationService-ClientSideMeshGeneration-WithSuggestedSize
+  - GenerationService-StarterPlayerScripts-WithSuggestedSize
 inherits:
   - Instance
 tags:
@@ -54,10 +52,7 @@ methods:
   - name: GenerationService:GenerateMeshAsync
     summary: |
       Starts the generation of a new 3D mesh from a text prompt and returns
-      unique IDs used to track and retrieve the result. After the generation is
-      complete, use
-      `Class.GenerationService:LoadGeneratedMeshAsync()|LoadGeneratedMeshAsync()`
-      to load and display the generated mesh.
+      unique IDs used to track and retrieve the result.
     description: |
       Starts the generation of a new 3D mesh from a text prompt and returns
       unique IDs used to track and retrieve the result. You can optionally
@@ -67,24 +62,17 @@ methods:
       `Class.GenerationService:LoadGeneratedMeshAsync|LoadGeneratedMeshAsync()`
       to load and display the generated mesh.
 
-      **Rate limits**
-
-      There is a rate limit of 5 generations per minute per experience. If you
-      exceed this limit, further generation requests are blocked until the next
-      minute.
+      **Error Codes**
 
-      **Error codes**
-
-      | Error                    | Description                                                              | Recommended developer action                                                         |
-      | ------------------------ | ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------ |
-      | Rate limit exceeded      | The maximum number of mesh generations has been exceeded for the minute. | Wait until the rate limit resets.                                                    |
-      | Moderation failure       | The mesh generation was flagged for moderation.                          | Review and modify the prompt to ensure it adheres to Roblox's moderation guidelines. |
-      | Internal server error    | An unexpected issue occurred on the server.                              | Retry the request later or check server status for issues.                           |
-      | Character limit exceeded | The input prompt length for this generation request exceeded the limit.  | Reduce the number of characters in the `Prompt` string of the `input` dictionary.    |
-    code_samples:
-      - GenerationService-GenerateMeshAsync-BasicUsage
-      - GenerationService-GenerateMeshAsync-WithIntermediateResultsCallback
-      - GenerationService-GenerateMeshAsync-ServerSideGenerationWithErrorHandling
+      | Error                                  | Description                                                              | Recommended developer action                                                         |
+      | -------------------------------------- | ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------ |
+      | Rate limit exceeded                    | The maximum number of mesh generations has been exceeded for the minute. | Wait until the rate limit resets.                                                    |
+      | Moderation failed                      | The mesh generation was flagged for moderation.                          | Review and modify the prompt to ensure it adheres to Roblox's moderation guidelines. |
+      | Internal server error                  | An unexpected issue occurred on the server.                              | Retry the request later or check server status for issues.                           |
+      | Character limit exceeded               | The input prompt length for this generation request exceeded the limit.  | Reduce the number of characters in the `Prompt` string of the `input` dictionary.    |
+      | Service overloaded                     | The service is overloaded.                                               | Retry the request later.                                                             |
+      | Size dimensions must be greater than 0 | Invalid size provided.                                                   | Change the size to above `0`.                                                        |
+    code_samples: []
     parameters:
       - name: inputs
         type: Dictionary
@@ -102,22 +90,25 @@ methods:
         type: Dictionary
         default:
         summary: |
-          Additional generation options. Currently, no options are supported.
+          A dictionary for additional generation options to influence the
+          result. The following key is supported:
+          
+          - `SuggestedSize` — Optional
+          `Datatype.Vector3` representing a size guide for the generated asset.
+          The service will attempt to create a model with a size and proportion
+          similar to the provided `Datatype.Vector3`. This does not guarantee
+          the final output size.
       - name: intermediateResultCallback
         type: Function?
         default:
         summary: |
           A callback function triggered with intermediate generation results.
-          Useful for retrieving early mesh versions (e.g. before textures are
-          applied).
+          Useful for retrieving early mesh versions before textures are applied.
     returns:
       - type: Tuple
         summary: |
-          A tuple of generation ID and context ID.
-
-          - Generation ID: A unique ID returned for each invocation of
-            `GenerateMeshAsync()`.
-          - Context ID: Not currently used.
+          A tuple of the generation ID (a unique ID returned for each invocation
+          of `GenerateMeshAsync()`) and context ID (not currently used).
     tags:
       - Yields
     deprecation_message: ''
@@ -129,17 +120,15 @@ methods:
     summary: |
       Retrieves and loads a mesh generated by
       `Class.GenerationService:GenerateMeshAsync()` using the provided
-      `generationId`. The mesh is returned as a `Class.MeshPart` with
-      `Class.EditableMesh` content.
+      `generationId`.
     description: |
       Retrieves and loads a mesh generated by
-      `Class.GenerationService:GenerateMeshAsync()` using the provided
-      generationId. The mesh is returned as a `Class.MeshPart` with
-      `Class.EditableMesh` content. Because editable meshes are not replicated,
-      the loaded mesh is not replicated to any other clients and can only be
-      loaded once per `generationId`.
-    code_samples:
-      - GenerationService-LoadGeneratedMeshAsync-LoadAGeneratedMesh
+      `Class.GenerationService:GenerateMeshAsync()|GenerateMeshAsync()` using
+      the provided `generationId`. The mesh can be returned as a
+      `Class.MeshPart` or `Class.Model`. Because editable meshes are not
+      replicated, the loaded mesh is not replicated to any other clients and can
+      only be loaded once per `generationId`.
+    code_samples: []
     parameters:
       - name: generationId
         type: string
@@ -151,8 +140,8 @@ methods:
     returns:
       - type: MeshPart
         summary: |
-          The generated mesh, returned as a `Class.MeshPart` containing an
-          `Class.EditableMesh`.
+          The generated asset, returned as a `Class.Model` with a single
+          `Class.MeshPart` containing an `Class.EditableMesh`.
     tags:
       - Yields
     deprecation_message: ''