Files
hypit/packages/wan/README.md
Sharky Wang c86239820d feat(wan): add the Wan 2.7 image models and serve them on Monid (#301)
* feat(wan): add the Wan 2.7 image models and serve them on Monid

`@hypit/wan@1` carries two exact models, `wan-2.7-image` and
`wan-2.7-image-pro`. Both take a prompt of up to 5,000 characters, up to nine
reference images, and a resolution band; the Pro variant adds 4K. `count`
renders up to four pictures, or names the ceiling of an image set, where the
model chooses how many of up to twelve it returns. An image set shapes a
storyline the way extended reasoning shapes a single picture, so the two are not
stated together.

The model takes no aspect ratio: with references present the output follows the
last one, and a prompt-only request renders at the band's own framing. It reads
exclusions from the prompt rather than a negative-prompt field. The endpoint's
custom colour palette and per-image bounding boxes have no representation in the
port vocabulary, which carries scalars and media rather than object arrays, so
the package declares neither.

`@hypit/provider-monid` serves both through Monid's `alibaba` endpoints. Its
result path previously assumed one video: routes now name their result type and
collection downloads every returned file, so an image set arrives as a set.
Two service limits are reported before any reference is resolved: 4K renders
from a prompt alone, and a request renders at most four pictures outside an
image set.

The request bodies for text-to-image, reference editing, image sets and Pro 4K
validate against the endpoints' published input schemas.

* chore: refresh the lockfile for @hypit/wan
2026-09-18 17:19:23 +08:00

1.4 KiB

@hypit/wan

Exact author/compute contracts and package-owned author Surfaces for Wan 2.7 Image and Wan 2.7 Image Pro.

The model variants are separate endpoints with exact request validation. Their Surfaces project the primary result to an ordinary image Artifact. The package contains no Provider selection, API key or network execution. The selected Provider implements its exact capability.

Import the model variant you mean and connect prompt and references as ordinary graph edges:

<wan:Image id="draft" prompt={prompt} resolution="2K">
  <wan:Reference image={product.image}/>
</wan:Image>

<wan:ProImage id="hero" prompt={heroPrompt} resolution="4K"/>

The Surface only lowers this syntax into the package's exact model request. It does not select a Provider.

Both variants accept prompts up to 5,000 characters and up to nine references, and render at 1K or 2K; the Pro variant adds 4K. The model takes no aspect ratio: with references present the output takes the shape of the last one, and a prompt-only element renders at the band's own framing. There is no negative prompt either, so write exclusions into the prompt.

count renders up to four pictures. Setting image-set renders one storyline across several pictures instead, where count names a ceiling of up to twelve and the model chooses how many it returns. An image set shapes a storyline the way extended-reasoning shapes a single picture, so the two are not stated together.