Skip to content

#DO NOT MERGE docs: add Tencent Hunyuan model examples to README#378

Open
dylanwongtencent wants to merge 3 commits intoreplicate:mainfrom
dylanwongtencent:feat/huanyuanreadme
Open

#DO NOT MERGE docs: add Tencent Hunyuan model examples to README#378
dylanwongtencent wants to merge 3 commits intoreplicate:mainfrom
dylanwongtencent:feat/huanyuanreadme

Conversation

@dylanwongtencent
Copy link
Copy Markdown

@dylanwongtencent dylanwongtencent commented Apr 14, 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

@dylanwongtencent dylanwongtencent changed the title docs: add Tencent Hunyuan model examples to README #DO NOT MERGE docs: add Tencent Hunyuan model examples to README Apr 14, 2026
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