Magic Hour

{'type': 'object', 'required': [], 'properties': {}}

{'type': 'object', 'required': ['id', 'email', 'tier', 'credits', 'subscription'], 'properties': {'id': {'type': 'string', 'example': 'cuid-example', 'description': 'Unique ID of the account that owns the API key.'}, 'tier': {'enum': ['free', 'creator', 'pro', 'business'], 'type': 'string', 'example': 'pro', 'description': 'Subscription tier in effect for the account. `free` if there is no active subscription, including while a subscription is `past_due`.'}, 'email': {'type': ['string', 'null'], 'example': 'user@example.com', 'description': 'Email address of the account.'}, 'credits': {'type': 'integer', 'example': 12500, 'minimum': 0.0, 'description': 'Credits currently available to spend. Includes subscription credits and any purchased credit packs.'}, 'subscription': {'type': ['object', 'null'], 'required': ['name', 'status', 'price', 'discount', 'billing_interval', 'current_period_end', 'cancel_at_period_end'], 'properties': {'name': {'type': ['string', 'null'], 'example': 'Pro', 'description': 'Name of the current subscription plan, e.g. `Creator`, `Pro`, `Pro Plus`, `Business`. `null` if the plan cannot be determined. Use `tier` for a machine-readable value.'}, 'price': {'type': 'object', 'required': ['amount', 'currency'], 'properties': {'amount': {'type': 'integer', 'example': 4900, 'minimum': 0.0, 'description': 'Price charged per billing interval, in the smallest unit of the currency (e.g. 4900 is $49.00 for `usd`). Discounts are not applied.'}, 'currency': {'type': 'string', 'example': 'usd', 'description': 'Three-letter ISO 4217 currency code, lowercase.'}}}, 'status': {'enum': ['active', 'past_due'], 'type': 'string', 'example': 'active', 'description': 'Status of the subscription.\n- `active`: payments are up to date.\n- `past_due`: the latest payment failed. `tier` is `free` until payment succeeds. The subscription is canceled if payment keeps failing.'}, 'discount': {'type': ['object', 'null'], 'required': ['percent_off', 'amount_off'], 'properties': {'amount_off': {'type': ['integer', 'null'], 'description': 'Fixed amount taken off `price.amount` each billing interval, in the smallest unit of the currency. `null` if the discount is a percentage.'}, 'percent_off': {'type': ['number', 'null'], 'example': 20, 'description': 'Percentage taken off `price.amount` each billing interval. `null` if the discount is a fixed amount.'}}, 'description': 'Discount applied to the subscription. `null` if no discount is applied.'}, 'billing_interval': {'enum': ['month', 'year', None], 'type': ['string', 'null'], 'example': 'month', 'description': 'How often the subscription is billed. `null` if unknown.'}, 'current_period_end': {'type': ['string', 'null'], 'format': 'date-time', 'example': '2026-10-01T00:00:00.000Z', 'description': 'End of the current billing period, in ISO 8601 format. The subscription renews at this time, or ends if `cancel_at_period_end` is `true`.'}, 'cancel_at_period_end': {'type': 'boolean', 'example': False, 'description': 'Whether the subscription is scheduled to end at `current_period_end` instead of renewing. The subscription stays usable until then.'}}, 'description': "Details of the account's subscription plan. `null` if the account has no subscription, e.g. a free account, an account that only purchased credit packs, or an account on usage-based API pricing.\n\nReflects the plan currently configured on the subscription. If a plan change is scheduled, `tier` stays on the current plan until the next payment succeeds, so `tier` and `name` can briefly disagree."}}}

{'type': 'object', 'required': ['assets'], 'properties': {'name': {'type': 'string', 'default': 'Clothes Changer - dateTime', 'example': 'My Clothes Changer image', 'description': 'Give your image a custom name for easy identification.'}, 'assets': {'type': 'object', 'required': ['person_file_path', 'garment_file_path'], 'properties': {'garment_type': {'enum': ['entire_outfit', 'upper_body', 'lower_body', 'dresses'], 'type': 'string', 'example': 'entire_outfit', 'description': 'Type of clothing item to swap. If not provided, swaps the entire outfit. \n* `upper_body` - for shirts/jackets \n* `lower_body` - for pants/skirts \n* `dresses` - for entire outfit (deprecated, use `entire_outfit` instead) \n* `entire_outfit` - for entire outfit'}, 'person_file_path': {'type': 'string', 'example': 'api-assets/id/model.png', 'minLength': 1, 'description': 'The image with the person. This value is either\n- a direct URL to the video file\n- `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).\n\nSee the [file upload guide](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) for details.\n'}, 'garment_file_path': {'type': 'string', 'example': 'api-assets/id/outfit.png', 'minLength': 1, 'description': 'The image of the outfit. This value is either\n- a direct URL to the video file\n- `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).\n\nSee the [file upload guide](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) for details.\n'}}, 'description': 'Provide the assets for clothes changer'}}}

{'type': 'object', 'required': ['id', 'credits_charged'], 'properties': {'id': {'type': 'string', 'example': 'cuid-example', 'description': 'Unique ID of the image. Use it with the [Get image Project API](https://docs.magichour.ai/api-reference/image-projects/get-image-details) to fetch status and downloads.'}, 'credits_charged': {'type': 'integer', 'example': 25, 'description': 'The amount of credits deducted from your account to generate the image. We charge credits right when the request is made. \n\nIf an error occurred while generating the image(s), credits will be refunded and this field will be updated to include the refund.'}}, 'description': 'Success'}

{'type': 'object', 'required': ['assets', 'style'], 'properties': {'name': {'type': 'string', 'default': 'Face Editor - dateTime', 'example': 'My Face Editor image', 'description': 'Give your image a custom name for easy identification.'}, 'style': {'type': 'object', 'properties': {'head_yaw': {'type': 'number', 'default': 0, 'example': 0, 'maximum': 100.0, 'minimum': -100.0, 'multipleOf': 5.0, 'description': 'Head yaw (-100 to 100), in increments of 5'}, 'head_roll': {'type': 'number', 'default': 0, 'example': 0, 'maximum': 100.0, 'minimum': -100.0, 'multipleOf': 5.0, 'description': 'Head roll (-100 to 100), in increments of 5'}, 'head_pitch': {'type': 'number', 'default': 0, 'example': 0, 'maximum': 100.0, 'minimum': -100.0, 'multipleOf': 5.0, 'description': 'Head pitch (-100 to 100), in increments of 5'}, 'mouth_grim': {'type': 'number', 'default': 0, 'example': 0, 'maximum': 100.0, 'minimum': -100.0, 'multipleOf': 5.0, 'description': 'Mouth grim (-100 to 100), in increments of 5'}, 'mouth_pout': {'type': 'number', 'default': 0, 'example': 0, 'maximum': 100.0, 'minimum': -100.0, 'multipleOf': 5.0, 'description': 'Mouth pout (-100 to 100), in increments of 5'}, 'mouth_purse': {'type': 'number', 'default': 0, 'example': 0, 'maximum': 100.0, 'minimum': -100.0, 'multipleOf': 5.0, 'description': 'Mouth purse (-100 to 100), in increments of 5'}, 'mouth_smile': {'type': 'number', 'default': 0, 'example': 0, 'maximum': 100.0, 'minimum': -100.0, 'multipleOf': 5.0, 'description': 'Mouth smile (-100 to 100), in increments of 5'}, 'enhance_face': {'type': 'boolean', 'default': False, 'example': False, 'description': 'Enhance face features'}, 'eye_open_ratio': {'type': 'number', 'default': 0, 'example': 0, 'maximum': 100.0, 'minimum': -100.0, 'multipleOf': 5.0, 'description': 'Eye open ratio (-100 to 100), in increments of 5'}, 'lip_open_ratio': {'type': 'number', 'default': 0, 'example': 0, 'maximum': 100.0, 'minimum': -100.0, 'multipleOf': 5.0, 'description': 'Lip open ratio (-100 to 100), in increments of 5'}, 'eye_gaze_vertical': {'type': 'number', 'default': 0, 'example': 0, 'maximum': 100.0, 'minimum': -100.0, 'multipleOf': 5.0, 'description': 'Vertical eye gaze (-100 to 100), in increments of 5'}, 'eyebrow_direction': {'type': 'number', 'default': 0, 'example': 0, 'maximum': 100.0, 'minimum': -100.0, 'multipleOf': 5.0, 'description': 'Eyebrow direction (-100 to 100), in increments of 5'}, 'eye_gaze_horizontal': {'type': 'number', 'default': 0, 'example': 0, 'maximum': 100.0, 'minimum': -100.0, 'multipleOf': 5.0, 'description': 'Horizontal eye gaze (-100 to 100), in increments of 5'}, 'mouth_position_vertical': {'type': 'number', 'default': 0, 'example': 0, 'maximum': 100.0, 'minimum': -100.0, 'multipleOf': 5.0, 'description': 'Vertical mouth position (-100 to 100), in increments of 5'}, 'mouth_position_horizontal': {'type': 'number', 'default': 0, 'example': 0, 'maximum': 100.0, 'minimum': -100.0, 'multipleOf': 5.0, 'description': 'Horizontal mouth position (-100 to 100), in increments of 5'}}, 'description': 'Face editing parameters'}, 'assets': {'type': 'object', 'required': ['image_file_path'], 'properties': {'image_file_path': {'type': 'string', 'example': 'api-assets/id/1234.png', 'minLength': 1, 'description': 'This is the image whose face will be edited. This value is either\n- a direct URL to the video file\n- `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).\n\nSee the [file upload guide](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) for details.\n'}}, 'description': 'Provide the assets for face editor'}}}

{'type': 'object', 'required': ['id', 'credits_charged'], 'properties': {'id': {'type': 'string', 'example': 'cuid-example', 'description': 'Unique ID of the image. Use it with the [Get image Project API](https://docs.magichour.ai/api-reference/image-projects/get-image-details) to fetch status and downloads.'}, 'credits_charged': {'type': 'integer', 'example': 1, 'description': 'The amount of credits deducted from your account to generate the image. We charge credits right when the request is made. \n\nIf an error occurred while generating the image(s), credits will be refunded and this field will be updated to include the refund.'}}, 'description': 'Success'}

{'type': 'object', 'required': ['style'], 'properties': {'name': {'type': 'string', 'default': 'Ai Gif - dateTime', 'example': 'My Ai Gif gif', 'description': 'Give your gif a custom name for easy identification.'}, 'style': {'type': 'object', 'required': ['prompt'], 'properties': {'prompt': {'type': 'string', 'example': 'Cute dancing cat, pixel art', 'maxLength': 500, 'minLength': 1, 'description': 'The prompt used for the GIF.'}}}, 'output_format': {'enum': ['gif', 'mp4', 'webm'], 'type': 'string', 'default': 'gif', 'example': 'gif', 'description': 'The output file format for the generated animation.'}}}

{'type': 'object', 'required': ['id', 'credits_charged'], 'properties': {'id': {'type': 'string', 'example': 'cuid-example', 'description': 'Unique ID of the image. Use it with the [Get image Project API](https://docs.magichour.ai/api-reference/image-projects/get-image-details) to fetch status and downloads.'}, 'credits_charged': {'type': 'integer', 'example': 50, 'description': 'The amount of credits deducted from your account to generate the image. We charge credits right when the request is made. \n\nIf an error occurred while generating the image(s), credits will be refunded and this field will be updated to include the refund.'}}, 'description': 'Success'}

{'type': 'object', 'required': ['assets'], 'properties': {'name': {'type': 'string', 'default': 'Ai Headshot - dateTime', 'example': 'My Ai Headshot image', 'description': 'Give your image a custom name for easy identification.'}, 'style': {'type': 'object', 'properties': {'prompt': {'type': 'string', 'description': "Prompt used to guide the style of your headshot. We recommend omitting the prompt unless you want to customize your headshot. You can visit [AI headshot generator](https://magichour.ai/create/ai-headshot-generator) to view an example of a good prompt used for our 'Professional' style."}}}, 'assets': {'type': 'object', 'required': ['image_file_path'], 'properties': {'image_file_path': {'type': 'string', 'example': 'api-assets/id/1234.png', 'minLength': 1, 'description': 'The image used to generate the headshot. This image must contain one detectable face. This value is either\n- a direct URL to the video file\n- `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).\n\nSee the [file upload guide](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) for details.\n'}}, 'description': 'Provide the assets for headshot photo'}}}

{'type': 'object', 'required': ['id', 'credits_charged'], 'properties': {'id': {'type': 'string', 'example': 'cuid-example', 'description': 'Unique ID of the image. Use it with the [Get image Project API](https://docs.magichour.ai/api-reference/image-projects/get-image-details) to fetch status and downloads.'}, 'credits_charged': {'type': 'integer', 'example': 50, 'description': 'The amount of credits deducted from your account to generate the image. We charge credits right when the request is made. \n\nIf an error occurred while generating the image(s), credits will be refunded and this field will be updated to include the refund.'}}, 'description': 'Success'}

{'type': 'object', 'required': ['style', 'assets'], 'properties': {'name': {'type': 'string', 'default': 'Ai Image Editor - dateTime', 'example': 'My Ai Image Editor image', 'description': 'Give your image a custom name for easy identification.'}, 'model': {'enum': ['default', 'qwen-edit', 'flux-2-klein', 'nano-banana-2-lite', 'nano-banana-2', 'krea-2', 'gpt-image-2.5-flare', 'gpt-image-2', 'seedream-v5-pro', 'seedream-v4.5', 'seedream-v4', 'nano-banana', 'nano-banana-pro'], 'type': 'string', 'example': 'default', 'description': 'The AI model to use for image editing. Each model has different capabilities and costs.\n\n**Models:**\n- `default` - Use the model we recommend, which will change over time. This is recommended unless you need a specific model. This is the default behavior.\n- `flux-2-klein` - from 5 credits/image\n  - Supported resolutions: 640px, 1k, 2k\n  - Available for tiers: free, creator, pro, business\n  - Max additional input images: 5\n- `gpt-image-2` - from 50 credits/image\n  - Supported resolutions: 640px, 1k, 2k, 4k\n  - Available for tiers: creator, pro, business\n  - Max additional input images: 9\n- `gpt-image-2.5-flare` - from 100 credits/image\n  - Supported resolutions: 640px, 1k, 2k, 4k\n  - Available for tiers: creator, pro, business\n  - Max additional input images: 9\n- `krea-2` - from 10 credits/image\n  - Supported resolutions: 640px, 1k\n  - Available for tiers: free, creator, pro, business\n  - Max additional input images: 1\n- `nano-banana` - from 50 credits/image\n  - Supported resolutions: 640px, 1k\n  - Available for tiers: creator, pro, business\n  - Max additional input images: 9\n- `nano-banana-2` - from 100 credits/image\n  - Supported resolutions: 640px, 1k, 2k, 4k\n  - Available for tiers: creator, pro, business\n  - Max additional input images: 9\n- `nano-banana-2-lite` - from 50 credits/image\n  - Supported resolutions: 640px, 1k\n  - Available for tiers: creator, pro, business\n  - Max additional input images: 9\n- `nano-banana-pro` - from 150 credits/image\n  - Supported resolutions: 1k, 2k, 4k\n  - Available for tiers: creator, pro, business\n  - Max additional input images: 9\n- `qwen-edit` - from 10 credits/image\n  - Supported resolutions: 640px, 1k, 2k\n  - Available for tiers: free, creator, pro, business\n  - Max additional input images: 2\n- `seedream-v4` - from 40 credits/image\n  - Supported resolutions: 640px, 1k, 2k, 4k\n  - Available for tiers: creator, pro, business\n  - Max additional input images: 9\n- `seedream-v4.5` - from 50 credits/image\n  - Supported resolutions: 640px, 1k, 2k, 4k\n  - Available for tiers: creator, pro, business\n  - Max additional input images: 9\n- `seedream-v5-pro` - from 75 credits/image\n  - Supported resolutions: 640px, 1k, 2k\n  - Available for tiers: creator, pro, business\n  - Max additional input images: 9\n'}, 'style': {'type': 'object', 'required': ['prompt'], 'properties': {'prompt': {'type': 'string', 'example': 'Give me sunglasses', 'maxLength': 15000, 'minLength': 1, 'description': 'The prompt used to edit the image.'}}}, 'assets': {'type': 'object', 'properties': {'image_file_paths': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'example': ['api-assets/id/1234.png', 'api-assets/id/1235.png'], 'maxItems': 10, 'description': 'The image(s) used in the edit, maximum of 10 images. This value is either\n- a direct URL to the video file\n- `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).\n\nSee the [file upload guide](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) for details.\n'}}, 'description': 'Provide the assets for image edit'}, 'resolution': {'enum': ['auto', '640px', '1k', '2k', '4k'], 'type': 'string', 'example': '1k', 'description': 'Maximum resolution (longest edge) for the output image.\n\n**Options:**\n- `640px` â\x80\x94 up to 640px\n- `1k` â\x80\x94 up to 1024px\n- `2k` â\x80\x94 up to 2048px\n- `4k` â\x80\x94 up to 4096px\n- `auto` â\x80\x94 **Deprecated.** Mapped server-side from your subscription tier to the best matching resolution the model supports\n\n**Per-model support:**\n- `flux-2-klein` - 640px, 1k, 2k\n- `gpt-image-2` - 640px, 1k, 2k, 4k\n- `gpt-image-2.5-flare` - 640px, 1k, 2k, 4k\n- `krea-2` - 640px, 1k\n- `nano-banana` - 640px, 1k\n- `nano-banana-2` - 640px, 1k, 2k, 4k\n- `nano-banana-2-lite` - 640px, 1k\n- `nano-banana-pro` - 1k, 2k, 4k\n- `qwen-edit` - 640px, 1k, 2k\n- `seedream-v4` - 640px, 1k, 2k, 4k\n- `seedream-v4.5` - 640px, 1k, 2k, 4k\n- `seedream-v5-pro` - 640px, 1k, 2k\n\nNote: Resolution availability depends on the model and your subscription tier.'}, 'image_count': {'enum': [1, 4, 9, 16], 'type': 'number', 'default': 1, 'example': 1, 'description': 'Number of images to generate. Maximum varies by model. Defaults to 1 if not specified.'}, 'aspect_ratio': {'enum': ['auto', '16:9', '9:16', '4:3', '3:2', '1:1', '4:5', '2:3'], 'type': 'string', 'example': '1:1', 'description': 'The aspect ratio of the output image(s). If not specified, defaults to `auto`.'}}}

{'type': 'object', 'required': ['id', 'credits_charged'], 'properties': {'id': {'type': 'string', 'example': 'cuid-example', 'description': 'Unique ID of the image. Use it with the [Get image Project API](https://docs.magichour.ai/api-reference/image-projects/get-image-details) to fetch status and downloads.'}, 'credits_charged': {'type': 'integer', 'example': 50, 'description': 'The amount of credits deducted from your account to generate the image. We charge credits right when the request is made. \n\nIf an error occurred while generating the image(s), credits will be refunded and this field will be updated to include the refund.'}}, 'description': 'Success'}

{'type': 'object', 'required': ['image_count', 'style'], 'properties': {'name': {'type': 'string', 'default': 'Ai Image - dateTime', 'example': 'My Ai Image image', 'description': 'Give your image a custom name for easy identification.'}, 'model': {'enum': ['default', 'z-image-turbo', 'flux-2-klein', 'nano-banana-2-lite', 'nano-banana-2', 'krea-2', 'gpt-image-2.5-flare', 'gpt-image-2', 'seedream-v5-pro', 'seedream-v4', 'nano-banana', 'nano-banana-pro', 'flux-schnell', 'seedream'], 'type': 'string', 'example': 'default', 'description': 'The AI model to use for image generation. Each model has different capabilities and costs.\n\n**Models:**\n- `default` - Use the model we recommend, which will change over time. This is recommended unless you need a specific model. This is the default behavior.\n- `flux-2-klein` - from 5 credits/image\n  - Supported resolutions: 640px, 1k, 2k\n  - Available for tiers: free, creator, pro, business\n  - Image count allowed: 1\n- `flux-schnell` - from 5 credits/image\n  - Supported resolutions: 640px, 1k, 2k\n  - Available for tiers: free, creator, pro, business\n  - Image count allowed: 1, 2, 3, 4\n- `gpt-image-2` - from 50 credits/image\n  - Supported resolutions: 640px, 1k, 2k, 4k\n  - Available for tiers: creator, pro, business\n  - Image count allowed: 1, 2, 3, 4\n- `gpt-image-2.5-flare` - from 100 credits/image\n  - Supported resolutions: 640px, 1k, 2k, 4k\n  - Available for tiers: creator, pro, business\n  - Image count allowed: 1, 2, 3, 4\n- `krea-2` - from 10 credits/image\n  - Supported resolutions: 640px, 1k\n  - Available for tiers: free, creator, pro, business\n  - Image count allowed: 1\n- `nano-banana` - from 50 credits/image\n  - Supported resolutions: 640px, 1k\n  - Available for tiers: creator, pro, business\n  - Image count allowed: 1, 2, 3, 4\n- `nano-banana-2` - from 100 credits/image\n  - Supported resolutions: 640px, 1k, 2k, 4k\n  - Available for tiers: creator, pro, business\n  - Image count allowed: 1, 4, 9, 16\n- `nano-banana-2-lite` - from 50 credits/image\n  - Supported resolutions: 640px, 1k\n  - Available for tiers: creator, pro, business\n  - Image count allowed: 1, 2, 3, 4\n- `nano-banana-pro` - from 150 credits/image\n  - Supported resolutions: 1k, 2k, 4k\n  - Available for tiers: creator, pro, business\n  - Image count allowed: 1, 4, 9, 16\n- `seedream-v4` - from 40 credits/image\n  - Supported resolutions: 640px, 1k, 2k, 4k\n  - Available for tiers: creator, pro, business\n  - Image count allowed: 1, 2, 3, 4\n- `seedream-v5-pro` - from 75 credits/image\n  - Supported resolutions: 640px, 1k, 2k\n  - Available for tiers: creator, pro, business\n  - Image count allowed: 1, 2, 3, 4\n- `z-image-turbo` - from 5 credits/image\n  - Supported resolutions: 640px, 1k, 2k\n  - Available for tiers: free, creator, pro, business\n  - Image count allowed: 1, 2, 3, 4\n\n**Deprecated Enum Values:**\n- `seedream` - Use `seedream-v4` instead.\n'}, 'style': {'type': 'object', 'required': ['prompt'], 'properties': {'tool': {'enum': ['ai-anime-generator', 'ai-art-generator', 'ai-background-generator', 'ai-character-generator', 'ai-face-generator', 'ai-fashion-generator', 'ai-icon-generator', 'ai-illustration-generator', 'ai-interior-design-generator', 'ai-landscape-generator', 'ai-logo-generator', 'ai-manga-generator', 'ai-outfit-generator', 'ai-pattern-generator', 'ai-photo-generator', 'ai-sketch-generator', 'ai-tattoo-generator', 'album-cover-generator', 'animated-characters-generator', 'architecture-generator', 'book-cover-generator', 'comic-book-generator', 'dark-fantasy-ai', 'disney-ai-generator', 'dnd-ai-art-generator', 'emoji-generator', 'fantasy-map-generator', 'graffiti-generator', 'movie-poster-generator', 'optical-illusion-generator', 'pokemon-generator', 'south-park-character-generator', 'superhero-generator', 'thumbnail-maker', 'general'], 'type': 'string', 'default': 'general', 'example': 'ai-anime-generator', 'description': "The art style to use for image generation. Defaults to 'general' if not provided."}, 'prompt': {'type': 'string', 'example': 'Cool image', 'minLength': 1, 'description': 'The prompt used for the image(s).'}}, 'description': 'The art style to use for image generation.'}, 'resolution': {'enum': ['auto', '640px', '1k', '2k', '4k'], 'type': 'string', 'default': 'auto', 'example': '1k', 'description': 'Maximum resolution (longest edge) for the output image.\n\n**Options:**\n- `640px` â\x80\x94 up to 640px\n- `1k` â\x80\x94 up to 1024px\n- `2k` â\x80\x94 up to 2048px\n- `4k` â\x80\x94 up to 4096px\n- `auto` â\x80\x94 **Deprecated.** Mapped server-side from your subscription tier to the best matching resolution the model supports\n\n**Per-model support:**\n- `flux-2-klein` - 640px, 1k, 2k\n- `flux-schnell` - 640px, 1k, 2k\n- `gpt-image-2` - 640px, 1k, 2k, 4k\n- `gpt-image-2.5-flare` - 640px, 1k, 2k, 4k\n- `krea-2` - 640px, 1k\n- `nano-banana` - 640px, 1k\n- `nano-banana-2` - 640px, 1k, 2k, 4k\n- `nano-banana-2-lite` - 640px, 1k\n- `nano-banana-pro` - 1k, 2k, 4k\n- `seedream-v4` - 640px, 1k, 2k, 4k\n- `seedream-v5-pro` - 640px, 1k, 2k\n- `z-image-turbo` - 640px, 1k, 2k\n\nNote: Resolution availability depends on the model and your subscription tier.'}, 'image_count': {'type': 'integer', 'example': 1, 'maximum': 16.0, 'minimum': 1.0, 'description': 'Number of images to generate. Maximum varies by model.'}, 'aspect_ratio': {'enum': ['1:1', '16:9', '9:16'], 'type': 'string', 'example': '1:1', 'description': 'The aspect ratio of the output image(s). If not specified, defaults to `1:1` (square).'}}}

