Photo AI Studio

{'type': 'object', 'properties': {'tag': {'type': 'string', 'description': 'Search themes by name or keyword'}, 'gender': {'enum': ['male', 'female', 'groups', 'pets', 'product'], 'type': 'string', 'description': 'Filter themes by gender category'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['type'], 'properties': {'type': {'enum': ['image_to_video', 'ugc', 'product_holder'], 'type': 'string', 'description': 'Type of video to create'}, 'gender': {'type': 'string', 'description': 'UGC model gender'}, 'prompt': {'type': 'string', 'description': 'Animation prompt, required for image_to_video'}, 'script': {'type': 'string', 'description': 'UGC script, up to 150 characters'}, 'emotion': {'type': 'string', 'description': 'UGC emotion, default neutral'}, 'duration': {'type': 'number', 'description': 'Duration in seconds, default 4'}, 'language': {'type': 'string', 'description': 'UGC language, default English'}, 'voice_id': {'type': 'string', 'description': 'Voice ID for UGC'}, 'image_url': {'type': 'string', 'description': 'CDN URL of the image to animate'}, 'resolution': {'type': 'string', 'description': 'Video resolution, default 720p'}, 'output_type': {'enum': ['image', 'video'], 'type': 'string', 'description': 'product_holder output: image costs 100 credits, video costs 500'}, 'aspect_ratio': {'type': 'string', 'description': 'Output aspect ratio'}, 'person_prompt': {'type': 'string', 'description': 'Person description for product_holder'}, 'wait_for_result': {'type': 'boolean', 'description': 'Wait up to 55 seconds for the result before returning. Defaults to false: the tool returns a prediction_id immediately and you poll get_prediction, which is the reliable pattern for photos and videos.'}, 'person_image_url': {'type': 'string', 'description': 'Person image for product_holder'}, 'product_image_url': {'type': 'string', 'description': 'Product image, required for product_holder'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['operation'], 'properties': {'prompt': {'type': 'string', 'description': 'Text prompt for replace_background, retouch, and custom'}, 'hairstyle': {'type': 'string', 'description': 'Target hairstyle for the hair operation'}, 'image_url': {'type': 'string', 'description': 'CDN URL of the image to edit, required for every operation except face_swap'}, 'operation': {'enum': ['remove_background', 'replace_background', 'retouch', 'skin', 'hair', 'makeup', 'age', 'expression', 'body_type', 'eye_color', 'color_correction', 'custom', 'clothes', 'try_on', 'product', 'upscale', 'restore', 'face_swap', 'extend'], 'type': 'string', 'description': 'The edit operation to perform'}, 'hair_color': {'type': 'string', 'description': 'Target hair color for the hair operation'}, 'num_images': {'type': 'number', 'description': 'Number of variations for try_on (1-4)'}, 'target_age': {'type': 'number', 'description': 'Target age for the age operation'}, 'wait_for_result': {'type': 'boolean', 'description': 'Wait up to 55 seconds for the result before returning. Defaults to false: the tool returns a prediction_id immediately and you poll get_prediction, which is the reliable pattern for photos and videos.'}, 'source_image_url': {'type': 'string', 'description': 'Source face image for face_swap'}, 'target_body_type': {'type': 'string', 'description': 'Target body type'}, 'target_eye_color': {'type': 'string', 'description': 'Target eye color'}, 'target_image_url': {'type': 'string', 'description': 'Target image for face_swap'}, 'clothes_image_url': {'type': 'string', 'description': 'Clothes image for clothes and try_on'}, 'product_image_url': {'type': 'string', 'description': 'Product image for the product operation'}, 'target_expression': {'type': 'string', 'description': 'Target expression, for example "happy"'}, 'reference_image_url': {'type': 'string', 'description': 'Reference image for hair or custom'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['images', 'gender'], 'properties': {'type': {'enum': ['themed', 'custom'], 'type': 'string', 'description': 'themed uses a preset style, custom uses your prompt'}, 'style': {'type': 'string', 'description': 'Style override, for example "realistic"'}, 'gender': {'enum': ['male', 'female', 'groups', 'pets', 'product'], 'type': 'string', 'description': 'Gender category for theme selection'}, 'images': {'type': 'array', 'items': {'type': 'string'}, 'description': 'CDN URLs of face photos (1-9), from upload_image'}, 'prompt': {'type': 'string', 'description': 'Custom prompt, required when type is custom'}, 'category': {'type': 'string', 'description': 'Theme slug from browse_themes, required when type is themed'}, 'num_images': {'type': 'number', 'description': 'Number of variations to generate (1-4)'}, 'aspect_ratio': {'enum': ['1:1', '2:3', '3:2', '16:9', '9:16'], 'type': 'string', 'description': 'Output aspect ratio'}, 'wait_for_result': {'type': 'boolean', 'description': 'Wait up to 55 seconds for the result before returning. Defaults to false: the tool returns a prediction_id immediately and you poll get_prediction, which is the reliable pattern for photos and videos.'}}, 'additionalProperties': False}

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

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

{'type': 'object', 'required': ['prediction_id'], 'properties': {'prediction_id': {'type': 'string', 'description': 'The prediction_id returned when the operation started'}}, 'additionalProperties': False}

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

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

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

{'type': 'object', 'properties': {'page': {'type': 'number', 'description': 'Page number, default 1'}, 'limit': {'type': 'number', 'description': 'Items per page, default 20, maximum 100'}, 'state': {'enum': ['pending', 'succeeded', 'failed'], 'type': 'string', 'description': 'Filter by state'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'image_url': {'type': 'string', 'description': 'Public URL of the image to upload'}, 'image_base64': {'type': 'string', 'description': 'Base64-encoded image data, raw or as a data URI. Use this when the image is not already on the web.'}}, 'additionalProperties': False}