GITBOOK-772: docs: add tencent/hunyuan-part

Author: techpro-aimlapi

docs/.gitbook/assets/371avBpG23C3CoYzHJXB5.png

@@ -144,7 +144,7 @@ If you've already made your choice and know the model ID, use the [Search panel]
 
 **Sber AI**: [Video](api-references/video-models/sber-ai/)
 
-**Tencent**: [Image](api-references/image-models/tencent/)
+**Tencent**: [Image](api-references/image-models/tencent/) [3D](api-references/3d-generating-models/tencent/)
 
 **Together AI**: [Embedding](api-references/embedding-models/Together-AI/)
 

docs/README.md

@@ -218,7 +218,6 @@
     * [Stable Diffusion v3.5 Large](api-references/image-models/Stability-AI/stable-diffusion-v35-large.md)
   * [Tencent](api-references/image-models/tencent/README.md)
     * [Hunyuan Image v3](api-references/image-models/tencent/hunyuan-image-v3-text-to-image.md)
-    * [Hunyuan Part](api-references/image-models/tencent/hunyuan-part.md)
   * [Topaz Labs](api-references/image-models/topaz-labs/README.md)
     * [Sharpen](api-references/image-models/topaz-labs/sharpen.md)
     * [Sharpen Generative](api-references/image-models/topaz-labs/sharpen-generative.md)
@@ -335,6 +334,8 @@
   * [Sber AI](api-references/video-models/sber-ai/README.md)
     * [Kandinsky 5 (Text-to-Video)](api-references/video-models/sber-ai/kandinsky5-text-to-video.md)
     * [Kandinsky 5 Distill (Text-to-Video)](api-references/video-models/sber-ai/kandinsky5-distill-text-to-video.md)
+  * [Tencent](api-references/video-models/tencent/README.md)
+    * [hunyuan-video-foley](api-references/video-models/tencent/hunyuan-video-foley.md)
   * [VEED](api-references/video-models/veed/README.md)
     * [fabric-1.0](api-references/video-models/veed/fabric-1.0.md)
     * [fabric-1.0-fast](api-references/video-models/veed/fabric-1.0-fast.md)
@@ -403,6 +404,8 @@
     * [magic/image-to-3d](api-references/3d-generating-models/magic/image-to-3d.md)
   * [Stability AI](api-references/3d-generating-models/Stability-AI/README.md)
     * [triposr](api-references/3d-generating-models/Stability-AI/triposr.md)
+  * [Tencent](api-references/3d-generating-models/tencent/README.md)
+    * [Hunyuan Part](api-references/3d-generating-models/tencent/hunyuan-part.md)
 * [Vision Models](api-references/vision-models/README.md)
   * [Image Analysis](api-references/vision-models/image-analysis.md)
   * [OCR: Optical Character Recognition](api-references/vision-models/ocr-optical-character-recognition/README.md)

docs/SUMMARY.md

@@ -87,4 +87,4 @@ Try to choose reference images where the target object is not obstructed by othe
 
 ## All Available 3D-Generating Models
 
-<table data-full-width="false"><thead><tr><th width="222.4000244140625">Model ID</th><th width="134.39996337890625">Developer</th><th width="95">Context</th><th>Model Card</th></tr></thead><tbody><tr><td><a href="Stability-AI/triposr.md">triposr</a></td><td>Tripo AI</td><td></td><td><a href="https://aimlapi.com/models/stable-tripo-sr-api">Stable TripoSR 3D</a></td></tr></tbody></table>
+<table data-full-width="true"><thead><tr><th width="265.4000244140625">Model ID + API Reference link</th><th width="134.39996337890625">Developer</th><th width="104">Context</th><th>Model Card</th></tr></thead><tbody><tr><td><a href="Stability-AI/triposr.md">triposr</a></td><td>Tripo AI</td><td></td><td><a href="https://aimlapi.com/models/stable-tripo-sr-api">Stable TripoSR 3D</a></td></tr><tr><td><a href="tencent/hunyuan-part.md">tencent/hunyuan-part</a></td><td>Tencent</td><td></td><td><a href="https://aimlapi.com/models/hunyuan-part">Hunyuan Part</a></td></tr></tbody></table>

docs/api-references/3d-generating-models/README.md

@@ -0,0 +1,2 @@
+# Tencent
+

docs/api-references/3d-generating-models/tencent/README.md

