Image

HY-WU Identity Edit

Credit-based pricing. Supports reference images.

Try HY-WU Identity Edit →Compare models

Output

image

Inputs

Reference image (required)

LLM-ready

API & LLM schema

Exact request contract for this model. Agents can fetch it from /api/v1/models?id=fal-ai/hy-wu-edit.

POST/api/v1/generate13 fields · 5 required

Field	Type	Requirement	Contract
`model_id`	constant	Required	ArtEmotion model identifier.
`extra`	object	Optional	Model-specific settings may also be nested here.
`max_credits`	number	Optional	Reject before submission if the estimated list price exceeds this cap. · Range: 1–…
`webhook_url`	string	Optional	Format: uri
`webhook_secret`	string	Optional	Optional model input.
`folder_id`	string	Optional	Optional model input.
`prompt`	string	Required	Optional model input.
`image_size`	string	Required	Match the target automatically, or choose a supported output frame. · Allowed: auto, square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9 · Default: auto
`num_inference_steps`	number	Optional	More steps can refine detail but take longer. The provider default is 30. · Default: 30 · Range: 1–…
`enable_thinking`	boolean	Optional	Let the model reason over both references before editing for stronger identity consistency. · Default: true
`output_format`	string	Required	PNG preserves maximum image fidelity; JPEG creates a smaller file. · Allowed: png, jpeg · Default: png
`seed`	integer	Optional	Optional random seed for a repeatable edit.
`reference_image_urls`	array<string>	Required	Items: 2–2

Minimal request example

{
  "model_id": "fal-ai/hy-wu-edit",
  "prompt": "Describe the result you want to create.",
  "image_size": "auto",
  "output_format": "png",
  "reference_image_urls": []
}

Raw JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fhy-wu-edit",
  "title": "HY-WU Identity Edit generation request",
  "description": "Request body accepted by POST /api/v1/generate for fal-ai/hy-wu-edit.",
  "type": "object",
  "properties": {
    "model_id": {
      "type": "string",
      "const": "fal-ai/hy-wu-edit",
      "description": "ArtEmotion model identifier."
    },
    "extra": {
      "type": "object",
      "additionalProperties": true,
      "description": "Model-specific settings may also be nested here."
    },
    "max_credits": {
      "type": "number",
      "minimum": 1,
      "description": "Reject before submission if the estimated list price exceeds this cap."
    },
    "webhook_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048
    },
    "webhook_secret": {
      "type": "string",
      "maxLength": 512
    },
    "folder_id": {
      "type": "string"
    },
    "prompt": {
      "type": "string"
    },
    "image_size": {
      "title": "Output framing",
      "description": "Match the target automatically, or choose a supported output frame.",
      "default": "auto",
      "type": "string",
      "enum": [
        "auto",
        "square_hd",
        "square",
        "portrait_4_3",
        "portrait_16_9",
        "landscape_4_3",
        "landscape_16_9"
      ]
    },
    "num_inference_steps": {
      "title": "Quality steps",
      "description": "More steps can refine detail but take longer. The provider default is 30.",
      "default": 30,
      "type": "number",
      "minimum": 1,
      "multipleOf": 1
    },
    "enable_thinking": {
      "title": "Identity reasoning",
      "description": "Let the model reason over both references before editing for stronger identity consistency.",
      "default": true,
      "type": "boolean"
    },
    "output_format": {
      "title": "Output format",
      "description": "PNG preserves maximum image fidelity; JPEG creates a smaller file.",
      "default": "png",
      "type": "string",
      "enum": [
        "png",
        "jpeg"
      ]
    },
    "seed": {
      "title": "Seed",
      "description": "Optional random seed for a repeatable edit.",
      "type": "integer"
    },
    "reference_image_urls": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri"
      },
      "minItems": 2,
      "maxItems": 2
    }
  },
  "required": [
    "model_id",
    "prompt",
    "image_size",
    "output_format",
    "reference_image_urls"
  ],
  "additionalProperties": false
}

Browse schemas for every ArtEmotion model →

FAQ

How much does HY-WU Identity Edit cost on ArtEmotion?

Credit-based pricing. You pay in ArtEmotion credits — every plan and top-up converts USD to credits at a fixed rate.

Do I get my credits back if HY-WU Identity Edit fails?

Yes — failed generations are never charged. The credits are released back to your balance automatically.

Can I call HY-WU Identity Edit from the API?

Yes. Use POST /api/v1/generate with model_id: "fal-ai/hy-wu-edit". See the API reference for the full schema.

Where are my generations stored?

Every output is saved to your personal Library. You can export or delete everything any time from Privacy & deletion.

Ready to generate with HY-WU Identity Edit?

Start now →

No commitment. New accounts get 50 free credits on signup. See pricing.