Skip to main content
ArtEmotion
Video

Hunyuan V2V

Credit-based pricing. Supports reference video.

Output
video
Aspect ratio
16:9, 9:16
Resolution
480p, 580p, 720p

Inputs

  • Reference video (required)

Example prompt

Studio Ghibli anime style, soft watercolour backgrounds, clean linework, cherry blossom petals shimmering in dreamy pastel light
Try this prompt →
LLM-ready

API & LLM schema

Exact request contract for this model. Agents can fetch it from /api/v1/models?id=fal-ai/hunyuan-video/video-to-video.

POST/api/v1/generate15 fields · 3 required
FieldTypeRequirementContract
model_idconstantRequiredArtEmotion model identifier.
extraobjectOptionalModel-specific settings may also be nested here.
max_creditsnumberOptionalReject before submission if the estimated list price exceeds this cap. · Range: 1–…
webhook_urlstringOptionalFormat: uri
webhook_secretstringOptionalOptional model input.
folder_idstringOptionalOptional model input.
promptstringRequiredOptional model input.
num_framesnumberOptionalThe number of frames to generate. · Allowed: 129, 85 · Default: 129
strengthnumberOptionalStrength for Video-to-Video · Default: 0.85 · Range: 0.01–1
pro_modebooleanOptionalBy default, generations are done with 35 steps. Pro mode does 55 steps which results in higher quality videos but will take more time and cost 2x more · Default: false
seedintegerOptionalThe seed to use for generating the video.
enable_safety_checkerbooleanOptionalRun the input safety checker before generation. · Default: false
aspect_ratiostringOptionalAllowed: 16:9, 9:16
resolutionstringOptionalAllowed: 480p, 580p, 720p
video_urlstringRequiredFormat: uri
Minimal request example
{
  "model_id": "fal-ai/hunyuan-video/video-to-video",
  "prompt": "Studio Ghibli anime style, soft watercolour backgrounds, clean linework, cherry blossom petals shimmering in dreamy pastel light",
  "video_url": "https://example.com/video"
}
Raw JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fhunyuan-video%2Fvideo-to-video",
  "title": "Hunyuan V2V generation request",
  "description": "Request body accepted by POST /api/v1/generate for fal-ai/hunyuan-video/video-to-video.",
  "type": "object",
  "properties": {
    "model_id": {
      "type": "string",
      "const": "fal-ai/hunyuan-video/video-to-video",
      "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"
    },
    "num_frames": {
      "title": "Num Frames",
      "description": "The number of frames to generate.",
      "default": 129,
      "type": "number",
      "enum": [
        129,
        85
      ]
    },
    "strength": {
      "title": "Strength",
      "description": "Strength for Video-to-Video",
      "default": 0.85,
      "type": "number",
      "minimum": 0.01,
      "maximum": 1,
      "multipleOf": 0.01
    },
    "pro_mode": {
      "title": "Pro Mode",
      "description": "By default, generations are done with 35 steps. Pro mode does 55 steps which results in higher quality videos but will take more time and cost 2x more",
      "default": false,
      "type": "boolean"
    },
    "seed": {
      "title": "Seed",
      "description": "The seed to use for generating the video.",
      "type": "integer"
    },
    "enable_safety_checker": {
      "title": "Enable Safety Checker",
      "description": "Run the input safety checker before generation.",
      "default": false,
      "type": "boolean"
    },
    "aspect_ratio": {
      "type": "string",
      "enum": [
        "16:9",
        "9:16"
      ]
    },
    "resolution": {
      "type": "string",
      "enum": [
        "480p",
        "580p",
        "720p"
      ]
    },
    "video_url": {
      "type": "string",
      "format": "uri"
    }
  },
  "required": [
    "model_id",
    "prompt",
    "video_url"
  ],
  "additionalProperties": false
}

FAQ

How much does Hunyuan V2V 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 Hunyuan V2V fails?

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

Can I call Hunyuan V2V from the API?

Yes. Use POST /api/v1/generate with model_id: "fal-ai/hunyuan-video/video-to-video". 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 Hunyuan V2V?

Start now →

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