{'type': 'object', 'required': ['id', 'credits_charged'], 'properties': {'id': {'type': 'string', 'example': 'cuid-example', 'description': 'Unique ID of the image. Use it with the [Get image Project API](https://docs.magichour.ai/api-reference/image-projects/get-image-details) to fetch status and downloads.'}, 'credits_charged': {'type': 'integer', 'example': 5, 'description': 'The amount of credits deducted from your account to generate the image. We charge credits right when the request is made. \n\nIf an error occurred while generating the image(s), credits will be refunded and this field will be updated to include the refund.'}}, 'description': 'Success'}

{'type': 'object', 'required': ['scale_factor', 'assets'], 'properties': {'name': {'type': 'string', 'default': 'Image Upscaler - dateTime', 'example': 'My Image Upscaler image', 'description': 'Give your image a custom name for easy identification.'}, 'style': {'type': 'object', 'default': {}, 'properties': {'mode': {'enum': ['pro', 'preserve', 'balanced', 'creative'], 'type': 'string', 'example': 'balanced', 'description': 'The upscaling mode. `"preserve"` uses the fast pro pipeline (1Ã\x97 credit multiplier). `"balanced"` and `"creative"` use the creative pipeline (2Ã\x97 credit multiplier). `"pro"` is deprecated and maps to `"preserve"`. Defaults to `"balanced"`.'}, 'prompt': {'type': 'string', 'description': 'A prompt to guide the final image. Only used when mode is `creative`.'}}, 'description': 'Style settings for the upscale. Use `mode` (`"preserve"`, `"balanced"`, or `"creative"`). Defaults to `"balanced"`.'}, 'assets': {'type': 'object', 'required': ['image_file_path'], 'properties': {'image_file_path': {'type': 'string', 'example': 'api-assets/id/1234.png', 'minLength': 1, 'description': 'The image to upscale. This value is either\n- a direct URL to the video file\n- `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).\n\nSee the [file upload guide](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) for details.\n. The maximum input image size is 4096x4096px.'}}, 'description': 'Provide the assets for upscaling'}, 'scale_factor': {'type': 'number', 'example': 2, 'description': 'How much to scale the image. Must be either 2 or 4.\n            \nNote: 4x upscale is only available on Creator, Pro, or Business tier.'}}}

{'type': 'object', 'required': ['id', 'credits_charged'], 'properties': {'id': {'type': 'string', 'example': 'cuid-example', 'description': 'Unique ID of the image. Use it with the [Get image Project API](https://docs.magichour.ai/api-reference/image-projects/get-image-details) to fetch status and downloads.'}, 'credits_charged': {'type': 'integer', 'example': 50, 'description': 'The amount of credits deducted from your account to generate the image. We charge credits right when the request is made. \n\nIf an error occurred while generating the image(s), credits will be refunded and this field will be updated to include the refund.'}}, 'description': 'Success'}

{'type': 'object', 'required': ['style'], 'properties': {'name': {'type': 'string', 'example': 'My Funny Meme', 'description': 'The name of the meme.'}, 'style': {'type': 'object', 'required': ['topic', 'template'], 'properties': {'topic': {'type': 'string', 'example': 'When the code finally works', 'maxLength': 200, 'minLength': 1, 'description': 'The topic of the meme.'}, 'template': {'enum': ['Random', 'Drake Hotline Bling', 'Galaxy Brain', 'Two Buttons', "Gru's Plan", 'Tuxedo Winnie The Pooh', 'Is This a Pigeon', 'Panik Kalm Panik', 'Disappointed Guy', 'Waiting Skeleton', 'Bike Fall', 'Change My Mind', 'Side Eyeing Chloe', 'Woman Yelling at a Cat', 'Success Kid', 'One Does Not Simply', 'Bad Luck Brian', 'Futurama Fry', 'Ancient Aliens', 'Disaster Girl', 'Hide the Pain Harold', 'Distracted Boyfriend', 'Left Exit 12 Off Ramp', 'Running Away Balloon', 'Batman Slapping Robin', 'UNO Draw 25', 'Mocking SpongeBob', 'Boardroom Meeting Suggestion', 'X, X Everywhere', 'Buff Doge vs Cheems', 'Bernie Once Again Asking', 'Roll Safe Think About It', 'Blank Nut Button', 'Epic Handshake', 'Sad Pablo Escobar', 'Inhaling Seagull', 'Surprised Pikachu', 'Always Has Been', 'Scroll of Truth', 'Marked Safe From', "Y'all Got Any More of That", 'Monkey Puppet', 'Oprah You Get A', "They're the Same Picture", "I Bet He's Thinking About Other Women", 'Evil Kermit', 'This Is Fine', "This Is Where I'd Put My Trophy", 'Anakin Padme Four Panel', 'Who Killed Hannibal', 'Clown Applying Makeup', 'Trade Offer', 'Laughing Leo', 'Sleeping Shaq', 'Megamind Peeking', 'Grandma Finds the Internet', 'Doge', 'American Chopper Argument', 'First World Problems', 'Grumpy Cat', 'SpongeBob Ight Imma Head Out', "But That's None of My Business", 'Creepy Condescending Wonka', 'Captain Picard Facepalm', 'Hard to Swallow Pills', 'Bell Curve', 'Absolute Cinema', 'You Guys Are Getting Paid', 'Types of Headaches', 'Mother Ignoring Kid Drowning in a Pool', 'Flex Tape', 'Spiderman Pointing at Spiderman', 'Charlie Conspiracy', 'Pawn Stars Best I Can Do', '0 Days Without', 'Squidward Window', 'Where Monkey', 'Soldier Protecting Sleeping Child', "They Don't Know", 'Spiderman Triple', 'Two Guys on a Bus', 'Imagination SpongeBob', 'All My Homies Hate', "You Know I'm Something of a Scientist Myself", 'Anime Girl Hiding from Terminator', 'A Train Hitting a School Bus', 'AJ Styles and Undertaker', 'Three-Headed Dragon', 'Grant Gustin Over Grave', 'Whisper and Goosebumps', 'Scooby Doo Mask Reveal', 'Domino Effect', 'Two Paths', "I'm the Captain Now", 'Say the Line Bart', 'Star Wars Yoda', 'Grim Reaper Knocking Door', 'Yo Dawg Heard You', 'Gus Fring We Are Not the Same', "C'mon Do Something", 'Leonardo DiCaprio Cheers'], 'type': 'string', 'example': 'Drake Hotline Bling', 'description': 'To use our templates, pass in one of the enum values.'}, 'searchWeb': {'type': 'boolean', 'default': False, 'example': False, 'description': 'Whether to search the web for meme content.'}}}}}

{'type': 'object', 'required': ['id', 'credits_charged'], 'properties': {'id': {'type': 'string', 'example': 'cuid-example', 'description': 'Unique ID of the image. Use it with the [Get image Project API](https://docs.magichour.ai/api-reference/image-projects/get-image-details) to fetch status and downloads.'}, 'credits_charged': {'type': 'integer', 'example': 10, 'description': 'The amount of credits deducted from your account to generate the image. We charge credits right when the request is made. \n\nIf an error occurred while generating the image(s), credits will be refunded and this field will be updated to include the refund.'}}, 'description': 'Success'}

{'type': 'object', 'required': ['content', 'style'], 'properties': {'name': {'type': 'string', 'default': 'Qr Code - dateTime', 'example': 'My Qr Code image', 'description': 'Give your image a custom name for easy identification.'}, 'style': {'type': 'object', 'required': ['art_style'], 'properties': {'art_style': {'type': 'string', 'example': 'Watercolor', 'description': 'To use our templates, pass in one of Watercolor, Cyberpunk City, Ink Landscape, Interior Painting, Japanese Street, Mech, Minecraft, Picasso Painting, Game Map, Spaceship, Chinese Painting, Winter Village, or pass any custom art style.'}}}, 'content': {'type': 'string', 'example': 'https://magichour.ai', 'description': 'The content of the QR code.'}}}

{'type': 'object', 'required': ['id', 'credits_charged'], 'properties': {'id': {'type': 'string', 'example': 'cuid-example', 'description': 'Unique ID of the image. Use it with the [Get image Project API](https://docs.magichour.ai/api-reference/image-projects/get-image-details) to fetch status and downloads.'}, 'credits_charged': {'type': 'integer', 'example': 0, 'description': 'The amount of credits deducted from your account to generate the image. We charge credits right when the request is made. \n\nIf an error occurred while generating the image(s), credits will be refunded and this field will be updated to include the refund.'}}, 'description': 'Success'}

{'type': 'object', 'required': ['start_seconds', 'end_seconds', 'assets'], 'properties': {'name': {'type': 'string', 'default': 'Talking Photo - dateTime', 'example': 'My Talking Photo image', 'description': 'Give your image a custom name for easy identification.'}, 'style': {'type': 'object', 'properties': {'prompt': {'type': 'string', 'description': 'A text prompt to guide the generation. Only applicable when generation_mode is `prompted`.\nThis field is ignored for other modes.'}, 'generation_mode': {'enum': ['realistic', 'prompted', 'pro', 'standard', 'stable', 'expressive'], 'type': 'string', 'default': 'realistic', 'example': 'realistic', 'description': 'Controls overall motion style.\n* `realistic` - Maintains likeness well, high quality, and reliable.\n* `prompted` - Slightly lower likeness; allows option to prompt scene.\n\n**Deprecated values (maintained for backward compatibility):**\n* `pro` - Deprecated: use `realistic`\n* `standard` - Deprecated: use `prompted`\n* `stable` - Deprecated: use `realistic`\n* `expressive` - Deprecated: use `prompted`'}}, 'description': 'Attributes used to dictate the style of the output'}, 'assets': {'type': 'object', 'required': ['image_file_path', 'audio_file_path'], 'properties': {'audio_file_path': {'type': 'string', 'example': 'api-assets/id/1234.mp3', 'minLength': 1, 'description': 'The audio file to sync with the image. This value is either\n- a direct URL to the video file\n- `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).\n\nSee the [file upload guide](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) for details.\n'}, 'image_file_path': {'type': 'string', 'example': 'api-assets/id/1234.png', 'minLength': 1, 'description': 'The source image to animate. This value is either\n- a direct URL to the video file\n- `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).\n\nSee the [file upload guide](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) for details.\n'}}, 'description': 'Provide the assets for creating a talking photo'}, 'end_seconds': {'type': 'number', 'format': 'float', 'example': 15, 'minimum': 0.1, 'description': 'The end time of the input audio in seconds. Maximum clip length depends on style.generation_mode: realistic 300s, prompted 45s.'}, 'start_seconds': {'type': 'number', 'format': 'float', 'example': 0, 'minimum': 0.0, 'description': 'The start time of the input audio in seconds. Maximum clip length depends on style.generation_mode: realistic 300s, prompted 45s.'}, 'max_resolution': {'type': 'integer', 'example': 1024, 'description': "Constrains the larger dimension (height or width) of the output video. Allows you to set a lower resolution than your plan's maximum if desired. The value is capped by your plan's max resolution."}}}

{'type': 'object', 'required': ['id', 'credits_charged'], 'properties': {'id': {'type': 'string', 'example': 'cuid-example', 'description': 'Unique ID of the video. Use it with the [Get video Project API](https://docs.magichour.ai/api-reference/video-projects/get-video-details) to fetch status and downloads.'}, 'credits_charged': {'type': 'integer', 'example': 450, 'description': "The amount of credits deducted from your account to generate the video. If the status is not 'complete', this value is an estimate and may be adjusted upon completion based on the actual FPS of the output video. \n\nIf video generation fails, credits will be refunded, and this field will be updated to include the refund."}}, 'description': 'Success'}

{'type': 'object', 'required': ['end_seconds', 'style', 'assets'], 'properties': {'name': {'type': 'string', 'default': 'Video Editor - dateTime', 'example': 'My Video Editor video', 'description': 'Give your video a custom name for easy identification.'}, 'model': {'enum': ['gemini-omni-1.1', 'gemini-omni', 'ltx-2.5', 'ltx-2.3'], 'type': 'string', 'example': 'gemini-omni-1.1', 'description': 'Editing model. Defaults to LTX 2.5 for free tier and `gemini-omni-1.1` for paid. `gemini-omni` is deprecated; use `gemini-omni-1.1` instead.'}, 'style': {'type': 'object', 'required': ['prompt'], 'properties': {'prompt': {'type': 'string', 'example': 'Change the car color to blue', 'minLength': 1, 'description': 'The prompt used to edit the video.'}}}, 'assets': {'type': 'object', 'required': ['video_file_path'], 'properties': {'video_file_path': {'type': 'string', 'example': 'api-assets/id/1234.mp4', 'minLength': 1, 'description': 'The video to edit. This value is either\n- a direct URL to the video file\n- `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).\n\nSee the [file upload guide](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) for details.\n'}}, 'description': 'Provide the assets for video editing.'}, 'resolution': {'enum': ['480p', '720p', '1080p'], 'type': 'string', 'example': '720p', 'description': 'Output resolution. Defaults to `480p` for free tier and `720p` for paid. `gemini-omni-1.1` and deprecated `gemini-omni` support 720p and 1080p; LTX 2.5 supports 480p, 720p, and 1080p.'}, 'end_seconds': {'type': 'number', 'format': 'float', 'example': 5, 'minimum': 0.1, 'description': 'End time of your clip in seconds. Must be greater than `start_seconds`. Minimum duration depends on model: `gemini-omni-1.1`: 3s, LTX 2.5: 0.5s. Maximum duration depends on model: `gemini-omni-1.1`: 10s, LTX 2.5: 20s.'}, 'start_seconds': {'type': 'number', 'format': 'float', 'default': 0, 'example': 0, 'minimum': 0.0, 'description': 'Start time of your clip (seconds). Must be â\x89¥ 0.'}}}

{'type': 'object', 'required': ['id', 'credits_charged'], 'properties': {'id': {'type': 'string', 'example': 'cuid-example', 'description': 'Unique ID of the video. Use it with the [Get video Project API](https://docs.magichour.ai/api-reference/video-projects/get-video-details) to fetch status and downloads.'}, 'credits_charged': {'type': 'integer', 'example': 450, 'description': "The amount of credits deducted from your account to generate the video. If the status is not 'complete', this value is an estimate and may be adjusted upon completion based on the actual FPS of the output video. \n\nIf video generation fails, credits will be refunded, and this field will be updated to include the refund."}}, 'description': 'Success'}

{'type': 'object', 'required': ['end_seconds', 'target_language', 'assets'], 'properties': {'name': {'type': 'string', 'default': 'Video Translator - dateTime', 'example': 'My Video Translator video', 'description': 'Give your video a custom name for easy identification.'}, 'assets': {'type': 'object', 'required': ['video_file_path'], 'properties': {'video_file_path': {'type': 'string', 'example': 'api-assets/id/1234.mp4', 'minLength': 1, 'description': 'Source video containing the speech to translate. This value is either\n- a direct URL to the video file\n- `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).\n\nSee the [file upload guide](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) for details.\n'}}, 'description': 'Source video for the translation job.'}, 'resolution': {'enum': ['480p', '720p', '1080p'], 'type': 'string', 'example': '720p', 'description': 'Output video resolution. Defaults to 480p. 720p and 1080p require a paid plan.'}, 'end_seconds': {'type': 'number', 'format': 'float', 'example': 15, 'minimum': 0.1, 'description': 'End time of your clip (seconds). Must be greater than start_seconds. The clip must be 1-30 seconds long.'}, 'start_seconds': {'type': 'number', 'format': 'float', 'default': 0, 'example': 0, 'minimum': 0.0, 'description': 'Start time of your clip (seconds). Must be â\x89¥ 0.'}, 'target_language': {'enum': ['English', 'Chinese (Simplified)', 'Hindi', 'Spanish', 'Arabic', 'French', 'Afrikaans', 'Bengali', 'Bulgarian', 'Catalan', 'Croatian', 'Czech', 'Danish', 'Dutch', 'Estonian', 'Finnish', 'German', 'Greek', 'Gujarati', 'Hebrew', 'Hungarian', 'Indonesian', 'Italian', 'Japanese', 'Kannada', 'Kazakh', 'Korean', 'Latvian', 'Lithuanian', 'Malay', 'Malayalam', 'Marathi', 'Norwegian', 'Persian', 'Polish', 'Portuguese', 'Punjabi', 'Romanian', 'Russian', 'Serbian', 'Slovak', 'Slovenian', 'Swahili', 'Swedish', 'Tamil', 'Telugu', 'Thai', 'Chinese (Traditional)', 'Turkish', 'Ukrainian', 'Urdu', 'Vietnamese', 'Welsh'], 'type': 'string', 'example': 'Spanish', 'description': "Language to translate the video's speech into."}}}

{'type': 'object', 'required': ['id', 'credits_charged'], 'properties': {'id': {'type': 'string', 'example': 'cuid-example', 'description': 'Unique ID of the video. Use it with the [Get video Project API](https://docs.magichour.ai/api-reference/video-projects/get-video-details) to fetch status and downloads.'}, 'credits_charged': {'type': 'integer', 'example': 450, 'description': "The amount of credits deducted from your account to generate the video. If the status is not 'complete', this value is an estimate and may be adjusted upon completion based on the actual FPS of the output video. \n\nIf video generation fails, credits will be refunded, and this field will be updated to include the refund."}}, 'description': 'Success'}

{'type': 'object', 'required': ['assets', 'style'], 'properties': {'name': {'type': 'string', 'default': 'Voice Cloner - dateTime', 'example': 'My Voice Cloner audio', 'description': 'Give your audio a custom name for easy identification.'}, 'style': {'type': 'object', 'required': ['prompt'], 'properties': {'prompt': {'type': 'string', 'example': 'Hello, this is my cloned voice.', 'maxLength': 1000, 'minLength': 1, 'description': 'Text used to generate speech from the cloned voice. The character limit is 1000 characters.'}}}, 'assets': {'type': 'object', 'required': ['audio_file_path'], 'properties': {'audio_file_path': {'type': 'string', 'example': 'api-assets/id/1234.mp3', 'minLength': 1, 'description': 'The audio used to clone the voice. This value is either\n- a direct URL to the video file\n- `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).\n\nSee the [file upload guide](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) for details.\n'}}, 'description': 'Provide the assets for voice cloning.'}}}

{'type': 'object', 'required': ['id', 'credits_charged'], 'properties': {'id': {'type': 'string', 'example': 'cuid-example', 'description': 'Unique ID of the audio. Use it with the [Get audio Project API](https://docs.magichour.ai/api-reference/audio-projects/get-audio-details) to fetch status and downloads.'}, 'credits_charged': {'type': 'integer', 'example': 1, 'description': 'The amount of credits deducted from your account to generate the audio. We charge credits right when the request is made. \n\nIf an error occurred while generating the audio, credits will be refunded and this field will be updated to include the refund.'}}, 'description': 'Success'}

{'type': 'object', 'required': ['style'], 'properties': {'name': {'type': 'string', 'default': 'Voice Generator - dateTime', 'example': 'My Voice Generator audio', 'description': 'Give your audio a custom name for easy identification.'}, 'style': {'type': 'object', 'example': {'prompt': 'Hello, how are you?', 'voice_name': 'Elon Musk'}, 'required': ['prompt', 'voice_name'], 'properties': {'prompt': {'type': 'string', 'example': 'Hello, how are you?', 'minLength': 1, 'description': 'Text used to generate speech. The character limit is 1000 characters.'}, 'voice_name': {'enum': ['Elon Musk', 'Mark Zuckerberg', 'Joe Rogan', 'Barack Obama', 'Morgan Freeman', 'Kanye West', 'Donald Trump', 'Joe Biden', 'Kim Kardashian', 'Taylor Swift', 'James Earl Jones', 'Samuel L. Jackson', 'Jeff Goldblum', 'David Attenborough', 'Sean Connery', 'Cillian Murphy', 'Anne Hathaway', 'Julia Roberts', 'Natalie Portman', 'Steve Carell', 'Amy Poehler', 'Stephen Colbert', 'Jimmy Fallon', 'David Letterman', 'Alex Trebek', 'Katy Perry', 'Prince', 'Kevin Bacon', 'Tom Hiddleston', 'Adam Driver', 'Alan Rickman', 'Alexz Johnson', 'Ana Gasteyer', 'Andrew Rannells', 'Arden Cho', 'Bear Grylls', 'Ben McKenzie', 'Ben Stiller', 'Ben Whishaw', 'Billie Joe Armstrong', 'Bingbing Li', 'Booboo Stewart', 'Bradley Steven Perry', 'Bruno Mars', 'Caity Lotz', 'Cameron Boyce', 'Candice Accola', 'Carrie Underwood', 'Casey Affleck', 'Caterina Scorsone', 'Cedric the Entertainer', 'Chace Crawford', 'Chadwick Boseman', 'Charlie Day', 'Chris Hemsworth', 'Chris Martin', 'Christopher Mintz-Plasse', 'Dan Fogler', 'Dan Stevens', 'Daniel Dae Kim', 'Danielle Panabaker', 'Dave Bautista', 'David Schwimmer', 'Denis Leary', 'Derek Mears', 'Diego Luna', 'Donald Glover', 'Donnie Yen', 'Doutzen Kroes', 'Dove Cameron', 'Dr. Dre', 'Drake Bell', 'Elle Fanning', 'Ernie Hudson', 'Fergie', 'Forest Whitaker', 'Francia Raisa', 'Freddie Highmore', 'Gillian Jacobs', 'Gina Carano', 'Ginnifer Goodwin', 'Gordon Ramsay', 'Guy Pearce', 'Gwendoline Christie', 'Hailee Steinfeld', 'Howie Mandel', 'Hugh Jackman', 'Hugh Laurie', 'J. K. Simmons', 'Jack Black', 'Jared Leto', 'Jennifer Carpenter', 'Kesha', 'Kris Jenner', 'Kristen Bell', 'Lorde', 'Matt Smith', 'Marilyn Monroe', 'Charlie Chaplin', 'Albert Einstein', 'Abraham Lincoln', 'John F. Kennedy', 'Lucille Ball', 'A.R. Rahman', 'Aamir Khan', 'Ajay Devgn', 'Akshay Kumar', 'Alain Delon', 'Alan Alda', 'Alan Cumming', 'Amitabh Bachchan', 'Ang Lee', 'Ansel Elgort', 'Anthony Anderson', 'Anthony Mackie', 'Armie Hammer', 'Asa Butterfield', 'B.J. Novak', 'Barbara Eden', 'Betty White', 'Bill Nighy', 'Bill Pullman', 'Blake Shelton', 'Bonnie Wright', 'Brad Paisley', 'Brendan Gleeson', 'Brian Cox', 'Bruno Ganz', 'Burt Reynolds', 'Carrie Fisher', 'Charles Dance', 'Chiwetel Ejiofor', 'Chris Pine', 'Christina Hendricks', 'Christina Ricci', 'Cyndi Lauper', 'Dakota Fanning', 'Damian Lewis', 'Dan Aykroyd', 'Daniel Craig', 'David Oyelowo', 'David Tennant', 'Diane Keaton', 'Diane Kruger', 'Dick Van Dyke', 'Domhnall Gleeson', 'Dominic Cooper', 'Donald Sutherland', 'Drew Carey', 'Eartha Kitt', 'Eddie Izzard', 'Edward Asner', 'Eli Roth', 'Elisabeth Moss', 'Ellen Burstyn', 'Emile Hirsch', 'Ezra Miller', 'Felicity Jones', 'Fiona Shaw', 'Florence Henderson', 'Freida Pinto', 'Geena Davis', 'Gemma Arterton', 'Geri Halliwell', 'Glenn Close', 'Gloria Steinem', 'Greta Gerwig', 'Gugu Mbatha-Raw', 'Hans Zimmer', 'Harry Connick Jr.', 'Harvey Keitel', 'Helena Bonham Carter', 'Henry Cavill', 'Hilary Swank', 'Hugh Bonneville', 'Idina Menzel', 'Imelda Staunton', 'Ingrid Bergman', 'Irrfan Khan', 'Isla Fisher', 'Iwan Rheon', 'Jack Lemmon', 'Janet Jackson', 'Jason Bateman', 'Jason Segel', 'Jennifer Coolidge', 'Johnny Galecki', 'Jon Favreau', 'Joseph Gordon-Levitt', 'Josh Brolin', 'Josh Gad', 'Josh Groban', 'Julia Louis-Dreyfus', 'Kristen Stewart', 'Kristen Wiig', 'Rooney Mara', 'Caitriona Balfe', 'J.J. Abrams', 'Zoe Saldana', 'SpongeBob SquarePants', 'Patrick Star', 'Squidward Tentacles', 'Homer Simpson', 'Bart Simpson', 'Peter Griffin', 'Stewie Griffin', 'Eric Cartman', 'Rick Sanchez', 'Bugs Bunny', 'Mickey Mouse', 'Donald Duck', 'Shrek', 'Donkey (Shrek)', 'Elsa (Frozen)', 'Woody (Toy Story)', 'Buzz Lightyear', 'Scooby-Doo', 'Shaggy Rogers', 'Bender (Futurama)', 'Optimus Prime', 'Batman (Animated)', 'The Joker (Animated)', 'Darth Vader', 'Yoda', 'Gollum Smeagol', 'Gandalf', 'Winnie the Pooh', 'Kermit the Frog', 'Elmo', 'SpiderMan (Tom Holland ver.)', 'Mario', 'Luigi', 'Sonic the Hedgehog', 'Naruto Uzumaki', 'Goku', 'Vegeta', 'Light Yagami', 'Luffy (One Piece)', 'Edward Elric', 'Eren Jaeger', 'Levi Ackerman', 'Tanjiro Kamado', 'All Might', 'GLaDOS', 'Master Chief', 'Kratos', 'Arthur Morgan', 'Geralt of Rivia', "Dwayne 'The Rock' Johnson", 'LeBron James', "Shaquille O'Neal", 'Conor McGregor', 'Mike Tyson', 'Kobe Bryant', 'Floyd Mayweather', 'Cristiano Ronaldo', 'Lionel Messi', 'Serena Williams', 'Tom Brady', 'Stephen Curry', 'John Cena', 'Hulk Hogan', 'Stone Cold Steve Austin', 'The Undertaker', 'Nate Diaz', 'Charles Barkley', 'Shannon Sharpe', 'Drake', 'Rihanna', 'Eminem', 'Snoop Dogg', 'Jay-Z', 'Ed Sheeran', 'Billie Eilish', 'Ariana Grande', 'Adele', 'Post Malone', 'Travis Scott', 'Nicki Minaj', 'Cardi B', 'Doja Cat', 'Bad Bunny', 'Justin Bieber', 'Sabrina Carpenter', 'Chappell Roan', 'Dua Lipa', 'The Weeknd', 'Miley Cyrus', 'Lady Gaga', 'Kendrick Lamar', 'Ozzy Osbourne', 'Freddie Mercury', 'Elvis Presley', 'Bob Marley', 'Frank Sinatra', 'MrBeast', 'PewDiePie', 'Kai Cenat', 'IShowSpeed', 'Markiplier', 'Jacksepticeye', 'KSI', 'Logan Paul', 'Jake Paul', 'Dream (Minecraft)', 'Corpse Husband', 'xQc', 'Pokimane', 'Valkyrae', 'Ninja', 'Joe Scott', 'Linus (LTT)', 'Ryan Reynolds', 'Tom Hanks', 'Robert Downey Jr.', 'Will Smith', 'Denzel Washington', 'Leonardo DiCaprio', 'Brad Pitt', 'Keanu Reeves', 'Nicolas Cage', 'Al Pacino', 'Robert De Niro', 'Arnold Schwarzenegger', 'Sylvester Stallone', 'Vin Diesel', 'Jason Statham', 'Tom Cruise', 'Johnny Depp', 'Scarlett Johansson', 'Angelina Jolie', 'Jennifer Aniston', 'Emma Watson', 'Margot Robbie', 'Sydney Sweeney', 'Zendaya', 'Timothee Chalamet', 'Pedro Pascal', 'Oscar Isaac', 'Benedict Cumberbatch', 'Ian McKellen', 'Patrick Stewart', 'Christopher Walken', 'Matthew McConaughey', 'Harrison Ford', 'Mark Wahlberg', 'Owen Wilson', 'Seth Rogen', 'Kevin Hart', 'Adam Sandler', 'Jim Carrey', 'Eddie Murphy', 'Robin Williams', 'Will Ferrell', 'Melissa McCarthy', 'Awkwafina', 'Jason Momoa', 'Idris Elba', 'Tom Hardy', 'Michael B. Jordan', 'Austin Butler', 'Glen Powell', 'Paul Giamatti', 'Bryan Cranston', 'Bob Odenkirk', 'Vladimir Putin', 'Queen Elizabeth II', 'Winston Churchill', 'Martin Luther King Jr.', 'Kamala Harris', 'Bernie Sanders', 'Alexandria Ocasio-Cortez', 'Narendra Modi', 'Oprah Winfrey', 'Ellen DeGeneres', 'Dr. Phil', 'Steve Harvey', 'Trevor Noah', 'John Oliver', 'James Corden', 'Ryan Seacrest', 'Howard Stern', "Conan O'Brien", 'Seth Meyers', 'Bill Nye', 'Neil deGrasse Tyson', 'Guy Fieri', 'Dave Chappelle', 'Chris Rock', 'Jerry Seinfeld', 'Ali Wong', 'John Mulaney', 'Hasan Minhaj', 'Nikki Glaser', 'Matt Rife', 'Gabriel Iglesias', 'Bo Burnham', 'Jeff Bezos', 'Bill Gates', 'Steve Jobs', 'Tim Cook', 'Sam Altman', 'Jensen Huang', 'Gilbert Gottfried', 'James May', 'Jeremy Clarkson', 'Richard Hammond', 'Bob Ross', 'Anthony Bourdain', 'David Goggins', 'Jordan Peterson', 'Joe Pesci', 'Danny DeVito', 'Seth MacFarlane', 'Patrick Warburton', 'Keith David', 'Mark Hamill', 'Liam Neeson', 'Antonio Banderas', 'Sofia Vergara', 'Penelope Cruz', 'Gal Gadot', 'Cate Blanchett', 'Viola Davis', 'Meryl Streep', 'Sandra Bullock', 'Reese Witherspoon', 'Salma Hayek', "Lupita Nyong'o", 'Florence Pugh', 'Jenna Ortega', 'Ana de Armas', 'Jacob Elordi', 'Barry White', 'Dolly Parton', 'Willie Nelson', 'Lil Wayne', '50 Cent', 'Ice Cube', 'Tupac Shakur', 'Notorious B.I.G.', 'David Bowie', 'Michael Jackson', 'Whitney Houston', 'Amy Winehouse', 'SZA', 'Tyler, The Creator', 'Thanos', 'Tony Stark', 'Captain Jack Sparrow', 'Walter White', 'Tommy Shelby', 'Michael Scott', 'Dwight Schrute', 'Bowser', 'Usain Bolt', 'Tyson Fury', 'Dana White', 'Pat McAfee', 'Giannis Antetokounmpo', 'Lex Fridman', 'Ben Shapiro', 'Tucker Carlson', 'Martha Stewart', 'Gordon Lightfoot', 'Lizzo', 'Megan Thee Stallion', 'Ice Spice', '21 Savage', 'Metro Boomin', 'Jack Harlow', 'Peso Pluma', 'BTS Jungkook', 'Quentin Tarantino', 'Werner Herzog', 'Anderson Cooper', 'Rachel Maddow', 'Mahatma Gandhi', 'Muhammad Ali', 'Princess Diana', 'Nelson Mandela', 'Steve Irwin', 'Morty Smith', 'Andrew Huberman', 'Willem Dafoe', 'Mike Rowe', 'Terminator', 'Deadpool', 'Plankton', 'Mr. Krabs', 'Picard', 'Ludwig', 'Emma Chamberlain', 'Casey Neistat', 'Marques Brownlee', 'Technoblade', 'Shroud', "Charli D'Amelio", 'Khaby Lame', 'Adin Ross', 'Trainwreckstv', 'Hasan Piker', 'Joey Diaz', 'Theo Von', 'Andrew Schulz', 'Bert Kreischer', 'Tom Segura', 'Shane Gillis', 'Joe List', 'Bobby Lee', 'Chris Williamson', 'Destiny', 'Ethan Klein', 'Hila Klein', 'Olivia Rodrigo', 'Gracie Abrams', 'Benson Boone', 'Noah Kahan', 'Zach Bryan', 'Morgan Wallen', 'Luke Combs', 'Chris Stapleton', 'Rauw Alejandro', 'Karol G', 'Feid', 'J Balvin', 'Central Cee', 'Dave (rapper)', 'Stormzy', 'Gunna', 'Future', 'Lil Baby', 'Playboi Carti', 'Don Toliver', 'Lana Del Rey', 'Halsey', 'Charli XCX', 'Tate McRae', 'Conan Gray', 'Troye Sivan', 'Harry Styles', 'Niall Horan', 'Shawn Mendes', 'John Legend', 'Sam Smith', 'Roman Reigns', 'Cody Rhodes', 'Seth Rollins', 'CM Punk', 'Randy Orton', 'Triple H', 'Ric Flair', 'Khabib Nurmagomedov', 'Jon Jones', 'Israel Adesanya', 'Alex Pereira', 'Jorge Masvidal', 'Patrick Mahomes', 'Travis Kelce', 'Aaron Rodgers', 'Kyrie Irving', 'Kevin Durant', 'Luka Doncic', 'Nikola Jokic', 'Simone Biles', 'Novak Djokovic', 'Rafael Nadal', 'Roger Federer', 'Max Verstappen', 'Lewis Hamilton', 'Mark Rober', 'Naval Ravikant', 'Peter Attia', 'Gary Vaynerchuk', 'Alex Hormozi', 'Grant Cardone', 'JD Vance', 'Nancy Pelosi', 'Ron DeSantis', 'Volodymyr Zelenskyy', 'Xi Jinping', 'Justin Trudeau', 'Emmanuel Macron', 'Boris Johnson', 'Rishi Sunak', 'Keir Starmer', 'Tom Holland', 'Anya Taylor-Joy', 'Barry Keoghan', 'Paul Mescal', 'Rachel Zegler', 'Millie Bobby Brown', 'Finn Wolfhard', 'Noah Schnapp', 'Ke Huy Quan', 'Ayo Edebiri', 'Jeremy Allen White', 'Cloud Strife', 'Sephiroth', 'Solid Snake', 'Nathan Drake', 'Joel Miller', 'Ellie Williams', 'Duke Nukem', 'Lara Croft', 'Link (Zelda)', 'Samus Aran', 'Kirby', 'Pikachu', 'Ash Ketchum', 'Agent 47', 'Vergil (DMC)', 'Dante (DMC)', 'Ryu (Street Fighter)', 'Chun-Li', 'Scorpion (Mortal Kombat)', 'Sub-Zero', 'Steve (Minecraft)', 'Herobrine', 'Cortana', 'Aloy', 'Ezio Auditore', 'Altair', 'BJ Blazkowicz', 'Doom Slayer', 'Handsome Jack', 'Tracer (Overwatch)', 'Genji (Overwatch)', 'Reaper (Overwatch)', 'Jinx (Arcane)', 'Vi (Arcane)', 'Nezuko Kamado', 'Zenitsu Agatsuma', 'Gojo Satoru', 'Itadori Yuji', 'Denji (Chainsaw Man)', 'Power (Chainsaw Man)', 'Zoro (One Piece)', 'Nami (One Piece)', 'Sasuke Uchiha', 'Kakashi Hatake', 'Itachi Uchiha', 'Spike Spiegel', 'L (Death Note)', 'Saitama (One Punch Man)', 'Deku (My Hero Academia)', 'Bakugo Katsuki', 'Captain America (MCU)', 'Thor (MCU)', 'Loki (MCU)', 'Wolverine', 'Groot', 'Rocket Raccoon', 'Venom', 'The Mandalorian', 'Baby Yoda (Grogu)', 'Tony Montana (Scarface)', 'John Wick', 'James Bond (Craig era)', 'Ferris Bueller', 'Tyler Durden', 'The Dude (Big Lebowski)', 'Forrest Gump', 'Willy Wonka', 'Freddy Krueger', 'Jason Voorhees', 'Michael Myers', 'Pennywise', 'Hannibal Lecter', 'Family Guy Quagmire', 'Lois Griffin', 'Marge Simpson', 'Lisa Simpson', 'Ned Flanders', 'Krusty the Clown', 'Mr. Burns', 'Timmy Turner', "Dexter (Dexter's Lab)", 'Johnny Bravo', 'Courage the Cowardly Dog', 'Finn the Human', 'Jake the Dog', 'Rick Grimes', 'Negan (Walking Dead)', 'Jesse Pinkman', 'Saul Goodman', 'Tony Soprano', 'Jim Halpert', 'Ron Swanson', 'Barney Stinson', 'Sheldon Cooper', 'Jon Snow', 'Tyrion Lannister', 'Daenerys Targaryen', 'Arya Stark', 'Homelander', 'Billy Butcher', 'Airrack', 'Zach King', 'Dude Perfect Tyler', 'Colleen Ballinger', 'David Dobrik', 'James Charles', 'NikkieTutorials', 'Jeffree Star', 'Danny Duncan', 'FaZe Rug', 'SSSniperWolf', 'Vegetta777', 'Rubius', 'Ibai Llanos', 'Fuerza Regida', 'Grupo Frontera', 'Bizarrap', 'Anitta', 'Rosalia', 'Maluma', 'Ozuna', 'Manuel Turizo', 'Camilo', 'Sam Fender', 'Hozier', 'Fred again', 'GloRilla', 'Sexyy Red', 'Flo Milli', 'Latto', 'Coi Leray', 'Ja Morant', 'Anthony Edwards', 'Victor Wembanyama', 'Caitlin Clark', 'Angel Reese', "Sha'Carri Richardson", 'Erling Haaland', 'Kylian Mbappe', 'Jude Bellingham', 'Neymar', 'Vinicius Junior', 'Shohei Ohtani', 'Connor McDavid', 'Sidney Crosby', 'Steven Crowder', 'Candace Owens', 'Charlie Kirk', 'Matt Walsh', 'Tim Dillon', 'Whitney Cummings', 'Sam Harris', 'Malcolm Gladwell', 'Simon Sinek', 'Mel Robbins', 'Jocko Willink', 'Emma Stone', 'Ryan Gosling', 'Bradley Cooper', 'Christian Bale', 'Joaquin Phoenix', 'Mahershala Ali', 'Jamie Foxx', 'Regina King', 'Taraji P. Henson', 'Octavia Spencer', 'John Boyega', 'Daisy Ridley', 'Jonathan Majors', 'Simu Liu', 'Constance Wu', 'Henry Golding', 'Dev Patel', 'Riz Ahmed', 'Mindy Kaling', 'Aubrey Plaza', 'Aziz Ansari', 'Randall Park', 'Rainbow Dash', 'Twilight Sparkle', 'Gumball Watterson', 'Rigby (Regular Show)', 'Mordecai (Regular Show)', 'Steven Universe', 'Garnet (Steven Universe)', 'Aang (Avatar)', 'Zuko (Avatar)', 'Aretha Franklin', 'Stevie Wonder', 'Ray Charles', 'Johnny Cash', 'Jimi Hendrix', 'Janis Joplin', 'Kurt Cobain', 'Freddie Prinze', 'Selena Gomez', 'Justin Timberlake', 'Usher', 'Chris Brown', 'A$AP Rocky', 'RM (BTS)', 'V (BTS)', 'Jimin', 'Lisa (Blackpink)', 'Jennie (Blackpink)', 'Rose (Blackpink)', 'Calvin Harris', 'David Guetta', 'Marshmello', 'Skrillex', 'Diplo', 'Zedd', 'Jimmy Kimmel', 'Graham Norton', 'Bill Maher', 'Sean Hannity', 'Wolf Blitzer', 'Lester Holt', 'Satya Nadella', 'Sundar Pichai', 'Warren Buffett', 'Sheryl Sandberg', 'Marc Andreessen', 'Peter Thiel', 'Stephen Hawking', 'Carl Sagan', 'Richard Feynman', 'Jane Goodall', 'Franklin D. Roosevelt', 'Ronald Reagan', 'Margaret Thatcher', 'King Charles III', 'Prince Harry', 'Prince William', 'Stephen King', 'J.K. Rowling', 'George R.R. Martin', 'Neil Gaiman', 'Malcolm X', 'Jamie Oliver', 'Tiger Woods', 'Venus Williams', 'David Beckham', 'Michael Phelps', 'Peyton Manning', 'Virat Kohli', 'Sachin Tendulkar', 'MS Dhoni', 'The Rock', 'Rey Mysterio', 'Bray Wyatt', 'Kevin Owens', 'H3H3', 'Philip DeFranco', 'Jenna Marbles', 'Shane Dawson', 'Liza Koshy', 'Lilly Singh', 'Rhett and Link', 'Danny Gonzalez', 'Drew Gooden', 'Cody Ko', 'Kurtis Conner', 'Trisha Paytas', 'Tana Mongeau', 'Jaclyn Hill', 'Bretman Rock', 'Safiya Nygaard', 'Shah Rukh Khan', 'Salman Khan', 'Priyanka Chopra', 'Deepika Padukone', 'Jennifer Lawrence', 'Chris Evans', 'Daniel Radcliffe', 'Rupert Grint', 'Anthony Hopkins', 'Jack Nicholson', 'Clint Eastwood', 'Obi-Wan Kenobi', 'Luke Skywalker', 'Han Solo', 'Princess Leia', 'Emperor Palpatine', 'Kylo Ren', 'C-3PO', 'Frodo Baggins', 'Aragorn', 'Legolas', 'Samwise Gamgee', 'Harry Potter', 'Hermione Granger', 'Ron Weasley', 'Albus Dumbledore', 'Severus Snape', 'Voldemort', 'Hagrid', 'Belle (Beauty and the Beast)', 'Ariel (Little Mermaid)', 'Cinderella', 'Snow White', 'Mulan', 'Rapunzel (Tangled)', 'Fiona (Shrek)', 'Ross Geller', 'Chandler Bing', 'Joey Tribbiani', 'Monica Geller', 'Rachel Green', 'Phoebe Buffay', 'George Costanza', 'Kramer (Seinfeld)', 'Elaine Benes', 'Carlton Banks', 'Hinata Hyuga', 'Ichigo Kurosaki', 'Yoshi', 'Spyro', 'Ryu Hayabusa', 'Leon Kennedy', 'Chris Redfield', 'Jill Valentine', 'Ada Wong', 'Big Boss (MGS)', 'Raiden (MGS)', 'Commander Shepard', 'Garrus Vakarian', 'V (Cyberpunk)', 'Johnny Silverhand', 'Valorant Jett', 'League of Legends Ahri', 'Yasuo (LoL)', 'Superman', 'Wonder Woman', 'Harley Quinn', 'Black Panther', 'Doctor Strange', 'Hulk', 'Black Widow', 'Nick Fury', 'Ant-Man', 'Don Draper', 'Walter Bishop (Fringe)', 'Frank Underwood', 'Dexter Morgan', 'Sherlock Holmes', 'Dr. House', 'Michael Corleone', 'Vito Corleone', 'Daffy Duck', 'Porky Pig', 'Tweety Bird', 'Sylvester the Cat', 'Fred Flintstone', 'Barney Rubble', 'George Jetson', 'Popeye', 'Skip Bayless', 'Stephen A Smith', 'Colin Cowherd', 'Ricky Gervais', 'Bill Burr', 'Sebastian Maniscalco', 'Trevor Wallace', 'Iliza Shlesinger', 'Bruce Springsteen', 'Eric Clapton', 'Mick Jagger', 'Paul McCartney', 'John Lennon', 'Elton John', 'Billy Joel', 'Fleetwood Mac Stevie Nicks', 'Sia', 'Demi Lovato', 'Camila Cabello', 'Enrique Iglesias', 'Ricky Martin', 'Faze Clan Banks', 'Tfue', 'Timthetatman', 'DrLupo', 'CouRage', 'Sykkuno', 'Disguised Toast', 'Fuslie', 'Jerma985', 'Vinesauce Vinny', 'Northernlion', 'Moistcr1tikal', 'Asmongold', 'Mizkif', 'Esfand', 'Quin69', 'Summit1g', 'Sodapoppin', 'Forsen', 'Pestily', 'Joe Budden', 'Charlamagne Tha God', 'Angela Yee', 'Big Boy', 'Zane Lowe', 'Rich Eisen', 'Bill Simmons', 'Dan Le Batard', 'Slash (musician)', 'James Hetfield', 'Dave Grohl', 'Chris Cornell', 'Axl Rose', 'Robert Plant', 'Jon Bon Jovi', 'Chester Bennington', 'Corey Taylor', 'Fernando Alonso', 'Charles Leclerc', 'Daniel Ricciardo', 'Valentino Rossi', 'Marc Marquez', 'Travis Pastrana', 'Tony Hawk', 'Rohit Sharma', 'Babar Azam', 'Ben Stokes', 'Joe Root', 'Anthony Joshua', 'Canelo Alvarez', 'Ronda Rousey', 'Amanda Nunes', 'Bruce Willis', 'Chris Pratt', 'Charlize Theron', 'Nicole Kidman', 'Amy Adams', 'Jamie Lee Curtis', 'Gary Oldman', 'Mark Ruffalo', 'Jeremy Renner', 'Chris Tucker', 'Jonah Hill', 'Ranveer Singh', 'Alia Bhatt', 'Hrithik Roshan', 'Lee Min Ho', 'Song Joong Ki', 'Park Seo Joon', 'Kylie Jenner', 'Khloe Kardashian', 'Paris Hilton', 'Neil Armstrong', 'Buzz Aldrin', 'Yuri Gagarin', 'Killua Zoldyck', 'Gon Freecss', 'Meliodas', 'Natsu Dragneel', 'Lucy Heartfilia', 'Erza Scarlet', 'Inuyasha', 'Kagome Higurashi', 'Yusuke Urameshi', 'Vash the Stampede', 'Alucard (Hellsing)', 'Guts (Berserk)', 'Griffith (Berserk)', 'Reigen Arataka', 'Mob (Mob Psycho 100)', 'Anya Forger', 'Loid Forger', 'Yor Forger', 'Pit (Kid Icarus)', 'Marth (Fire Emblem)', 'Ike (Fire Emblem)', 'Sora (Kingdom Hearts)', 'Riku (Kingdom Hearts)', 'Sam Porter Bridges', 'Big Smoke (GTA)', 'CJ (GTA San Andreas)', 'Niko Bellic', 'Trevor Philips', 'Michael De Santa', 'Franklin Clinton', 'Marcus Fenix', 'Isaac Clarke', 'Ellie (Borderlands)', 'Lilith (Borderlands)', 'Claptrap', 'Widowmaker (Overwatch)', 'Mercy (Overwatch)', 'Reinhardt (Overwatch)', 'Phineas Flynn', 'Doofenshmirtz', 'Blossom (PPG)', 'Bubbles (PPG)', 'Buttercup (PPG)', 'Mojo Jojo', 'Ben Tennyson', 'Danny Phantom', 'Invader Zim', 'GIR (Invader Zim)', 'Sandy Cheeks', 'Ellen Ripley', 'Sarah Connor', 'Indiana Jones', 'Austin Powers', 'Inspector Clouseau', 'Gru (Despicable Me)', 'Alvin (Chipmunks)', 'Megatron', 'Chucky', 'Ghostface (Scream)', 'The Grinch', 'Jack Skellington', 'Jayson Tatum', 'Devin Booker', 'Damian Lillard', 'James Harden', 'Russell Westbrook', 'Joel Embiid', 'Justin Jefferson', 'Josh Allen', 'Joe Burrow', 'Micah Parsons', 'Myles Garrett', 'CeeDee Lamb', 'Burna Boy', 'Wizkid', 'Davido', 'Tems', 'Magnus Carlsen', 'Hikaru Nakamura', 'MrBallen', 'Ned Fulmer', 'Zach Kornfeld', 'Eugene Lee Yang', 'Alton Brown', 'Andrew Rea', 'Steve-O', 'Johnny Knoxville', 'Bam Margera', 'Russell Brand', 'Piers Morgan', 'Douglas Murray', 'Dave Rubin', 'Michael Knowles', 'Vivek Ramaswamy', 'Marjorie Taylor Greene', 'Mitch McConnell', 'Mike Pence', 'Hillary Clinton', 'Bill Clinton', 'George W Bush', 'George H W Bush', 'Jimmy Carter', 'Angela Merkel', 'Tara Strong', 'Tom Kenny', 'Nolan North', 'Troy Baker', 'Jennifer Hale', 'Steve Blum', 'Cersei Lannister', 'Jaime Lannister', 'Sansa Stark', 'Bran Stark', 'The Hound', 'Melisandre', 'Varys', 'Petyr Baelish', 'Ned Stark', 'Gus Fring', 'Mike Ehrmantraut', 'Hank Schrader', 'Skyler White', 'Joy (Inside Out)', 'Sadness (Inside Out)', 'Anger (Inside Out)', 'Mirabel (Encanto)', 'Bruno (Encanto)', 'Remy (Ratatouille)', 'Lightning McQueen', 'Mater (Cars)', 'Wreck-It Ralph', 'Vanellope von Schweetz', 'PointCrow', 'Ranboo', 'Wilbur Soot', 'Tubbo', 'GeorgeNotFound', 'Sapnap', 'Quackity', 'Karl Jacobs', 'Norman Bates', 'Anton Chigurh', 'Patrick Bateman', 'Travis Bickle', 'Rocky Balboa', 'Rambo', 'Maximus (Gladiator)', 'William Wallace', 'King Leonidas', 'Leslie Knope', 'Tom Haverford', 'April Ludgate', 'Andy Dwyer', 'Kevin Malone', 'Creed Bratton', 'Stanley Hudson', 'Toby Flenderson', 'Angela Martin', 'Summer Smith', 'Beth Smith', 'Jerry Smith', 'BoJack Horseman', 'Todd Chavez', 'Princess Carolyn', 'Diane Nguyen', 'Big Mouth Nick', 'Maury (Big Mouth)', 'Archer (Sterling)', 'Lana Kane', 'Malory Archer', 'Fry (Futurama)', 'Leela (Futurama)', 'Professor Farnsworth', 'Zapp Brannigan', 'Beavis', 'Butt-Head', 'King of the Hill Hank Hill', 'Bobby Hill', 'Dale Gribble', 'Stan Marsh', 'Kyle Broflovski', 'Randy Marsh', 'Towelie', 'Butters Stotch', 'Mr. Garrison', 'Chef (South Park)', 'Ike Broflovski', 'Wendy Testaburger', 'PC Principal', 'Jimmy Valmer', 'Michelle Obama', 'Al Gore', 'Desmond Tutu', 'Anthony Fauci', 'Greta Thunberg', 'Malala Yousafzai', 'Grimes', 'Jafar (Aladdin)', 'Ursula (Little Mermaid)', 'Iago (Aladdin parrot)', 'Zazu (Lion King)', "Yzma (Emperor's New Groove)", "Kronk (Emperor's New Groove)", 'Discord (My Little Pony)', 'Skeletor (He-Man)', 'Captain Hook (Peter Pan)', 'Sebastian (Little Mermaid)', 'HAL 9000', 'Mushu (Mulan)', 'Lumiere (Beauty and the Beast)', 'Cogsworth (Beauty and the Beast)', 'Scuttle (Little Mermaid)', 'Rafiki (Lion King)', 'Kristoff (Frozen)', 'Hans (Frozen)', 'Merlin (Sword in the Stone)'], 'type': 'string', 'example': 'Elon Musk', 'description': "The voice to use for the speech. Available voices: Elon Musk, Mark Zuckerberg, Joe Rogan, Barack Obama, Morgan Freeman, Kanye West, Donald Trump, Joe Biden, Kim Kardashian, Taylor Swift, James Earl Jones, Samuel L. Jackson, Jeff Goldblum, David Attenborough, Sean Connery, Cillian Murphy, Anne Hathaway, Julia Roberts, Natalie Portman, Steve Carell, Amy Poehler, Stephen Colbert, Jimmy Fallon, David Letterman, Alex Trebek, Katy Perry, Prince, Kevin Bacon, Tom Hiddleston, Adam Driver, Alan Rickman, Alexz Johnson, Ana Gasteyer, Andrew Rannells, Arden Cho, Bear Grylls, Ben McKenzie, Ben Stiller, Ben Whishaw, Billie Joe Armstrong, Bingbing Li, Booboo Stewart, Bradley Steven Perry, Bruno Mars, Caity Lotz, Cameron Boyce, Candice Accola, Carrie Underwood, Casey Affleck, Caterina Scorsone, Cedric the Entertainer, Chace Crawford, Chadwick Boseman, Charlie Day, Chris Hemsworth, Chris Martin, Christopher Mintz-Plasse, Dan Fogler, Dan Stevens, Daniel Dae Kim, Danielle Panabaker, Dave Bautista, David Schwimmer, Denis Leary, Derek Mears, Diego Luna, Donald Glover, Donnie Yen, Doutzen Kroes, Dove Cameron, Dr. Dre, Drake Bell, Elle Fanning, Ernie Hudson, Fergie, Forest Whitaker, Francia Raisa, Freddie Highmore, Gillian Jacobs, Gina Carano, Ginnifer Goodwin, Gordon Ramsay, Guy Pearce, Gwendoline Christie, Hailee Steinfeld, Howie Mandel, Hugh Jackman, Hugh Laurie, J. K. Simmons, Jack Black, Jared Leto, Jennifer Carpenter, Kesha, Kris Jenner, Kristen Bell, Lorde, Matt Smith, Marilyn Monroe, Charlie Chaplin, Albert Einstein, Abraham Lincoln, John F. Kennedy, Lucille Ball, A.R. Rahman, Aamir Khan, Ajay Devgn, Akshay Kumar, Alain Delon, Alan Alda, Alan Cumming, Amitabh Bachchan, Ang Lee, Ansel Elgort, Anthony Anderson, Anthony Mackie, Armie Hammer, Asa Butterfield, B.J. Novak, Barbara Eden, Betty White, Bill Nighy, Bill Pullman, Blake Shelton, Bonnie Wright, Brad Paisley, Brendan Gleeson, Brian Cox, Bruno Ganz, Burt Reynolds, Carrie Fisher, Charles Dance, Chiwetel Ejiofor, Chris Pine, Christina Hendricks, Christina Ricci, Cyndi Lauper, Dakota Fanning, Damian Lewis, Dan Aykroyd, Daniel Craig, David Oyelowo, David Tennant, Diane Keaton, Diane Kruger, Dick Van Dyke, Domhnall Gleeson, Dominic Cooper, Donald Sutherland, Drew Carey, Eartha Kitt, Eddie Izzard, Edward Asner, Eli Roth, Elisabeth Moss, Ellen Burstyn, Emile Hirsch, Ezra Miller, Felicity Jones, Fiona Shaw, Florence Henderson, Freida Pinto, Geena Davis, Gemma Arterton, Geri Halliwell, Glenn Close, Gloria Steinem, Greta Gerwig, Gugu Mbatha-Raw, Hans Zimmer, Harry Connick Jr., Harvey Keitel, Helena Bonham Carter, Henry Cavill, Hilary Swank, Hugh Bonneville, Idina Menzel, Imelda Staunton, Ingrid Bergman, Irrfan Khan, Isla Fisher, Iwan Rheon, Jack Lemmon, Janet Jackson, Jason Bateman, Jason Segel, Jennifer Coolidge, Johnny Galecki, Jon Favreau, Joseph Gordon-Levitt, Josh Brolin, Josh Gad, Josh Groban, Julia Louis-Dreyfus, Kristen Stewart, Kristen Wiig, Rooney Mara, Caitriona Balfe, J.J. Abrams, Zoe Saldana, SpongeBob SquarePants, Patrick Star, Squidward Tentacles, Homer Simpson, Bart Simpson, Peter Griffin, Stewie Griffin, Eric Cartman, Rick Sanchez, Bugs Bunny, Mickey Mouse, Donald Duck, Shrek, Donkey (Shrek), Elsa (Frozen), Woody (Toy Story), Buzz Lightyear, Scooby-Doo, Shaggy Rogers, Bender (Futurama), Optimus Prime, Batman (Animated), The Joker (Animated), Darth Vader, Yoda, Gollum Smeagol, Gandalf, Winnie the Pooh, Kermit the Frog, Elmo, SpiderMan (Tom Holland ver.), Mario, Luigi, Sonic the Hedgehog, Naruto Uzumaki, Goku, Vegeta, Light Yagami, Luffy (One Piece), Edward Elric, Eren Jaeger, Levi Ackerman, Tanjiro Kamado, All Might, GLaDOS, Master Chief, Kratos, Arthur Morgan, Geralt of Rivia, Dwayne 'The Rock' Johnson, LeBron James, Shaquille O'Neal, Conor McGregor, Mike Tyson, Kobe Bryant, Floyd Mayweather, Cristiano Ronaldo, Lionel Messi, Serena Williams, Tom Brady, Stephen Curry, John Cena, Hulk Hogan, Stone Cold Steve Austin, The Undertaker, Nate Diaz, Charles Barkley, Shannon Sharpe, Drake, Rihanna, Eminem, Snoop Dogg, Jay-Z, Ed Sheeran, Billie Eilish, Ariana Grande, Adele, Post Malone, Travis Scott, Nicki Minaj, Cardi B, Doja Cat, Bad Bunny, Justin Bieber, Sabrina Carpenter, Chappell Roan, Dua Lipa, The Weeknd, Miley Cyrus, Lady Gaga, Kendrick Lamar, Ozzy Osbourne, Freddie Mercury, Elvis Presley, Bob Marley, Frank Sinatra, MrBeast, PewDiePie, Kai Cenat, IShowSpeed, Markiplier, Jacksepticeye, KSI, Logan Paul, Jake Paul, Dream (Minecraft), Corpse Husband, xQc, Pokimane, Valkyrae, Ninja, Joe Scott, Linus (LTT), Ryan Reynolds, Tom Hanks, Robert Downey Jr., Will Smith, Denzel Washington, Leonardo DiCaprio, Brad Pitt, Keanu Reeves, Nicolas Cage, Al Pacino, Robert De Niro, Arnold Schwarzenegger, Sylvester Stallone, Vin Diesel, Jason Statham, Tom Cruise, Johnny Depp, Scarlett Johansson, Angelina Jolie, Jennifer Aniston, Emma Watson, Margot Robbie, Sydney Sweeney, Zendaya, Timothee Chalamet, Pedro Pascal, Oscar Isaac, Benedict Cumberbatch, Ian McKellen, Patrick Stewart, Christopher Walken, Matthew McConaughey, Harrison Ford, Mark Wahlberg, Owen Wilson, Seth Rogen, Kevin Hart, Adam Sandler, Jim Carrey, Eddie Murphy, Robin Williams, Will Ferrell, Melissa McCarthy, Awkwafina, Jason Momoa, Idris Elba, Tom Hardy, Michael B. Jordan, Austin Butler, Glen Powell, Paul Giamatti, Bryan Cranston, Bob Odenkirk, Vladimir Putin, Queen Elizabeth II, Winston Churchill, Martin Luther King Jr., Kamala Harris, Bernie Sanders, Alexandria Ocasio-Cortez, Narendra Modi, Oprah Winfrey, Ellen DeGeneres, Dr. Phil, Steve Harvey, Trevor Noah, John Oliver, James Corden, Ryan Seacrest, Howard Stern, Conan O'Brien, Seth Meyers, Bill Nye, Neil deGrasse Tyson, Guy Fieri, Dave Chappelle, Chris Rock, Jerry Seinfeld, Ali Wong, John Mulaney, Hasan Minhaj, Nikki Glaser, Matt Rife, Gabriel Iglesias, Bo Burnham, Jeff Bezos, Bill Gates, Steve Jobs, Tim Cook, Sam Altman, Jensen Huang, Gilbert Gottfried, James May, Jeremy Clarkson, Richard Hammond, Bob Ross, Anthony Bourdain, David Goggins, Jordan Peterson, Joe Pesci, Danny DeVito, Seth MacFarlane, Patrick Warburton, Keith David, Mark Hamill, Liam Neeson, Antonio Banderas, Sofia Vergara, Penelope Cruz, Gal Gadot, Cate Blanchett, Viola Davis, Meryl Streep, Sandra Bullock, Reese Witherspoon, Salma Hayek, Lupita Nyong'o, Florence Pugh, Jenna Ortega, Ana de Armas, Jacob Elordi, Barry White, Dolly Parton, Willie Nelson, Lil Wayne, 50 Cent, Ice Cube, Tupac Shakur, Notorious B.I.G., David Bowie, Michael Jackson, Whitney Houston, Amy Winehouse, SZA, Tyler, The Creator, Thanos, Tony Stark, Captain Jack Sparrow, Walter White, Tommy Shelby, Michael Scott, Dwight Schrute, Bowser, Usain Bolt, Tyson Fury, Dana White, Pat McAfee, Giannis Antetokounmpo, Lex Fridman, Ben Shapiro, Tucker Carlson, Martha Stewart, Gordon Lightfoot, Lizzo, Megan Thee Stallion, Ice Spice, 21 Savage, Metro Boomin, Jack Harlow, Peso Pluma, BTS Jungkook, Quentin Tarantino, Werner Herzog, Anderson Cooper, Rachel Maddow, Mahatma Gandhi, Muhammad Ali, Princess Diana, Nelson Mandela, Steve Irwin, Morty Smith, Andrew Huberman, Willem Dafoe, Mike Rowe, Terminator, Deadpool, Plankton, Mr. Krabs, Picard, Ludwig, Emma Chamberlain, Casey Neistat, Marques Brownlee, Technoblade, Shroud, Charli D'Amelio, Khaby Lame, Adin Ross, Trainwreckstv, Hasan Piker, Joey Diaz, Theo Von, Andrew Schulz, Bert Kreischer, Tom Segura, Shane Gillis, Joe List, Bobby Lee, Chris Williamson, Destiny, Ethan Klein, Hila Klein, Olivia Rodrigo, Gracie Abrams, Benson Boone, Noah Kahan, Zach Bryan, Morgan Wallen, Luke Combs, Chris Stapleton, Rauw Alejandro, Karol G, Feid, J Balvin, Central Cee, Dave (rapper), Stormzy, Gunna, Future, Lil Baby, Playboi Carti, Don Toliver, Lana Del Rey, Halsey, Charli XCX, Tate McRae, Conan Gray, Troye Sivan, Harry Styles, Niall Horan, Shawn Mendes, John Legend, Sam Smith, Roman Reigns, Cody Rhodes, Seth Rollins, CM Punk, Randy Orton, Triple H, Ric Flair, Khabib Nurmagomedov, Jon Jones, Israel Adesanya, Alex Pereira, Jorge Masvidal, Patrick Mahomes, Travis Kelce, Aaron Rodgers, Kyrie Irving, Kevin Durant, Luka Doncic, Nikola Jokic, Simone Biles, Novak Djokovic, Rafael Nadal, Roger Federer, Max Verstappen, Lewis Hamilton, Mark Rober, Naval Ravikant, Peter Attia, Gary Vaynerchuk, Alex Hormozi, Grant Cardone, JD Vance, Nancy Pelosi, Ron DeSantis, Volodymyr Zelenskyy, Xi Jinping, Justin Trudeau, Emmanuel Macron, Boris Johnson, Rishi Sunak, Keir Starmer, Tom Holland, Anya Taylor-Joy, Barry Keoghan, Paul Mescal, Rachel Zegler, Millie Bobby Brown, Finn Wolfhard, Noah Schnapp, Ke Huy Quan, Ayo Edebiri, Jeremy Allen White, Cloud Strife, Sephiroth, Solid Snake, Nathan Drake, Joel Miller, Ellie Williams, Duke Nukem, Lara Croft, Link (Zelda), Samus Aran, Kirby, Pikachu, Ash Ketchum, Agent 47, Vergil (DMC), Dante (DMC), Ryu (Street Fighter), Chun-Li, Scorpion (Mortal Kombat), Sub-Zero, Steve (Minecraft), Herobrine, Cortana, Aloy, Ezio Auditore, Altair, BJ Blazkowicz, Doom Slayer, Handsome Jack, Tracer (Overwatch), Genji (Overwatch), Reaper (Overwatch), Jinx (Arcane), Vi (Arcane), Nezuko Kamado, Zenitsu Agatsuma, Gojo Satoru, Itadori Yuji, Denji (Chainsaw Man), Power (Chainsaw Man), Zoro (One Piece), Nami (One Piece), Sasuke Uchiha, Kakashi Hatake, Itachi Uchiha, Spike Spiegel, L (Death Note), Saitama (One Punch Man), Deku (My Hero Academia), Bakugo Katsuki, Captain America (MCU), Thor (MCU), Loki (MCU), Wolverine, Groot, Rocket Raccoon, Venom, The Mandalorian, Baby Yoda (Grogu), Tony Montana (Scarface), John Wick, James Bond (Craig era), Ferris Bueller, Tyler Durden, The Dude (Big Lebowski), Forrest Gump, Willy Wonka, Freddy Krueger, Jason Voorhees, Michael Myers, Pennywise, Hannibal Lecter, Family Guy Quagmire, Lois Griffin, Marge Simpson, Lisa Simpson, Ned Flanders, Krusty the Clown, Mr. Burns, Timmy Turner, Dexter (Dexter's Lab), Johnny Bravo, Courage the Cowardly Dog, Finn the Human, Jake the Dog, Rick Grimes, Negan (Walking Dead), Jesse Pinkman, Saul Goodman, Tony Soprano, Jim Halpert, Ron Swanson, Barney Stinson, Sheldon Cooper, Jon Snow, Tyrion Lannister, Daenerys Targaryen, Arya Stark, Homelander, Billy Butcher, Airrack, Zach King, Dude Perfect Tyler, Colleen Ballinger, David Dobrik, James Charles, NikkieTutorials, Jeffree Star, Danny Duncan, FaZe Rug, SSSniperWolf, Vegetta777, Rubius, Ibai Llanos, Fuerza Regida, Grupo Frontera, Bizarrap, Anitta, Rosalia, Maluma, Ozuna, Manuel Turizo, Camilo, Sam Fender, Hozier, Fred again, GloRilla, Sexyy Red, Flo Milli, Latto, Coi Leray, Ja Morant, Anthony Edwards, Victor Wembanyama, Caitlin Clark, Angel Reese, Sha'Carri Richardson, Erling Haaland, Kylian Mbappe, Jude Bellingham, Neymar, Vinicius Junior, Shohei Ohtani, Connor McDavid, Sidney Crosby, Steven Crowder, Candace Owens, Charlie Kirk, Matt Walsh, Tim Dillon, Whitney Cummings, Sam Harris, Malcolm Gladwell, Simon Sinek, Mel Robbins, Jocko Willink, Emma Stone, Ryan Gosling, Bradley Cooper, Christian Bale, Joaquin Phoenix, Mahershala Ali, Jamie Foxx, Regina King, Taraji P. Henson, Octavia Spencer, John Boyega, Daisy Ridley, Jonathan Majors, Simu Liu, Constance Wu, Henry Golding, Dev Patel, Riz Ahmed, Mindy Kaling, Aubrey Plaza, Aziz Ansari, Randall Park, Rainbow Dash, Twilight Sparkle, Gumball Watterson, Rigby (Regular Show), Mordecai (Regular Show), Steven Universe, Garnet (Steven Universe), Aang (Avatar), Zuko (Avatar), Aretha Franklin, Stevie Wonder, Ray Charles, Johnny Cash, Jimi Hendrix, Janis Joplin, Kurt Cobain, Freddie Prinze, Selena Gomez, Justin Timberlake, Usher, Chris Brown, A$AP Rocky, RM (BTS), V (BTS), Jimin, Lisa (Blackpink), Jennie (Blackpink), Rose (Blackpink), Calvin Harris, David Guetta, Marshmello, Skrillex, Diplo, Zedd, Jimmy Kimmel, Graham Norton, Bill Maher, Sean Hannity, Wolf Blitzer, Lester Holt, Satya Nadella, Sundar Pichai, Warren Buffett, Sheryl Sandberg, Marc Andreessen, Peter Thiel, Stephen Hawking, Carl Sagan, Richard Feynman, Jane Goodall, Franklin D. Roosevelt, Ronald Reagan, Margaret Thatcher, King Charles III, Prince Harry, Prince William, Stephen King, J.K. Rowling, George R.R. Martin, Neil Gaiman, Malcolm X, Jamie Oliver, Tiger Woods, Venus Williams, David Beckham, Michael Phelps, Peyton Manning, Virat Kohli, Sachin Tendulkar, MS Dhoni, The Rock, Rey Mysterio, Bray Wyatt, Kevin Owens, H3H3, Philip DeFranco, Jenna Marbles, Shane Dawson, Liza Koshy, Lilly Singh, Rhett and Link, Danny Gonzalez, Drew Gooden, Cody Ko, Kurtis Conner, Trisha Paytas, Tana Mongeau, Jaclyn Hill, Bretman Rock, Safiya Nygaard, Shah Rukh Khan, Salman Khan, Priyanka Chopra, Deepika Padukone, Jennifer Lawrence, Chris Evans, Daniel Radcliffe, Rupert Grint, Anthony Hopkins, Jack Nicholson, Clint Eastwood, Obi-Wan Kenobi, Luke Skywalker, Han Solo, Princess Leia, Emperor Palpatine, Kylo Ren, C-3PO, Frodo Baggins, Aragorn, Legolas, Samwise Gamgee, Harry Potter, Hermione Granger, Ron Weasley, Albus Dumbledore, Severus Snape, Voldemort, Hagrid, Belle (Beauty and the Beast), Ariel (Little Mermaid), Cinderella, Snow White, Mulan, Rapunzel (Tangled), Fiona (Shrek), Ross Geller, Chandler Bing, Joey Tribbiani, Monica Geller, Rachel Green, Phoebe Buffay, George Costanza, Kramer (Seinfeld), Elaine Benes, Carlton Banks, Hinata Hyuga, Ichigo Kurosaki, Yoshi, Spyro, Ryu Hayabusa, Leon Kennedy, Chris Redfield, Jill Valentine, Ada Wong, Big Boss (MGS), Raiden (MGS), Commander Shepard, Garrus Vakarian, V (Cyberpunk), Johnny Silverhand, Valorant Jett, League of Legends Ahri, Yasuo (LoL), Superman, Wonder Woman, Harley Quinn, Black Panther, Doctor Strange, Hulk, Black Widow, Nick Fury, Ant-Man, Don Draper, Walter Bishop (Fringe), Frank Underwood, Dexter Morgan, Sherlock Holmes, Dr. House, Michael Corleone, Vito Corleone, Daffy Duck, Porky Pig, Tweety Bird, Sylvester the Cat, Fred Flintstone, Barney Rubble, George Jetson, Popeye, Skip Bayless, Stephen A Smith, Colin Cowherd, Ricky Gervais, Bill Burr, Sebastian Maniscalco, Trevor Wallace, Iliza Shlesinger, Bruce Springsteen, Eric Clapton, Mick Jagger, Paul McCartney, John Lennon, Elton John, Billy Joel, Fleetwood Mac Stevie Nicks, Sia, Demi Lovato, Camila Cabello, Enrique Iglesias, Ricky Martin, Faze Clan Banks, Tfue, Timthetatman, DrLupo, CouRage, Sykkuno, Disguised Toast, Fuslie, Jerma985, Vinesauce Vinny, Northernlion, Moistcr1tikal, Asmongold, Mizkif, Esfand, Quin69, Summit1g, Sodapoppin, Forsen, Pestily, Joe Budden, Charlamagne Tha God, Angela Yee, Big Boy, Zane Lowe, Rich Eisen, Bill Simmons, Dan Le Batard, Slash (musician), James Hetfield, Dave Grohl, Chris Cornell, Axl Rose, Robert Plant, Jon Bon Jovi, Chester Bennington, Corey Taylor, Fernando Alonso, Charles Leclerc, Daniel Ricciardo, Valentino Rossi, Marc Marquez, Travis Pastrana, Tony Hawk, Rohit Sharma, Babar Azam, Ben Stokes, Joe Root, Anthony Joshua, Canelo Alvarez, Ronda Rousey, Amanda Nunes, Bruce Willis, Chris Pratt, Charlize Theron, Nicole Kidman, Amy Adams, Jamie Lee Curtis, Gary Oldman, Mark Ruffalo, Jeremy Renner, Chris Tucker, Jonah Hill, Ranveer Singh, Alia Bhatt, Hrithik Roshan, Lee Min Ho, Song Joong Ki, Park Seo Joon, Kylie Jenner, Khloe Kardashian, Paris Hilton, Neil Armstrong, Buzz Aldrin, Yuri Gagarin, Killua Zoldyck, Gon Freecss, Meliodas, Natsu Dragneel, Lucy Heartfilia, Erza Scarlet, Inuyasha, Kagome Higurashi, Yusuke Urameshi, Vash the Stampede, Alucard (Hellsing), Guts (Berserk), Griffith (Berserk), Reigen Arataka, Mob (Mob Psycho 100), Anya Forger, Loid Forger, Yor Forger, Pit (Kid Icarus), Marth (Fire Emblem), Ike (Fire Emblem), Sora (Kingdom Hearts), Riku (Kingdom Hearts), Sam Porter Bridges, Big Smoke (GTA), CJ (GTA San Andreas), Niko Bellic, Trevor Philips, Michael De Santa, Franklin Clinton, Marcus Fenix, Isaac Clarke, Ellie (Borderlands), Lilith (Borderlands), Claptrap, Widowmaker (Overwatch), Mercy (Overwatch), Reinhardt (Overwatch), Phineas Flynn, Doofenshmirtz, Blossom (PPG), Bubbles (PPG), Buttercup (PPG), Mojo Jojo, Ben Tennyson, Danny Phantom, Invader Zim, GIR (Invader Zim), Sandy Cheeks, Ellen Ripley, Sarah Connor, Indiana Jones, Austin Powers, Inspector Clouseau, Gru (Despicable Me), Alvin (Chipmunks), Megatron, Chucky, Ghostface (Scream), The Grinch, Jack Skellington, Jayson Tatum, Devin Booker, Damian Lillard, James Harden, Russell Westbrook, Joel Embiid, Justin Jefferson, Josh Allen, Joe Burrow, Micah Parsons, Myles Garrett, CeeDee Lamb, Burna Boy, Wizkid, Davido, Tems, Magnus Carlsen, Hikaru Nakamura, MrBallen, Ned Fulmer, Zach Kornfeld, Eugene Lee Yang, Alton Brown, Andrew Rea, Steve-O, Johnny Knoxville, Bam Margera, Russell Brand, Piers Morgan, Douglas Murray, Dave Rubin, Michael Knowles, Vivek Ramaswamy, Marjorie Taylor Greene, Mitch McConnell, Mike Pence, Hillary Clinton, Bill Clinton, George W Bush, George H W Bush, Jimmy Carter, Angela Merkel, Tara Strong, Tom Kenny, Nolan North, Troy Baker, Jennifer Hale, Steve Blum, Cersei Lannister, Jaime Lannister, Sansa Stark, Bran Stark, The Hound, Melisandre, Varys, Petyr Baelish, Ned Stark, Gus Fring, Mike Ehrmantraut, Hank Schrader, Skyler White, Joy (Inside Out), Sadness (Inside Out), Anger (Inside Out), Mirabel (Encanto), Bruno (Encanto), Remy (Ratatouille), Lightning McQueen, Mater (Cars), Wreck-It Ralph, Vanellope von Schweetz, PointCrow, Ranboo, Wilbur Soot, Tubbo, GeorgeNotFound, Sapnap, Quackity, Karl Jacobs, Norman Bates, Anton Chigurh, Patrick Bateman, Travis Bickle, Rocky Balboa, Rambo, Maximus (Gladiator), William Wallace, King Leonidas, Leslie Knope, Tom Haverford, April Ludgate, Andy Dwyer, Kevin Malone, Creed Bratton, Stanley Hudson, Toby Flenderson, Angela Martin, Summer Smith, Beth Smith, Jerry Smith, BoJack Horseman, Todd Chavez, Princess Carolyn, Diane Nguyen, Big Mouth Nick, Maury (Big Mouth), Archer (Sterling), Lana Kane, Malory Archer, Fry (Futurama), Leela (Futurama), Professor Farnsworth, Zapp Brannigan, Beavis, Butt-Head, King of the Hill Hank Hill, Bobby Hill, Dale Gribble, Stan Marsh, Kyle Broflovski, Randy Marsh, Towelie, Butters Stotch, Mr. Garrison, Chef (South Park), Ike Broflovski, Wendy Testaburger, PC Principal, Jimmy Valmer, Michelle Obama, Al Gore, Desmond Tutu, Anthony Fauci, Greta Thunberg, Malala Yousafzai, Grimes, Jafar (Aladdin), Ursula (Little Mermaid), Iago (Aladdin parrot), Zazu (Lion King), Yzma (Emperor's New Groove), Kronk (Emperor's New Groove), Discord (My Little Pony), Skeletor (He-Man), Captain Hook (Peter Pan), Sebastian (Little Mermaid), HAL 9000, Mushu (Mulan), Lumiere (Beauty and the Beast), Cogsworth (Beauty and the Beast), Scuttle (Little Mermaid), Rafiki (Lion King), Kristoff (Frozen), Hans (Frozen), Merlin (Sword in the Stone)"}}, 'description': 'The content used to generate speech.'}}}

{'type': 'object', 'required': ['id', 'credits_charged'], 'properties': {'id': {'type': 'string', 'example': 'cuid-example', 'description': 'Unique ID of the audio. Use it with the [Get audio Project API](https://docs.magichour.ai/api-reference/audio-projects/get-audio-details) to fetch status and downloads.'}, 'credits_charged': {'type': 'integer', 'example': 1, 'description': 'The amount of credits deducted from your account to generate the audio. We charge credits right when the request is made. \n\nIf an error occurred while generating the audio, credits will be refunded and this field will be updated to include the refund.'}}, 'description': 'Success'}

{'type': 'object', 'required': ['fps', 'end_seconds', 'height', 'width', 'style', 'assets'], 'properties': {'fps': {'type': 'number', 'example': 12, 'minimum': 1.0, 'description': 'The desire output video frame rate'}, 'name': {'type': 'string', 'default': 'Animation - dateTime', 'example': 'My Animation video', 'description': 'Give your video a custom name for easy identification.'}, 'style': {'type': 'object', 'required': ['art_style', 'camera_effect', 'prompt_type', 'transition_speed'], 'properties': {'prompt': {'type': 'string', 'example': 'Cyberpunk city', 'description': 'The prompt used for the video. Prompt is required if `prompt_type` is `custom`. Otherwise this value is ignored'}, 'art_style': {'enum': ['Custom', 'Painterly Illustration', 'Vibrant Matte Illustration', 'Traditional Watercolor', 'Cyberpunk', 'Ink and Watercolor Portrait', 'Intricate Abstract Lines Portrait', '3D Render', 'Old School Comic', 'Bold Colored Illustration', 'Synthwave', 'Minimal Cold Futurism', 'Futuristic Anime', 'Cinematic Miyazaki', 'Studio Ghibli Film Still', 'Soft Delicate Matte Portrait', 'Cinematic Landscape', 'Landscape Painting', 'Photograph', 'Jackson Pollock', 'Cubist', 'Abstract Minimalist', 'Impressionism', 'Van Gogh', 'Woodcut', 'Oil Painting', 'Vintage Japanese Anime', 'Pixar', 'Cosmic', 'Pixel Art', 'Fantasy', 'Arcane', 'Sin City', 'Double Exposure', 'Painted Cityscape', '90s Streets', 'Overgrown', 'Postapocalyptic', 'Spooky', 'Miniatures', 'Low Poly', 'Art Deco', 'Inkpunk', 'Dark Graphic Illustration', 'Dark Watercolor', 'Faded Illustration', 'Directed by AI'], 'type': 'string', 'example': 'Painterly Illustration', 'description': 'The art style used to create the output video'}, 'prompt_type': {'enum': ['custom', 'use_lyrics', 'ai_choose'], 'type': 'string', 'example': 'custom', 'description': '\n* `custom` - Use your own prompt for the video.\n* `use_lyrics` - Use the lyrics of the audio to create the prompt. If this option is selected, then `assets.audio_source` must be `file` or `youtube`.\n* `ai_choose` - Let AI write the prompt. If this option is selected, then `assets.audio_source` must be `file` or `youtube`.'}, 'camera_effect': {'enum': ['Simple Zoom Out', 'Simple Zoom In', 'Bounce Out', 'Spin Bounce', 'Rolling Bounces', 'Rise and Climb', 'Dramatic Zoom In', 'Dramatic Zoom Out', 'Sway Out', 'Boost Zoom In', 'Boost Zoom Out', 'Heartbeat', 'Bounce in Place', 'Earthquake Bounce', 'Slice Bounce', 'Bounce In And Out', 'Jump', 'Road Trip', 'Traverse', 'Rubber Band', 'Rodeo', 'Accelerate', 'Speed of Light', 'Drift Spin', 'Vertigo', 'Cog in the Machine', 'Quadrant', 'Tron', 'Pusher', 'Roll In', 'Hesitate In', 'Zoom In - Audio Sync', 'Pulse - Audio Sync', 'Aggressive Zoom In - Audio Sync', 'Roll In - Audio Sync', 'Zoom Out - Audio Sync', 'Aggressive Zoom Out - Audio Sync', 'Sway Out - Audio Sync', 'Bounce and Spin - Audio Sync', 'Zoom In and Spin - Audio Sync', 'Vertigo - Audio Sync', 'Bounce Out - Audio Sync', 'Earthquake Bounce - Audio Sync', 'Pusher - Audio Sync', 'Evolve - Audio Sync', 'Devolve - Audio Sync', 'Slideshow', 'Pan Left', 'Pan Right', 'Tilt Up', 'Tilt Down', 'Directed by AI'], 'type': 'string', 'example': 'Simple Zoom In', 'description': 'The camera effect used to create the output video'}, 'art_style_custom': {'type': 'string', 'description': 'Describe custom art style. This field is required if `art_style` is `Custom`'}, 'transition_speed': {'type': 'integer', 'example': 5, 'maximum': 10.0, 'minimum': 1.0, 'description': "Change determines how quickly the video's content changes across frames. \n* Higher = more rapid transitions.\n* Lower = more stable visual experience."}}, 'description': 'Defines the style of the output video'}, 'width': {'type': 'integer', 'example': 512, 'minimum': 64.0, 'description': 'The width of the final output video. The maximum width depends on your subscription. Please refer to our [pricing page](https://magichour.ai/pricing) for more details'}, 'assets': {'type': 'object', 'required': ['audio_source'], 'properties': {'youtube_url': {'type': 'string', 'format': 'uri', 'minLength': 1, 'description': 'Using a youtube video as the input source. This field is required if `audio_source` is `youtube`'}, 'audio_source': {'enum': ['none', 'file', 'youtube'], 'type': 'string', 'example': 'file', 'description': "Optionally add an audio source if you'd like to incorporate audio into your video"}, 'audio_file_path': {'type': 'string', 'example': 'api-assets/id/1234.mp3', 'minLength': 1, 'description': 'The path of the input audio. This field is required if `audio_source` is `file`. This value is either\n- a direct URL to the video file\n- `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).\n\nSee the [file upload guide](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) for details.\n'}, 'image_file_path': {'type': 'string', 'example': 'api-assets/id/1234.png', 'minLength': 1, 'description': 'An initial image to use a the first frame of the video. This value is either\n- a direct URL to the video file\n- `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).\n\nSee the [file upload guide](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) for details.\n'}}, 'description': 'Provide the assets for animation.'}, 'height': {'type': 'integer', 'example': 960, 'minimum': 64.0, 'description': 'The height of the final output video. The maximum height depends on your subscription. Please refer to our [pricing page](https://magichour.ai/pricing) for more details'}, 'end_seconds': {'type': 'number', 'format': 'float', 'example': 15, 'minimum': 0.1, 'description': 'This value determines the duration of the output video.'}}}

{'type': 'object', 'required': ['id', 'credits_charged'], 'properties': {'id': {'type': 'string', 'example': 'cuid-example', 'description': 'Unique ID of the video. Use it with the [Get video Project API](https://docs.magichour.ai/api-reference/video-projects/get-video-details) to fetch status and downloads.'}, 'credits_charged': {'type': 'integer', 'example': 450, 'description': "The amount of credits deducted from your account to generate the video. If the status is not 'complete', this value is an estimate and may be adjusted upon completion based on the actual FPS of the output video. \n\nIf video generation fails, credits will be refunded, and this field will be updated to include the refund."}}, 'description': 'Success'}

{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'example': 'cuid-example', 'description': 'Unique ID of the audio project. This value is returned by all of the POST APIs that create an audio.'}}}

{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'example': 'cuid-example', 'description': 'Unique ID of the audio project. This value is returned by all of the POST APIs that create an audio.'}}}

{'type': 'object', 'required': ['id', 'name', 'status', 'type', 'created_at', 'enabled', 'credits_charged', 'downloads', 'error'], 'properties': {'id': {'type': 'string', 'example': 'cuid-example', 'description': 'Unique ID of the audio. Use it with the [Get audio Project API](https://docs.magichour.ai/api-reference/audio-projects/get-audio-details) to fetch status and downloads.'}, 'name': {'type': ['string', 'null'], 'example': 'Example Name', 'description': 'The name of the audio.'}, 'type': {'type': 'string', 'example': 'VOICE_GENERATOR', 'description': 'The type of the audio project. Possible values are AUDIO_TRANSLATOR, VOICE_GENERATOR, VOICE_CHANGER, VOICE_CLONER, VIDEO_TO_AUDIO, MUSIC_GENERATOR, SOUND_EFFECT_GENERATOR'}, 'error': {'type': ['object', 'null'], 'required': ['message', 'code'], 'properties': {'code': {'type': 'string', 'example': 'no_source_face', 'description': 'An error code to indicate why a failure happened.'}, 'message': {'type': 'string', 'example': 'Please use an image with a detectable face', 'description': 'Details on the reason why a failure happened.'}}, 'description': 'In the case of an error, this object will contain the error encountered during video render'}, 'status': {'enum': ['draft', 'queued', 'rendering', 'complete', 'error', 'canceled'], 'type': 'string', 'example': 'complete', 'description': 'The status of the audio.\n\n- `draft` - the project was created but has not been submitted for rendering\n- `queued` - the job is waiting for an available server\n- `rendering` - the job is being processed; the `audio.started` webhook event fires when rendering begins\n- `complete` - the job finished successfully; fires `audio.completed`\n- `error` - the job failed during processing; fires `audio.errored`\n- `canceled` - the job was manually canceled (for example from the Magic Hour web app)\n\n**Note:** `rendering`, `complete`, and `error` have matching webhook events; `canceled` does not - a canceled job emits no webhook event, so poll this endpoint to detect cancellation.'}, 'enabled': {'type': 'boolean', 'description': 'Whether this resource is active. If false, it is deleted.'}, 'downloads': {'type': 'array', 'items': {'type': 'object', 'required': ['url', 'expires_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'example': 'https://videos.magichour.ai/id/output.wav'}, 'expires_at': {'type': 'string', 'format': 'date-time', 'example': '2024-10-19T05:16:19.027Z'}}, 'description': 'The download url and expiration date of the audio project'}}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'credits_charged': {'type': 'integer', 'example': 2, 'description': 'The amount of credits deducted from your account to generate the audio. We charge credits right when the request is made. \n\nIf an error occurred while generating the audio, credits will be refunded and this field will be updated to include the refund.'}}, 'description': 'Success'}

{'type': 'object', 'required': ['end_seconds', 'assets'], 'properties': {'name': {'type': 'string', 'default': 'Audio To Video - dateTime', 'example': 'My Audio To Video video', 'description': 'Give your video a custom name for easy identification.'}, 'style': {'type': 'object', 'properties': {'prompt': {'type': 'string', 'example': 'Car driving through a city', 'description': 'Prompt to guide the visual style of the video.'}}, 'description': 'Attributes used to dictate the style of the output'}, 'assets': {'type': 'object', 'required': ['audio_file_path'], 'properties': {'audio_file_path': {'type': 'string', 'example': 'api-assets/id/1234.mp3', 'minLength': 1, 'description': 'The path of the audio file. This value is either\n- a direct URL to the video file\n- `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).\n\nSee the [file upload guide](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) for details.\n'}, 'image_file_path': {'type': 'string', 'example': 'api-assets/id/1234.png', 'minLength': 1, 'description': 'Reference image for the initial frame of the video. This value is either\n- a direct URL to the video file\n- `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).\n\nSee the [file upload guide](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) for details.\n'}}, 'description': 'Provide the audio file and an optional reference image.'}, 'resolution': {'enum': ['480p', '720p', '1080p'], 'type': 'string', 'example': '720p', 'description': 'Output video resolution. Defaults to `720p` on paid tiers and `480p` on free tiers.'}, 'end_seconds': {'type': 'number', 'format': 'float', 'example': 15, 'minimum': 0.1, 'description': 'End time of your clip (seconds). Must be greater than start_seconds.'}, 'start_seconds': {'type': 'number', 'format': 'float', 'default': 0, 'example': 0, 'minimum': 0.0, 'description': 'Start time of your clip (seconds). Must be â\x89¥ 0.'}}}

{'type': 'object', 'required': ['id', 'credits_charged'], 'properties': {'id': {'type': 'string', 'example': 'cuid-example', 'description': 'Unique ID of the video. Use it with the [Get video Project API](https://docs.magichour.ai/api-reference/video-projects/get-video-details) to fetch status and downloads.'}, 'credits_charged': {'type': 'integer', 'example': 450, 'description': "The amount of credits deducted from your account to generate the video. If the status is not 'complete', this value is an estimate and may be adjusted upon completion based on the actual FPS of the output video. \n\nIf video generation fails, credits will be refunded, and this field will be updated to include the refund."}}, 'description': 'Success'}

{'type': 'object', 'required': ['start_seconds', 'end_seconds', 'assets', 'style'], 'properties': {'name': {'type': 'string', 'default': 'Auto Subtitle - dateTime', 'example': 'My Auto Subtitle video', 'description': 'Give your video a custom name for easy identification.'}, 'style': {'type': 'object', 'properties': {'template': {'enum': ['karaoke', 'cinematic', 'minimalist', 'highlight'], 'type': 'string', 'description': 'Preset subtitle templates. Please visit https://magichour.ai/create/auto-subtitle-generator to see the style of the existing templates.'}, 'custom_config': {'type': 'object', 'properties': {'font': {'type': 'string', 'example': 'Noto Sans', 'description': 'Font name from Google Fonts. Not all fonts support all languages or character sets. \nWe recommend verifying language support and appearance directly on https://fonts.google.com before use.'}, 'font_size': {'type': 'number', 'example': 24, 'description': 'Font size in pixels. If not provided, the font size is automatically calculated based on the video resolution.'}, 'font_style': {'type': 'string', 'example': 'normal', 'description': 'Font style (e.g., normal, italic, bold)'}, 'text_color': {'type': 'string', 'example': '#FFFFFF', 'description': 'Primary text color in hex format'}, 'stroke_color': {'type': 'string', 'example': '#000000', 'description': 'Stroke (outline) color of the text'}, 'stroke_width': {'type': 'number', 'example': 1, 'description': 'Width of the text stroke in pixels. If `stroke_color` is provided, but `stroke_width` is not, the `stroke_width` will be calculated automatically based on the font size.'}, 'vertical_position': {'type': 'string', 'example': 'bottom', 'description': 'Vertical alignment of the text (e.g., top, center, bottom)'}, 'horizontal_position': {'type': 'string', 'example': 'center', 'description': 'Horizontal alignment of the text (e.g., left, center, right)'}, 'highlighted_text_color': {'type': 'string', 'example': '#FFD700', 'description': 'Color used to highlight the current spoken text'}}, 'description': 'Custom subtitle configuration.'}}, 'description': 'Style of the subtitle. At least one of `.style.template` or `.style.custom_config` must be provided. \n* If only `.style.template` is provided, default values for the template will be used.\n* If both are provided, the fields in `.style.custom_config` will be used to overwrite the fields in `.style.template`.\n* If only `.style.custom_config` is provided, then all fields in `.style.custom_config` will be used.\n\nTo use custom config only, the following `custom_config` params are required:\n* `.style.custom_config.font`\n* `.style.custom_config.text_color`\n* `.style.custom_config.vertical_position`\n* `.style.custom_config.horizontal_position`\n'}, 'assets': {'type': 'object', 'required': ['video_file_path'], 'properties': {'video_file_path': {'type': 'string', 'example': 'api-assets/id/1234.mp4', 'minLength': 1, 'description': 'This is the video used to add subtitles. This value is either\n- a direct URL to the video file\n- `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).\n\nSee the [file upload guide](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) for details.\n'}}, 'description': 'Provide the assets for auto subtitle generator'}, 'end_seconds': {'type': 'number', 'format': 'float', 'example': 15, 'minimum': 0.1, 'description': 'End time of your clip (seconds). Must be greater than start_seconds.'}, 'start_seconds': {'type': 'number', 'format': 'float', 'example': 0, 'minimum': 0.0, 'description': 'Start time of your clip (seconds). Must be â\x89¥ 0.'}}}

{'type': 'object', 'required': ['id', 'credits_charged'], 'properties': {'id': {'type': 'string', 'example': 'cuid-example', 'description': 'Unique ID of the video. Use it with the [Get video Project API](https://docs.magichour.ai/api-reference/video-projects/get-video-details) to fetch status and downloads.'}, 'credits_charged': {'type': 'integer', 'example': 450, 'description': "The amount of credits deducted from your account to generate the video. If the status is not 'complete', this value is an estimate and may be adjusted upon completion based on the actual FPS of the output video. \n\nIf video generation fails, credits will be refunded, and this field will be updated to include the refund."}}, 'description': 'Success'}

{'type': 'object', 'required': ['resolution', 'assets'], 'properties': {'name': {'type': 'string', 'default': 'Body Swap - dateTime', 'example': 'My Body Swap image', 'description': 'Give your image a custom name for easy identification.'}, 'assets': {'type': 'object', 'required': ['person_file_path', 'scene_file_path'], 'properties': {'scene_file_path': {'type': 'string', 'example': 'api-assets/id/5678.png', 'minLength': 1, 'description': 'Original scene image (background). This value is either\n- a direct URL to the video file\n- `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).\n\nSee the [file upload guide](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) for details.\n'}, 'person_file_path': {'type': 'string', 'example': 'api-assets/id/1234.png', 'minLength': 1, 'description': 'Image of the person to place into the scene. This value is either\n- a direct URL to the video file\n- `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).\n\nSee the [file upload guide](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) for details.\n'}}, 'description': 'Person image and scene image for body swap'}, 'resolution': {'enum': ['640px', '1k', '2k', '4k'], 'type': 'string', 'example': '1k', 'description': 'Output resolution. Determines credits charged for the run.'}}}

{'type': 'object', 'required': ['id', 'credits_charged'], 'properties': {'id': {'type': 'string', 'example': 'cuid-example', 'description': 'Unique ID of the image. Use it with the [Get image Project API](https://docs.magichour.ai/api-reference/image-projects/get-image-details) to fetch status and downloads.'}, 'credits_charged': {'type': 'integer', 'example': 50, 'description': 'The amount of credits deducted from your account to generate the image. We charge credits right when the request is made. \n\nIf an error occurred while generating the image(s), credits will be refunded and this field will be updated to include the refund.'}}, 'description': 'Success'}

{'type': 'object', 'required': ['end_seconds', 'assets'], 'properties': {'name': {'type': 'string', 'default': 'Character Replace - dateTime', 'example': 'My Character Replace video', 'description': 'Give your video a custom name for easy identification.'}, 'model': {'enum': ['wan-animate', 'kling-3.0'], 'type': 'string', 'default': 'wan-animate', 'example': 'wan-animate', 'description': 'Model to use. Defaults to `wan-animate`.\n\n* **`wan-animate`**: 480p, 720p. Supports `points` subject selection.\n* **`kling-3.0`**: 720p, 1080p. Clips of 3â\x80\x9310 seconds in `replace` mode or 3â\x80\x9330 seconds in `animate` mode. Picks the main person automatically, so `points` are rejected.'}, 'style': {'type': 'object', 'example': {'mode': 'replace', 'selection_mode': 'auto'}, 'properties': {'mode': {'enum': ['replace', 'animate'], 'type': 'string', 'example': 'replace', 'description': 'Processing mode. `replace` swaps the detected subject with your reference character. `animate` transfers motion from the video onto your character image.'}, 'points': {'type': 'array', 'items': {'type': 'object', 'required': ['position_x', 'position_y', 'time_seconds'], 'properties': {'position_x': {'type': 'integer', 'example': 320, 'minimum': 0.0, 'description': 'Horizontal pixel coordinate in the source video frame at `time_seconds`, measured from the left edge.'}, 'position_y': {'type': 'integer', 'example': 180, 'minimum': 0.0, 'description': 'Vertical pixel coordinate in the source video frame at `time_seconds`, measured from the top edge.'}, 'time_seconds': {'type': 'number', 'format': 'float', 'example': 2.5, 'minimum': 0.0, 'description': 'Timestamp on the source video timeline in seconds. Uses the same clock as `start_seconds` and `end_seconds`.'}}}, 'description': 'On-frame markers for manual subject selection. Required when `selection_mode` is `point`. Ignored when `selection_mode` is `auto` or omitted. Rejected for models without subject selection (supported by `wan-animate`).'}, 'selection_mode': {'enum': ['auto', 'point'], 'type': 'string', 'example': 'auto', 'description': 'How to locate the subject in the source video. `auto` detects a person automatically. `point` uses your `points` to mark the subject and is supported by `wan-animate`. Defaults to `auto`.'}}, 'description': 'Optional style controls for replace vs animate mode and subject selection.'}, 'assets': {'type': 'object', 'required': ['video_file_path', 'image_file_path'], 'properties': {'image_file_path': {'type': 'string', 'example': 'api-assets/id/5678.png', 'minLength': 1, 'description': 'Reference character image used as the replacement or animation target. This value is either\n- a direct URL to the video file\n- `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).\n\nSee the [file upload guide](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) for details.\n'}, 'video_file_path': {'type': 'string', 'example': 'api-assets/id/1234.mp4', 'minLength': 1, 'description': 'Source video containing the subject to replace or animate. This value is either\n- a direct URL to the video file\n- `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).\n\nSee the [file upload guide](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) for details.\n'}}, 'description': 'Source video and reference character image for the job.'}, 'resolution': {'enum': ['480p', '720p', '1080p'], 'type': 'string', 'example': '720p', 'description': 'Output video resolution. Must be supported by `model`. Defaults to the lowest resolution available on your plan for that model.'}, 'end_seconds': {'type': 'number', 'format': 'float', 'example': 15, 'minimum': 0.1, 'description': 'End time of your clip (seconds). Must be greater than start_seconds.'}, 'start_seconds': {'type': 'number', 'format': 'float', 'default': 0, 'example': 0, 'minimum': 0.0, 'description': 'Start time of your clip (seconds). Must be â\x89¥ 0.'}}}

{'type': 'object', 'required': ['id', 'credits_charged'], 'properties': {'id': {'type': 'string', 'example': 'cuid-example', 'description': 'Unique ID of the video. Use it with the [Get video Project API](https://docs.magichour.ai/api-reference/video-projects/get-video-details) to fetch status and downloads.'}, 'credits_charged': {'type': 'integer', 'example': 450, 'description': "The amount of credits deducted from your account to generate the video. If the status is not 'complete', this value is an estimate and may be adjusted upon completion based on the actual FPS of the output video. \n\nIf video generation fails, credits will be refunded, and this field will be updated to include the refund."}}, 'description': 'Success'}

{'type': 'object', 'required': ['assets'], 'properties': {'assets': {'type': 'object', 'required': ['target_file_path'], 'properties': {'target_file_path': {'type': 'string', 'example': 'api-assets/id/1234.png', 'description': 'This is the image or video where the face will be detected. This value is either\n- a direct URL to the video file\n- `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).\n\nSee the [file upload guide](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) for details.\n'}}, 'description': 'Provide the assets for face detection'}, 'confidence_score': {'type': 'number', 'default': 0.5, 'example': 0.5, 'maximum': 1.0, 'minimum': 0.0, 'multipleOf': 0.05, 'description': 'Confidence threshold for filtering detected faces. \n* Higher values (e.g., 0.9) include only faces detected with high certainty, reducing false positives. \n* Lower values (e.g., 0.3) include more faces, but may increase the chance of incorrect detections.'}}}

{'type': 'object', 'required': ['id', 'credits_charged'], 'properties': {'id': {'type': 'string', 'example': 'uuid-example', 'description': 'The id of the task. Use this value in the [get face detection details API](https://docs.magichour.ai/api-reference/files/get-face-detection-details) to get the details of the face detection task.'}, 'credits_charged': {'type': 'integer', 'description': 'The credits charged for the task.'}}}

{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'example': 'uuid-example', 'description': 'The id of the task. This value is returned by the [face detection API](https://docs.magichour.ai/api-reference/files/face-detection#response-id).'}}}

{'type': 'object', 'required': ['id', 'credits_charged', 'status', 'faces'], 'properties': {'id': {'type': 'string', 'example': 'uuid-example', 'description': 'The id of the task. This value is returned by the [face detection API](https://docs.magichour.ai/api-reference/files/face-detection#response-id).'}, 'faces': {'type': 'array', 'items': {'type': 'object', 'required': ['path', 'url'], 'properties': {'url': {'type': 'string', 'example': 'https://videos.magichour.ai/api-assets/id/0-0.png', 'description': 'The url to the face image. This is used to render the image in your applications.'}, 'path': {'type': 'string', 'example': 'api-assets/id/0-0.png', 'description': 'The path to the face image. This should be used in face swap photo/video API calls as `.assets.face_mappings.original_face`'}}}, 'example': [{'url': 'https://videos.magichour.ai/api-assets/id/0-0.png', 'path': 'api-assets/id/0-0.png'}], 'description': 'The faces detected in the image or video. The list is populated as faces are detected.'}, 'status': {'enum': ['queued', 'rendering', 'complete', 'error'], 'type': 'string', 'example': 'complete', 'description': 'The status of the detection.'}, 'credits_charged': {'type': 'integer', 'example': 0, 'description': 'The credits charged for the task.'}}}

{'type': 'object', 'required': ['start_seconds', 'end_seconds', 'assets'], 'properties': {'name': {'type': 'string', 'default': 'Face Swap - dateTime', 'example': 'My Face Swap video', 'description': 'Give your video a custom name for easy identification.'}, 'style': {'type': 'object', 'example': {'version': 'default'}, 'properties': {'version': {'enum': ['v1', 'v2', 'default'], 'type': 'string', 'example': 'default', 'description': '* `v1` - May preserve skin detail and texture better, but weaker identity preservation.\n* `v2` - Faster, sharper, better handling of hair and glasses. stronger identity preservation.\n* `default` - Use the version we recommend, which will change over time. This is recommended unless you need a specific earlier version. This is the default behavior.'}}, 'description': 'Style of the face swap video.'}, 'assets': {'type': 'object', 'required': ['video_source'], 'properties': {'youtube_url': {'type': 'string', 'format': 'uri', 'description': 'YouTube URL (required if `video_source` is `youtube`).'}, 'video_source': {'enum': ['file', 'youtube'], 'type': 'string', 'example': 'file', 'description': 'Choose your video source.'}, 'face_mappings': {'type': 'array', 'items': {'type': 'object', 'required': ['original_face', 'new_face'], 'properties': {'new_face': {'type': 'string', 'example': 'api-assets/id/1234.png', 'description': 'The face image that will be used to replace the face in the `original_face`. This value is either\n- a direct URL to the video file\n- `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).\n\nSee the [file upload guide](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) for details.\n'}, 'original_face': {'type': 'string', 'example': 'api-assets/id/0-0.png', 'description': 'The face detected from the image in `target_file_path`. The file name is in the format of `<face_frame>-<face_index>.png`. This value is corresponds to the response in the [face detection API](https://docs.magichour.ai/api-reference/files/get-face-detection-details).\n\n* The face_frame is the frame number of the face in the target image. For images, the frame number is always 0.\n* The face_index is the index of the face in the target image, starting from 0 going left to right.'}}}, 'example': [{'new_face': 'api-assets/id/1234.png', 'original_face': 'api-assets/id/0-0.png'}], 'maxItems': 5, 'description': 'This is the array of face mappings used for multiple face swap. The value is required if `face_swap_mode` is `individual-faces`.'}, 'face_swap_mode': {'enum': ['all-faces', 'individual-faces'], 'type': 'string', 'default': 'all-faces', 'example': 'all-faces', 'description': 'Choose how to swap faces:\n- **all-faces** (recommended) â\x80\x94 swap all detected faces using one source image (`source_file_path` required)\n- **individual-faces** â\x80\x94 specify exact mappings using `face_mappings`'}, 'image_file_path': {'type': 'string', 'example': 'image/id/1234.png', 'description': 'The path of the input image with the face to be swapped.  The value is required if `face_swap_mode` is `all-faces`.\n\nThis value is either\n- a direct URL to the video file\n- `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).\n\nSee the [file upload guide](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) for details.\n'}, 'video_file_path': {'type': 'string', 'example': 'api-assets/id/1234.mp4', 'description': 'Your video file. Required if `video_source` is `file`. This value is either\n- a direct URL to the video file\n- `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).\n\nSee the [file upload guide](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) for details.\n'}}, 'description': 'Provide the assets for face swap. For video, The `video_source` field determines whether `video_file_path` or `youtube_url` field is used'}, 'end_seconds': {'type': 'number', 'format': 'float', 'example': 15, 'minimum': 0.1, 'description': 'End time of your clip (seconds). Must be greater than start_seconds.'}, 'start_seconds': {'type': 'number', 'format': 'float', 'example': 0, 'minimum': 0.0, 'description': 'Start time of your clip (seconds). Must be â\x89¥ 0.'}}}

{'type': 'object', 'required': ['id', 'credits_charged'], 'properties': {'id': {'type': 'string', 'example': 'cuid-example', 'description': 'Unique ID of the video. Use it with the [Get video Project API](https://docs.magichour.ai/api-reference/video-projects/get-video-details) to fetch status and downloads.'}, 'credits_charged': {'type': 'integer', 'example': 450, 'description': "The amount of credits deducted from your account to generate the video. If the status is not 'complete', this value is an estimate and may be adjusted upon completion based on the actual FPS of the output video. \n\nIf video generation fails, credits will be refunded, and this field will be updated to include the refund."}}, 'description': 'Success'}

{'type': 'object', 'required': ['assets'], 'properties': {'name': {'type': 'string', 'default': 'Face Swap - dateTime', 'example': 'My Face Swap image', 'description': 'Give your image a custom name for easy identification.'}, 'assets': {'type': 'object', 'required': ['target_file_path'], 'properties': {'face_mappings': {'type': 'array', 'items': {'type': 'object', 'required': ['original_face', 'new_face'], 'properties': {'new_face': {'type': 'string', 'example': 'api-assets/id/1234.png', 'description': 'The face image that will be used to replace the face in the `original_face`. This value is either\n- a direct URL to the video file\n- `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).\n\nSee the [file upload guide](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) for details.\n'}, 'original_face': {'type': 'string', 'example': 'api-assets/id/0-0.png', 'description': 'The face detected from the image in `target_file_path`. The file name is in the format of `<face_frame>-<face_index>.png`. This value is corresponds to the response in the [face detection API](https://docs.magichour.ai/api-reference/files/get-face-detection-details).\n\n* The face_frame is the frame number of the face in the target image. For images, the frame number is always 0.\n* The face_index is the index of the face in the target image, starting from 0 going left to right.'}}}, 'example': [{'new_face': 'api-assets/id/1234.png', 'original_face': 'api-assets/id/0-0.png'}], 'maxItems': 5, 'description': 'This is the array of face mappings used for multiple face swap. The value is required if `face_swap_mode` is `individual-faces`.'}, 'face_swap_mode': {'enum': ['all-faces', 'individual-faces'], 'type': 'string', 'default': 'all-faces', 'example': 'all-faces', 'description': 'Choose how to swap faces:\n- **all-faces** (recommended) â\x80\x94 swap all detected faces using one source image (`source_file_path` required)\n- **individual-faces** â\x80\x94 specify exact mappings using `face_mappings`'}, 'source_file_path': {'type': 'string', 'example': 'api-assets/id/1234.png', 'minLength': 1, 'description': 'This is the image from which the face is extracted. The value is required if `face_swap_mode` is `all-faces`.\n\nThis value is either\n- a direct URL to the video file\n- `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).\n\nSee the [file upload guide](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) for details.\n'}, 'target_file_path': {'type': 'string', 'example': 'api-assets/id/1234.png', 'minLength': 1, 'description': 'This is the image where the face from the source image will be placed. This value is either\n- a direct URL to the video file\n- `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).\n\nSee the [file upload guide](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) for details.\n'}}, 'description': 'Provide the assets for face swap photo'}}}

{'type': 'object', 'required': ['id', 'credits_charged'], 'properties': {'id': {'type': 'string', 'example': 'cuid-example', 'description': 'Unique ID of the image. Use it with the [Get image Project API](https://docs.magichour.ai/api-reference/image-projects/get-image-details) to fetch status and downloads.'}, 'credits_charged': {'type': 'integer', 'example': 10, 'description': 'The amount of credits deducted from your account to generate the image. We charge credits right when the request is made. \n\nIf an error occurred while generating the image(s), credits will be refunded and this field will be updated to include the refund.'}}, 'description': 'Success'}

{'type': 'object', 'required': ['download_url'], 'properties': {'max_bytes': {'type': 'integer', 'default': 15728640}, 'download_url': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['download_url'], 'properties': {'max_bytes': {'type': 'integer', 'default': 15728640}, 'download_url': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['download_url'], 'properties': {'max_bytes': {'type': 'integer', 'default': 15728640}, 'download_url': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['assets'], 'properties': {'name': {'type': 'string', 'default': 'Head Swap - dateTime', 'example': 'My Head Swap image', 'description': 'Give your image a custom name for easy identification.'}, 'assets': {'type': 'object', 'required': ['body_file_path', 'head_file_path'], 'properties': {'body_file_path': {'type': 'string', 'example': 'api-assets/id/1234.png', 'minLength': 1, 'description': 'Image that receives the swapped head. This value is either\n- a direct URL to the video file\n- `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).\n\nSee the [file upload guide](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) for details.\n'}, 'head_file_path': {'type': 'string', 'example': 'api-assets/id/5678.png', 'minLength': 1, 'description': 'Image of the head to place on the body. This value is either\n- a direct URL to the video file\n- `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).\n\nSee the [file upload guide](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) for details.\n'}}, 'description': 'Provide the body and head images for head swap'}, 'max_resolution': {'type': 'integer', 'example': 1024, 'description': "Constrains the larger dimension (height or width) of the output. Omit to use the maximum allowed for your plan (capped at 2048px). Values above your plan maximum are clamped down to your plan's maximum."}}}

{'type': 'object', 'required': ['id', 'credits_charged'], 'properties': {'id': {'type': 'string', 'example': 'cuid-example', 'description': 'Unique ID of the image. Use it with the [Get image Project API](https://docs.magichour.ai/api-reference/image-projects/get-image-details) to fetch status and downloads.'}, 'credits_charged': {'type': 'integer', 'example': 10, 'description': 'The amount of credits deducted from your account to generate the image. We charge credits right when the request is made. \n\nIf an error occurred while generating the image(s), credits will be refunded and this field will be updated to include the refund.'}}, 'description': 'Success'}

{'type': 'object', 'required': ['assets'], 'properties': {'name': {'type': 'string', 'default': 'Background Remover - dateTime', 'example': 'My Background Remover image', 'description': 'Give your image a custom name for easy identification.'}, 'assets': {'type': 'object', 'required': ['image_file_path'], 'properties': {'image_file_path': {'type': 'string', 'example': 'api-assets/id/1234.png', 'description': 'The image to remove the background. This value is either\n- a direct URL to the video file\n- `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).\n\nSee the [file upload guide](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) for details.\n'}, 'background_image_file_path': {'type': 'string', 'example': 'api-assets/id/1234.png', 'description': 'The image used as the new background for the image_file_path. This image will be resized to match the image in image_file_path. Please make sure the resolution between the images are similar.\n\nThis value is either\n- a direct URL to the video file\n- `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).\n\nSee the [file upload guide](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) for details.\n'}}, 'description': 'Provide the assets for background removal'}}}

{'type': 'object', 'required': ['id', 'credits_charged'], 'properties': {'id': {'type': 'string', 'example': 'cuid-example', 'description': 'Unique ID of the image. Use it with the [Get image Project API](https://docs.magichour.ai/api-reference/image-projects/get-image-details) to fetch status and downloads.'}, 'credits_charged': {'type': 'integer', 'example': 5, 'description': 'The amount of credits deducted from your account to generate the image. We charge credits right when the request is made. \n\nIf an error occurred while generating the image(s), credits will be refunded and this field will be updated to include the refund.'}}, 'description': 'Success'}

{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'example': 'cuid-example', 'description': 'Unique ID of the image project. This value is returned by all of the POST APIs that create an image.'}}}

{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'example': 'cuid-example', 'description': 'Unique ID of the image project. This value is returned by all of the POST APIs that create an image.'}}}

{'type': 'object', 'required': ['id', 'name', 'status', 'image_count', 'type', 'created_at', 'enabled', 'credits_charged', 'downloads', 'error'], 'properties': {'id': {'type': 'string', 'example': 'cuid-example', 'description': 'Unique ID of the image. Use it with the [Get image Project API](https://docs.magichour.ai/api-reference/image-projects/get-image-details) to fetch status and downloads.'}, 'name': {'type': ['string', 'null'], 'example': 'Example Name', 'description': 'The name of the image.'}, 'type': {'type': 'string', 'example': 'AI_IMAGE', 'description': 'The type of the image project. Possible values are FACE_EDITOR, AI_IMAGE_EDITOR, GENERATIVE_FILL, AI_SELFIE, AI_HEADSHOT, AI_INFLUENCER, AI_IMAGE, AI_MEME, CLOTHES_CHANGER, BACKGROUND_REMOVER, FACE_SWAP, IMAGE_UPSCALER, IMAGE_ENHANCER, AI_GIF, QR_CODE, PHOTO_EDITOR, PHOTO_COLORIZER, IMAGE_COLOR_GRADER, HEAD_SWAP, BODY_SWAP, STORYBOARD, IMAGE_EXPANDER'}, 'error': {'type': ['object', 'null'], 'required': ['message', 'code'], 'properties': {'code': {'type': 'string', 'example': 'no_source_face', 'description': 'An error code to indicate why a failure happened.'}, 'message': {'type': 'string', 'example': 'Please use an image with a detectable face', 'description': 'Details on the reason why a failure happened.'}}, 'description': 'In the case of an error, this object will contain the error encountered during video render'}, 'status': {'enum': ['draft', 'queued', 'rendering', 'complete', 'error', 'canceled'], 'type': 'string', 'example': 'complete', 'description': 'The status of the image.\n\n- `draft` - the project was created but has not been submitted for rendering\n- `queued` - the job is waiting for an available server\n- `rendering` - the job is being processed; the `image.started` webhook event fires when rendering begins\n- `complete` - the job finished successfully; fires `image.completed`\n- `error` - the job failed during processing; fires `image.errored`\n- `canceled` - the job was manually canceled (for example from the Magic Hour web app)\n\n**Note:** `rendering`, `complete`, and `error` have matching webhook events; `canceled` does not - a canceled job emits no webhook event, so poll this endpoint to detect cancellation.'}, 'enabled': {'type': 'boolean', 'description': 'Whether this resource is active. If false, it is deleted.'}, 'downloads': {'type': 'array', 'items': {'type': 'object', 'required': ['url', 'expires_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'example': 'https://videos.magichour.ai/id/output.png'}, 'expires_at': {'type': 'string', 'format': 'date-time', 'example': '2024-10-19T05:16:19.027Z'}}, 'description': 'The download url and expiration date of the image project'}}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'image_count': {'type': 'integer', 'example': 1, 'description': 'Number of images generated'}, 'credits_charged': {'type': 'integer', 'example': 5, 'description': 'The amount of credits deducted from your account to generate the image. We charge credits right when the request is made. \n\nIf an error occurred while generating the image(s), credits will be refunded and this field will be updated to include the refund.'}}, 'description': 'Success'}

{'type': 'object', 'required': ['end_seconds', 'assets'], 'properties': {'name': {'type': 'string', 'default': 'Image To Video - dateTime', 'example': 'My Image To Video video', 'description': 'Give your video a custom name for easy identification.'}, 'audio': {'type': 'boolean', 'example': True, 'description': 'Whether to include audio in the video. Defaults to `false` if not specified.\n\nAudio support varies by model:\n* **`gemini-omni-1.1`**: Not supported\n* **`kling-2.6`**: Not supported\n* **`kling-3.0`**: Toggle-able: audio adds extra credits when enabled\n* **`ltx-2.5`**: Toggle-able: no additional credits for audio\n* **`minimax-h3`**: Toggle-able: no additional credits for audio\n* **`seedance-1.5`**: Toggle-able: audio adds extra credits when enabled\n* **`seedance-2.0`**: Toggle-able: no additional credits for audio\n* **`seedance-2.0-mini`**: Toggle-able: no additional credits for audio\n* **`seedance-2.5`**: Toggle-able: no additional credits for audio\n* **`veo3.1`**: Toggle-able: audio adds extra credits when enabled\n* **`veo3.1-lite`**: Toggle-able: audio adds extra credits when enabled\n* **`wan-2.2`**: Not supported\n* **`wan-3.0`**: Toggle-able: no additional credits for audio\n'}, 'model': {'enum': ['default', 'kling-3.0', 'ltx-2.5', 'seedance-2.0-mini', 'wan-3.0', 'seedance-2.5', 'gemini-omni-1.1', 'minimax-h3', 'wan-2.2', 'seedance-1.5', 'seedance-2.0', 'veo3.1-lite', 'sora-2', 'veo3.1', 'kling-2.6', 'ltx-2.3', 'ltx-2', 'kling-2.5', 'kling-1.6', 'seedance', 'kling-2.5-audio', 'veo3.1-audio'], 'type': 'string', 'default': 'default', 'example': 'kling-3.0', 'description': 'The AI model to use for video generation.\n\n* `default`: uses our currently recommended model for general use. For paid tiers, defaults to `kling-3.0`. For free tiers, it defaults to `ltx-2.5`.\n* `gemini-omni-1.1`: Best for precise short clips, first/last frames, and high-resolution output.\n* `kling-2.6`: Best for action, motion blur, and controlled camera moves.\n* `kling-3.0`: Best for cinematic stories, references, and optional audio.\n* `ltx-2.5`: Fastest for general scenes, long clips, audio, and rapid iteration.\n* `minimax-h3`: Great for reference-driven clips with native audio and longer durations.\n* `seedance-1.5`: Best for smooth, consistent motion with an end frame.\n* `seedance-2.0`: Best for reference-led clips with precise subject control.\n* `seedance-2.0-mini`: Faster reference-led clips with consistent motion and audio.\n* `seedance-2.5`: Best for premium realism, detail, and natural motion.\n* `veo3.1`: Best for romantic interactions and expressive action, with realistic detail.\n* `veo3.1-lite`: Balanced realism and audio at a lower cost than Veo 3.1.\n* `wan-2.2`: Best for physical motion, action, and camera movement.\n* `wan-3.0`: High-quality video with native audio, long clips, and end-frame control.\n\nIf you specify the deprecated model value that includes the `-audio` suffix, this will be the same as included `audio` as `true`.'}, 'style': {'type': 'object', 'properties': {'prompt': {'type': 'string', 'example': 'a dog running', 'description': 'The prompt used for the video.'}}, 'description': 'Attributed used to dictate the style of the output'}, 'assets': {'type': 'object', 'required': ['image_file_path'], 'properties': {'image_file_path': {'type': 'string', 'example': 'api-assets/id/1234.png', 'minLength': 1, 'description': 'The path of the image file. This value is either\n- a direct URL to the video file\n- `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).\n\nSee the [file upload guide](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) for details.\n'}, 'end_image_file_path': {'type': 'string', 'example': 'api-assets/id/1234.png', 'minLength': 1, 'description': 'The image to use as the last frame of the video.\n\n* **`gemini-omni-1.1`**: Supports 360p, 720p, 1080p, 4k.\n* **`kling-2.6`**: Supports 1080p.\n* **`kling-3.0`**: Supports 720p, 1080p, 4k.\n* **`ltx-2.5`**: Supports 480p, 720p, 1080p.\n* **`minimax-h3`**: Not supported\n* **`seedance-1.5`**: Supports 480p, 720p, 1080p.\n* **`seedance-2.0`**: Supports 480p, 720p, 1080p, 4k.\n* **`seedance-2.0-mini`**: Supports 480p, 720p.\n* **`seedance-2.5`**: Supports 480p, 720p, 1080p.\n* **`veo3.1`**: Supports 720p, 1080p. Requires a duration of 8 seconds or less.\n* **`veo3.1-lite`**: Supports 720p, 1080p. Requires a duration of 8 seconds or less.\n* **`wan-2.2`**: Not supported\n* **`wan-3.0`**: Supports 480p, 720p, 1080p.\n'}}, 'description': 'Provide the assets for image-to-video.'}, 'resolution': {'enum': ['360p', '480p', '720p', '1080p', '4k'], 'type': 'string', 'example': '720p', 'description': 'Controls the output video resolution. Defaults to `720p` on paid tiers and `480p` on free tiers.\n\n* **`gemini-omni-1.1`**: Supports 360p, 720p, 1080p, 4k.\n* **`kling-2.6`**: Supports 720p, 1080p.\n* **`kling-3.0`**: Supports 720p, 1080p, 4k.\n* **`ltx-2.5`**: Supports 480p, 720p, 1080p.\n* **`minimax-h3`**: Supports 480p, 720p, 1080p.\n* **`seedance-1.5`**: Supports 480p, 720p, 1080p.\n* **`seedance-2.0`**: Supports 480p, 720p, 1080p, 4k.\n* **`seedance-2.0-mini`**: Supports 480p, 720p.\n* **`seedance-2.5`**: Supports 480p, 720p, 1080p.\n* **`veo3.1`**: Supports 720p, 1080p.\n* **`veo3.1-lite`**: Supports 720p, 1080p.\n* **`wan-2.2`**: Supports 480p, 720p, 1080p.\n* **`wan-3.0`**: Supports 480p, 720p, 1080p.\n'}, 'end_seconds': {'type': 'number', 'format': 'float', 'example': 5, 'maximum': 60.0, 'minimum': 1.0, 'description': 'The total duration of the output video in seconds. Supported durations depend on the chosen model:\n\n* **`gemini-omni-1.1`**: any integer from 3 to 10\n* **`kling-2.6`**: 5, 10\n* **`kling-3.0`**: any integer from 3 to 15\n* **`ltx-2.5`**: any integer from 1 to 60\n* **`minimax-h3`**: any integer from 1 to 30\n* **`seedance-1.5`**: any integer from 4 to 12\n* **`seedance-2.0`**: any integer from 4 to 15\n* **`seedance-2.0-mini`**: any integer from 4 to 15\n* **`seedance-2.5`**: any integer from 4 to 30\n* **`veo3.1`**: 4, 6, 8, 16, 24, 32, 40, 48, 56\n* **`veo3.1-lite`**: 4, 6, 8, 16, 24, 32, 40, 48, 56\n* **`wan-2.2`**: 3, 4, 5, 6, 7, 8, 9, 10, 15\n* **`wan-3.0`**: 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30\n'}}}

{'type': 'object', 'required': ['id', 'credits_charged'], 'properties': {'id': {'type': 'string', 'example': 'cuid-example', 'description': 'Unique ID of the video. Use it with the [Get video Project API](https://docs.magichour.ai/api-reference/video-projects/get-video-details) to fetch status and downloads.'}, 'credits_charged': {'type': 'integer', 'example': 450, 'description': "The amount of credits deducted from your account to generate the video. If the status is not 'complete', this value is an estimate and may be adjusted upon completion based on the actual FPS of the output video. \n\nIf video generation fails, credits will be refunded, and this field will be updated to include the refund."}}, 'description': 'Success'}

{'type': 'object', 'required': ['start_seconds', 'end_seconds', 'assets'], 'properties': {'name': {'type': 'string', 'default': 'Lip Sync - dateTime', 'example': 'My Lip Sync video', 'description': 'Give your video a custom name for easy identification.'}, 'style': {'type': 'object', 'properties': {'generation_mode': {'enum': ['lite', 'standard', 'pro'], 'type': 'string', 'default': 'lite', 'example': 'lite', 'description': 'A specific version of our lip sync system, optimized for different needs.\n* `lite` -  Fast lip sync - best for simple videos. Costs 1 credit per frame of video.\n* `standard` -  Natural, accurate lip sync - best for most creators. Costs 1 credit per frame of video.\n* `pro` -  Premium fidelity with enhanced detail - best for professionals. Costs 2 credits per frame of video.\n\nNote: `standard` and `pro` are only available for users on Creator, Pro, and Business tiers.\n              '}}, 'description': 'Attributes used to dictate the style of the output'}, 'assets': {'type': 'object', 'required': ['audio_file_path', 'video_source'], 'properties': {'youtube_url': {'type': 'string', 'format': 'uri', 'description': 'YouTube URL (required if `video_source` is `youtube`).'}, 'video_source': {'enum': ['file', 'youtube'], 'type': 'string', 'example': 'file', 'description': 'Choose your video source.'}, 'audio_file_path': {'type': 'string', 'example': 'api-assets/id/1234.mp3', 'minLength': 1, 'description': 'The path of the audio file. This value is either\n- a direct URL to the video file\n- `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).\n\nSee the [file upload guide](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) for details.\n'}, 'video_file_path': {'type': 'string', 'example': 'api-assets/id/1234.mp4', 'description': 'Your video file. Required if `video_source` is `file`. This value is either\n- a direct URL to the video file\n- `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).\n\nSee the [file upload guide](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) for details.\n'}}, 'description': 'Provide the assets for lip-sync. For video, The `video_source` field determines whether `video_file_path` or `youtube_url` field is used'}, 'end_seconds': {'type': 'number', 'format': 'float', 'example': 15, 'minimum': 0.1, 'description': 'End time of your clip (seconds). Must be greater than start_seconds.'}, 'max_fps_limit': {'type': 'number', 'example': 12, 'minimum': 1.0, 'description': "Defines the maximum FPS (frames per second) for the output video. If the input video's FPS is lower than this limit, the output video will retain the input FPS. This is useful for reducing unnecessary frame usage in scenarios where high FPS is not required."}, 'start_seconds': {'type': 'number', 'format': 'float', 'example': 0, 'minimum': 0.0, 'description': 'Start time of your clip (seconds). Must be â\x89¥ 0.'}}}

{'type': 'object', 'required': ['id', 'credits_charged'], 'properties': {'id': {'type': 'string', 'example': 'cuid-example', 'description': 'Unique ID of the video. Use it with the [Get video Project API](https://docs.magichour.ai/api-reference/video-projects/get-video-details) to fetch status and downloads.'}, 'credits_charged': {'type': 'integer', 'example': 450, 'description': "The amount of credits deducted from your account to generate the video. If the status is not 'complete', this value is an estimate and may be adjusted upon completion based on the actual FPS of the output video. \n\nIf video generation fails, credits will be refunded, and this field will be updated to include the refund."}}, 'description': 'Success'}

{'type': 'object', 'required': ['assets'], 'properties': {'name': {'type': 'string', 'default': 'Photo Colorizer - dateTime', 'example': 'My Photo Colorizer image', 'description': 'Give your image a custom name for easy identification.'}, 'assets': {'type': 'object', 'required': ['image_file_path'], 'properties': {'image_file_path': {'type': 'string', 'example': 'api-assets/id/1234.png', 'minLength': 1, 'description': 'The image used to generate the colorized image. This value is either\n- a direct URL to the video file\n- `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).\n\nSee the [file upload guide](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) for details.\n'}}, 'description': 'Provide the assets for photo colorization'}}}

{'type': 'object', 'required': ['id', 'credits_charged'], 'properties': {'id': {'type': 'string', 'example': 'cuid-example', 'description': 'Unique ID of the image. Use it with the [Get image Project API](https://docs.magichour.ai/api-reference/image-projects/get-image-details) to fetch status and downloads.'}, 'credits_charged': {'type': 'integer', 'example': 10, 'description': 'The amount of credits deducted from your account to generate the image. We charge credits right when the request is made. \n\nIf an error occurred while generating the image(s), credits will be refunded and this field will be updated to include the refund.'}}, 'description': 'Success'}

{'type': 'object', 'properties': {}, 'additionalProperties': False}

{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}

{'type': 'object', 'required': [], 'properties': {'type': {'enum': ['character', 'reference', 'voice', 'moodboard', 'brand_kit'], 'type': 'string', 'example': 'character', 'description': 'Only return saved items of this type.'}, 'limit': {'type': 'integer', 'default': 20, 'example': 20, 'maximum': 100.0, 'minimum': 1.0, 'description': 'Maximum number of saved items to return. Defaults to 20.'}, 'cursor': {'type': 'string', 'minLength': 1, 'description': "Opaque pagination cursor from the previous response's next_cursor."}}}

{'type': 'object', 'required': ['items', 'next_cursor'], 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'type', 'name', 'assets'], 'properties': {'id': {'type': 'string', 'example': 'cuid-example', 'description': 'Unique ID of the saved item.'}, 'name': {'type': ['string', 'null'], 'example': 'Alex', 'description': 'User-provided name of the saved item.'}, 'type': {'enum': ['character', 'reference', 'voice', 'moodboard', 'brand_kit'], 'type': 'string', 'example': 'character', 'description': 'Saved item type.'}, 'assets': {'type': 'array', 'items': {'type': 'object', 'required': ['file_path', 'media_kind', 'is_primary', 'url', 'url_expires_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Signed URL for previewing or downloading the asset. Expires after 24 hours.'}, 'file_path': {'type': 'string', 'example': 'saved-items/user-id/item-id/image.png', 'description': 'Durable asset path. Pass it to a compatible API asset field without uploading it again.'}, 'is_primary': {'type': 'boolean', 'example': True, 'description': "Whether this asset is the saved item's primary asset."}, 'media_kind': {'enum': ['IMAGE', 'VIDEO', 'AUDIO'], 'type': 'string', 'example': 'IMAGE', 'description': 'Media type of the asset.'}, 'url_expires_at': {'type': 'string', 'format': 'date-time', 'example': '2026-09-17T00:00:00.000Z', 'description': 'When the signed URL expires. The saved asset and file_path do not expire.'}}}}}}}, 'next_cursor': {'type': ['string', 'null'], 'description': 'Cursor for the next page, or null when there are no more saved items.'}}}

{'type': 'object', 'required': ['end_seconds', 'style'], 'properties': {'name': {'type': 'string', 'default': 'Text To Video - dateTime', 'example': 'My Text To Video video', 'description': 'Give your video a custom name for easy identification.'}, 'audio': {'type': 'boolean', 'example': True, 'description': 'Whether to include audio in the video. Defaults to `false` if not specified.\n\nAudio support varies by model:\n* **`gemini-omni-1.1`**: Not supported\n* **`kling-2.6`**: Not supported\n* **`kling-3.0`**: Toggle-able: audio adds extra credits when enabled\n* **`ltx-2.5`**: Toggle-able: no additional credits for audio\n* **`minimax-h3`**: Toggle-able: no additional credits for audio\n* **`seedance-1.5`**: Toggle-able: audio adds extra credits when enabled\n* **`seedance-2.0`**: Toggle-able: no additional credits for audio\n* **`seedance-2.0-mini`**: Toggle-able: no additional credits for audio\n* **`seedance-2.5`**: Toggle-able: no additional credits for audio\n* **`veo3.1`**: Toggle-able: audio adds extra credits when enabled\n* **`veo3.1-lite`**: Toggle-able: audio adds extra credits when enabled\n* **`wan-2.2`**: Not supported\n* **`wan-3.0`**: Toggle-able: no additional credits for audio\n'}, 'model': {'enum': ['default', 'kling-3.0', 'ltx-2.5', 'seedance-2.0-mini', 'wan-3.0', 'seedance-2.5', 'gemini-omni-1.1', 'minimax-h3', 'wan-2.2', 'seedance-1.5', 'seedance-2.0', 'veo3.1-lite', 'sora-2', 'veo3.1', 'kling-2.6', 'ltx-2.3', 'ltx-2', 'kling-2.5', 'kling-1.6', 'seedance', 'kling-2.5-audio', 'veo3.1-audio'], 'type': 'string', 'default': 'default', 'example': 'kling-3.0', 'description': 'The AI model to use for video generation.\n\n* `default`: uses our currently recommended model for general use. For paid tiers, defaults to `kling-3.0`. For free tiers, it defaults to `ltx-2.5`.\n* `gemini-omni-1.1`: Best for precise short clips, first/last frames, and high-resolution output.\n* `kling-2.6`: Best for action, motion blur, and controlled camera moves.\n* `kling-3.0`: Best for cinematic stories, references, and optional audio.\n* `ltx-2.5`: Fastest for general scenes, long clips, audio, and rapid iteration.\n* `minimax-h3`: Great for reference-driven clips with native audio and longer durations.\n* `seedance-1.5`: Best for smooth, consistent motion with an end frame.\n* `seedance-2.0`: Best for reference-led clips with precise subject control.\n* `seedance-2.0-mini`: Faster reference-led clips with consistent motion and audio.\n* `seedance-2.5`: Best for premium realism, detail, and natural motion.\n* `veo3.1`: Best for romantic interactions and expressive action, with realistic detail.\n* `veo3.1-lite`: Balanced realism and audio at a lower cost than Veo 3.1.\n* `wan-2.2`: Best for physical motion, action, and camera movement.\n* `wan-3.0`: High-quality video with native audio, long clips, and end-frame control.\n\nIf you specify the deprecated model value that includes the `-audio` suffix, this will be the same as included `audio` as `true`.'}, 'style': {'type': 'object', 'required': ['prompt'], 'properties': {'prompt': {'type': 'string', 'example': 'a dog running', 'maxLength': 20000, 'minLength': 1, 'description': 'The prompt used for the video.'}}}, 'references': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'file_path'], 'properties': {'name': {'type': 'string', 'pattern': '^[A-Za-z][\\w-]*$'}, 'file_path': {'type': 'string', 'minLength': 1}}}, 'maxItems': 10, 'minItems': 1}, 'resolution': {'enum': ['360p', '480p', '720p', '1080p', '4k'], 'type': 'string', 'example': '720p', 'description': 'Controls the output video resolution. Defaults to `720p` on paid tiers and `480p` on free tiers.\n\n* **`gemini-omni-1.1`**: Supports 360p, 720p, 1080p, 4k.\n* **`kling-2.6`**: Supports 720p, 1080p.\n* **`kling-3.0`**: Supports 720p, 1080p, 4k.\n* **`ltx-2.5`**: Supports 480p, 720p, 1080p.\n* **`minimax-h3`**: Supports 480p, 720p, 1080p.\n* **`seedance-1.5`**: Supports 480p, 720p, 1080p.\n* **`seedance-2.0`**: Supports 480p, 720p, 1080p, 4k.\n* **`seedance-2.0-mini`**: Supports 480p, 720p.\n* **`seedance-2.5`**: Supports 480p, 720p, 1080p.\n* **`veo3.1`**: Supports 720p, 1080p.\n* **`veo3.1-lite`**: Supports 720p, 1080p.\n* **`wan-2.2`**: Supports 480p, 720p, 1080p.\n* **`wan-3.0`**: Supports 480p, 720p, 1080p.\n'}, 'end_seconds': {'type': 'number', 'format': 'float', 'example': 5, 'maximum': 60.0, 'minimum': 1.0, 'description': 'The total duration of the output video in seconds. Supported durations depend on the chosen model:\n\n* **`gemini-omni-1.1`**: any integer from 3 to 10\n* **`kling-2.6`**: 5, 10\n* **`kling-3.0`**: any integer from 3 to 15\n* **`ltx-2.5`**: any integer from 1 to 60\n* **`minimax-h3`**: any integer from 1 to 30\n* **`seedance-1.5`**: any integer from 4 to 12\n* **`seedance-2.0`**: any integer from 4 to 15\n* **`seedance-2.0-mini`**: any integer from 4 to 15\n* **`seedance-2.5`**: any integer from 4 to 30\n* **`veo3.1`**: 4, 6, 8, 16, 24, 32, 40, 48, 56\n* **`veo3.1-lite`**: 4, 6, 8, 16, 24, 32, 40, 48, 56\n* **`wan-2.2`**: 3, 4, 5, 6, 7, 8, 9, 10, 15\n* **`wan-3.0`**: 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30\n'}, 'aspect_ratio': {'enum': ['16:9', '9:16', '1:1'], 'type': 'string', 'example': '16:9', 'description': 'Determines the aspect ratio of the output video.\n\n* **`gemini-omni-1.1`**: Supports 16:9, 9:16.\n* **`kling-2.6`**: Supports 9:16, 16:9, 1:1.\n* **`kling-3.0`**: Supports 9:16, 16:9, 1:1.\n* **`ltx-2.5`**: Supports 9:16, 16:9, 1:1.\n* **`minimax-h3`**: Supports 16:9, 9:16, 1:1.\n* **`seedance-1.5`**: Supports 9:16, 16:9, 1:1.\n* **`seedance-2.0`**: Supports 9:16, 16:9, 1:1.\n* **`seedance-2.0-mini`**: Supports 9:16, 16:9, 1:1.\n* **`seedance-2.5`**: Supports 9:16, 16:9, 1:1.\n* **`veo3.1`**: Supports 9:16, 16:9.\n* **`veo3.1-lite`**: Supports 9:16, 16:9.\n* **`wan-2.2`**: Supports 9:16, 16:9, 1:1.\n* **`wan-3.0`**: Supports 16:9, 9:16, 1:1.\n'}}}

