Skip to content

#docs: add Tencent Hunyuan model examples to README#379

Open
dywongcloud wants to merge 1 commit intoreplicate:mainfrom
dywongcloud:tencent-readme
Open

#docs: add Tencent Hunyuan model examples to README#379
dywongcloud wants to merge 1 commit intoreplicate:mainfrom
dywongcloud:tencent-readme

Conversation

@dywongcloud
Copy link
Copy Markdown

@dywongcloud dywongcloud commented Apr 28, 2026

Can we add a small section to the examples?

Summary

  • add README examples for Tencent Hunyuan models on Replicate
  • cover text-to-image, text-to-video, and 3D generation
  • keep the examples consistent with the existing Replicate + FileOutput patterns already documented in this README

Why

Replicate hosts official/public Tencent Hunyuan models, but the JavaScript README does not currently show any Tencent examples. Adding a few copy-paste snippets makes it easier for users to discover and try Tencent models from the Node.js client.

diff --git a/README.md b/README.md
--- a/README.md
+++ b/README.md
@@
 > File handle inputs are automatically uploaded to Replicate. See replicate.files.create for more information. The maximum size for uploaded files is 100MiB. To run a model with a larger file as an input, upload the file to your own storage provider and pass a publicly accessible URL.
+
+### More examples
+
+#### Tencent Hunyuan Image 3
+
+```js
+import { writeFile } from "node:fs/promises";
+import Replicate from "replicate";
+
+const replicate = new Replicate();
+const input = {
+  prompt:
+    "An illustration of a pink and brown butterfly on a pink background, with the black text Hunyuan Image 3 on Replicate below.",
+};
+
+const output = await replicate.run("tencent/hunyuan-image-3", { input });
+await writeFile("hunyuan-image-3.png", output[0]);
+```
+
+#### Tencent Hunyuan Video
+
+```js
+import { writeFile } from "node:fs/promises";
+import Replicate from "replicate";
+
+const replicate = new Replicate();
+const input = {
+  prompt: "A cat walks on the grass, realistic style.",
+  width: 854,
+  height: 480,
+  video_length: 129,
+  infer_steps: 50,
+  seed: 42,
+};
+
+const output = await replicate.run("tencent/hunyuan-video", { input });
+await writeFile("hunyuan-video.mp4", output);
+```
+
+#### Tencent Hunyuan3D-2mv
+
+```js
+import { readFile, writeFile } from "node:fs/promises";
+import Replicate from "replicate";
+
+const replicate = new Replicate();
+const input = {
+  front_image: await readFile("./front.png"),
+  // Optional additional views for better reconstruction:
+  // back_image: await readFile("./back.png"),
+  // left_image: await readFile("./left.png"),
+  // right_image: await readFile("./right.png"),
+  file_type: "glb",
+  steps: 30,
+  guidance_scale: 5,
+  target_face_num: 10000,
+};
+
+const output = await replicate.run("tencent/hunyuan3d-2mv", { input });
+await writeFile("hunyuan3d-2mv.glb", output);
+```
 ## TypeScript usage

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant