Skip to main content

Legacy Models

Models Deprecated

HY-Image-3.0-Plus-4090-Tob-v1.0, HY-Image-v3.0-I2I-ToB-v1.0.1, and the legacy hunyuan-image model are deprecated. For new projects use Hy-Image-3.5-preview (the cloudbase provider, @cloudbase/js-sdk >= 3.11.0).

Legacy models are invoked through the hunyuan-image provider and require manual generateImageSubUrlConfig setup.

Text-to-Image​

ParameterTypeRequiredDescription
modelstringYesHY-Image-3.0-Plus-4090-Tob-v1.0
promptstringYesImage description, up to 500 characters
sizestringNoImage size, default 1024x1024
revise{ value: boolean }NoEnable prompt revision
seednumberNoGeneration seed in [1, 4294967295]
footnotestringNoCustom watermark, up to 16 characters

Supported sizes: 1024x1024, 1280x720, 720x1280, 1280x1280.

import cloudbase from "@cloudbase/js-sdk";

const app = cloudbase.init({ env: "your-env-id" });
const ai = app.ai();

const imageModel = ai.createImageModel("hunyuan-image");
imageModel.generateImageSubUrlConfig["hunyuan-image"][
  "HY-Image-3.0-Plus-4090-Tob-v1.0"
] = "images/ar/generations";

const res = await imageModel.generateImage({
  model: "HY-Image-3.0-Plus-4090-Tob-v1.0",
  prompt: "A chubby orange cat napping on a windowsill, watercolor style, warm tones",
  size: "1024x1024",
  revise: { value: true },
});

console.log(res.data[0].url); // Image URL, valid for 24 hours
console.log(res.data[0].revised_prompt); // The revised prompt

Image-to-Image​

On top of the text-to-image parameters, legacy image-to-image adds reference image parameters:

ParameterTypeRequiredDescription
image_urlslist<string>NoReference image URL list; use either this or images
imageslist<string>NoReference image Base64 list; takes precedence over image_urls
Reference Image Requirements
  • At most 1 image, no larger than 10MB
  • PNG, JPEG, JPG
const imageModel = ai.createImageModel("hunyuan-image");

const res = await imageModel.generateImage({
  model: "HY-Image-v3.0-I2I-ToB-v1.0.1",
  prompt: "Convert this photo into an oil painting",
  image_urls: ["https://example.com/reference.jpg"],
  revise: { value: true },
});

console.log(res.data[0].url);

Custom Watermark​

Pass the footnote parameter to generateImage; the server adds the watermark synchronously during generation:

const res = await imageModel.generateImage({
  model: "HY-Image-3.0-Plus-4090-Tob-v1.0",
  prompt: "A chubby orange cat napping on a windowsill",
  footnote: "CloudBase AI",
});

console.log(res.data[0].url); // The returned image already contains the watermark
  • Rendered at the bottom-right corner, up to 16 characters (CJK and Latin alike)
  • No extra generation time