{'type': 'object', 'required': ['id', 'credits_charged'], 'properties': {'id': {'type': 'string', 'example': 'cuid-example', 'description': 'Unique ID of the video. Use it with the [Get video Project API](https://docs.magichour.ai/api-reference/video-projects/get-video-details) to fetch status and downloads.'}, 'credits_charged': {'type': 'integer', 'example': 450, 'description': "The amount of credits deducted from your account to generate the video. If the status is not 'complete', this value is an estimate and may be adjusted upon completion based on the actual FPS of the output video. \n\nIf video generation fails, credits will be refunded, and this field will be updated to include the refund."}}, 'description': 'Success'}

{'type': 'object', 'required': ['items'], 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'extension'], 'properties': {'type': {'enum': ['video', 'audio', 'image'], 'type': 'string', 'example': 'video', 'description': 'The type of asset to upload. Possible types are video, audio, image'}, 'extension': {'type': 'string', 'example': 'mp4', 'pattern': '^[a-z0-9]+$', 'description': 'The extension of the file to upload. Do not include the dot (.) before the extension. Possible extensions are mp4,m4v,mov,webm,mp3,wav,aac,flac,webm,weba,m4a,opus,ogg,oga,aiff,amr,png,jpg,jpeg,jfif,heic,heif,webp,avif,jp2,tiff,tif,bmp,gif,webp,webm'}}}, 'example': [{'type': 'video', 'extension': 'mp4'}, {'type': 'audio', 'extension': 'mp3'}], 'minItems': 1, 'description': 'The list of assets to upload. The response array will match the order of items in the request body.'}}}