@@ -0,0 +1,144 @@
+# Hunyuan Part
+
+{% columns %}
+{% column width="66.66666666666666%" %}
+{% hint style="info" %}
+This documentation is valid for the following list of our models:
+
+* `tencent/hunyuan-part`
+{% endhint %}
+{% endcolumn %}
+
+{% column width="33.33333333333334%" %}
+<a href="https://aimlapi.com/app/hunyuan/hunyuan-image-v3-text-to-image" class="button primary">Try in Playground</a>
+{% endcolumn %}
+{% endcolumns %}
+
+## Model Overview
+
+The model analyzes a 3D mesh and performs high-fidelity, structure-coherent shape decomposition, splitting the original mesh into multiple parts that can then be used independently in 3D editors, for example for texturing or animation.
+
+## Setup your API Key
+
+If you don’t have an API key for the AI/ML API yet, feel free to use our [Quickstart guide](https://docs.aimlapi.com/quickstart/setting-up).
+
+## API Schema
+
+{% openapi-operation spec="hunyuan-part" path="/v1/images/generations" method="post" %}
+[OpenAPI hunyuan-part](https://raw.githubusercontent.com/aimlapi/api-docs/refs/heads/main/docs/api-references/3d-generating-models/Tencent/hunyuan-part.json)
+{% endopenapi-operation %}
+
+## Quick Example
+
+Let's generate an image using a simple prompt.
+
+{% tabs %}
+{% tab title="Python" %}
+{% code overflow="wrap" %}
+```python
+import requests
+import json
+
+def main():
+    response = requests.post(
+        "https://api.aimlapi.com/v1/images/generations",
+        headers={
+            # Insert your AIML API Key instead of <YOUR_AIMLAPI_KEY>:
+            "Authorization": "Bearer d09bc3015a66486e9bd4e6d1942934e1",
+            "Content-Type": "application/json",
+        },
+        json={
+            "model": "tencent/hunyuan-part",
+            "mesh_url": "https://storage.googleapis.com/falserverless/model_tests/video_models/base_basic_shaded.glb",
+        },
+    )
+
+    response.raise_for_status()
+    data = response.json()
+
+    data = response.json()
+    print(json.dumps(data, indent=2, ensure_ascii=False))
+
+
+if __name__ == "__main__":
+    main()
+```
+{% endcode %}
+{% endtab %}
+
+{% tab title="JS" %}
+{% code overflow="wrap" %}
+```javascript
+async function main() {
+  const response = await fetch('https://api.aimlapi.com/v1/images/generations', {
+    method: 'POST',
+    headers: {
+      // Insert your AIML API Key instead of <YOUR_AIMLAPI_KEY>:
+      'Authorization': 'Bearer <YOUR_AIMLAPI_KEY>',
+      'Content-Type': 'application/json',
+    },
+    body: JSON.stringify({
+      model: 'tencent/hunyuan-part',
+      mesh_url: 'https://storage.googleapis.com/falserverless/model_tests/video_models/base_basic_shaded.glb',
+    }),
+  });
+
+  const data = await response.json();
+  console.log(data);
+}
+
+main();
+```
+{% endcode %}
+{% endtab %}
+{% endtabs %}
+
+<details>
+
+<summary>Response</summary>
+
+{% code overflow="wrap" %}
+```json5
+{
+  "segmented_mesh": {
+    "url": "https://cdn.aimlapi.com/flamingo/files/b/0a8a7d7b/gG3-a4ScI4yBswdMQ8CYQ_segmented.glb",
+    "content_type": "application/octet-stream",
+    "file_name": "segmented.glb",
+    "file_size": 1600920
+  },
+  "mask_1_mesh": {
+    "url": "https://cdn.aimlapi.com/flamingo/files/b/0a8a7d7b/Csp8ZOZQsxpaOtDrvbe2G_mask_1.glb",
+    "content_type": "application/octet-stream",
+    "file_name": "mask_1.glb",
+    "file_size": 1600912
+  },
+  "mask_2_mesh": {
+    "url": "https://cdn.aimlapi.com/flamingo/files/b/0a8a7d7b/fStkD-Pq6RZrlooYcZ34__mask_2.glb",
+    "content_type": "application/octet-stream",
+    "file_name": "mask_2.glb",
+    "file_size": 1600920
+  },
+  "mask_3_mesh": {
+    "url": "https://cdn.aimlapi.com/flamingo/files/b/0a8a7d7b/YVHy9A0XgUMehoLCA7z5o_mask_3.glb",
+    "content_type": "application/octet-stream",
+    "file_name": "mask_3.glb",
+    "file_size": 1600920
+  },
+  "best_mask_index": 2,
+  "iou_scores": [
+    0.49007099866867065,
+    0.5047933459281921,
+    0.4866638779640198
+  ],
+  "seed": 3285486654,
+  "requestId": "74e75e9a-7965-4348-a84d-d8663b0906dd",
+  "meta": {
+    "usage": {
+      "credits_used": 84000
+    }
+  }
+}
+```
+{% endcode %}
+
+</details>

docs/api-references/3d-generating-models/tencent/hunyuan-part.md

@@ -46,6 +46,8 @@ Then, configure the metaparameters for your generation:
 
 Here is an example of generation an image of a robot classroom using the `flux-pro` image model:
 
+{% tabs %}
+{% tab title="Python" %}
 {% code overflow="wrap" %}
 ```python
 import requests
@@ -72,6 +74,8 @@ response.raise_for_status()
 print("Generation:", response.json())
 ```
 {% endcode %}
+{% endtab %}
+{% endtabs %}
 
 We obtained the following image by running that code example:
 

docs/api-references/image-models/README.md

@@ -98,21 +98,16 @@ main();
 {% code overflow="wrap" %}
 ```json5
 {
-    "data": [
-        {
-            "url": "https://v3b.fal.media/files/b/lion/JdrvNguTlt29LmURRbKKN.png",
-            "content_type": "image/png",
-            "file_name": null,
-            "file_size": null,
-            "width": 1280,
-            "height": 768
-        }
-    ],
-    "meta": {
-        "usage": {
-            "tokens_used": 210000
-        }
+  "data": [
+    {
+      "url": "https://cdn.aimlapi.com/flamingo/files/b/0a8a7b4c/371avBpG23C3CoYzHJXB5.png"
+    }
+  ],
+  "meta": {
+    "usage": {
+      "credits_used": 210000
     }
+  }
 }
 ```
 {% endcode %}
@@ -121,4 +116,4 @@ main();
 
 We obtained the following 1280x768 image by running this code example:
 
-<figure><img src="https://v3b.fal.media/files/b/lion/JdrvNguTlt29LmURRbKKN.png" alt=""><figcaption><p><code>A T-Rex relaxing on a beach, lying on a sun lounger and wearing sunglasses.</code></p></figcaption></figure>
+<figure><img src="../../../.gitbook/assets/371avBpG23C3CoYzHJXB5.png" alt=""><figcaption><p>A T-Rex relaxing on a beach, lying on a sun lounger and wearing sunglasses.</p></figcaption></figure>

docs/api-references/image-models/tencent/hunyuan-image-v3-text-to-image.md

@@ -72,7 +72,7 @@ Can't find the model you need? Join our [Discord community](https://discord.gg/8
 
 ### 3D-Generating Models
 
-<table data-full-width="true"><thead><tr><th width="265.4000244140625">Model ID + API Reference link</th><th width="134.39996337890625">Developer</th><th width="104">Context</th><th>Model Card</th></tr></thead><tbody><tr><td><a href="3d-generating-models/Stability-AI/triposr.md">triposr</a></td><td>Tripo AI</td><td></td><td><a href="https://aimlapi.com/models/stable-tripo-sr-api">Stable TripoSR 3D</a></td></tr></tbody></table>
+<table data-full-width="true"><thead><tr><th width="265.4000244140625">Model ID + API Reference link</th><th width="134.39996337890625">Developer</th><th width="104">Context</th><th>Model Card</th></tr></thead><tbody><tr><td><a href="3d-generating-models/Stability-AI/triposr.md">triposr</a></td><td>Tripo AI</td><td></td><td><a href="https://aimlapi.com/models/stable-tripo-sr-api">Stable TripoSR 3D</a></td></tr><tr><td><a href="3d-generating-models/tencent/hunyuan-part.md">tencent/hunyuan-part</a></td><td>Tencent</td><td></td><td><a href="https://aimlapi.com/models/hunyuan-part">Hunyuan Part</a></td></tr></tbody></table>
 
 ### Embedding Models