{'type': 'object', 'required': ['items'], 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'required': ['upload_url', 'expires_at', 'file_path'], 'properties': {'file_path': {'type': 'string', 'example': 'video/id/1234.mp4', 'description': 'this value is used in APIs that needs assets, such as image_file_path, video_file_path, and audio_file_path'}, 'expires_at': {'type': 'string', 'format': 'date-time', 'example': '2024-07-21T17:32:28Z', 'description': 'when the upload url expires, and will need to request a new one.'}, 'upload_url': {'type': 'string', 'format': 'uri', 'example': 'https://videos.magichour.ai/id/video.mp4?auth-value=1234567890', 'description': 'Used to upload the file to storage, send a PUT request with the file as data to upload.'}}}, 'example': [{'file_path': 'api-assets/id/video.mp4', 'expires_at': '2024-07-25T16:56:21.932Z', 'upload_url': 'https://videos.magichour.ai/api-assets/id/video.mp4?auth-value=1234567890'}, {'file_path': 'api-assets/id/audio.mp3', 'expires_at': '2024-07-25T16:56:21.932Z', 'upload_url': 'https://videos.magichour.ai/api-assets/id/audio.mp3?auth-value=1234567890'}], 'description': 'The list of upload URLs and file paths for the assets. The response array will match the order of items in the request body. Refer to the [Input Files Guide](https://docs.magichour.ai/integration/inputs-and-outputs) for more details.'}}, 'description': 'Success'}

{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'example': 'cuid-example', 'description': 'Unique ID of the video project. This value is returned by all of the POST APIs that create a video.'}}}

{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'example': 'cuid-example', 'description': 'Unique ID of the video project. This value is returned by all of the POST APIs that create a video.'}}}

{'type': 'object', 'required': ['id', 'name', 'status', 'type', 'created_at', 'width', 'height', 'enabled', 'start_seconds', 'end_seconds', 'credits_charged', 'fps', 'error', 'downloads'], 'properties': {'id': {'type': 'string', 'example': 'cuid-example', 'description': 'Unique ID of the video. Use it with the [Get video Project API](https://docs.magichour.ai/api-reference/video-projects/get-video-details) to fetch status and downloads.'}, 'fps': {'type': 'number', 'example': 30, 'description': "Frame rate of the video. If the status is not 'complete', the frame rate is an estimate and will be adjusted when the video completes."}, 'name': {'type': ['string', 'null'], 'example': 'Example Name', 'description': 'The name of the video.'}, 'type': {'type': 'string', 'example': 'FACE_SWAP', 'description': 'The type of the video project. Possible values are ANIMATION, AUTO_SUBTITLE, VIDEO_TO_VIDEO, FACE_SWAP, TEXT_TO_VIDEO, IMAGE_TO_VIDEO, LIP_SYNC, TALKING_PHOTO, AVATAR, VIDEO_UPSCALER, VIDEO_EDITOR, CHARACTER_REPLACE, VIDEO_COLORIZER, VIDEO_WATERMARK_REMOVER, VIDEO_COLOR_GRADER, VIDEO_TRANSLATOR, MUSIC_VIDEO, EXTEND, AUDIO_TO_VIDEO, VIDEO_EXPANDER, UGC_AD'}, 'error': {'type': ['object', 'null'], 'required': ['message', 'code'], 'properties': {'code': {'type': 'string', 'example': 'no_source_face', 'description': 'An error code to indicate why a failure happened.'}, 'message': {'type': 'string', 'example': 'Please use an image with a detectable face', 'description': 'Details on the reason why a failure happened.'}}, 'description': 'In the case of an error, this object will contain the error encountered during video render'}, 'width': {'type': 'integer', 'example': 512, 'description': 'The width of the final output video. A value of -1 indicates the width can be ignored.'}, 'height': {'type': 'integer', 'example': 960, 'description': 'The height of the final output video. A value of -1 indicates the height can be ignored.'}, 'status': {'enum': ['draft', 'queued', 'rendering', 'complete', 'error', 'canceled'], 'type': 'string', 'example': 'complete', 'description': 'The status of the video.\n\n- `draft` - the project was created but has not been submitted for rendering\n- `queued` - the job is waiting for an available server\n- `rendering` - the job is being processed; the `video.started` webhook event fires when rendering begins\n- `complete` - the job finished successfully; fires `video.completed`\n- `error` - the job failed during processing; fires `video.errored`\n- `canceled` - the job was manually canceled (for example from the Magic Hour web app)\n\n**Note:** `rendering`, `complete`, and `error` have matching webhook events; `canceled` does not - a canceled job emits no webhook event, so poll this endpoint to detect cancellation.'}, 'enabled': {'type': 'boolean', 'description': 'Whether this resource is active. If false, it is deleted.'}, 'downloads': {'type': 'array', 'items': {'type': 'object', 'required': ['url', 'expires_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'example': 'https://videos.magichour.ai/id/output.mp4'}, 'expires_at': {'type': 'string', 'format': 'date-time', 'example': '2024-10-19T05:16:19.027Z'}}, 'description': 'The download url and expiration date of the image project'}}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'end_seconds': {'type': 'number', 'format': 'float', 'example': 15, 'minimum': 0.1, 'description': 'End time of your clip (seconds). Must be greater than start_seconds.'}, 'start_seconds': {'type': 'number', 'format': 'float', 'example': 0, 'minimum': 0.0, 'description': 'Start time of your clip (seconds). Must be â\x89¥ 0.'}, 'credits_charged': {'type': 'integer', 'example': 450, 'description': "The amount of credits deducted from your account to generate the video. If the status is not 'complete', this value is an estimate and may be adjusted upon completion based on the actual FPS of the output video. \n\nIf video generation fails, credits will be refunded, and this field will be updated to include the refund."}}, 'description': 'Success'}

{'type': 'object', 'required': ['start_seconds', 'end_seconds', 'style', 'assets'], 'properties': {'name': {'type': 'string', 'default': 'Video To Video - dateTime', 'example': 'My Video To Video video', 'description': 'Give your video a custom name for easy identification.'}, 'style': {'type': 'object', 'required': ['art_style'], 'properties': {'model': {'enum': ['Dreamshaper', 'Absolute Reality', 'Flat 2D Anime', 'Soft Anime', 'Kaywaii', 'Western Anime', '3D Anime', 'default'], 'type': 'string', 'default': 'default', 'example': 'default', 'description': "* `Dreamshaper` - a good all-around model that works for both animations as well as realism.\n* `Absolute Reality` - better at realism, but you'll often get similar results with Dreamshaper as well.\n* `Flat 2D Anime` - best for a flat illustration style that's common in most anime.\n* `default` - use the default recommended model for the selected art style."}, 'prompt': {'type': ['string', 'null'], 'description': 'The prompt used for the video. Prompt is required if `prompt_type` is `custom` or `append_default`. If `prompt_type` is `default`, then the `prompt` value passed will be ignored.'}, 'version': {'enum': ['v1', 'v2', 'default'], 'type': 'string', 'default': 'default', 'example': 'default', 'description': '* `v1` - more detail, closer prompt adherence, and frame-by-frame previews.\n* `v2` - faster, more consistent, and less noisy.\n* `default` - use the default version for the selected art style.'}, 'art_style': {'enum': ['Minecraft', 'Watercolor', 'Pixel', 'Retro Sci-Fi', 'Lego', 'Origami', 'Ghost', 'Sub-Zero', 'Studio Ghibli', 'Comic', 'Impressionism', 'Master Chief', 'Solid Snake', 'Street Fighter', 'Hologram', 'GTA', 'Clay', 'Mystique', 'Dragonball Z', 'Mario', 'Samurai', 'Spartan', 'Boba Fett', '3D Render', 'Airbender', 'Android', 'Anime Warrior', 'Armored Knight', "Assassin's Creed", 'Avatar', 'Black Spiderman', 'Bold Anime', 'Celestial Skin', 'Chinese Swordsmen', 'Cyberpunk', 'Cypher', 'Dark Fantasy', 'Future Bot', 'Futuristic Fantasy', 'Ghibli Anime', 'Gundam', 'Illustration', 'Ink', 'Ink Poster', 'Jinx', 'Knight', 'Link', 'Marble', 'Mech', 'Naruto', 'Neon Dream', 'No Art Style', 'Oil Painting', 'On Fire', 'Painterly Anime', 'Pixar', 'Power Armor', 'Power Ranger', 'Radiant Anime', 'Realistic Anime', 'Realistic Pixar', 'Retro Anime', 'Samurai Bot', 'Sharp Anime', 'Soft Anime', 'Starfield', 'The Void', 'Tomb Raider', 'Underwater', 'Van Gogh', 'Viking', 'Western Anime', 'Wu Kong', 'Wuxia Anime', 'Zelda'], 'type': 'string'}, 'prompt_type': {'enum': ['default', 'custom', 'append_default'], 'type': 'string', 'default': 'default', 'example': 'default', 'description': '* `default` - Use the default recommended prompt for the art style.\n* `custom` - Only use the prompt passed in the API. Note: for v1, lora prompt will still be auto added to apply the art style properly.\n* `append_default` - Add the default recommended prompt to the end of the prompt passed in the API.'}}}, 'assets': {'type': 'object', 'required': ['video_source'], 'properties': {'youtube_url': {'type': 'string', 'format': 'uri', 'description': 'YouTube URL (required if `video_source` is `youtube`).'}, 'video_source': {'enum': ['file', 'youtube'], 'type': 'string', 'example': 'file', 'description': 'Choose your video source.'}, 'video_file_path': {'type': 'string', 'example': 'api-assets/id/1234.mp4', 'description': 'Your video file. Required if `video_source` is `file`. This value is either\n- a direct URL to the video file\n- `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).\n\nSee the [file upload guide](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) for details.\n'}}, 'description': 'Provide the assets for video-to-video. For video, The `video_source` field determines whether `video_file_path` or `youtube_url` field is used'}, 'end_seconds': {'type': 'number', 'format': 'float', 'example': 15, 'minimum': 0.1, 'description': 'End time of your clip (seconds). Must be greater than start_seconds.'}, 'start_seconds': {'type': 'number', 'format': 'float', 'example': 0, 'minimum': 0.0, 'description': 'Start time of your clip (seconds). Must be â\x89¥ 0.'}, 'fps_resolution': {'enum': ['FULL', 'HALF'], 'type': 'string', 'default': 'HALF', 'example': 'HALF', 'description': 'Determines whether the resulting video will have the same frame per second as the original video, or half.\n* `FULL` - the result video will have the same FPS as the input video\n* `HALF` - the result video will have half the FPS as the input video'}}}

{'type': 'object', 'required': ['id', 'credits_charged'], 'properties': {'id': {'type': 'string', 'example': 'cuid-example', 'description': 'Unique ID of the video. Use it with the [Get video Project API](https://docs.magichour.ai/api-reference/video-projects/get-video-details) to fetch status and downloads.'}, 'credits_charged': {'type': 'integer', 'example': 450, 'description': "The amount of credits deducted from your account to generate the video. If the status is not 'complete', this value is an estimate and may be adjusted upon completion based on the actual FPS of the output video. \n\nIf video generation fails, credits will be refunded, and this field will be updated to include the refund."}}, 'description': 'Success'}

{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string'}, 'timeout_seconds': {'type': 'number', 'default': 180.0}, 'max_inline_downloads': {'type': 'integer', 'default': 4}, 'poll_interval_seconds': {'type': 'number', 'default': 2.0}, 'max_bytes_per_download': {'type': 'integer', 'default': 15728640}, 'include_inline_downloads': {'type': 'boolean', 'default': True}}, 'additionalProperties': False}

{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string'}, 'timeout_seconds': {'type': 'number', 'default': 180.0}, 'max_inline_downloads': {'type': 'integer', 'default': 4}, 'poll_interval_seconds': {'type': 'number', 'default': 2.0}, 'max_bytes_per_download': {'type': 'integer', 'default': 15728640}, 'include_inline_downloads': {'type': 'boolean', 'default': True}}, 'additionalProperties': False}

{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string'}, 'timeout_seconds': {'type': 'number', 'default': 300.0}, 'max_inline_downloads': {'type': 'integer', 'default': 0}, 'poll_interval_seconds': {'type': 'number', 'default': 2.0}, 'include_inline_downloads': {'type': 'boolean', 'default': False}}, 'additionalProperties': False}