{"info":{"title":"Magnific API","description":"The Magnific API is your gateway to a vast collection of high-quality digital resources for your applications and projects. As a leading platform, it offers a wide range of graphics, including vectors, photos, illustrations, icons, PSD templates, and more, all curated by talented designers from around the world.","version":"1.0.0"},"components":{"schemas":{"get_resource_detail_by_id_200_response":{"example":{"data":{"download_size":1024,"related_resources":{"same_series":{"items":[{"name":"White t-shirt with copy space on gray background","preview":{"height":500,"url":"https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm","width":300},"premium":true,"new":true,"id":15667327,"has_prompt":true,"is_ai_generated":true,"slug":"merry-christmas","url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm","type":"vector","author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}},{"name":"White t-shirt with copy space on gray background","preview":{"height":500,"url":"https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm","width":300},"premium":true,"new":true,"id":15667327,"has_prompt":true,"is_ai_generated":true,"slug":"merry-christmas","url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm","type":"vector","author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}}],"url":"https://www.freepik.com/serie/32689488"},"same_author":[{"name":"White t-shirt with copy space on gray background","preview":{"height":500,"url":"https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm","width":300},"premium":true,"new":true,"id":15667327,"has_prompt":true,"is_ai_generated":true,"slug":"merry-christmas","url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm","type":"vector","author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}},{"name":"White t-shirt with copy space on gray background","preview":{"height":500,"url":"https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm","width":300},"premium":true,"new":true,"id":15667327,"has_prompt":true,"is_ai_generated":true,"slug":"merry-christmas","url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm","type":"vector","author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}}],"suggested":[{"name":"White t-shirt with copy space on gray background","preview":{"height":500,"url":"https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm","width":300},"premium":true,"new":true,"id":15667327,"has_prompt":true,"is_ai_generated":true,"slug":"merry-christmas","url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm","type":"vector","author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}},{"name":"White t-shirt with copy space on gray background","preview":{"height":500,"url":"https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm","width":300},"premium":true,"new":true,"id":15667327,"has_prompt":true,"is_ai_generated":true,"slug":"merry-christmas","url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm","type":"vector","author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}}],"same_collection":{"items":[{"name":"White t-shirt with copy space on gray background","preview":{"height":500,"url":"https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm","width":300},"premium":true,"new":true,"id":15667327,"has_prompt":true,"is_ai_generated":true,"slug":"merry-christmas","url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm","type":"vector","author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}},{"name":"White t-shirt with copy space on gray background","preview":{"height":500,"url":"https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm","width":300},"premium":true,"new":true,"id":15667327,"has_prompt":true,"is_ai_generated":true,"slug":"merry-christmas","url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm","type":"vector","author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}}],"url":"https://www.freepik.com/collection/shining"}},"url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm","new":true,"related_tags":[{"name":"Merry Christmas","slug":"merry-christmas","url":"https://www.freepik.com/dog"},{"name":"Merry Christmas","slug":"merry-christmas","url":"https://www.freepik.com/dog"}],"id":15667327,"name":"White t-shirt with copy space on gray background","available_formats":{"ai":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"png":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"psd":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"eps":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"atn":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"fonts":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"jpg":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"3d-render":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"svg":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"zip":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"resources":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]}},"preview":{"height":500,"url":"https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm","width":300},"vertical":"mockup","is_ai_generated":true,"author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647},"created":"2023-03-07T23:05:26Z","has_prompt":true,"premium":true,"slug":"merry-christmas","license":"https://www.freepik.com/profile/license/pdf/4350594","type":"photo","dimensions":{"width":2000,"height":3000}}},"required":["data"],"type":"object","properties":{"data":{"$ref":"#/components/schemas/get_resource_detail_by_id_200_response_data"}}},"request_15":{"required":["prompt"],"properties":{"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"seed":{"example":12345,"description":"Seed for reproducible generation. Using the same prompt and seed returns a\nconsistent result across requests. Omit to get a random seed on each request.\n","type":"integer"},"negative_prompt":{"example":"vocals, distortion, dissonance","description":"Text describing elements to avoid in the generated track, such as unwanted\ninstruments, styles, or moods.\n","type":"string"},"prompt":{"minLength":1,"example":"Uplifting orchestral score with soaring strings and triumphant brass","maxLength":2500,"type":"string","description":"Text description of the music you want to generate with Google Lyria.\nBe specific about genre, mood, instruments, and tempo for best results.\n\n**Tips for effective prompts:**\n- Include genre: \"lo-fi hip hop\", \"orchestral\", \"synthwave\", \"acoustic folk\"\n- Describe mood: \"uplifting\", \"melancholic\", \"energetic\", \"relaxed\"\n- Mention instruments: \"piano\", \"strings\", \"electric guitar\", \"808 drums\"\n- Add tempo hints: \"slow tempo\", \"upbeat\", \"driving rhythm\"\n"}},"type":"object"},"download_resource_by_id_image_size_parameter":{"oneOf":[{"type":"string","enum":["small","medium","large","original"]},{"pattern":"^(\\d{3}|[12]\\d{3})px$","type":"string"}]},"resolution_1":{"default":"2k","enum":["720p","1k","2k","4k"],"description":"Output resolution for the video upscaling:\n- `720p`: HD output\n- `1k`: Standard definition output\n- `2k`: High definition output (default)\n- `4k`: Ultra high definition output\n","type":"string"},"flavor_1":{"default":"vivid","enum":["vivid","natural"],"description":"Video processing flavor that determines the upscaling style:\n- `vivid`: Enhanced colors and contrast for more vibrant output\n- `natural`: Preserves original colors and natural appearance\n","type":"string"},"itvminimax-768p-request-content":{"title":"Image to Video","allOf":[{"$ref":"#/components/schemas/minimax-hailuo-02-base"},{"required":["first_frame_image"],"properties":{"last_frame_image":{"example":"https://img.freepik.com/free-photo/beautiful-sunset-over-mountains_123456-7890.jpg","description":"The model will use the image passed in this parameter as the last frame to generate a video. Supported formats: URL of the image or base64 encoding of the image. Image specifications: format must be JPG, JPEG, or PNG; aspect ratio should be greater than 2:5 and less than 5:2; the shorter side must exceed 300 pixels; file size must not exceed 20MB.","type":"string"},"duration":{"default":6,"enum":[6,10],"example":6,"description":"Video length in seconds","type":"integer"},"first_frame_image":{"example":"https://img.freepik.com/free-photo/beautiful-sunset-over-mountains_123456-7890.jpg","description":"The model will use the image passed in this parameter as the first frame to generate a video. Supported formats: URL of the image or base64 encoding of the image. Image specifications: format must be JPG, JPEG, or PNG; aspect ratio should be greater than 2:5 and less than 5:2; the shorter side must exceed 300 pixels; file size must not exceed 20MB.","type":"string"}},"type":"object"}]},"download_resource_by_id_200_response":{"example":{"data":{"signed_url":"https://img.freepik.com/premium-photo/close-up-cat-resting_1048944-9269194.jpg?t=st=1725276607~exp=1725280207~hmac=1538f1b294fc3a19a19e9f02ceeb6594a9a1e36a900de85d47bbd386e27dddbe","filename":"blackboard-template.zip","url":"https://downloadscdn5.freepik.com/d/1137445/blackboard-template.zip"}},"required":["data"],"type":"object","properties":{"data":{"$ref":"#/components/schemas/download_resource_by_id_200_response_data"}}},"output-format":{"default":"h264","enum":["h264","prores_422_hq"],"description":"Output video format. `h264` (default) returns an H.264 MP4. `prores_422_hq` returns an Apple ProRes 422 HQ master (.mov) alongside an H.264 preview.\nWhen `prores_422_hq` is selected the completed task's `generated` array contains both files: the H.264 MP4 preview and the ProRes master, which can be identified by its `.mov` extension.\n","type":"string"},"resource":{"required":["author","has_prompt","id","is_ai_generated","name","new","premium","preview","slug","type","url"],"example":{"name":"White t-shirt with copy space on gray background","preview":{"height":500,"url":"https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm","width":300},"premium":true,"new":true,"id":15667327,"has_prompt":true,"is_ai_generated":true,"slug":"merry-christmas","url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm","type":"vector","author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}},"properties":{"name":{"example":"White t-shirt with copy space on gray background","description":"Resource's name.","type":"string"},"preview":{"$ref":"#/components/schemas/preview"},"url":{"example":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm","format":"uri","description":"Detail resource's url","type":"string"},"new":{"example":true,"description":"True if the resource is new, false otherwise.","type":"boolean"},"id":{"example":15667327,"minimum":1,"type":"integer","description":"Resource's id."},"has_prompt":{"example":true,"description":"True if the resource has prompt, false otherwise.","type":"boolean"},"premium":{"example":true,"description":"True if the resource is premium, false otherwise.","type":"boolean"},"slug":{"example":"merry-christmas","type":"string","minLength":1},"is_ai_generated":{"example":true,"description":"True if the resource is generated by AI, false otherwise.","type":"boolean"},"type":{"$ref":"#/components/schemas/resource-type"},"author":{"$ref":"#/components/schemas/author"}},"type":"object","description":"A regular resource."},"request_17":{"required":["text","voice_id"],"properties":{"stability":{"default":0.5,"minimum":0,"example":0.5,"description":"Controls voice consistency and expressiveness. Lower values (0.0) produce more expressive and varied speech, while higher values (1.0) produce more consistent and stable output.","type":"number","maximum":1},"similarity_boost":{"default":0.2,"minimum":0,"example":0.2,"description":"Controls how closely the generated voice matches the original voice sample. Higher values produce closer matching but may introduce artifacts.","type":"number","maximum":1},"voice_id":{"example":"21m00Tcm4TlvDq8ikWAM","description":"The unique identifier of the ElevenLabs voice to use for synthesis. You can find voice IDs in the ElevenLabs voice library.","type":"string"},"speed":{"default":1,"minimum":0.7,"example":1,"description":"Speech rate multiplier. 0.7 is 30% slower than normal, 1.0 is normal speed, 1.2 is 20% faster.","type":"number","maximum":1.2},"use_speaker_boost":{"default":true,"example":true,"type":"boolean","description":"Enable speaker boost for enhanced voice clarity and presence in the generated audio."},"text":{"minLength":1,"example":"Welcome to Magnific. Create amazing designs with AI-powered tools.","maxLength":40000,"type":"string","description":"The text to convert to speech. Supports UTF-8 characters including accented letters and non-Latin scripts."},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"}},"type":"object"},"request-content_5":{"required":["video"],"properties":{"resolution":{"$ref":"#/components/schemas/resolution_1"},"smart_grain":{"default":0,"minimum":0,"description":"Applies a film grain effect to the output video. Helps preserve natural film grain and texture detail.\nValid values range from 0 (no grain) to 100 (maximum grain). Default is 0.\n","type":"integer","maximum":100},"fps_boost":{"default":false,"description":"Enable FPS boost to increase the frame rate of the upscaled video. When enabled, the strength parameter is ignored and the fully upscaled result is returned.","type":"boolean"},"video":{"description":"Source video to upscale. Must be a publicly accessible HTTPS URL pointing to the video.\n","type":"string"},"webhook_url":{"format":"uri","description":"Optional callback URL that will receive asynchronous notifications when the upscaling task completes.\nThe webhook will be called with the task status and the upscaled video URL.\n","type":"string"},"output_format":{"$ref":"#/components/schemas/output-format"},"strength":{"default":60,"minimum":0,"description":"Strength of the upscaling effect. Controls how much the output differs from the original video.\nA value of 0 returns the original video, 100 returns the fully upscaled result.\nIntermediate values blend the original with the upscaled result.\nThis parameter is ignored when fps_boost is enabled. Default is 60.\n","type":"integer","maximum":100},"sharpen":{"default":0,"minimum":0,"description":"Video sharpness intensity control. Higher values increase edge definition and clarity.\nValid values range from 0 (no sharpening) to 100 (maximum sharpness). Default is 0.\n","type":"integer","maximum":100}},"type":"object"},"minimax-hailuo-02-base":{"required":["prompt"],"properties":{"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"prompt_optimizer":{"default":true,"description":"Whether to use the prompt optimizer. If true, the model will automatically optimize the incoming prompt to improve the generation quality.","type":"boolean"},"prompt":{"example":"A beautiful sunset over the mountains with birds flying in the sky","maxLength":2000,"type":"string","description":"Description of the video. Note: It should be less than 2000 characters."}},"type":"object"},"request-content_6":{"required":["enhancement_model","video"],"properties":{"target_fps":{"minimum":1,"description":"Target output frame rate. When it differs from the source frame rate, AI frame interpolation is applied (see `frame_interpolation`). Omit to keep the source frame rate.\nNote: frame interpolation requires a target of at least 15 fps.\n","type":"integer","maximum":60},"frame_interpolation":{"$ref":"#/components/schemas/frame-interpolation"},"resolution":{"$ref":"#/components/schemas/resolution_2"},"webhook_url":{"format":"uri","description":"Optional callback URL that will receive asynchronous notifications when the upscaling task completes.\nThe webhook will be called with the task status and the upscaled video URL.\n","type":"string"},"enhancement_model":{"$ref":"#/components/schemas/enhancement-model"},"noise":{"default":0,"minimum":0,"description":"Noise reduction / addition intensity applied by the enhancement model.\nValid values range from 0 to 1. Default is 0.\n","type":"number","maximum":1},"video":{"description":"Source video to upscale. A publicly accessible HTTPS URL pointing to the video, or an uploaded file reference (`upl_...`).\n","type":"string"}},"type":"object"},"elevenlabs-v3-request":{"required":["text","voice_id"],"properties":{"stability":{"default":0.5,"minimum":0,"example":0.5,"description":"Controls how closely the delivery sticks to the voice versus how freely it performs the text: 0.0 (Creative) is the most expressive and follows audio tags most strongly, 0.5 (Natural) is balanced, 1.0 (Robust) is the most consistent.","type":"number","maximum":1},"similarity_boost":{"default":0.75,"minimum":0,"example":0.75,"description":"Controls how closely the generated voice matches the original voice. Higher values produce closer matching.","type":"number","maximum":1},"voice_id":{"maxLength":255,"minLength":1,"example":"21m00Tcm4TlvDq8ikWAM","description":"The unique identifier of the ElevenLabs voice to use for synthesis. You can find voice IDs in the ElevenLabs voice library.","type":"string","pattern":"^[a-zA-Z0-9_-]+$"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"text":{"minLength":1,"example":"[excited] Welcome to Magnific! [pause 0.5s] Let's create something amazing.","maxLength":5000,"type":"string","description":"The text to convert to speech, up to 5,000 characters. Supports UTF-8 characters including accented letters and non-Latin scripts.\n\nInline audio tags in square brackets direct the performance instead of being read aloud, e.g. `[excited]`, `[whispers]`, `[laughs]` or `[pause 1s]`.\n"}},"type":"object"},"ttvminimax-768p-request-content":{"title":"Text to Video","allOf":[{"$ref":"#/components/schemas/minimax-hailuo-02-base"},{"properties":{"duration":{"default":6,"enum":[6,10],"example":6,"description":"Video length in seconds","type":"integer"}},"type":"object"}]},"itvminimax-1080p-request-content":{"title":"Image to Video","allOf":[{"$ref":"#/components/schemas/minimax-hailuo-02-base"},{"required":["first_frame_image"],"properties":{"last_frame_image":{"example":"https://img.freepik.com/free-photo/beautiful-sunset-over-mountains_123456-7890.jpg","description":"The model will use the image passed in this parameter as the last frame to generate a video. Supported formats: URL of the image or base64 encoding of the image. Image specifications: format must be JPG, JPEG, or PNG; aspect ratio should be greater than 2:5 and less than 5:2; the shorter side must exceed 300 pixels; file size must not exceed 20MB.","type":"string"},"duration":{"default":6,"enum":[6],"example":6,"description":"Video length in seconds (1080P only supports 6 seconds)","type":"integer"},"first_frame_image":{"example":"https://img.freepik.com/free-photo/beautiful-sunset-over-mountains_123456-7890.jpg","description":"The model will use the image passed in this parameter as the first frame to generate a video. Supported formats: URL of the image or base64 encoding of the image. Image specifications: format must be JPG, JPEG, or PNG; aspect ratio should be greater than 2:5 and less than 5:2; the shorter side must exceed 300 pixels; file size must not exceed 20MB.","type":"string"}},"type":"object"}]},"ttvminimax-1080p-request-content":{"title":"Text to Video","allOf":[{"$ref":"#/components/schemas/minimax-hailuo-02-base"},{"properties":{"duration":{"default":6,"enum":[6],"example":6,"description":"Video length in seconds (1080P only supports 6 seconds)","type":"integer"}},"type":"object"}]},"itvminimax23-768p-request-content":{"title":"Image to Video","allOf":[{"$ref":"#/components/schemas/minimax-hailuo-23-base"},{"required":["first_frame_image"],"properties":{"last_frame_image":{"example":"https://img.freepik.com/free-photo/beautiful-sunset-over-mountains_123456-7890.jpg","description":"The model will use the image passed in this parameter as the last frame to generate a video. Supported formats: URL of the image or base64 encoding of the image. Image specifications: format must be JPG, JPEG, or PNG; aspect ratio should be greater than 2:5 and less than 5:2; the shorter side must exceed 300 pixels; file size must not exceed 20MB.","type":"string"},"duration":{"default":6,"enum":[6,10],"example":6,"description":"Video length in seconds","type":"integer"},"first_frame_image":{"example":"https://img.freepik.com/free-photo/beautiful-sunset-over-mountains_123456-7890.jpg","description":"The model will use the image passed in this parameter as the first frame to generate a video. Supported formats: URL of the image or base64 encoding of the image. Image specifications: format must be JPG, JPEG, or PNG; aspect ratio should be greater than 2:5 and less than 5:2; the shorter side must exceed 300 pixels; file size must not exceed 20MB.","type":"string"}},"type":"object"}]},"minimax-hailuo-23-base":{"required":["prompt"],"properties":{"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"prompt_optimizer":{"default":true,"description":"Whether to use the prompt optimizer. If true, the model will automatically optimize the incoming prompt to improve the generation quality.","type":"boolean"},"prompt":{"example":"A beautiful sunset over the mountains with birds flying in the sky","maxLength":2000,"type":"string","description":"Description of the video. Note: It should be less than 2000 characters."}},"type":"object"},"ttvminimax23-768p-request-content":{"title":"Text to Video","allOf":[{"$ref":"#/components/schemas/minimax-hailuo-23-base"},{"properties":{"duration":{"default":6,"enum":[6,10],"example":6,"description":"Video length in seconds","type":"integer"}},"type":"object"}]},"itvminimax23-1080p-request-content":{"title":"Image to Video","allOf":[{"$ref":"#/components/schemas/minimax-hailuo-23-base"},{"required":["first_frame_image"],"properties":{"last_frame_image":{"example":"https://img.freepik.com/free-photo/beautiful-sunset-over-mountains_123456-7890.jpg","description":"The model will use the image passed in this parameter as the last frame to generate a video. Supported formats: URL of the image or base64 encoding of the image. Image specifications: format must be JPG, JPEG, or PNG; aspect ratio should be greater than 2:5 and less than 5:2; the shorter side must exceed 300 pixels; file size must not exceed 20MB.","type":"string"},"duration":{"default":6,"enum":[6],"example":6,"description":"Video length in seconds (1080P only supports 6 seconds)","type":"integer"},"first_frame_image":{"example":"https://img.freepik.com/free-photo/beautiful-sunset-over-mountains_123456-7890.jpg","description":"The model will use the image passed in this parameter as the first frame to generate a video. Supported formats: URL of the image or base64 encoding of the image. Image specifications: format must be JPG, JPEG, or PNG; aspect ratio should be greater than 2:5 and less than 5:2; the shorter side must exceed 300 pixels; file size must not exceed 20MB.","type":"string"}},"type":"object"}]},"ttvminimax23-1080p-request-content":{"title":"Text to Video","allOf":[{"$ref":"#/components/schemas/minimax-hailuo-23-base"},{"properties":{"duration":{"default":6,"enum":[6],"example":6,"description":"Video length in seconds (1080P only supports 6 seconds)","type":"integer"}},"type":"object"}]},"itvminimax23-768p-fast-request-content":{"title":"Image to Video (Fast)","allOf":[{"$ref":"#/components/schemas/itvminimax23-768p-request-content"}]},"ttvminimax23-768p-fast-request-content":{"title":"Text to Video (Fast)","allOf":[{"$ref":"#/components/schemas/ttvminimax23-768p-request-content"}]},"tool-metadata":{"example":{"sort_order":999,"total_cost":5,"category":"general","icon":"workflow","description_key":"description_key","translation_key":"translation_key"},"properties":{"sort_order":{"example":999,"description":"Display order within category.","type":"integer"},"total_cost":{"example":5,"description":"Total credit cost per execution (sum of all workflow nodes).","type":"integer"},"category":{"example":"general","description":"Category for grouping tools.","type":"string"},"icon":{"example":"workflow","description":"Icon identifier for UI rendering.","type":"string"},"description_key":{"description":"Translation key for the tool description.","type":"string","nullable":true},"translation_key":{"description":"Translation key for the tool name.","type":"string","nullable":true}},"type":"object","description":"Metadata about the tool (UI hints, cost, categorization)."},"frame-interpolation":{"default":"apollo","enum":["apollo","chronos"],"description":"Frame interpolation model used when `target_fps` differs from the source frame rate:\n- `apollo`: recommended for most videos (default)\n- `chronos`: optimized for slow-motion and large frame-rate changes\n","type":"string"},"itvminimax23-1080p-fast-request-content":{"title":"Image to Video (Fast)","allOf":[{"$ref":"#/components/schemas/itvminimax23-1080p-request-content"}]},"ttvminimax23-1080p-fast-request-content":{"title":"Text to Video (Fast)","allOf":[{"$ref":"#/components/schemas/ttvminimax23-1080p-request-content"}]},"relight-request":{"required":["image"],"properties":{"transfer_light_from_lightmap":{"description":"Base64 or URL of the lightmap for light transfer. Icompatible with 'transfer_light_from_reference_image'","type":"string"},"transfer_light_from_reference_image":{"description":"Base64 or URL of the reference image for light transfer. Incompatible with 'transfer_light_from_lightmap'","type":"string"},"prompt":{"description":"You can guide the generation process and influence the light transfer with a descriptive prompt. For example, if the reference image is a brightly lit scene, adding something like \"A sunlit forest clearing at golden hour\" will be helpful.\n\nYou can also use your imagination to alter lighting conditions in images: transforming a daytime scene into a moonlit night, enhancing the warmth of a sunset, or even dramatic changes like casting shadows of towering structures across a cityscape.\n\nIMPORTANT: You can emphasize specific aspects of the light in your prompt by using a number in parentheses, ranging from 1 to 1.4, like \"(dark scene:1.3)\".\n","type":"string"},"interpolate_from_original":{"default":false,"description":"When enabled, this feature will make your final image interpolate from the original using the \"Light transfer strength\" slider, at the cost of sometimes restricting the generation's freedom.\n\nIf disabled, the generation will be freer and will generally produce better results. However, for example, if you want to generate all the frames of a video where a room transitions from having the lights off and very dim lighting to gradually becoming fully illuminated as a new day begins, activating this option might be useful (together with gradually ingreasing the \"Light transfer strength\" slider).\n","type":"boolean"},"change_background":{"default":true,"description":"When enabled, it will change the background based on your prompt and/or reference image. This is super useful for product placement and portraits. However, don't forget to disable it if your scene is something like a landscape or an interior.\n","type":"boolean"},"advanced_settings":{"$ref":"#/components/schemas/relight-request-advanced-settings"},"image":{"description":"Base64 or URL of the image to do the relight","type":"string"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"style":{"default":"standard","enum":["standard","darker_but_realistic","clean","smooth","brighter","contrasted_n_hdr","just_composition"],"type":"string"},"preserve_details":{"default":true,"description":"It will try to maintain the texture and small details of the original image. Especially good for product photography, texts, etc. Disable it if you prefer a smoother result.\n","type":"boolean"},"light_transfer_strength":{"default":100,"minimum":0,"description":"It allows you to specify the level of light transfer, meaning the intensity that your prompt, reference image, or lightmap will have. A value of 0% will keep your image closest to the original, while 100% represents the maximum possible light transfer.\n\nIf you enable \"Interpolate from original\", lower values on this slider will make the result even more similar to your original image.\nValid values range `[0, 100]`, default `100`\n","type":"integer","maximum":100}},"type":"object"},"itvwan-v22-720p-request-content":{"title":"Image to Video - Wan v2.2 720p","allOf":[{"$ref":"#/components/schemas/wan-v22-base"}]},"wan-v22-base":{"required":["image"],"properties":{"seed":{"example":70,"description":"Random seed for video generation.","type":"integer"},"duration":{"default":"5","enum":["5","10"],"example":"5","description":"Video duration in seconds","type":"string"},"prompt":{"example":"A beautiful girl opens her eyes and smiles warmly, the camera gently zooms in capturing the sparkle in her eyes, soft natural lighting","maxLength":2000,"type":"string","description":"The text content used for the video generation. This is the main description of the video to be generated."},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"image":{"example":"https://img.freepik.com/free-photo/beautiful-girl-dancing_123456-7890.jpg","description":"The image to use for the video generation. Supported formats: URL of the image or base64 encoding of the image. Each dimension (width and height) must be between 240px and 8000px. Accepted image formats: JPEG, PNG, WebP. Maximum file size: 10MB.","type":"string"},"aspect_ratio":{"$ref":"#/components/schemas/wan-v22-aspect-ratio"}},"type":"object"},"meta_image":{"example":{"height":1024,"size":"square_1_1","width":1024},"allOf":[{"$ref":"#/components/schemas/image_size"},{"required":["height","width"],"properties":{"width":{"minimum":1,"example":1024,"description":"Image width. If not present, default is `1024`.\nValid values range `[1, 1792]`\n","type":"integer","maximum":1792},"height":{"minimum":1,"example":1024,"description":"Image height","type":"integer","maximum":1792}},"type":"object"}]},"request-content_8":{"required":["image","mask","prompt"],"properties":{"prompt":{"example":"A beautiful sunset over the ocean","description":"The prompt describing the desired changes to the image.","type":"string"},"rendering_speed":{"default":"DEFAULT","enum":["TURBO","DEFAULT","QUALITY"],"example":"DEFAULT","description":"The rendering speed for image generation.\n- TURBO: Fastest, lower quality\n- DEFAULT: Balanced speed and quality\n- QUALITY: Slower, higher quality\n","type":"string"},"magic_prompt":{"example":"AUTO","enum":["AUTO","ON","OFF"],"description":"Determine if MagicPrompt should be used to enhance the prompt.\n- AUTO: Automatically decide\n- ON: Always use MagicPrompt\n- OFF: Never use MagicPrompt\n","type":"string"},"mask":{"example":"iVBORw0KGgoAAAANSUhEUgAA...","description":"A black and white image of the same size as the image being edited.\nBlack regions indicate where to edit the image.\nSupports HTTPS URLs or Base64 encoded string.\nSupported formats: JPEG, WebP, PNG (max 10MB)\n","type":"string"},"color_palette":{"$ref":"#/components/schemas/request_content_8_color_palette"},"seed":{"minimum":0,"example":12345,"description":"Optional seed for reproducibility","type":"integer","maximum":2147483647},"style_type":{"example":"AUTO","enum":["AUTO","GENERAL","REALISTIC","DESIGN"],"description":"The type of style to use. Must be specified if character_reference_images is provided.\n- AUTO: Automatically select style\n- GENERAL: General purpose style\n- REALISTIC: Realistic style\n- DESIGN: Design-oriented style\n","type":"string"},"image":{"example":"iVBORw0KGgoAAAANSUhEUgAA...","description":"The image to be edited. Supports HTTPS URLs or Base64 encoded string.\nSupported formats: JPEG, WebP, PNG (max 10MB)\n","type":"string"},"character_reference_images":{"example":["https://example.com/character-ref.jpg"],"description":"Images to use as character references for consistency.\nProvide as Base64 strings or URLs.\nMaximum total size: 10MB across all references.\nSupported formats: JPEG, PNG, WebP\n","type":"array","items":{"type":"string"}},"style_codes":{"example":["style_code_1","style_code_2"],"description":"A list of style codes to use for image generation","type":"array","items":{"type":"string"}},"style_reference_images":{"example":["https://example.com/style-ref.jpg"],"description":"Images to use as style references. Provide as Base64 strings or URLs.\nMaximum total size: 10MB across all references.\nSupported formats: JPEG, PNG, WebP\n","type":"array","items":{"type":"string"}},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"}},"type":"object"},"ttifd_request_content_styling_effects":{"properties":{"framing":{"enum":["portrait","lowangle","midshot","wideshot","tiltshot","aerial"],"description":"Camera effect to apply","type":"string"},"color":{"enum":["softhue","b&w","goldglow","vibrant","coldneon"],"description":"Color effect to apply","type":"string"},"lightning":{"enum":["iridescent","dramatic","goldenhour","longexposure","indorlight","flash","neon"],"description":"Lightning effect to apply","type":"string"}},"type":"object"},"wan-v22-aspect-ratio":{"default":"auto","enum":["auto","widescreen_16_9","social_story_9_16","square_1_1","classic_4_3"],"example":"auto","description":"Video aspect ratio.`","type":"string"},"itvwan-v22-580p-request-content":{"title":"Image to Video - Wan v2.2 580p","allOf":[{"$ref":"#/components/schemas/wan-v22-base"}]},"itvwan-v22-480p-request-content":{"title":"Image to Video - Wan v2.2 480p","allOf":[{"$ref":"#/components/schemas/wan-v22-base"}]},"t2v-wan-v26-720p-request-content":{"title":"Text to Video - WAN v2.6 720p","description":"Generate 720p video from text prompt using WAN v2.6 model. Supports 5 aspect ratios: 16:9, 9:16, 1:1, 4:3, and 3:4.","allOf":[{"$ref":"#/components/schemas/wan-v26-t2v-720p-base"}]},"wan-v26-t2v-720p-base":{"required":["prompt"],"title":"WAN v2.6 Text-to-Video 720p Base","type":"object","allOf":[{"$ref":"#/components/schemas/wan-v26-720p-base"}]},"wan-v26-720p-base":{"type":"object","allOf":[{"$ref":"#/components/schemas/wan-v26-common"},{"properties":{"size":{"default":"1280*720","enum":["1280*720","720*1280","960*960","1088*832","832*1088"],"example":"1280*720","description":"Video size for the 720p resolution tier. Available aspect ratios:\n- `1280*720`: Landscape (16:9)\n- `720*1280`: Portrait (9:16)\n- `960*960`: Square (1:1)\n- `1088*832`: Standard landscape (4:3)\n- `832*1088`: Standard portrait (3:4)\n","type":"string"}},"type":"object"}]},"ttifd_request_content_styling":{"properties":{"effects":{"$ref":"#/components/schemas/ttifd_request_content_styling_effects"},"colors":{"maxItems":5,"items":{"$ref":"#/components/schemas/colors_palette_inner"},"minItems":1,"description":"Dominant colors to generate the image","type":"array"}},"type":"object","description":"Styling options for the image"},"ttif2t_request_content_image_size":{"properties":{"width":{"minimum":512,"example":1024,"description":"Image width in pixels","type":"integer","maximum":2048},"height":{"minimum":512,"example":1024,"description":"Image height in pixels","type":"integer","maximum":2048}},"description":"Custom image dimensions (alternative to using standard aspect ratios).\n\n**Valid range:** 512 to 2048 pixels for both width and height\n**Default:** 1024×1024 if not specified\n\n**Note:** Total resolution affects cost and generation time.\n","type":"object","nullable":true},"MusicListItem":{"required":["id","title"],"example":{"favorites":350,"popularity":85,"cover_url":"cover_url","artist":{"name":"John Doe"},"moods":[{"name":"Happy"},{"name":"Energetic"}],"created_at":"2000-01-23T04:56:07.000+00:00","is_premium":true,"genres":[{"name":"Electronic"},{"name":"Ambient"}],"preview_url":"preview_url","download_url":"download_url","is_active":true,"file_url":"file_url","seconds":225,"title":"Summer Vibes","in_playlists":15,"downloads":1200,"id":1,"time":"3:45"},"properties":{"time":{"example":"3:45","description":"Music duration formatted as minutes and seconds","type":"string"},"file_url":{"description":"Direct S3/CDN URL to the audio file","type":"string","nullable":true},"cover_url":{"description":"URL to the music cover image","type":"string","nullable":true},"artist":{"$ref":"#/components/schemas/MusicListArtist"},"moods":{"example":[{"name":"Happy"},{"name":"Energetic"}],"description":"Mood tags from the search index","type":"array","items":{"$ref":"#/components/schemas/MoodSearchTag"}},"created_at":{"format":"date-time","description":"Music creation timestamp","type":"string"},"is_premium":{"description":"Whether the music is premium","type":"boolean"},"genres":{"example":[{"name":"Electronic"},{"name":"Ambient"}],"description":"Genre tags from the search index","type":"array","items":{"$ref":"#/components/schemas/GenreSearchTag"}},"preview_url":{"description":"Preview URL for the audio file (same as file_url)","type":"string","nullable":true},"download_url":{"description":"URL to download the music","type":"string","nullable":true},"is_active":{"description":"Whether the music is active","type":"boolean"},"title":{"example":"Summer Vibes","description":"Music title","type":"string"},"popularity":{"example":85,"description":"Popularity score","type":"integer"},"id":{"example":1,"description":"Unique identifier of the music item","type":"integer"},"seconds":{"example":225,"description":"Music duration in seconds","type":"integer"},"downloads":{"example":1200,"description":"Total number of downloads","type":"integer"},"favorites":{"example":350,"description":"Total number of favorites","type":"integer"},"in_playlists":{"example":15,"description":"Number of playlists containing this music","type":"integer"}},"type":"object","description":"Music item returned by search results (MeilisearchTrackSerializer). Fields are only included when non-null in the search index."},"t2v-wan-25-720p-request-content":{"title":"Text to Video - WAN 2.5 720p","description":"Generate 720p video from text prompt using WAN 2.5 model","allOf":[{"$ref":"#/components/schemas/wan-25-t2v-base"}]},"tti_nano_banana_pro_request_reference_images_inner":{"required":["image","mime_type"],"properties":{"image":{"example":"https://example.com/reference-image.jpg","description":"Image URL (publicly accessible URL or GCS format)","type":"string"},"text":{"example":"Reference style for lighting and composition","description":"Optional text description to attach to the reference image","type":"string"},"mime_type":{"example":"image/jpeg","enum":["image/png","image/jpeg","image/webp"],"description":"MIME type of the image","type":"string"}},"type":"object"},"wan-v26-common":{"properties":{"shot_type":{"default":"single","enum":["single","multi"],"example":"single","description":"Shot composition type:\n- `single`: Continuous single shot (default, recommended for most use cases)\n- `multi`: Multi-shot sequence with scene transitions (requires enable_prompt_expansion=true)\n","type":"string"},"negative_prompt":{"example":"blurry, low quality, watermark","maxLength":1000,"type":"string","description":"Things to avoid in the generated video. Use this to prevent unwanted elements.\n\n**Examples:** \"blurry, low quality, watermark, text, distortion, extra limbs\"\n"},"prompt":{"example":"A serene mountain landscape at golden hour with mist rising from the valley","maxLength":2000,"type":"string","description":"Main description of the video - scene, characters, motion, camera moves, style.\n\n**Tips:**\n- Be specific about scenes and visual details\n- Describe camera movements (zoom, pan, tilt)\n- Mention lighting and atmosphere\n\n**Examples:**\n- Simple: \"a cat sitting on a windowsill\"\n- Detailed: \"fluffy orange cat on wooden windowsill, looking at snow falling outside, soft warm lighting, camera slowly zooms in\"\n"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"duration":{"default":"5","enum":["5","10","15"],"example":"5","description":"Video duration in seconds:\n- `5`: Short clip, faster generation\n- `10`: Medium length, more developed action\n- `15`: Longer video, most detailed scenes\n","type":"string"},"enable_prompt_expansion":{"default":false,"example":false,"type":"boolean","description":"Enable AI prompt optimizer to expand shorter prompts into detailed scripts.\nUseful when you have a simple idea but want richer video output.\n"},"seed":{"default":-1,"minimum":-1,"example":12345,"description":"Random seed for reproducibility. Use the same seed with identical parameters to get similar results.\nSet to -1 for random seed.\n","type":"integer","maximum":2147483647}},"type":"object"},"reimagine-flux-request":{"required":["image"],"properties":{"imagination":{"enum":["wild","subtle","vivid"],"description":"Imagination type","type":"string"},"image":{"format":"byte","description":"Base64 image to do the reimagination","type":"string"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"prompt":{"example":"A beautiful sunset over a calm ocean","type":"string"},"aspect_ratio":{"default":"original","enum":["original","square_1_1","classic_4_3","traditional_3_4","widescreen_16_9","social_story_9_16","standard_3_2","portrait_2_3","horizontal_2_1","vertical_1_2","social_post_4_5"],"description":"Image size with the aspect ratio. The aspect ratio is the proportional relationship between an image's width and height, expressed as *_width_height (e.g., square_1_1, widescreen_16_9). It is calculated by dividing the width by the height.\\\nIf not present, the default is `original`.\n","type":"string"}},"type":"object"},"icons_related":{"example":{"style":[{"name":"a woman reads a book in a tablet sits in the luxurious back of the library","free_svg":true,"thumbnails":[{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512},{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512}],"created":"2023-03-07T23:05:26Z","id":52912,"slug":"a-woman-reads-a-book-in-a-tablet-sits-in-the-luxurious-back-of-the-library","family":{"name":"Outline","total":1200,"id":1},"style":{"name":"Meticulous Yellow shadow","id":50},"author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}},{"name":"a woman reads a book in a tablet sits in the luxurious back of the library","free_svg":true,"thumbnails":[{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512},{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512}],"created":"2023-03-07T23:05:26Z","id":52912,"slug":"a-woman-reads-a-book-in-a-tablet-sits-in-the-luxurious-back-of-the-library","family":{"name":"Outline","total":1200,"id":1},"style":{"name":"Meticulous Yellow shadow","id":50},"author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}}],"variants":[{"name":"a woman reads a book in a tablet sits in the luxurious back of the library","free_svg":true,"thumbnails":[{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512},{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512}],"created":"2023-03-07T23:05:26Z","id":52912,"slug":"a-woman-reads-a-book-in-a-tablet-sits-in-the-luxurious-back-of-the-library","family":{"name":"Outline","total":1200,"id":1},"style":{"name":"Meticulous Yellow shadow","id":50},"author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}},{"name":"a woman reads a book in a tablet sits in the luxurious back of the library","free_svg":true,"thumbnails":[{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512},{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512}],"created":"2023-03-07T23:05:26Z","id":52912,"slug":"a-woman-reads-a-book-in-a-tablet-sits-in-the-luxurious-back-of-the-library","family":{"name":"Outline","total":1200,"id":1},"style":{"name":"Meticulous Yellow shadow","id":50},"author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}}],"visual_concept":[{"name":"a woman reads a book in a tablet sits in the luxurious back of the library","free_svg":true,"thumbnails":[{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512},{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512}],"created":"2023-03-07T23:05:26Z","id":52912,"slug":"a-woman-reads-a-book-in-a-tablet-sits-in-the-luxurious-back-of-the-library","family":{"name":"Outline","total":1200,"id":1},"style":{"name":"Meticulous Yellow shadow","id":50},"author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}},{"name":"a woman reads a book in a tablet sits in the luxurious back of the library","free_svg":true,"thumbnails":[{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512},{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512}],"created":"2023-03-07T23:05:26Z","id":52912,"slug":"a-woman-reads-a-book-in-a-tablet-sits-in-the-luxurious-back-of-the-library","family":{"name":"Outline","total":1200,"id":1},"style":{"name":"Meticulous Yellow shadow","id":50},"author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}}]},"properties":{"style":{"description":"Related icons by style","type":"array","items":{"$ref":"#/components/schemas/icon"}},"variants":{"description":"Icon's variants, same icon with different colors","type":"array","items":{"$ref":"#/components/schemas/icon"}},"visual_concept":{"description":"Related Icons by visual concept","type":"array","items":{"$ref":"#/components/schemas/icon"}}},"type":"object"},"team_credit_usage_response_inner_consumptions_inner_user_usages_inner":{"example":{"user_email":"designer@company.com","user_reference":"usr_a3f81c2d9e4b7f60","project_name":"Marketing Campaign","api_key_id":"d98b3edd-38c6-4f03-a9bd-da6eff110782","group_name":"Design Team","project_reference":"a1b2c3d4-1111-4000-8000-000000000001","api_key_name":"prod-batch","user_credits":1200,"user_uses":30},"properties":{"user_email":{"example":"designer@company.com","description":"User email address. `null` when the user could not be resolved\n(deleted account) and on entries generated by an API key, which\nbelong to no person. The consumption is still counted in the\nparent totals either way.\n\nTo attribute a `null` entry, use `api_key_id` when it is\npresent — the entry came from a key, not a person — and\n`user_reference` otherwise.\n","type":"string","nullable":true},"user_reference":{"example":"usr_a3f81c2d9e4b7f60","description":"Opaque, stable identifier of the person behind this entry. It\ndoes not change over time, so entries from different periods\nbelonging to the same person can be matched even once their\naccount has been deleted and `user_email` has become `null`.\n\nIt reveals nothing about the person and is scoped to your team:\nthe same individual appears under a different reference in\nanother team's reports.\n\n`null` on entries generated by an API key, which belong to no\nperson — use `api_key_id` there — and on entries whose user has\nno reference available.\n","type":"string","nullable":true},"project_name":{"example":"Marketing Campaign","description":"Project name, if resolvable.","type":"string"},"api_key_id":{"example":"d98b3edd-38c6-4f03-a9bd-da6eff110782","description":"API key that generated this consumption, when it was not made by\na person. Matches `api_key_id` in `GET /v1/analytics/team-api-keys`,\nso the two responses can be joined. Absent on entries made by a\nperson.\n","type":"string","nullable":true},"user_uses":{"example":30,"description":"Number of operations by this user.","type":"integer"},"group_name":{"example":"Design Team","description":"Group name, if resolvable.","type":"string"},"api_key_name":{"example":"prod-batch","description":"Display name of `api_key_id`. `null` when the name cannot be\nresolved; the entry is still attributable through `api_key_id`.\nKeys deleted after generating the consumption keep their name.\n","type":"string","nullable":true},"user_credits":{"example":1200,"description":"Credits consumed by this user.","type":"integer"},"project_reference":{"example":"a1b2c3d4-1111-4000-8000-000000000001","description":"Project UUID, if any.","type":"string"}},"type":"object"},"available_formats":{"properties":{"ai":{"$ref":"#/components/schemas/formats_1"},"png":{"$ref":"#/components/schemas/formats_1"},"psd":{"$ref":"#/components/schemas/formats_1"},"eps":{"$ref":"#/components/schemas/formats_1"},"atn":{"$ref":"#/components/schemas/formats_1"},"fonts":{"$ref":"#/components/schemas/formats_1"},"jpg":{"$ref":"#/components/schemas/formats_1"},"3d-render":{"$ref":"#/components/schemas/formats_1"},"svg":{"$ref":"#/components/schemas/formats_1"},"zip":{"$ref":"#/components/schemas/formats_1"},"resources":{"$ref":"#/components/schemas/formats_1"}},"description":"The available formats for the resource.","type":"object","nullable":true},"duration":{"default":5,"enum":[3,4,5,6,7,8,9,10,11,12,13,14,15],"description":"Duration of the generated video in seconds. One of: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15.","type":"integer"},"tti_nano_banana_2_1_request_reference_images_inner":{"required":["image"],"properties":{"image":{"example":"https://example.com/product.png","description":"Reference image as a public HTTPS URL or a base64-encoded string","type":"string"},"text":{"example":"Image 1","description":"Optional caption attached to this image. When omitted, the image is\ncaptioned `Image N` (its 1-based position in the list), so the\nprompt can refer to it as \"Image 1\", \"Image 2\", and so on.\n","type":"string"},"mime_type":{"example":"image/png","enum":["image/png","image/jpeg","image/webp"],"description":"MIME type of the image. Optional: when omitted it is derived from the image.","type":"string"}},"type":"object"},"text-to-icon-request":{"properties":{"format":{"$ref":"#/components/schemas/text-to-icon-format"}},"allOf":[{"$ref":"#/components/schemas/text-to-icon-request-preview"}]},"text-to-icon-request-preview":{"required":["prompt","webhook_url"],"properties":{"num_inference_steps":{"minimum":10,"example":10,"description":"The number of inference steps to use for the generation","type":"integer","maximum":50},"prompt":{"example":"A cute cat icon","description":"The prompt to generate the icon","type":"string"},"webhook_url":{"example":"https://example.com/webhook","format":"uri","description":"The webhook URL to receive the result","type":"string"},"style":{"default":"solid","enum":["solid","outline","color","flat","sticker"],"example":"solid","description":"The style to use for the icon","type":"string"},"guidance_scale":{"minimum":0,"example":7,"description":"The guidance scale to use for the generation","type":"number","maximum":10}},"type":"object"},"t2v-wan-v26-1080p-request-content":{"title":"Text to Video - WAN v2.6 1080p","description":"Generate 1080p video from text prompt using WAN v2.6 model. Supports 5 aspect ratios: 16:9, 9:16, 1:1, 4:3, and 3:4.","allOf":[{"$ref":"#/components/schemas/wan-v26-t2v-1080p-base"}]},"request-content_4":{"required":["video"],"properties":{"resolution":{"$ref":"#/components/schemas/resolution_1"},"sharpen":{"default":0,"minimum":0,"description":"Video sharpness intensity control. Higher values increase edge definition and clarity.\nValid values range from 0 (no sharpening) to 100 (maximum sharpness). Default is 0.\n","type":"integer","maximum":100},"smart_grain":{"default":0,"minimum":0,"description":"Applies a film grain effect to the output video. Helps preserve natural film grain and texture detail.\nValid values range from 0 (no grain) to 100 (maximum grain). Default is 0.\n","type":"integer","maximum":100},"webhook_url":{"format":"uri","description":"Optional callback URL that will receive asynchronous notifications when the upscaling task completes.\nThe webhook will be called with the task status and the upscaled video URL.\n","type":"string"},"creativity":{"default":0,"minimum":0,"description":"Creativity intensity. Controls how much creative freedom is applied during upscaling.\nValid values range from 0 (no creativity) to 100 (maximum creativity). Default is 0.\n","type":"integer","maximum":100},"video":{"description":"Source video to upscale. Must be a publicly accessible HTTPS URL pointing to the video.\n","type":"string"},"output_format":{"$ref":"#/components/schemas/output-format"},"fps_boost":{"default":false,"description":"Enable FPS boost to increase the frame rate of the upscaled video.","type":"boolean"},"flavor":{"$ref":"#/components/schemas/flavor_1"}},"type":"object"},"kling_4k_i2v_request_dynamic_masks_inner_trajectories_inner":{"required":["x","y"],"properties":{"x":{"description":"Horizontal coordinate (X-coordinate) in 2D pixel system.","type":"integer"},"y":{"description":"Vertical coordinate (Y-coordinate) in 2D pixel system.","type":"integer"}},"type":"object"},"team_credit_usage_response_inner_consumptions_inner":{"example":{"user_usages":[{"user_email":"designer@company.com","user_reference":"usr_a3f81c2d9e4b7f60","project_name":"Marketing Campaign","api_key_id":"d98b3edd-38c6-4f03-a9bd-da6eff110782","group_name":"Design Team","project_reference":"a1b2c3d4-1111-4000-8000-000000000001","api_key_name":"prod-batch","user_credits":1200,"user_uses":30},{"user_email":"designer@company.com","user_reference":"usr_a3f81c2d9e4b7f60","project_name":"Marketing Campaign","api_key_id":"d98b3edd-38c6-4f03-a9bd-da6eff110782","group_name":"Design Team","project_reference":"a1b2c3d4-1111-4000-8000-000000000001","api_key_name":"prod-batch","user_credits":1200,"user_uses":30}],"tool_name":"pikaso-tti-flux-dev","user_uses":45,"user_credits":1800,"tool":"AI Image Models"},"properties":{"user_usages":{"description":"Per-user breakdown. Always included.\n\nAn entry is normally attributable to one of two things: a person,\nidentified by `user_email` and `user_reference`, or an API key,\nidentified by `api_key_id` and `api_key_name`.\n\nAn entry may still carry none of them. That happens when the user\nbehind it cannot be resolved and no reference is available for them,\nand it is real usage that is counted in the parent totals like any\nother — reconcile it against those totals rather than treating it as\nmissing data.\n","type":"array","items":{"$ref":"#/components/schemas/team_credit_usage_response_inner_consumptions_inner_user_usages_inner"}},"tool_name":{"example":"pikaso-tti-flux-dev","description":"Specific tool that was billed. Two rows with the same `tool`, user,\nproject and date are distinct consumptions, not duplicates: they are\ntold apart by this field and their credits must be summed, not\nde-duplicated.\n","type":"string"},"user_uses":{"example":45,"description":"Number of operations in this period.","type":"integer"},"user_credits":{"example":1800,"description":"Total credits consumed.","type":"integer"},"tool":{"example":"AI Image Models","description":"Tool category display name. Many tools share a category, so this\nvalue does not identify a row on its own — use `tool_name` for that.\n","type":"string"}},"type":"object"},"wan-v26-t2v-1080p-base":{"required":["prompt"],"title":"WAN v2.6 Text-to-Video 1080p Base","type":"object","allOf":[{"$ref":"#/components/schemas/wan-v26-1080p-base"}]},"kling_4k_i2v_request_dynamic_masks_inner":{"required":["mask","trajectories"],"properties":{"mask":{"description":"Dynamic mask image for defining motion brush application areas with trajectories.\n\n● Support inputting image Base64 encoding or image URL (ensure the URL is accessible and follows the same format requirements as the image field).\n● Supported image formats include .jpg / .jpeg / .png\n● The aspect ratio of the mask image must match the input image (image field); otherwise, the task will fail (failed).\n● The resolutions of the static_mask image and the dynamic_masks.mask image must be identical; otherwise, the task will fail (failed).","type":"string"},"trajectories":{"description":"Motion Trajectory Coordinate Sequence","type":"array","items":{"$ref":"#/components/schemas/kling_4k_i2v_request_dynamic_masks_inner_trajectories_inner"}}},"type":"object"},"team_project_budget":{"required":["assigned","available","consumed"],"description":"Credit budget of the project, or `null` when it has no active budget — which is not the same as a budget of zero: without one the project spends from its group or the organization pool. Always `null` on non-Enterprise teams. Consumption is tracked against the budget, so what the project has left is `available`, already computed as `assigned - consumed` and never negative.","example":{"consumed":5000000,"available":10000000,"assigned":15000000},"properties":{"consumed":{"minimum":0,"example":5000000,"format":"int64","description":"Credits the project has already spent from its budget. It can end up above `assigned` (for example, when the budget is lowered after spending), in which case `available` is 0.","type":"integer"},"available":{"minimum":0,"example":10000000,"format":"int64","description":"Credits the project can still spend, `assigned - consumed` floored at 0.","type":"integer"},"assigned":{"minimum":0,"example":15000000,"format":"int64","description":"Credits reserved for this project.","type":"integer"}},"type":"object","nullable":true},"wan-v26-1080p-base":{"type":"object","allOf":[{"$ref":"#/components/schemas/wan-v26-common"},{"properties":{"size":{"default":"1920*1080","enum":["1920*1080","1080*1920","1440*1440","1632*1248","1248*1632"],"example":"1920*1080","description":"Video size for the 1080p resolution tier. Available aspect ratios:\n- `1920*1080`: Landscape (16:9)\n- `1080*1920`: Portrait (9:16)\n- `1440*1440`: Square (1:1)\n- `1632*1248`: Standard landscape (4:3)\n- `1248*1632`: Standard portrait (3:4)\n","type":"string"}},"type":"object"}]},"request_content_8_color_palette":{"properties":{"name":{"enum":["EMBER","FRESH","JUNGLE","MAGIC","MELON","MOSAIC","PASTEL","ULTRAMARINE"],"description":"A color palette preset value","type":"string"},"members":{"description":"Custom color palette members","type":"array","items":{"$ref":"#/components/schemas/request_content_8_color_palette_members_inner"}}},"type":"object","description":"A color palette for generation. Specify either name (preset) or members (custom colors), not both.\n"},"author":{"example":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647},"required":["assets","avatar","id","name","slug"],"type":"object","properties":{"name":{"example":"John Doe","type":"string","minLength":1},"assets":{"minimum":0,"description":"The number of assets of this author.","type":"integer"},"slug":{"example":"merry-christmas","type":"string","minLength":1},"avatar":{"example":"https://avatar.cdnpk.net/61668527-220726032514.jpg","format":"uri","type":"string"},"id":{"minimum":1,"type":"integer","maximum":9.2233720368548e+18}}},"text-to-icon-format":{"default":"png","enum":["png","svg"],"example":"svg","description":"The format of the icon","type":"string"},"image-expand-request":{"required":["image"],"properties":{"top":{"default":256,"maximum":2048,"description":"Pixels to expand on the top. Omit the field to use the default of `256`;\nsend `0` to leave this edge unexpanded.\n","minimum":0,"type":"integer","nullable":true},"prompt":{"description":"The description of the changes you want to make. This text guides the expansion process, allowing you to specify features, styles, or modifications for the expanded areas.","type":"string"},"bottom":{"default":256,"maximum":2048,"description":"Pixels to expand on the bottom. Omit the field to use the default of `256`;\nsend `0` to leave this edge unexpanded.\n","minimum":0,"type":"integer","nullable":true},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"image":{"format":"byte","description":"Base64 image to expand","type":"string"},"left":{"default":512,"maximum":2048,"description":"Pixels to expand on the left. Omit the field to use the default of `512`;\nsend `0` to leave this edge unexpanded. The requested size is not always\nthe size you get back — see the description of this endpoint.\n","minimum":0,"type":"integer","nullable":true},"right":{"default":512,"maximum":2048,"description":"Pixels to expand on the right. Omit the field to use the default of `512`;\nsend `0` to leave this edge unexpanded.\n","minimum":0,"type":"integer","nullable":true}},"type":"object"},"request_10":{"required":["prompt"],"properties":{"style":{"$ref":"#/components/schemas/style-enum"},"generate_audio_switch":{"default":false,"description":"When set to `true`, PixVerse-V6 generates synchronized audio (background music, sound effects, or dialogue) together with the video.","type":"boolean"},"duration":{"default":5,"minimum":1,"description":"Duration of the generated video in seconds. PixVerse-V6 accepts any\ninteger value from `1` to `15` (PixVerse-V5.5 only accepted `5`, `8`\nor `10`).\n","type":"integer","maximum":15},"prompt":{"description":"Text prompt describing the video to generate.","type":"string"},"resolution":{"$ref":"#/components/schemas/resolution_4"},"thinking_type":{"$ref":"#/components/schemas/thinking-type"},"seed":{"description":"The same seed and the same prompt given to the same version of the model will output the same video every time.","type":"integer"},"negative_prompt":{"default":"","description":"Negative prompt to be used for the generation.","type":"string"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"generate_multi_clip_switch":{"default":false,"description":"When set to `true`, PixVerse-V6 produces multi-clip output with dynamic camera changes within a single generation.","type":"boolean"},"aspect_ratio":{"$ref":"#/components/schemas/aspect-ratio_4"}},"type":"object"},"mystic_request_styling_styles_inner":{"required":["name"],"properties":{"name":{"description":"Name of the style to apply.\n**The name of the style can be found in the `v1/ai/loras` endpoint.**\n","type":"string"},"strength":{"default":100,"minimum":0,"description":"Strength of the style to apply. The higher the value, the more the style will be applied to the image. Some styles may not be affected by this parameter.\n\nValid values range `[0, 200]`. Default value is `100`.\n","type":"number","maximum":200}},"type":"object"},"i2v-wan-v26-720p-request-content":{"title":"Image to Video - WAN v2.6 720p","description":"Generate 720p video from image using WAN v2.6 model. Supports 5 aspect ratios: 16:9, 9:16, 1:1, 4:3, and 3:4.","allOf":[{"$ref":"#/components/schemas/wan-v26-i2v-720p-base"}]},"advanced-custom-elements-tag-id":{"enum":["o_101","o_102","o_103","o_104","o_105","o_106","o_107","o_108"],"description":"Tag category for the element:\n- `o_101`: Hottest\n- `o_102`: Character\n- `o_103`: Animal\n- `o_104`: Item\n- `o_105`: Costume\n- `o_106`: Scene\n- `o_107`: Effect\n- `o_108`: Others\n","type":"string"},"mystic_request_styling_characters_inner":{"required":["strength"],"properties":{"strength":{"default":100,"minimum":0,"description":"Strength of the character to apply. The higher the value, the more the character will be applied to the image.\nIf ID is not set, the strength will be applied to the character specified in the `prompt` field.\n\nValid values range `[0, 200]`. Default value is `100`.\n","type":"number","maximum":200},"id":{"description":"ID of the character to modify.\n**This ID can be found in the `v1/ai/loras` endpoint.**\n","type":"string"}},"type":"object"},"download_resource_by_id_200_response_data":{"anyOf":[{"$ref":"#/components/schemas/download"},{"$ref":"#/components/schemas/ai_download"}]},"wan-v26-i2v-720p-base":{"required":["image","prompt"],"title":"WAN v2.6 Image-to-Video 720p Base","type":"object","allOf":[{"$ref":"#/components/schemas/wan-v26-720p-base"},{"properties":{"image":{"example":"https://example.com/image.jpg","description":"URL of the keyframe or base image to animate. Must be publicly accessible.\n\n**Supported formats:** JPEG, PNG, WebP\n**Dimension constraints:** Each dimension (width and height) must be between 240px and 8000px.\n**Maximum file size:** 10MB\n**Recommended:** High quality image with clear subject\n","type":"string"}},"type":"object"}]},"mystic_request_styling":{"properties":{"characters":{"description":"Modify the characters introduced in the `prompt` field adjusting their strength","maxItems":1,"type":"array","items":{"$ref":"#/components/schemas/mystic_request_styling_characters_inner"}},"styles":{"maxItems":1,"type":"array","items":{"$ref":"#/components/schemas/mystic_request_styling_styles_inner"}},"colors":{"maxItems":5,"items":{"$ref":"#/components/schemas/colors_palette_inner"},"minItems":1,"description":"Dominant colors to generate the image","type":"array"}},"type":"object","description":"Styling options for the image"},"search_resources_200_response_data_inner":{"anyOf":[{"$ref":"#/components/schemas/vector_psd_resource"},{"$ref":"#/components/schemas/photo_resource"}]},"input_definition_config":{"properties":{"mediaType":{"example":"image","enum":["image","video","audio"],"description":"For `creation` type — the expected media kind.","type":"string"}},"description":"Type-specific configuration.\nFor `creation` type: contains `mediaType` (image, video, audio).\nFor `select` type: may contain `options`.\nNull when not applicable (e.g. for `text` type).\n","type":"object","nullable":true},"i2v-wan-v26-1080p-request-content":{"title":"Image to Video - WAN v2.6 1080p","description":"Generate 1080p video from image using WAN v2.6 model. Supports 5 aspect ratios: 16:9, 9:16, 1:1, 4:3, and 3:4.","allOf":[{"$ref":"#/components/schemas/wan-v26-i2v-1080p-base"}]},"image-expand-ideogram-request":{"required":["bottom","image","left","right","top"],"properties":{"top":{"minimum":0,"description":"Number of pixels to expand on the top side","type":"integer","maximum":2048},"seed":{"minimum":0,"description":"Optional seed for reproducibility","type":"integer","maximum":2147483647},"image":{"format":"byte","description":"Base64 image to expand","type":"string"},"bottom":{"minimum":0,"description":"Number of pixels to expand on the bottom side","type":"integer","maximum":2048},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"left":{"minimum":0,"description":"Number of pixels to expand on the left side","type":"integer","maximum":2048},"prompt":{"description":"Optional text prompt describing the desired expanded content. If not provided, the AI model will auto-generate a prompt based on the image.","type":"string"},"right":{"minimum":0,"description":"Number of pixels to expand on the right side","type":"integer","maximum":2048}},"type":"object"},"input_definition_presentation":{"properties":{"mode":{"example":"textarea","description":"The UI control mode (e.g. `textarea`, `input`).","type":"string"},"type":{"example":"text","description":"The presentation type.","type":"string"}},"description":"UI presentation hints for rendering the input.\nPresent for `text` type inputs; null or absent for other types.\n","type":"object","nullable":true},"classifier_request_image":{"description":"Base64-encoded image string or URL pointing to an image.","oneOf":[{"format":"byte","description":"Base64-encoded image string.","type":"string"},{"format":"uri","description":"URL pointing to an image.","type":"string"},{"format":"binary","description":"Binary encoded image string.","type":"string"}]},"wan-v26-i2v-1080p-base":{"required":["image","prompt"],"title":"WAN v2.6 Image-to-Video 1080p Base","type":"object","allOf":[{"$ref":"#/components/schemas/wan-v26-1080p-base"},{"properties":{"image":{"example":"https://example.com/image.jpg","description":"URL of the keyframe or base image to animate. Must be publicly accessible.\n\n**Supported formats:** JPEG, PNG, WebP\n**Dimension constraints:** Each dimension (width and height) must be between 240px and 8000px.\n**Maximum file size:** 10MB\n**Recommended:** High quality image with clear subject\n","type":"string"}},"type":"object"}]},"related_same_series_same_series":{"required":["items","url"],"description":"Other photos which belongs to the same photo series.","example":{"items":[{"name":"White t-shirt with copy space on gray background","preview":{"height":500,"url":"https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm","width":300},"premium":true,"new":true,"id":15667327,"has_prompt":true,"is_ai_generated":true,"slug":"merry-christmas","url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm","type":"vector","author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}},{"name":"White t-shirt with copy space on gray background","preview":{"height":500,"url":"https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm","width":300},"premium":true,"new":true,"id":15667327,"has_prompt":true,"is_ai_generated":true,"slug":"merry-christmas","url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm","type":"vector","author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}}],"url":"https://www.freepik.com/serie/32689488"},"properties":{"url":{"example":"https://www.freepik.com/serie/32689488","format":"uri","description":"The url of the series.","type":"string"},"items":{"description":"Other resources which belongs to the same photo series.","type":"array","items":{"$ref":"#/components/schemas/resource"}}},"type":"object","nullable":true},"t2v-wan-25-480p-request-content":{"title":"Text to Video - WAN 2.5 480p","description":"Generate 480p video from text prompt using WAN 2.5 model","allOf":[{"$ref":"#/components/schemas/wan-25-t2v-base"}]},"run_detail_result":{"description":"Execution output. Contains arrays of generated assets grouped by media type.\nNull while the run is still in progress or if the execution failed.\n\nAsset URLs are **temporary** and valid for 12 hours.\n","example":{"videos":[{"id":"LSFgqqrswO","duration":0.80082819046101,"width":6,"created_at":"2026-02-11T10:14:15Z","height":1,"url":"https://pikaso.cdnpk.net/private/production/3280037299/render.png?token=...","tool":"text-to-image"},{"id":"LSFgqqrswO","duration":0.80082819046101,"width":6,"created_at":"2026-02-11T10:14:15Z","height":1,"url":"https://pikaso.cdnpk.net/private/production/3280037299/render.png?token=...","tool":"text-to-image"}],"audios":[{"id":"LSFgqqrswO","duration":0.80082819046101,"width":6,"created_at":"2026-02-11T10:14:15Z","height":1,"url":"https://pikaso.cdnpk.net/private/production/3280037299/render.png?token=...","tool":"text-to-image"},{"id":"LSFgqqrswO","duration":0.80082819046101,"width":6,"created_at":"2026-02-11T10:14:15Z","height":1,"url":"https://pikaso.cdnpk.net/private/production/3280037299/render.png?token=...","tool":"text-to-image"}],"images":[{"id":"LSFgqqrswO","duration":0.80082819046101,"width":6,"created_at":"2026-02-11T10:14:15Z","height":1,"url":"https://pikaso.cdnpk.net/private/production/3280037299/render.png?token=...","tool":"text-to-image"},{"id":"LSFgqqrswO","duration":0.80082819046101,"width":6,"created_at":"2026-02-11T10:14:15Z","height":1,"url":"https://pikaso.cdnpk.net/private/production/3280037299/render.png?token=...","tool":"text-to-image"}]},"properties":{"videos":{"description":"Generated video assets.","type":"array","items":{"$ref":"#/components/schemas/webhook-result-item"}},"audios":{"description":"Generated audio assets.","type":"array","items":{"$ref":"#/components/schemas/webhook-result-item"}},"images":{"description":"Generated image assets.","type":"array","items":{"$ref":"#/components/schemas/webhook-result-item"}}},"type":"object","nullable":true},"image-expand-seedream-v4-5-request":{"required":["bottom","image","left","right","top"],"properties":{"top":{"minimum":0,"description":"Number of pixels to expand on the top side","type":"integer","maximum":2048},"seed":{"minimum":0,"description":"Optional seed for reproducibility","type":"integer","maximum":2147483647},"image":{"description":"Image to expand. Accepts an HTTPS URL or a Base64-encoded image (max 10MB).","type":"string"},"bottom":{"minimum":0,"description":"Number of pixels to expand on the bottom side","type":"integer","maximum":2048},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"left":{"minimum":0,"description":"Number of pixels to expand on the left side","type":"integer","maximum":2048},"prompt":{"description":"Optional text prompt describing the desired expanded content. If not provided, the AI model will auto-generate a prompt based on the image.","type":"string"},"right":{"minimum":0,"description":"Number of pixels to expand on the right side","type":"integer","maximum":2048}},"type":"object"},"ttisdv5l-edit-request-content":{"allOf":[{"$ref":"#/components/schemas/ttisdv5l-request-content"},{"required":["reference_images"],"properties":{"reference_images":{"maxItems":5,"items":{"description":"Image as Base64 encoded string or publicly accessible URL","type":"string"},"example":["https://example.com/reference-image-1.jpg","https://example.com/reference-image-2.jpg"],"minItems":1,"description":"Array of reference images for image editing.\nSeedream V5 Lite preserves subject details, lighting, and color tone when editing.\n\n**Supported formats:**\n- Base64-encoded image strings\n- Publicly accessible image URLs\n\n**Image requirements:**\n- Minimum resolution: 256x256 pixels\n- Maximum file size: 10MB per image\n- Supported formats: JPG, JPEG, PNG\n","type":"array"}},"type":"object"}]},"wan-25-t2v-base":{"required":["prompt"],"title":"WAN 2.5 Text-to-Video Base","type":"object","allOf":[{"$ref":"#/components/schemas/wan-25-base"}]},"ttisdv5p-request-content":{"required":["prompt"],"properties":{"seed":{"minimum":0,"example":12345,"description":"Random seed for reproducibility.\nUsing the same seed with identical parameters produces similar results.\nUseful for iterating on a design or creating variations.\n","type":"integer","maximum":4294967295},"prompt":{"example":"A futuristic cityscape at sunset with neon lights","maxLength":4096,"type":"string","description":"Text description of the image you want to generate.\n\n**Tips:**\n- Be specific about visual details, composition, and style\n- Seedream 5.0 Pro delivers high-fidelity detail, strong prompt adherence, and superior composition\n- Describe lighting, atmosphere, and camera angles for best results\n\n**Examples:**\n- Simple: \"A futuristic cityscape at sunset with neon lights\"\n- Detailed: \"A futuristic cityscape at sunset with neon lights, detailed architecture, volumetric lighting, cinematic composition\"\n"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"resolution":{"default":"2k","enum":["1.5k","2k"],"example":"2k","description":"Output resolution tier.\n\nAvailable options:\n- `2k`: Base output - up to ~4.19M pixels (2048x2048 at 1:1)\n- `1.5k`: Economical tier - capped at ~2.36M pixels (1536x1536 at 1:1)\n\nThe final image dimensions fit the selected aspect ratio within the tier's\npixel budget, with each dimension rounded to a multiple of 16.\n","type":"string"},"thinking_level":{"default":"high","enum":["fast","high"],"example":"high","description":"How much the model reasons about the prompt before drawing.\n\nAvailable options:\n- `high`: The model refines the prompt first. Better for complex compositions and many constraints, at the cost of a noticeably longer generation time.\n- `fast`: Skips that step for much faster generations. A good fit when the reference images already carry most of the intent.\n\nIt does not affect the price.\n","type":"string"},"aspect_ratio":{"default":"square_1_1","enum":["square_1_1","widescreen_16_9","social_story_9_16","portrait_2_3","traditional_3_4","standard_3_2","classic_4_3","cinematic_21_9"],"example":"square_1_1","description":"The aspect ratio of the generated image, combined with the resolution tier to compute the final dimensions.\n\nAvailable options:\n- `square_1_1`: Square format - Instagram feed, profile pictures\n- `widescreen_16_9`: Landscape - YouTube thumbnails, presentations\n- `social_story_9_16`: Portrait - TikTok, Instagram Stories\n- `portrait_2_3`: Tall portrait - Pinterest pins\n- `traditional_3_4`: Classic photo - Traditional photography\n- `standard_3_2`: Photo print - Standard prints\n- `classic_4_3`: Monitor ratio - Classic displays\n- `cinematic_21_9`: Ultra-wide - Cinematic banners\n","type":"string"}},"type":"object"},"detail_vector":{"example":{"download_size":1024,"related_resources":{"same_series":{"items":[{"name":"White t-shirt with copy space on gray background","preview":{"height":500,"url":"https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm","width":300},"premium":true,"new":true,"id":15667327,"has_prompt":true,"is_ai_generated":true,"slug":"merry-christmas","url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm","type":"vector","author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}},{"name":"White t-shirt with copy space on gray background","preview":{"height":500,"url":"https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm","width":300},"premium":true,"new":true,"id":15667327,"has_prompt":true,"is_ai_generated":true,"slug":"merry-christmas","url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm","type":"vector","author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}}],"url":"https://www.freepik.com/serie/32689488"},"same_author":[{"name":"White t-shirt with copy space on gray background","preview":{"height":500,"url":"https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm","width":300},"premium":true,"new":true,"id":15667327,"has_prompt":true,"is_ai_generated":true,"slug":"merry-christmas","url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm","type":"vector","author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}},{"name":"White t-shirt with copy space on gray background","preview":{"height":500,"url":"https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm","width":300},"premium":true,"new":true,"id":15667327,"has_prompt":true,"is_ai_generated":true,"slug":"merry-christmas","url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm","type":"vector","author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}}],"suggested":[{"name":"White t-shirt with copy space on gray background","preview":{"height":500,"url":"https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm","width":300},"premium":true,"new":true,"id":15667327,"has_prompt":true,"is_ai_generated":true,"slug":"merry-christmas","url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm","type":"vector","author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}},{"name":"White t-shirt with copy space on gray background","preview":{"height":500,"url":"https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm","width":300},"premium":true,"new":true,"id":15667327,"has_prompt":true,"is_ai_generated":true,"slug":"merry-christmas","url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm","type":"vector","author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}}],"same_collection":{"items":[{"name":"White t-shirt with copy space on gray background","preview":{"height":500,"url":"https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm","width":300},"premium":true,"new":true,"id":15667327,"has_prompt":true,"is_ai_generated":true,"slug":"merry-christmas","url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm","type":"vector","author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}},{"name":"White t-shirt with copy space on gray background","preview":{"height":500,"url":"https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm","width":300},"premium":true,"new":true,"id":15667327,"has_prompt":true,"is_ai_generated":true,"slug":"merry-christmas","url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm","type":"vector","author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}}],"url":"https://www.freepik.com/collection/shining"}},"url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm","new":true,"related_tags":[{"name":"Merry Christmas","slug":"merry-christmas","url":"https://www.freepik.com/dog"},{"name":"Merry Christmas","slug":"merry-christmas","url":"https://www.freepik.com/dog"}],"id":15667327,"name":"White t-shirt with copy space on gray background","available_formats":{"ai":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"png":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"psd":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"eps":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"atn":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"fonts":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"jpg":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"3d-render":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"svg":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"zip":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"resources":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]}},"preview":{"height":500,"url":"https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm","width":300},"vertical":"mockup","is_ai_generated":true,"author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647},"created":"2023-03-07T23:05:26Z","has_prompt":true,"premium":true,"slug":"merry-christmas","license":"https://www.freepik.com/profile/license/pdf/4350594","type":"photo","dimensions":{"width":2000,"height":3000}},"allOf":[{"$ref":"#/components/schemas/detail_resource"},{"required":["available_formats","dimensions","related_resources","related_tags","type"],"properties":{"related_resources":{"$ref":"#/components/schemas/vector_related"},"available_formats":{"$ref":"#/components/schemas/available_formats_1"},"type":{"example":"photo","enum":["vector"],"type":"string"},"related_tags":{"type":"array","items":{"$ref":"#/components/schemas/tag_2"}},"dimensions":{"$ref":"#/components/schemas/dimensions"}},"type":"object","description":"Vector details."}]},"wan-25-base":{"properties":{"seed":{"minimum":0,"example":12345,"description":"Random seed for reproducibility. Use the same seed with identical parameters to get similar results.\nLeave null for random seed.\n","type":"integer","maximum":2147483647},"negative_prompt":{"example":"blurry, low quality, watermark","maxLength":500,"type":"string","description":"Things to avoid in the generated video. Use this to prevent unwanted elements.\n\n**Examples:** \"blurry, low quality, watermark, text, distortion, extra limbs\"\n"},"prompt":{"example":"A serene mountain landscape at golden hour with mist rising from the valley","maxLength":800,"type":"string","description":"Main description of the video - scene, characters, motion, camera moves, style.\n\n**Tips:**\n- Be specific about scenes and visual details\n- Describe camera movements (zoom, pan, tilt)\n- Mention lighting and atmosphere\n\n**Examples:**\n- Simple: \"a cat sitting on a windowsill\"\n- Detailed: \"fluffy orange cat on wooden windowsill, looking at snow falling outside, soft warm lighting\"\n"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"duration":{"default":"5","enum":["5","10"],"example":"5","description":"Video duration in seconds:\n- `5`: Short clip, faster generation\n- `10`: Medium length, more developed action\n","type":"string"},"enable_prompt_expansion":{"default":true,"example":true,"type":"boolean","description":"Enable AI prompt optimizer to expand shorter prompts into detailed scripts.\nUseful when you have a simple idea but want richer video output.\n"}},"type":"object"},"detail_psd":{"allOf":[{"$ref":"#/components/schemas/detail_resource"},{"required":["available_formats","dimensions","related_resources","related_tags","type"],"properties":{"related_resources":{"$ref":"#/components/schemas/psd_related"},"model_type":{"example":"Midjourney","description":"The AI model used to generate the resource. Only present when the resource is AI generated.","type":"string","nullable":true},"available_formats":{"$ref":"#/components/schemas/available_formats"},"model_subtype":{"example":"Midjourney 5","description":"The AI model version used to generate the resource. Only present when the resource is AI generated.","type":"string","nullable":true},"type":{"example":"photo","enum":["psd"],"type":"string"},"related_tags":{"type":"array","items":{"$ref":"#/components/schemas/tag_2"}},"dimensions":{"$ref":"#/components/schemas/dimensions"}},"type":"object","description":"PSD details."}]},"recent_creation_thumbnail":{"description":"Thumbnail of the file.","example":{"url":"https://cdn.freepik.com/thumbnails/8421.jpg"},"properties":{"url":{"example":"https://cdn.freepik.com/thumbnails/8421.jpg","format":"uri","type":"string"}},"type":"object","nullable":true},"ttisdv5p-edit-request-content":{"allOf":[{"$ref":"#/components/schemas/ttisdv5p-request-content"},{"required":["reference_images"],"properties":{"reference_images":{"maxItems":10,"items":{"description":"Image as Base64 encoded string or publicly accessible URL","type":"string"},"example":["https://example.com/reference-image-1.jpg","https://example.com/reference-image-2.jpg"],"minItems":1,"description":"Array of reference images for image editing (1 to 10 images).\nSeedream 5.0 Pro preserves subject details, lighting, and color tone when editing.\n\n**Supported formats:**\n- Base64-encoded image strings\n- Publicly accessible image URLs\n\n**Image requirements:**\n- Minimum resolution: 256x256 pixels\n- Maximum file size: 10MB per image\n- Supported formats: JPG, JPEG, PNG\n","type":"array"}},"type":"object"}]},"ai_download":{"allOf":[{"$ref":"#/components/schemas/download"},{"required":["prompt"],"properties":{"prompt":{"example":"Two cute cats are playing with a ball of wool","description":"The used prompt to create this resource","type":"string"}},"type":"object"}]},"request-content_1":{"properties":{"seed":{"minimum":1,"description":"Seed for the image generation. If not provided, a random seed will be used.","type":"integer","maximum":4294967295},"styling":{"$ref":"#/components/schemas/ttifd_request_content_styling"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"prompt":{"description":"The prompt is a short text that describes the image you want to generate. It can range from simple descriptions, like `\"a cat\"`, to detailed scenarios, such as `\"a cat with wings, playing the guitar, and wearing a hat\"`. If no prompt is provided, the AI will generate a random image.\n","type":"string"},"aspect_ratio":{"default":"square_1_1","enum":["square_1_1","classic_4_3","traditional_3_4","widescreen_16_9","social_story_9_16","standard_3_2","portrait_2_3","horizontal_2_1","vertical_1_2","social_post_4_5"],"example":"square_1_1","description":"Image size with the aspect ratio. The aspect ratio is the proportional relationship between an image's width and height, expressed as *_width_height (e.g., square_1_1, widescreen_16_9). It is calculated by dividing the width by the height.\\\nIf not present, the default is `square_1_1`.\n","type":"string"}},"type":"object"},"task-detail_1":{"example":{"generated":["https://openapi-generator.tech","https://openapi-generator.tech"],"task_id":"046b6c7f-0b8a-43b9-b35d-6489e6daee91","status":"CREATED"},"allOf":[{"$ref":"#/components/schemas/task"},{"required":["generated"],"properties":{"generated":{"type":"array","items":{"format":"uri","description":"URL of the generated image","type":"string"}}},"type":"object"}]},"ttirecraft-v4-request-content":{"required":["prompt"],"properties":{"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"aspect_ratio":{"default":"square_1_1","enum":["square_1_1","horizontal_2_1","vertical_1_2","standard_3_2","portrait_2_3","classic_4_3","traditional_3_4","social_5_4","social_post_4_5","widescreen_16_9","social_story_9_16"],"example":"square_1_1","description":"Aspect ratio of the generated image, expressed as *_width_height.\n\nRecraft renders from a fixed set of sizes, so the output dimensions are the\nones listed below and are **not always the exact mathematical ratio the\nname suggests** — `widescreen_16_9` renders 1344x768, which is 7:4.\n\n| `aspect_ratio` | V4 / V4.1 `mid` | V4 Pro / V4.1 `pro` |\n|---|---|---|\n| `square_1_1` | 1024x1024 | 2048x2048 |\n| `horizontal_2_1` | 1536x768 | 3072x1536 |\n| `vertical_1_2` | 768x1536 | 1536x3072 |\n| `standard_3_2` | 1280x832 | 2560x1664 |\n| `portrait_2_3` | 832x1280 | 1664x2560 |\n| `classic_4_3` | 1216x896 | 2432x1792 |\n| `traditional_3_4` | 896x1216 | 1792x2432 |\n| `social_5_4` | 1152x896 | 2304x1792 |\n| `social_post_4_5` | 896x1152 | 1792x2304 |\n| `widescreen_16_9` | 1344x768 | 2688x1536 |\n| `social_story_9_16` | 768x1344 | 1536x2688 |\n","type":"string"},"enhance_prompt":{"default":true,"example":true,"type":"boolean","description":"Rewrite the prompt with an LLM before generating, which generally produces\na richer design. Any text the image must render is preserved verbatim.\n\nSet it to `false` to send the prompt exactly as written, which is what you\nwant when you need a deterministic input.\n"},"prompt":{"minLength":1,"example":"A storefront sign that reads OPEN DAILY 9AM, flat vector poster style","maxLength":10000,"type":"string","description":"Text description of the image you want to generate.\n\n**Tips:**\n- Recraft's strength is rendering legible text inside the image, so spell\n  out any wording the design must contain\n- Describe layout, palette and typography, not just the subject\n\n**Examples:**\n- Simple: \"A storefront sign that reads OPEN DAILY 9AM\"\n- Detailed: \"A storefront sign that reads OPEN DAILY 9AM, flat vector poster style, cream and navy palette, bold rounded display type\"\n"}},"type":"object"},"request_content_3_scale_factor":{"description":"Image scaling factor for upscaling. Determines how much larger the output image will be compared to the input.\nFor example, a scale ratio of 2 will double the dimensions (2x width and 2x height, resulting in 4x total pixels).\nValid values range from 2 to 16. Can be provided as an integer or string.\n","oneOf":[{"minimum":2,"type":"integer","maximum":16},{"pattern":"^(2|3|4|5|6|7|8|9|1[0-6])$","type":"string"}]},"data_icon_download_data":{"example":{"filename":"filename","url":"https://openapi-generator.tech"},"properties":{"filename":{"type":"string"},"url":{"type":"string","format":"uri"}},"type":"object"},"MusicDetail_artist":{"required":["bio","cover_url","id","name","track_count"],"example":{"cover_url":"cover_url","track_count":42,"name":"John Doe","bio":"bio","id":1},"properties":{"name":{"example":"John Doe","type":"string"},"track_count":{"example":42,"description":"Total number of music items by the artist","type":"integer"},"cover_url":{"description":"URL to the artist cover image","type":"string"},"bio":{"description":"Artist biography","type":"string"},"id":{"example":1,"type":"integer"}},"type":"object","nullable":true},"resolution_3":{"enum":["720p","480p"],"description":"Output video resolution. Controls the quality and dimensions of the generated talking video.\n- `720p`: HD resolution (1280x720). Best for high-quality previews and production use.\n- `480p`: SD resolution (854x480). Suitable for drafts and faster processing.\n","type":"string"},"image_size":{"required":["size"],"properties":{"size":{"$ref":"#/components/schemas/aspect_ratio"}},"type":"object"},"ttirecraft-v4-pro-request-content":{"required":["prompt"],"properties":{"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"aspect_ratio":{"default":"square_1_1","enum":["square_1_1","horizontal_2_1","vertical_1_2","standard_3_2","portrait_2_3","classic_4_3","traditional_3_4","social_5_4","social_post_4_5","widescreen_16_9","social_story_9_16"],"example":"square_1_1","description":"Aspect ratio of the generated image, expressed as *_width_height.\n\nRecraft renders from a fixed set of sizes, so the output dimensions are the\nones listed below and are **not always the exact mathematical ratio the\nname suggests** — `widescreen_16_9` renders 1344x768, which is 7:4.\n\n| `aspect_ratio` | V4 / V4.1 `mid` | V4 Pro / V4.1 `pro` |\n|---|---|---|\n| `square_1_1` | 1024x1024 | 2048x2048 |\n| `horizontal_2_1` | 1536x768 | 3072x1536 |\n| `vertical_1_2` | 768x1536 | 1536x3072 |\n| `standard_3_2` | 1280x832 | 2560x1664 |\n| `portrait_2_3` | 832x1280 | 1664x2560 |\n| `classic_4_3` | 1216x896 | 2432x1792 |\n| `traditional_3_4` | 896x1216 | 1792x2432 |\n| `social_5_4` | 1152x896 | 2304x1792 |\n| `social_post_4_5` | 896x1152 | 1792x2304 |\n| `widescreen_16_9` | 1344x768 | 2688x1536 |\n| `social_story_9_16` | 768x1344 | 1536x2688 |\n","type":"string"},"enhance_prompt":{"default":true,"example":true,"type":"boolean","description":"Rewrite the prompt with an LLM before generating, which generally produces\na richer design. Any text the image must render is preserved verbatim.\n\nSet it to `false` to send the prompt exactly as written, which is what you\nwant when you need a deterministic input.\n"},"prompt":{"minLength":1,"example":"A storefront sign that reads OPEN DAILY 9AM, flat vector poster style","maxLength":10000,"type":"string","description":"Text description of the image you want to generate.\n\n**Tips:**\n- Recraft's strength is rendering legible text inside the image, so spell\n  out any wording the design must contain\n- Describe layout, palette and typography, not just the subject\n\n**Examples:**\n- Simple: \"A storefront sign that reads OPEN DAILY 9AM\"\n- Detailed: \"A storefront sign that reads OPEN DAILY 9AM, flat vector poster style, cream and navy palette, bold rounded display type\"\n"}},"type":"object"},"ttirecraft-v41-request-content":{"required":["prompt"],"properties":{"enhance_prompt":{"default":true,"example":true,"type":"boolean","description":"Rewrite the prompt with an LLM before generating, which generally produces\na richer design. Any text the image must render is preserved verbatim.\n\nSet it to `false` to send the prompt exactly as written, which is what you\nwant when you need a deterministic input.\n"},"prompt":{"minLength":1,"example":"A storefront sign that reads OPEN DAILY 9AM, flat vector poster style","maxLength":10000,"type":"string","description":"Text description of the image you want to generate.\n\n**Tips:**\n- Recraft's strength is rendering legible text inside the image, so spell\n  out any wording the design must contain\n- Describe layout, palette and typography, not just the subject\n\n**Examples:**\n- Simple: \"A storefront sign that reads OPEN DAILY 9AM\"\n- Detailed: \"A storefront sign that reads OPEN DAILY 9AM, flat vector poster style, cream and navy palette, bold rounded display type\"\n"},"tier":{"default":"mid","enum":["mid","pro"],"example":"mid","description":"Quality tier, which selects both the price and the output size.\n- `mid`: the V4 sizes listed under `aspect_ratio` (default)\n- `pro`: twice the linear dimensions, four times the pixels\n\n**Credits:** `mid` is billed as Recraft V4 and `pro` as Recraft V4 Pro.\n","type":"string"},"variant":{"default":"standard","enum":["standard","utility"],"example":"standard","description":"How much art direction the model applies on top of the prompt.\n- `standard`: the model adds its own visual judgement — palette,\n  decoration, display typography (default)\n- `utility`: a literal, neutral render with no invented colour or\n  ornament. Use it for diagrams, wireframes, UI mockups and any asset\n  that must follow the prompt exactly\n\nDoes not affect the price.\n","type":"string"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"aspect_ratio":{"default":"square_1_1","enum":["square_1_1","horizontal_2_1","vertical_1_2","standard_3_2","portrait_2_3","classic_4_3","traditional_3_4","social_5_4","social_post_4_5","widescreen_16_9","social_story_9_16"],"example":"square_1_1","description":"Aspect ratio of the generated image, expressed as *_width_height.\n\nRecraft renders from a fixed set of sizes, so the output dimensions are the\nones listed below and are **not always the exact mathematical ratio the\nname suggests** — `widescreen_16_9` renders 1344x768, which is 7:4.\n\n| `aspect_ratio` | V4 / V4.1 `mid` | V4 Pro / V4.1 `pro` |\n|---|---|---|\n| `square_1_1` | 1024x1024 | 2048x2048 |\n| `horizontal_2_1` | 1536x768 | 3072x1536 |\n| `vertical_1_2` | 768x1536 | 1536x3072 |\n| `standard_3_2` | 1280x832 | 2560x1664 |\n| `portrait_2_3` | 832x1280 | 1664x2560 |\n| `classic_4_3` | 1216x896 | 2432x1792 |\n| `traditional_3_4` | 896x1216 | 1792x2432 |\n| `social_5_4` | 1152x896 | 2304x1792 |\n| `social_post_4_5` | 896x1152 | 1792x2304 |\n| `widescreen_16_9` | 1344x768 | 2688x1536 |\n| `social_story_9_16` | 768x1344 | 1536x2688 |\n","type":"string"}},"type":"object"},"recent_creation":{"example":{"name":"My awesome creation","tool_name":"text-to-image","external_id":"8421","folder_id":98764,"folder_reference":"1e041aff-d0cf-48e0-a424-e8b2853ea8f8","creation":{"family":"image","preview":"https://openapi-generator.tech","public":false,"raw":"https://openapi-generator.tech","nsfw":false,"url":"https://cdn.freepik.com/creations/8421.png","large_preview":"https://openapi-generator.tech","metadata":"{}","identifier":"a1b2c3d4","status":"completed","created_at":"2023-03-07T23:05:26Z","tool":"text-to-image","user_id":159327,"id":8421},"reference":"4fef9987-75d0-44d1-b336-65f42f883bff","updated_at":"2023-03-07T23:05:26Z","created_at":"2023-03-07T23:05:26Z","thumbnail":{"url":"https://cdn.freepik.com/thumbnails/8421.jpg"},"user_id":159327,"id":1337},"properties":{"name":{"example":"My awesome creation","description":"The name of the file.","type":"string"},"tool_name":{"example":"text-to-image","description":"The tool that produced the file.","type":"string","nullable":true},"external_id":{"example":"8421","description":"The ID of the file on the external tool (creation id).","type":"string","nullable":true},"folder_id":{"example":98764,"description":"The id of the folder where the file is located.","type":"integer","nullable":true},"folder_reference":{"description":"The reference of the folder where the file is located.","example":"1e041aff-d0cf-48e0-a424-e8b2853ea8f8","format":"uuid","type":"string","nullable":true},"creation":{"$ref":"#/components/schemas/creation"},"reference":{"example":"4fef9987-75d0-44d1-b336-65f42f883bff","format":"uuid","description":"Reference id of the file.","type":"string"},"user_id":{"example":159327,"description":"The ID of the owner user.","type":"integer"},"created_at":{"example":"2023-03-07T23:05:26Z","format":"date-time","description":"The date when the file was created.","type":"string"},"thumbnail":{"$ref":"#/components/schemas/recent_creation_thumbnail"},"updated_at":{"example":"2023-03-07T23:05:26Z","format":"date-time","description":"The date when the file was updated.","type":"string"},"id":{"example":1337,"description":"The ID of the file.","type":"integer"}},"type":"object","description":"A user file enriched with the metadata of its creation."},"request_7":{"required":["end_image_url","first_image_url","prompt"],"properties":{"style":{"$ref":"#/components/schemas/style-enum"},"generate_audio_switch":{"default":false,"description":"When set to `true`, PixVerse-V6 generates synchronized audio (background music, sound effects, or dialogue) together with the video.","type":"boolean"},"duration":{"default":5,"minimum":1,"description":"Duration of the generated video in seconds. PixVerse-V6 accepts any\ninteger value from `1` to `15`.\n","type":"integer","maximum":15},"prompt":{"description":"Prompt describing the video transition to generate.","type":"string"},"end_image_url":{"format":"uri","description":"URL of the image to use as the last frame.","type":"string"},"thinking_type":{"$ref":"#/components/schemas/thinking-type"},"first_image_url":{"format":"uri","description":"URL of the image to use as the first frame.","type":"string"},"seed":{"description":"The same seed and the same prompt given to the same version of the model will output the same video every time.","type":"integer"},"negative_prompt":{"default":"","description":"Negative prompt to be used for the generation.","type":"string"},"aspect_ratio":{"$ref":"#/components/schemas/aspect-ratio_3"},"resolution":{"$ref":"#/components/schemas/resolution_4"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"generate_multi_clip_switch":{"default":false,"description":"When set to `true`, PixVerse-V6 produces multi-clip output with dynamic camera changes within a single generation.","type":"boolean"},"camera_movement":{"$ref":"#/components/schemas/camera-movement"}},"type":"object"},"related_same_collection_same_collection":{"required":["items","url"],"description":"Related resources of the same collection.","example":{"items":[{"name":"White t-shirt with copy space on gray background","preview":{"height":500,"url":"https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm","width":300},"premium":true,"new":true,"id":15667327,"has_prompt":true,"is_ai_generated":true,"slug":"merry-christmas","url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm","type":"vector","author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}},{"name":"White t-shirt with copy space on gray background","preview":{"height":500,"url":"https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm","width":300},"premium":true,"new":true,"id":15667327,"has_prompt":true,"is_ai_generated":true,"slug":"merry-christmas","url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm","type":"vector","author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}}],"url":"https://www.freepik.com/collection/shining"},"properties":{"url":{"example":"https://www.freepik.com/collection/shining","format":"uri","description":"The url of the collection.","type":"string"},"items":{"description":"Other resources which belongs to a public collection of the author Magnific.","type":"array","items":{"$ref":"#/components/schemas/resource"}}},"type":"object","nullable":true},"ttigi2-request-content":{"required":["prompt"],"properties":{"prompt":{"minLength":1,"example":"A vintage travel poster for Mars, bold sans-serif title, muted orange palette","maxLength":32000,"type":"string","description":"Text description of the image you want to generate.\n\n**Tips:**\n- GPT Image 2 follows long, detailed instructions well\n- Text to render inside the image can be given verbatim, in quotes\n- Precise constraints (colours, layout, camera) are respected closely\n\n**Examples:**\n- Simple: \"A vintage travel poster for Mars\"\n- Detailed: \"A vintage travel poster for Mars, bold sans-serif title reading VISIT MARS, muted orange palette, grain\"\n"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"output_compression":{"minimum":0,"example":80,"description":"Compression level for the generated image, where 100 is the least\ncompressed. Only applies when `output_format` is `jpeg` or `webp`;\nignored for `png`.\n","type":"integer","maximum":100},"quality":{"default":"high","enum":["low","medium","high"],"example":"high","description":"Render quality tier. Higher tiers spend more provider compute and cost\nmore credits; lower tiers are faster and cheaper.\n- `low`: fastest and cheapest, for drafts and iteration\n- `medium`: balanced\n- `high`: maximum detail and prompt adherence (default)\n","type":"string"},"background":{"example":"auto","enum":["opaque","auto"],"description":"How the image background is produced.\n- `opaque`: always render a filled background\n- `auto`: let the model decide, which may return a transparent background\n\nTransparency is only preserved by formats that support an alpha channel\n(`png`, `webp`). When omitted, the provider default applies.\n","type":"string"},"num_images":{"default":1,"minimum":1,"example":1,"description":"How many images to generate for this prompt. **Each image is billed\nseparately.**\n","type":"integer","maximum":10},"resolution":{"default":"1k","enum":["1k","2k","4k"],"example":"1k","description":"Resolution tier of the generated image. Combined with `aspect_ratio` it\nselects the exact pixel size.\n\n**Credits:** the tier multiplies the price set by `quality` — `1k` x1,\n`2k` x2, `4k` x3. On the edit endpoint it does not affect the price.\n","type":"string"},"output_format":{"default":"png","enum":["png","jpeg","webp"],"example":"png","description":"The file format of the generated image.\n- `png`: lossless, supports transparency. Best for logos, text and sharp edges\n- `jpeg`: compressed, no transparency. Smallest files for photographic content\n- `webp`: compressed, supports transparency\n\n`output_compression` only applies to `jpeg` and `webp`.\n","type":"string"},"moderation":{"default":"auto","enum":["auto","low"],"example":"auto","description":"Strictness of the model provider's own content filter.\n- `auto`: the provider's standard filtering (default)\n- `low`: less restrictive filtering\n\nThis is the model provider's filter and is applied in addition to\nFreepik's platform moderation, which cannot be disabled.\n","type":"string"},"aspect_ratio":{"default":"square_1_1","enum":["square_1_1","classic_4_3","traditional_3_4","widescreen_16_9","social_story_9_16","film_horizontal_21_9","standard_3_2","portrait_2_3","horizontal_2_1","banner_3_1"],"example":"square_1_1","description":"Image size with the aspect ratio. The aspect ratio is the proportional\nrelationship between an image's width and height, expressed as\n*_width_height (e.g., square_1_1, widescreen_16_9). It is calculated by\ndividing the width by the height.\nIf not present, the default is `square_1_1`.\n","type":"string"}},"type":"object"},"option":{"example":{"size":400,"width":4096,"container":"mp4","codec":"AVC Coding","active":true,"quality":"4k","is_original":true,"id":76989,"height":2304,"bit_rate":25.44,"aspect_ratio":"16:9"},"required":["aspect_ratio"],"type":"object","properties":{"size":{"example":400,"minimum":1,"type":"number","maximum":500000},"width":{"example":4096,"minimum":1,"type":"integer","description":"The width of the original video."},"container":{"example":"mp4","type":"string"},"codec":{"example":"AVC Coding","type":"string"},"active":{"example":true,"type":"boolean"},"quality":{"$ref":"#/components/schemas/quality"},"is_original":{"example":true,"description":"if it is the original file uploaded by the author without any post processing","type":"boolean"},"aspect-ratio":{"$ref":"#/components/schemas/aspect-ratio_2"},"height":{"example":2304,"type":"integer","minimum":1},"bit_rate":{"example":25.44,"minimum":1,"type":"number","maximum":500000},"id":{"example":76989,"type":"integer","minimum":1}}},"detail_resource":{"allOf":[{"$ref":"#/components/schemas/resource"},{"required":["created","download_size","license","vertical"],"properties":{"license":{"example":"https://www.freepik.com/profile/license/pdf/4350594","format":"uri","description":"The URL of the license.","type":"string"},"download_size":{"example":1024,"minimum":0,"type":"integer","description":"The size of the resource in bytes."},"vertical":{"$ref":"#/components/schemas/vertical-type"},"created":{"example":"2023-03-07T23:05:26Z","format":"date-time","description":"The date when the resource was created.","type":"string"}},"type":"object","description":"Vector details."}]},"kling-4k-i2v-request":{"required":["image"],"properties":{"cfg_scale":{"default":0.5,"minimum":0,"description":"Guidance scale controlling prompt adherence versus creative freedom. Range: 0 to 1.\n\n- **0**: Maximum creative freedom, loosest interpretation of the prompt\n- **0.5** (default): Balanced between prompt adherence and creativity\n- **1**: Strongest adherence to the prompt, least creative variation\n","format":"float","type":"number","maximum":1},"duration":{"default":"5","enum":["3","4","5","6","7","8","9","10","11","12","13","14","15"],"description":"Duration of the generated video in seconds.\n\n**Range:** 3-15 seconds\n","type":"string"},"static_mask":{"description":"Static mask image for defining motion brush application areas.\n\n● Supports both Base64 encoding and image URLs (ensure URLs are publicly accessible and follow the same format requirements as the `image` field).\n● Supported image formats include .jpg / .jpeg / .png.\n● The aspect ratio of the mask image MUST match the input image (`image` field); otherwise, the task will fail.\n● The resolutions of the `static_mask` image and the `dynamic_masks.mask` images must be identical; otherwise, the task will fail.\n● The static brush feature allows you to define areas where motion will be applied in the generated video.","type":"string"},"webhook_url":{"format":"uri","description":"Optional callback URL that receives asynchronous notifications when the task changes status.\nThe payload includes the task status and result URL when completed.\n","type":"string"},"dynamic_masks":{"type":"array","items":{"$ref":"#/components/schemas/kling_4k_i2v_request_dynamic_masks_inner"}},"negative_prompt":{"default":"blur, distort, and low quality","maxLength":2500,"type":"string","description":"Undesired elements to avoid in the generated video. Maximum 2500 characters."},"image":{"description":"Reference image for video generation. Supports Base64 encoding or URL (ensure accessibility).\nFor URL, must be publicly accessible.\n\n**Image requirements:**\n- Minimum: 300x300 pixels\n- Maximum: 10MB file size\n- Aspect ratio: 1:2.5 to 2.5:1\n- Formats: JPG, JPEG, PNG\n","type":"string"},"image_tail":{"description":"Optional end frame control image. Supports Base64 encoding or URL.\nFor URL, must be publicly accessible. Must follow the same format requirements as the `image` field.\n\n**Image requirements:**\n- Same as `image` field\n","type":"string"},"prompt":{"maxLength":2500,"description":"Text prompt describing the desired video content. Maximum 2500 characters.\n\n**Tips for better results:**\n- Be specific about motion, camera angles, and actions\n- Describe the scene, characters, and atmosphere\n","type":"string"}},"type":"object"},"team_credit_usage_response_inner":{"example":{"date":"2026-01-01T00:00:00Z","consumptions":[{"user_usages":[{"user_email":"designer@company.com","user_reference":"usr_a3f81c2d9e4b7f60","project_name":"Marketing Campaign","api_key_id":"d98b3edd-38c6-4f03-a9bd-da6eff110782","group_name":"Design Team","project_reference":"a1b2c3d4-1111-4000-8000-000000000001","api_key_name":"prod-batch","user_credits":1200,"user_uses":30},{"user_email":"designer@company.com","user_reference":"usr_a3f81c2d9e4b7f60","project_name":"Marketing Campaign","api_key_id":"d98b3edd-38c6-4f03-a9bd-da6eff110782","group_name":"Design Team","project_reference":"a1b2c3d4-1111-4000-8000-000000000001","api_key_name":"prod-batch","user_credits":1200,"user_uses":30}],"tool_name":"pikaso-tti-flux-dev","user_uses":45,"user_credits":1800,"tool":"AI Image Models"},{"user_usages":[{"user_email":"designer@company.com","user_reference":"usr_a3f81c2d9e4b7f60","project_name":"Marketing Campaign","api_key_id":"d98b3edd-38c6-4f03-a9bd-da6eff110782","group_name":"Design Team","project_reference":"a1b2c3d4-1111-4000-8000-000000000001","api_key_name":"prod-batch","user_credits":1200,"user_uses":30},{"user_email":"designer@company.com","user_reference":"usr_a3f81c2d9e4b7f60","project_name":"Marketing Campaign","api_key_id":"d98b3edd-38c6-4f03-a9bd-da6eff110782","group_name":"Design Team","project_reference":"a1b2c3d4-1111-4000-8000-000000000001","api_key_name":"prod-batch","user_credits":1200,"user_uses":30}],"tool_name":"pikaso-tti-flux-dev","user_uses":45,"user_credits":1800,"tool":"AI Image Models"}]},"properties":{"date":{"example":"2026-01-01T00:00:00Z","format":"date-time","description":"Start date of the time period.","type":"string"},"consumptions":{"type":"array","items":{"$ref":"#/components/schemas/team_credit_usage_response_inner_consumptions_inner"}}},"type":"object"},"run-detail":{"required":["app_id","completed_at","error_message","result","run_id","started_at","status"],"example":{"app_id":"uqzQLDr2Aw","started_at":"2026-02-25T12:00:00Z","completed_at":"2026-02-25T12:02:00Z","result":{"videos":[{"id":"LSFgqqrswO","duration":0.80082819046101,"width":6,"created_at":"2026-02-11T10:14:15Z","height":1,"url":"https://pikaso.cdnpk.net/private/production/3280037299/render.png?token=...","tool":"text-to-image"},{"id":"LSFgqqrswO","duration":0.80082819046101,"width":6,"created_at":"2026-02-11T10:14:15Z","height":1,"url":"https://pikaso.cdnpk.net/private/production/3280037299/render.png?token=...","tool":"text-to-image"}],"audios":[{"id":"LSFgqqrswO","duration":0.80082819046101,"width":6,"created_at":"2026-02-11T10:14:15Z","height":1,"url":"https://pikaso.cdnpk.net/private/production/3280037299/render.png?token=...","tool":"text-to-image"},{"id":"LSFgqqrswO","duration":0.80082819046101,"width":6,"created_at":"2026-02-11T10:14:15Z","height":1,"url":"https://pikaso.cdnpk.net/private/production/3280037299/render.png?token=...","tool":"text-to-image"}],"images":[{"id":"LSFgqqrswO","duration":0.80082819046101,"width":6,"created_at":"2026-02-11T10:14:15Z","height":1,"url":"https://pikaso.cdnpk.net/private/production/3280037299/render.png?token=...","tool":"text-to-image"},{"id":"LSFgqqrswO","duration":0.80082819046101,"width":6,"created_at":"2026-02-11T10:14:15Z","height":1,"url":"https://pikaso.cdnpk.net/private/production/3280037299/render.png?token=...","tool":"text-to-image"}]},"error_message":"error_message","status":"completed","run_id":"omps2OH829"},"properties":{"app_id":{"example":"uqzQLDr2Aw","description":"SQID of the flow that was executed. (Field name retained from the underlying execution payload.)","type":"string"},"started_at":{"description":"ISO 8601 timestamp when execution started. Null while the run is pending.","example":"2026-02-25T12:00:00Z","format":"date-time","type":"string","nullable":true},"status":{"$ref":"#/components/schemas/run-status"},"result":{"$ref":"#/components/schemas/run_detail_result"},"error_message":{"example":null,"description":"Error details when the execution fails or completes with errors. Null on success.","type":"string","nullable":true},"completed_at":{"description":"ISO 8601 timestamp when execution completed. Null while the run is still in progress.","example":"2026-02-25T12:02:00Z","format":"date-time","type":"string","nullable":true},"run_id":{"example":"omps2OH829","description":"Unique identifier (SQID) for this execution run. Matches the `workflow_run_identifier` returned by the run endpoint.","type":"string"}},"type":"object","description":"Status and result of a single flow execution run."},"psd_related":{"allOf":[{"required":["same_author","same_series","suggested"],"properties":{"suggested":{"description":"Other resources related to this one.","type":"array","items":{"$ref":"#/components/schemas/resource"}},"same_author":{"description":"Other resources created by this author.","type":"array","items":{"$ref":"#/components/schemas/resource"}}},"type":"object","description":"Related resources and tags for this resource."},{"$ref":"#/components/schemas/related_same_series"},{"$ref":"#/components/schemas/related_same_collection"}]},"audit_log_event_action":{"example":{"data":{"operation":"grant","role":"admin","target_user_id":10511077},"resource_id":"18422","event_type":"team.member.role_changed","request_id":"req-7f3a9c1e","project_name":"Marketing Campaign Q4","correlation_id":"corr-2b8e","verb":"update","context":{},"status":"success","old_state":{"role":"member"},"new_state":{"role":"admin"},"duration_ms":42,"folder_name":"Q4 assets"},"properties":{"correlation_id":{"example":"corr-2b8e","description":"Correlation identifier linking related events.","type":"string","nullable":true},"resource_id":{"example":"18422","description":"Identifier of the resource the action happened to.","type":"string","nullable":true},"event_type":{"example":"team.member.role_changed","description":"Canonical event type.","type":"string"},"request_id":{"example":"req-7f3a9c1e","description":"Request identifier. Use the `request_id` filter to fetch all events of one request.","type":"string","nullable":true},"data":{"example":{"operation":"grant","role":"admin","target_user_id":10511077},"description":"Free-form event payload, narrowed to the public allow-list. Keys vary by\n`event_type` (e.g. `target_user_id`, `role`, `group_id`, `operation`,\n`project_reference`, `permission`, `outcome`).\n","type":"object","additionalProperties":true},"project_name":{"example":"Marketing Campaign Q4","description":"Human-readable project name, resolved server-side from the event's project reference.","type":"string","nullable":true},"verb":{"example":"update","description":"The action performed.","type":"string"},"status":{"example":"success","description":"Outcome status of the action.","type":"string"},"context":{"additionalProperties":true,"example":{},"description":"Additional contextual metadata for the event.","type":"object","nullable":true},"old_state":{"additionalProperties":true,"example":{"role":"member"},"description":"Vetted subset of the resource state before the action.","type":"object","nullable":true},"new_state":{"additionalProperties":true,"example":{"role":"admin"},"description":"Vetted subset of the resource state after the action.","type":"object","nullable":true},"duration_ms":{"example":42,"description":"Action duration in milliseconds, when measured.","type":"integer","nullable":true},"folder_name":{"example":"Q4 assets","description":"Human-readable folder name, resolved server-side from the event's folder reference.","type":"string","nullable":true}},"type":"object"},"advanced-custom-elements-video-list":{"required":["refer_videos"],"properties":{"refer_videos":{"maxItems":1,"items":{"$ref":"#/components/schemas/advanced-custom-elements-refer-video"},"minItems":1,"description":"Reference videos. Only 1 video can be uploaded.","type":"array"}},"type":"object","description":"Reference video for defining the element. Required when reference_type is `video_refer`, ignored when reference_type is `image_refer`.\nOnly one video can be uploaded. If the video contains human voice, voice tone customization will be initiated.\n"},"faithful-request":{"required":["image"],"properties":{"smart_grain":{"default":2,"minimum":0,"example":2,"description":"Smart grain intensity","type":"integer","maximum":100},"skin_detail":{"default":80,"minimum":0,"example":80,"description":"Skin detail enhancement level","type":"integer","maximum":100},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"image":{"example":"https://example.com/portrait.jpg","description":"Input image. Supports Base64 encoding or HTTPS URL (must be publicly accessible).","type":"string"},"sharpen":{"default":0,"minimum":0,"example":0,"description":"Sharpening intensity","type":"integer","maximum":100}},"type":"object"},"advanced-custom-elements-refer-image":{"required":["image_url"],"properties":{"image_url":{"description":"Reference image URL or Base64 encoding. Supported formats: .jpg, .jpeg, .png. Max file size: 10MB. Min dimensions: 300px.","type":"string"}},"type":"object"},"team-project":{"example":{"project_reference":"a1b2c3d4-1111-4000-8000-000000000001","name":"Marketing Campaign Q4","budget":{"consumed":5000000,"available":10000000,"assigned":15000000}},"required":["budget","name","project_reference"],"type":"object","properties":{"project_reference":{"example":"a1b2c3d4-1111-4000-8000-000000000001","format":"uuid","description":"Project reference UUID. Use in `project_references` filter of team-credit-usage.","type":"string"},"name":{"example":"Marketing Campaign Q4","description":"Project name.","type":"string"},"budget":{"$ref":"#/components/schemas/team_project_budget"}}},"formats_1":{"required":["items","total"],"properties":{"total":{"example":1,"description":"The total number of files for that format.","type":"integer"},"items":{"type":"array","items":{"$ref":"#/components/schemas/format"}}},"type":"object"},"request_9":{"required":["prompt"],"properties":{"style":{"$ref":"#/components/schemas/style-enum"},"generate_audio_switch":{"default":false,"description":"When set to true, PixVerse-V5.5 generates synchronized audio (background music, sound effects, or dialogue) together with the video.","type":"boolean"},"duration":{"default":5,"enum":[5,8,10],"description":"The duration of the generated video in seconds. 8s videos cost double. 10s videos are only available up to 720p. 1080p videos are limited to 5 or 8 seconds.","type":"integer"},"prompt":{"description":"Text prompt describing the video to generate","type":"string"},"resolution":{"$ref":"#/components/schemas/resolution_4"},"thinking_type":{"$ref":"#/components/schemas/thinking-type"},"seed":{"description":"The same seed and the same prompt given to the same version of the model will output the same video every time","type":"integer"},"negative_prompt":{"default":"","description":"Negative prompt to be used for the generation","type":"string"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"generate_multi_clip_switch":{"default":false,"description":"When set to true, PixVerse-V5.5 produces multi-clip output with dynamic camera changes within a single generation.","type":"boolean"},"aspect_ratio":{"$ref":"#/components/schemas/aspect-ratio_3"}},"type":"object"},"request-content_2":{"required":["image"],"properties":{"smart_grain":{"default":7,"minimum":0,"description":"Smart grain","type":"integer","maximum":100},"image":{"format":"byte","description":"Base64 image to upscale","type":"string"},"webhook_url":{"format":"uri","description":"Webhook URL","type":"string"},"ultra_detail":{"default":30,"minimum":0,"description":"Ultra detail","type":"integer","maximum":100},"filter_nsfw":{"default":false,"description":"Enable NSFW content filtering on the output image","type":"boolean"},"sharpen":{"default":50,"minimum":0,"description":"Sharpen the image","type":"integer","maximum":100}},"type":"object"},"ttigi2-edit-request-content":{"required":["prompt","reference_images"],"properties":{"reference_images":{"maxItems":16,"items":{"example":"https://example.com/product.jpg","description":"Image URL (must be publicly reachable over HTTPS), a base64-encoded\nimage, or an upload id returned by the uploads API.\nSupported formats: jpg, jpeg, png, webp.\n","type":"string"},"minItems":1,"description":"The images to edit, in order. GPT Image 2 uses them together as the\nvisual context for the prompt: it can restyle one image, or compose a\nnew image from several.\n\nEach image may be up to 20 MiB, and one request may carry up to\n64 MiB of images in total.\n","type":"array"},"prompt":{"minLength":1,"example":"Put the product on a marble surface","maxLength":32000,"type":"string","description":"Text instruction describing the edit to apply to the reference images.\n\n**Tips:**\n- Say what should change, not what the image already contains\n- Several references are used together as one visual context\n- Text inside the image can be corrected or replaced verbatim\n\n**Examples:**\n- Simple: \"Put the product on a marble surface\"\n- Detailed: \"Replace the background with a sunlit studio, keep the product and its shadow, change the label text to ORGANIC\"\n"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"output_compression":{"minimum":0,"example":80,"description":"Compression level for the generated image, where 100 is the least\ncompressed. Only applies when `output_format` is `jpeg` or `webp`;\nignored for `png`.\n","type":"integer","maximum":100},"quality":{"default":"high","enum":["low","medium","high"],"example":"high","description":"Render quality tier. Higher tiers spend more provider compute and cost\nmore credits; lower tiers are faster and cheaper.\n- `low`: fastest and cheapest, for drafts and iteration\n- `medium`: balanced\n- `high`: maximum detail and prompt adherence (default)\n","type":"string"},"aspect_ratio":{"default":"square_1_1","enum":["square_1_1","classic_4_3","traditional_3_4","widescreen_16_9","social_story_9_16","film_horizontal_21_9","standard_3_2","portrait_2_3","horizontal_2_1","banner_3_1"],"example":"square_1_1","description":"Image size with the aspect ratio. The aspect ratio is the proportional\nrelationship between an image's width and height, expressed as\n*_width_height (e.g., square_1_1, widescreen_16_9). It is calculated by\ndividing the width by the height.\nIf not present, the default is `square_1_1`.\n","type":"string"},"resolution":{"default":"1k","enum":["1k","2k","4k"],"example":"1k","description":"Resolution tier of the generated image. Combined with `aspect_ratio` it\nselects the exact pixel size.\n\n**Credits:** the tier multiplies the price set by `quality` — `1k` x1,\n`2k` x2, `4k` x3. On the edit endpoint it does not affect the price.\n","type":"string"},"output_format":{"default":"png","enum":["png","jpeg","webp"],"example":"png","description":"The file format of the generated image.\n- `png`: lossless, supports transparency. Best for logos, text and sharp edges\n- `jpeg`: compressed, no transparency. Smallest files for photographic content\n- `webp`: compressed, supports transparency\n\n`output_compression` only applies to `jpeg` and `webp`.\n","type":"string"},"num_images":{"default":1,"minimum":1,"example":1,"description":"How many images to generate for this prompt. **Each image is billed\nseparately.**\n","type":"integer","maximum":10},"moderation":{"default":"auto","enum":["auto","low"],"example":"auto","description":"Strictness of the model provider's own content filter.\n- `auto`: the provider's standard filtering (default)\n- `low`: less restrictive filtering\n\nThis is the model provider's filter and is applied in addition to\nFreepik's platform moderation, which cannot be disabled.\n","type":"string"},"background":{"example":"auto","enum":["opaque","auto"],"description":"How the image background is produced.\n- `opaque`: always render a filled background\n- `auto`: let the model decide, which may return a transparent background\n\nTransparency is only preserved by formats that support an alpha channel\n(`png`, `webp`). When omitted, the provider default applies.\n","type":"string"}},"type":"object"},"available_formats_1":{"description":"The available formats for the resource.","example":{"ai":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"png":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"psd":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"eps":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"atn":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"fonts":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"jpg":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"3d-render":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"svg":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"zip":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"resources":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]}},"properties":{"ai":{"$ref":"#/components/schemas/formats"},"png":{"$ref":"#/components/schemas/formats"},"psd":{"$ref":"#/components/schemas/formats"},"eps":{"$ref":"#/components/schemas/formats"},"atn":{"$ref":"#/components/schemas/formats"},"fonts":{"$ref":"#/components/schemas/formats"},"jpg":{"$ref":"#/components/schemas/formats"},"3d-render":{"$ref":"#/components/schemas/formats"},"svg":{"$ref":"#/components/schemas/formats"},"zip":{"$ref":"#/components/schemas/formats"},"resources":{"$ref":"#/components/schemas/formats"}},"type":"object","nullable":true},"request_content_8_color_palette_members_inner":{"required":["color_hex"],"properties":{"color_hex":{"example":"#FF5733","pattern":"^#(?:[0-9a-fA-F]{3}){1,2}$","type":"string","description":"Hexadecimal color code"},"color_weight":{"minimum":0.05,"example":0.5,"description":"Weight of the color in the palette","type":"number","maximum":1}},"type":"object"},"output-format_1":{"default":"png","enum":["png","jpeg"],"description":"Output image format.\n- `png`: Lossless compression, best for high-quality results\n- `jpeg`: Lossy compression, smaller file size suitable for web use\n","type":"string"},"upload-list-response":{"example":{"files":[{"ttl_seconds":6,"expires_at":"2000-01-23T04:56:07.000+00:00","asset_url":"https://cdn-magnific.freepik.com/uploads/109580722/upl_img_a1b2c3?token=exp=1783147635~hmac=...","content_type":"content_type","created_at":"2000-01-23T04:56:07.000+00:00","asset_url_expires_in":86400,"file_id":"upl_a1b2c3d4e5f6","size_bytes":0},{"ttl_seconds":6,"expires_at":"2000-01-23T04:56:07.000+00:00","asset_url":"https://cdn-magnific.freepik.com/uploads/109580722/upl_img_a1b2c3?token=exp=1783147635~hmac=...","content_type":"content_type","created_at":"2000-01-23T04:56:07.000+00:00","asset_url_expires_in":86400,"file_id":"upl_a1b2c3d4e5f6","size_bytes":0}]},"required":["files"],"type":"object","properties":{"files":{"type":"array","items":{"$ref":"#/components/schemas/upload-list-item"}}}},"ttigi25-request-content":{"required":["prompt"],"properties":{"prompt":{"minLength":1,"example":"A vintage travel poster for Mars, bold sans-serif title, muted orange palette","maxLength":32000,"type":"string","description":"Text description of the image you want to generate.\n\n**Tips:**\n- GPT Image 2.5 follows long, detailed instructions well\n- Text to render inside the image can be given verbatim, in quotes\n- Precise constraints (colours, layout, camera) are respected closely\n\n**Examples:**\n- Simple: \"A vintage travel poster for Mars\"\n- Detailed: \"A vintage travel poster for Mars, bold sans-serif title reading VISIT MARS, muted orange palette, grain\"\n"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"output_compression":{"minimum":0,"example":80,"description":"Compression level for the generated image, where 100 is the least\ncompressed. Only applies when `output_format` is `jpeg` or `webp`;\nignored for `png`.\n","type":"integer","maximum":100},"quality":{"default":"medium","enum":["low","medium","high","xhigh","max"],"example":"medium","description":"Render quality tier. Higher tiers spend more provider compute; lower\ntiers are faster.\n- `low`: fastest, for drafts and iteration\n- `medium`: balanced (default)\n- `high`: high detail and prompt adherence\n- `xhigh`, `max`: the extended tiers of GPT Image 2.5, for the most\n  demanding renders\n\n**Credits:** `low`, `medium` and `high` are billed on their own tier.\n`xhigh` and `max` are currently billed at the `high` price.\n","type":"string"},"aspect_ratio":{"default":"auto","enum":["auto","square_1_1","classic_4_3","traditional_3_4","widescreen_16_9","social_story_9_16","film_horizontal_21_9","standard_3_2","portrait_2_3","horizontal_2_1","banner_3_1"],"example":"auto","description":"Shape of the generated image, expressed as *_width_height (e.g.\n`square_1_1`, `widescreen_16_9`).\n\n`auto` (the default) lets the model choose the shape. When the request\ncarries `reference_images`, the output keeps **their** aspect ratio,\nincluding ratios that are not in this list — which is what makes `auto`\nthe right choice for editing a picture whose proportions must be\npreserved.\n","type":"string"},"num_images":{"default":1,"minimum":1,"example":1,"description":"How many images to generate for this prompt. **Each image is billed\nseparately.**\n","type":"integer","maximum":10},"output_format":{"default":"png","enum":["png","jpeg","webp"],"example":"png","description":"The file format of the generated image.\n- `png`: lossless, supports transparency. Best for logos, text and sharp edges\n- `jpeg`: compressed, no transparency. Smallest files for photographic content\n- `webp`: compressed, supports transparency\n\n`output_compression` only applies to `jpeg` and `webp`. A `jpeg` output\ncannot carry an alpha channel, so it is rejected when `background` is\n`transparent`.\n","type":"string"},"resolution":{"default":"1k","enum":["1k","2k","4k"],"example":"1k","description":"Resolution tier of the generated image. Combined with `aspect_ratio` it\nselects the exact pixel size.\n\nWith `aspect_ratio: auto`, only `1k` leaves the size to the model; `2k`\nand `4k` render a square at that tier.\n\n**Credits:** the tier multiplies the price set by `quality` — `1k` x1,\n`2k` x2, `4k` x3. On the edit endpoint it does not affect the price.\n","type":"string"},"variant":{"default":"flare","enum":["flare","sunburst"],"example":"flare","description":"Which model of the GPT Image 2.5 line renders the request. Both share\nevery other parameter, the quality scale and the price.\n- `flare`: optimised for latency (default)\n- `sunburst`: optimised for editing precision\n","type":"string"},"moderation":{"default":"auto","enum":["auto","low"],"example":"auto","description":"Strictness of the model provider's own content filter.\n- `auto`: the provider's standard filtering (default)\n- `low`: less restrictive filtering\n\nThis is the model provider's filter and is applied in addition to\nFreepik's platform moderation, which cannot be disabled.\n","type":"string"},"background":{"example":"auto","enum":["transparent","opaque","auto"],"description":"How the image background is produced.\n- `transparent`: render without a background. Requires an `output_format`\n  with an alpha channel (`png` or `webp`)\n- `opaque`: always render a filled background\n- `auto`: let the model decide\n\nWhen omitted, the provider default applies.\n","type":"string"}},"type":"object"},"advanced-custom-elements-image-list":{"required":["frontal_image","refer_images"],"properties":{"frontal_image":{"description":"Frontal reference image URL or Base64 encoding. At least one frontal reference image is required. Supported formats: .jpg, .jpeg, .png. Max file size: 10MB. Min dimensions: 300px. Aspect ratio: 1:2.5 to 2.5:1.","type":"string"},"refer_images":{"maxItems":3,"items":{"$ref":"#/components/schemas/advanced-custom-elements-refer-image"},"minItems":1,"description":"1 to 3 additional reference images from other angles or close-ups. These should differ from the frontal reference image.","type":"array"}},"type":"object","description":"Reference images for defining the element. Required when reference_type is `image_refer`, ignored when reference_type is `video_refer`.\nProvide one frontal reference image and 1 to 3 additional reference images from different angles or close-ups.\n"},"audit_log_event_member_auth":{"required":["api_key_id","api_key_name","type"],"example":{"api_key_id":"11111111-1111-4111-8111-111111111111","api_key_name":"CI pipeline","type":"api_key"},"properties":{"api_key_id":{"example":"11111111-1111-4111-8111-111111111111","description":"Identifier of the API key, as listed on the team's API keys. Events recorded before key identifiers were stored carry the masked key (`********dc03`) instead.","type":"string","nullable":true},"api_key_name":{"example":"CI pipeline","description":"Name of the API key, including deleted keys; `null` when it cannot be resolved.","type":"string","nullable":true},"type":{"example":"api_key","enum":["api_key","session"],"description":"`api_key` when the action was done with an API key, `session` otherwise.","type":"string"}},"type":"object","description":"How the member authenticated. An action done with an API key is attributed to the member who created the key, and names the key here. Always present and never null: every event without an API key, including system actors and events recorded before this field existed, reads `type: session` with both key fields `null`."},"change-camera-request":{"required":["image"],"properties":{"seed":{"example":42,"minimum":1,"type":"integer","description":"Seed for the random number generator. Using the same seed with identical parameters produces the same output, enabling reproducible results across multiple requests.\n"},"horizontal_angle":{"default":0,"minimum":0,"example":45,"description":"Horizontal rotation angle in degrees. Controls the left-right rotation of the camera around the subject.\n- `0`: Front view (no rotation)\n- `90`: Right side view\n- `180`: Back view\n- `270`: Left side view\n- `360`: Full rotation (equivalent to 0)\n\nValid values: `0` to `360`. Default: `0`.\n","type":"integer","maximum":360},"image":{"example":"https://example.com/input-image.jpg","description":"Input image to transform. Provide as a publicly accessible HTTPS URL.\nSupported formats: JPG, PNG, WebP.\n","type":"string"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"zoom":{"default":5,"minimum":0,"example":5,"description":"Zoom level controlling how close the camera appears to the subject.\n- `0`: Wide shot (far away, full scene visible)\n- `5`: Medium shot (standard framing)\n- `10`: Close-up (very close to the subject)\n\nValid values: `0` to `10`. Default: `5`.\n","type":"integer","maximum":10},"output_format":{"$ref":"#/components/schemas/output-format_1"},"vertical_angle":{"default":0,"minimum":-30,"example":15,"description":"Vertical tilt angle in degrees. Controls the up-down tilt of the camera relative to the subject.\n- `-30`: Looking up at the subject from below\n- `0`: Eye-level view (no tilt)\n- `45`: Moderate downward angle\n- `90`: Bird's eye view (directly above)\n\nValid values: `-30` to `90`. Default: `0`.\n","type":"integer","maximum":90}},"type":"object"},"enhancement-model":{"default":"starlight_precise_2_5","enum":["starlight_precise_2_5","starlight_fast_2"],"description":"Topaz Starlight enhancement model:\n- `starlight_precise_2_5`: highest-quality generative upscaler (default)\n- `starlight_fast_2`: faster generative upscaler with a slight trade-off in quality\n","type":"string"},"task-detail-200-default-response":{"description":"OK - The task exists and the status is returned"},"run-status":{"example":"completed","enum":["pending","running","completed","completed_with_errors","failed","cancelled"],"description":"Execution status of the flow run:\n- `pending`: Run is queued but has not started yet\n- `running`: Flow is executing\n- `completed`: Finished successfully, result is available\n- `completed_with_errors`: Execution finished but some nodes failed\n- `failed`: Execution failed entirely\n- `cancelled`: Execution was cancelled\n","type":"string"},"itvko1-video-reference-request":{"required":["prompt"],"title":"Kling O1 Video Reference","description":"Generate video using Kling O1 with reference images for character/style consistency.\n\n**Best for:**\n- Maintaining character consistency across shots\n- Creating videos with specific visual style\n- Multi-shot storytelling with consistent subjects\n","type":"object","properties":{"reference_images":{"maxItems":7,"items":{"type":"string"},"example":["https://example.com/character-reference.jpg"],"description":"List of reference images for maintaining visual consistency (up to 7).\nEach image can be a URL or Base64 encoded string.\n","type":"array"},"duration":{"default":"5","enum":["5","10"],"type":"string"},"prompt":{"maxLength":2500,"description":"Text prompt describing the video you want to generate.\nBe specific about actions, camera movements, and mood.\n","type":"string"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"aspect_ratio":{"default":"16:9","enum":["16:9","9:16","1:1"],"type":"string"}}},"audit_log_event_member":{"example":{"email":"admin@company.com","auth":{"api_key_id":"11111111-1111-4111-8111-111111111111","api_key_name":"CI pipeline","type":"api_key"},"user_id":10499812,"type":"user"},"properties":{"email":{"example":"admin@company.com","description":"Actor email address.","type":"string","nullable":true},"auth":{"$ref":"#/components/schemas/audit_log_event_member_auth"},"type":{"example":"user","description":"Actor type.","type":"string"},"user_id":{"example":10499812,"description":"Actor user ID.","type":"integer","nullable":true}},"type":"object","description":"The actor that performed the action."},"image":{"example":{"base64":"iVBORw0KGgoAAAANSUhEUgAAASwAAAEsAQAAAABRBrPYAAABrElEQVR4nO3BMQEAAADCoPVPbQ0Po...","has_nsfw":false},"required":["base64","has_nsfw"],"type":"object","properties":{"base64":{"example":"iVBORw0KGgoAAAANSUhEUgAAASwAAAEsAQAAAABRBrPYAAABrElEQVR4nO3BMQEAAADCoPVPbQ0Po...","format":"base64","description":"Base64 encoded image","type":"string"},"has_nsfw":{"example":false,"description":"True if the image has No Safe For Work content, false otherwise","type":"boolean"}}},"ttigi25-edit-request-content":{"required":["prompt","reference_images"],"properties":{"reference_images":{"maxItems":16,"items":{"example":"https://example.com/product.jpg","description":"Image URL (must be publicly reachable over HTTPS), a base64-encoded\nimage, or an upload id returned by the uploads API.\nSupported formats: jpg, jpeg, png, webp.\n","type":"string"},"minItems":1,"description":"The images to edit, in order. GPT Image 2.5 uses them together as the\nvisual context for the prompt: it can restyle one image, or compose a\nnew image from several.\n\nWith the default `aspect_ratio: auto`, the output keeps the aspect\nratio of these images.\n\nEach image may be up to 20 MiB, and one request may carry up to\n64 MiB of images in total.\n","type":"array"},"prompt":{"minLength":1,"example":"Put the product on a marble surface","maxLength":32000,"type":"string","description":"Text instruction describing the edit to apply to the reference images.\n\n**Tips:**\n- Say what should change, not what the image already contains\n- Several references are used together as one visual context\n- Text inside the image can be corrected or replaced verbatim\n\n**Examples:**\n- Simple: \"Put the product on a marble surface\"\n- Detailed: \"Replace the background with a sunlit studio, keep the product and its shadow, change the label text to ORGANIC\"\n"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"output_compression":{"minimum":0,"example":80,"description":"Compression level for the generated image, where 100 is the least\ncompressed. Only applies when `output_format` is `jpeg` or `webp`;\nignored for `png`.\n","type":"integer","maximum":100},"quality":{"default":"medium","enum":["low","medium","high","xhigh","max"],"example":"medium","description":"Render quality tier. Higher tiers spend more provider compute; lower\ntiers are faster.\n- `low`: fastest, for drafts and iteration\n- `medium`: balanced (default)\n- `high`: high detail and prompt adherence\n- `xhigh`, `max`: the extended tiers of GPT Image 2.5, for the most\n  demanding renders\n\n**Credits:** `low`, `medium` and `high` are billed on their own tier.\n`xhigh` and `max` are currently billed at the `high` price.\n","type":"string"},"aspect_ratio":{"default":"auto","enum":["auto","square_1_1","classic_4_3","traditional_3_4","widescreen_16_9","social_story_9_16","film_horizontal_21_9","standard_3_2","portrait_2_3","horizontal_2_1","banner_3_1"],"example":"auto","description":"Shape of the generated image, expressed as *_width_height (e.g.\n`square_1_1`, `widescreen_16_9`).\n\n`auto` (the default) lets the model choose the shape. When the request\ncarries `reference_images`, the output keeps **their** aspect ratio,\nincluding ratios that are not in this list — which is what makes `auto`\nthe right choice for editing a picture whose proportions must be\npreserved.\n","type":"string"},"resolution":{"default":"1k","enum":["1k","2k","4k"],"example":"1k","description":"Resolution tier of the generated image. Combined with `aspect_ratio` it\nselects the exact pixel size.\n\nWith `aspect_ratio: auto`, only `1k` leaves the size to the model; `2k`\nand `4k` render a square at that tier.\n\n**Credits:** the tier multiplies the price set by `quality` — `1k` x1,\n`2k` x2, `4k` x3. On the edit endpoint it does not affect the price.\n","type":"string"},"variant":{"default":"flare","enum":["flare","sunburst"],"example":"flare","description":"Which model of the GPT Image 2.5 line renders the request. Both share\nevery other parameter, the quality scale and the price.\n- `flare`: optimised for latency (default)\n- `sunburst`: optimised for editing precision\n","type":"string"},"num_images":{"default":1,"minimum":1,"example":1,"description":"How many images to generate for this prompt. **Each image is billed\nseparately.**\n","type":"integer","maximum":10},"output_format":{"default":"png","enum":["png","jpeg","webp"],"example":"png","description":"The file format of the generated image.\n- `png`: lossless, supports transparency. Best for logos, text and sharp edges\n- `jpeg`: compressed, no transparency. Smallest files for photographic content\n- `webp`: compressed, supports transparency\n\n`output_compression` only applies to `jpeg` and `webp`. A `jpeg` output\ncannot carry an alpha channel, so it is rejected when `background` is\n`transparent`.\n","type":"string"},"moderation":{"default":"auto","enum":["auto","low"],"example":"auto","description":"Strictness of the model provider's own content filter.\n- `auto`: the provider's standard filtering (default)\n- `low`: less restrictive filtering\n\nThis is the model provider's filter and is applied in addition to\nFreepik's platform moderation, which cannot be disabled.\n","type":"string"},"background":{"example":"auto","enum":["transparent","opaque","auto"],"description":"How the image background is produced.\n- `transparent`: render without a background. Requires an `output_format`\n  with an alpha channel (`png` or `webp`)\n- `opaque`: always render a filled background\n- `auto`: let the model decide\n\nWhen omitted, the provider default applies.\n","type":"string"}},"type":"object"},"webhook-result-item":{"example":{"id":"LSFgqqrswO","duration":0.80082819046101,"width":6,"created_at":"2026-02-11T10:14:15Z","height":1,"url":"https://pikaso.cdnpk.net/private/production/3280037299/render.png?token=...","tool":"text-to-image"},"properties":{"id":{"example":"LSFgqqrswO","description":"Unique identifier of the generated asset.","type":"string"},"duration":{"description":"Duration in seconds (for video/audio assets). Null for images.","type":"number","nullable":true},"width":{"description":"Width in pixels.","type":"integer","nullable":true},"created_at":{"example":"2026-02-11T10:14:15Z","format":"date-time","description":"ISO 8601 creation timestamp of the asset.","type":"string"},"height":{"description":"Height in pixels.","type":"integer","nullable":true},"tool":{"example":"text-to-image","description":"The AI tool that produced this asset (e.g. `text-to-image`, `image-upscaler`).","type":"string"},"url":{"example":"https://pikaso.cdnpk.net/private/production/3280037299/render.png?token=...","format":"uri","description":"Download URL for the generated asset.","type":"string"}},"type":"object","description":"A single generated asset from the flow execution."},"magnific-one-request-content":{"required":["prompt"],"properties":{"quality":{"default":"high","enum":["medium","high"],"example":"high","description":"Render quality in `quality` mode.\n- `medium`: faster and cheaper\n- `high`: maximum detail (default)\n\nIgnored in `draft` mode, which always renders at `medium`.\n\n**Credits:** together with `resolution`, it sets the price of the\nrequest.\n","type":"string"},"reference_images":{"maxItems":10,"items":{"example":"https://example.com/reference.jpg","description":"Publicly accessible image URL.","type":"string"},"minItems":1,"description":"Optional reference images that guide the style of the result.\nSupported in both modes. They do not change the price.\n","type":"array"},"mode":{"default":"quality","enum":["quality","draft"],"example":"quality","description":"What the request produces.\n- `quality`: one finished image (default)\n- `draft`: a contact sheet of quick variations, returned as 8 or 16\n  individual images (see `tiles`). Use it to explore directions before\n  rendering the chosen one in `quality` mode.\n","type":"string"},"prompt":{"minLength":1,"example":"A lighthouse on a cliff at dusk","maxLength":2000,"type":"string","description":"Text description of the image you want to generate. Magnific One\ndevelops the art direction (composition, style, lighting and visual\ntreatment) from it before rendering.\n\n**Examples:**\n- Simple: \"A lighthouse on a cliff at dusk\"\n- Detailed: \"Editorial photo of a lighthouse on a basalt cliff at dusk, long exposure sea, warm window light, cinematic framing\"\n"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"resolution":{"default":"2k","enum":["1k","2k","4k"],"example":"2k","description":"Resolution tier of the image in `quality` mode. Combined with\n`aspect_ratio` it selects the exact pixel size.\n\nIgnored in `draft` mode, which always renders its contact sheet at `2k`.\n\n**Credits:** together with `quality`, it sets the price of the request.\n","type":"string"},"tiles":{"default":8,"enum":[8,16],"example":8,"description":"Number of individual images returned in `draft` mode. Ignored in\n`quality` mode.\n- `8`: a 2x4 sheet (default). May approximate `aspect_ratio`\n- `16`: a 4x4 sheet. Always preserves `aspect_ratio` exactly\n","type":"integer"},"aspect_ratio":{"default":"1:1","enum":["1:1","2:1","3:1","2:3","3:2","3:4","4:3","16:9","9:16","21:9"],"example":"1:1","description":"Aspect ratio of the image. In `draft` mode it describes each individual\nimage, not the contact sheet.\n\nWith `tiles: 16` every ratio is honoured exactly. With `tiles: 8` the\nsheet is twice as wide relative to its images, and the ratios that no\nlonger fit are approximated to the closest supported one: `1:1`, `2:3`,\n`3:2` and `3:4` come back exact, the rest may deviate. Use `tiles: 16`\nwhen the ratio of every image must be exact.\n","type":"string"}},"type":"object","additionalProperties":false},"duration_2":{"default":8,"enum":[4,6,8],"description":"Duration of the generated video in seconds.","type":"integer"},"audit_log_event_source":{"example":{"platform":"web","project":"magnific","referer":"referer"},"properties":{"platform":{"example":"web","description":"Originating platform.","type":"string","nullable":true},"project":{"example":"magnific","description":"Originating product/project.","type":"string","nullable":true},"referer":{"example":null,"description":"Referer, when available.","type":"string","nullable":true}},"type":"object","description":"Where the action originated."},"upload-request-body":{"required":["files"],"properties":{"files":{"maxItems":14,"items":{"$ref":"#/components/schemas/upload-file-request"},"minItems":1,"description":"List of files to generate upload URLs for","type":"array"}},"type":"object"},"reference-image":{"required":["url"],"properties":{"url":{"example":"https://example.com/character1.jpg","format":"uri","description":"Publicly accessible URL of the reference image.\n\n**Supported formats:** JPEG, JPG, PNG, WEBP\n**Recommended resolution:** shortest side at least 400 px (720P or higher recommended)\n**Maximum file size:** 10 MB\n","type":"string"}},"type":"object","description":"A reference image used to guide reference-to-video generation."},"is_ai_generated":{"example":true,"description":"True if the resource is generated by AI, false otherwise.","type":"boolean"},"vector_psd_resource":{"example":{"id":15667327,"filename":"filename","url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm","related":{"serie":{"title":"White t-shirt with copy space on gray background","licenses":[{"type":"freemium","url":"https://www.freepik.com/profile/license/pdf/4350594"},{"type":"freemium","url":"https://www.freepik.com/profile/license/pdf/4350594"}],"image":{"orientation":"horizontal","source":{"key":"large","size":"740x640","url":"https://img.freepik.com/free-photo/tshirt_53876-104920.jpg"},"type":"vector"},"id":15667327,"author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647},"url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm"},"others":{"title":"White t-shirt with copy space on gray background","licenses":[{"type":"freemium","url":"https://www.freepik.com/profile/license/pdf/4350594"},{"type":"freemium","url":"https://www.freepik.com/profile/license/pdf/4350594"}],"image":{"orientation":"horizontal","source":{"key":"large","size":"740x640","url":"https://img.freepik.com/free-photo/tshirt_53876-104920.jpg"},"type":"vector"},"id":15667327,"author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647},"url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm"},"keywords":{"name":"Merry Christmas","slug":"merry-christmas"}},"meta":{"is_new":true,"available_formats":{"ai":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"png":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"psd":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"eps":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"atn":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"fonts":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"jpg":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"3d-render":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"svg":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"zip":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"resources":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]}},"published_at":"2020-12-01T23:50:50Z"},"licenses":[{"type":"freemium","url":"https://www.freepik.com/profile/license/pdf/4350594"},{"type":"freemium","url":"https://www.freepik.com/profile/license/pdf/4350594"}],"image":{"orientation":"horizontal","source":{"key":"large","size":"740x640","url":"https://img.freepik.com/free-photo/tshirt_53876-104920.jpg"},"type":"vector"},"stats":{"downloads":0,"likes":0},"products":[{"type":"essential","url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm"},{"type":"essential","url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm"}],"title":"White t-shirt with copy space on gray background","author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}},"additionalProperties":true,"allOf":[{"$ref":"#/components/schemas/resource_base"},{"required":["filename","meta","related","stats"],"properties":{"related":{"$ref":"#/components/schemas/resource_related"},"stats":{"$ref":"#/components/schemas/resource_stats"},"products":{"description":"These products of this resource","deprecated":true,"type":"array","items":{"$ref":"#/components/schemas/resource_product"}},"meta":{"$ref":"#/components/schemas/resource_meta"},"filename":{"description":"The filename of this resource.","type":"string"}},"type":"object","description":"A resource within a list of resources from collection"}]},"colors_palette_inner":{"required":["color","weight"],"properties":{"color":{"example":"#FF0000","pattern":"^#[0-9A-F]{6}$","type":"string","description":"Hex color code"},"weight":{"minimum":0.05,"example":0.5,"description":"Weight of the color (0.05 to 1)","type":"number","maximum":1}},"type":"object"},"team-member":{"example":{"email":"designer@company.com","role":"member","status":"active"},"properties":{"email":{"example":"designer@company.com","description":"User email address.","type":"string"},"role":{"example":"member","enum":["owner","admin","member"],"description":"User role within the team.","type":"string"},"status":{"example":"active","enum":["active","inactive","invited"],"description":"Membership status.","type":"string"}},"type":"object"},"loras-character-request":{"required":["gender","images","name","quality"],"properties":{"name":{"pattern":"^[a-zA-Z0-9-_]+$","type":"string","description":"Name of the LoRA character. This name will be used to identify the style in the system."},"gender":{"type":"string","enum":["male","female","neutral","custom"]},"webhook_url":{"format":"uri","description":"Webhook URL to notify the user when the task is completed","type":"string"},"quality":{"enum":["high","ultra"],"description":"Quality of the LoRA character","type":"string"},"images":{"maxItems":20,"items":{"format":"uri","description":"Url of the image to train the LoRA character","type":"string"},"minItems":8,"description":"List of images to train the LoRA character","type":"array"},"description":{"description":"Description of the LoRA character","type":"string"}},"type":"object"},"request-content_7":{"required":["prompt"],"properties":{"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"reference_images":{"maxItems":3,"items":{"example":"iVBORw0KGgoAAAANSUhEUgAAASwAAAEsAQAAAABRBrPYAAABrElEQVR4nO3BMQEAAADCoPVPbQ0Po...","description":"Reference image as Base64 encoded string or publicly accessible URL","type":"string"},"example":["iVBORw0KGgoAAAANSUhEUgAAASwAAAEsAQAAAABRBrPYAAABrElEQVR4nO3BMQEAAADCoPVPbQ0Po...","https://example.com/reference-image.jpg"],"description":"Optional array of reference images for image editing. Each image can be provided as a Base64 encoded string or a publicly accessible URL.\nMaximum of 3 reference images allowed. If provided, the model will use these images as reference for editing or style transfer.\n","type":"array"},"prompt":{"example":"A beautiful sunset over mountains with vibrant orange and purple skies","description":"The prompt is a short text that describes the image you want to generate or edit. It can range from simple descriptions, like `\"a cat\"`, to detailed scenarios, such as `\"a cat with wings, playing the guitar, and wearing a hat\"`. This field is required for both image generation and editing.\n","type":"string"}},"type":"object"},"request_1":{"required":["audio_url","image_url","resolution"],"properties":{"resolution":{"$ref":"#/components/schemas/resolution_3"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"image_url":{"example":"https://example.com/portrait.jpg","description":"URL of the portrait image to animate into a talking video. The image should contain a clearly visible face for best lip-sync results. Must be a publicly accessible URL.","type":"string"},"audio_url":{"example":"https://example.com/speech-audio.mp3","description":"URL of the audio file for lip synchronization. The person in the image will speak in sync with this audio. Must be a publicly accessible URL. Supported formats include MP3, WAV, and M4A.","type":"string"}},"type":"object"},"inline_object":{"example":{"message":"message"},"properties":{"message":{"type":"string"}},"type":"object"},"inline_object_1_problem_invalid_params_inner":{"required":["field","name","reason"],"properties":{"name":{"example":"page","description":"Name of the invalid parameter.","type":"string"},"field":{"example":"page","description":"Field of the invalid parameter. Mirrors `name`.","type":"string"},"reason":{"example":"Parameter 'page' must be greater than 0","type":"string"}},"type":"object"},"ttizi-request-content":{"required":["prompt"],"properties":{"num_inference_steps":{"default":8,"minimum":1,"example":8,"description":"The number of inference steps to perform.\nHigher values may produce more detailed images but take longer.\nFor Z-Image turbo, 8 steps is recommended for optimal speed/quality balance.\n","type":"integer","maximum":50},"seed":{"minimum":0,"example":42,"description":"Random seed for reproducibility.\nUsing the same seed with identical parameters produces the same image.\nUseful for iterating on a design or creating variations.\n","type":"integer","maximum":4294967295},"prompt":{"example":"A suited raccoon smoking a cigar","maxLength":4096,"type":"string","description":"Text description of the image you want to generate.\n\n**Tips:**\n- Be specific about visual details, composition, and style\n- Z-Image excels at fast, high-quality image generation\n- Works well with detailed scene descriptions\n\n**Examples:**\n- Simple: \"A suited raccoon smoking a cigar\"\n- Detailed: \"A cyberpunk city street at night, neon signs reflecting on wet pavement, flying cars in the distance\"\n"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"image_size":{"default":"square_hd","enum":["square","square_hd","portrait_3_4","portrait_9_16","landscape_4_3","landscape_16_9"],"example":"square_hd","description":"The aspect ratio and size of the generated image.\nIf not specified, defaults to `square_hd` (1024x1024).\n\n**Available sizes:**\n- `square`: 512x512 pixels\n- `square_hd`: 1024x1024 pixels (default)\n- `portrait_3_4`: 768x1024 pixels\n- `portrait_9_16`: 576x1024 pixels\n- `landscape_4_3`: 1024x768 pixels\n- `landscape_16_9`: 1024x576 pixels\n","type":"string"},"output_format":{"default":"png","enum":["jpeg","png"],"example":"png","description":"The format of the generated image.\n- `png`: Lossless format, best for images with text or sharp edges\n- `jpeg`: Compressed format, smaller file size\n","type":"string"},"enable_safety_checker":{"default":true,"description":"Whether to enable the content safety checker.\nWhen enabled, the model filters potentially unsafe content.\n","type":"boolean"}},"type":"object"},"schema":{"type":"array","items":{"type":"string","enum":["1:1","4:3","9:16","16:9","256:135"]}},"inline_object_1_problem":{"required":["invalid_params","message"],"properties":{"message":{"example":"Validation error","type":"string"},"invalid_params":{"type":"array","items":{"$ref":"#/components/schemas/inline_object_1_problem_invalid_params_inner"}}},"type":"object"},"preview-with-aspect-ratio":{"example":{"width":100,"height":100,"url":"https://v1.cdnpk.net/videvo_files/video/premium/video0289/watermarked/_Geometric80s30_FPpreview.mp4","aspect_ratio":"16:9"},"allOf":[{"$ref":"#/components/schemas/preview"},{"required":["aspect_ratio"],"properties":{"aspect_ratio":{"$ref":"#/components/schemas/aspect-ratio_2"}},"type":"object"}]},"orientation":{"enum":["horizontal","vertical","square","panoramic","unknown"],"description":"The orientation of the image.","type":"string"},"inline_object_1":{"properties":{"problem":{"$ref":"#/components/schemas/inline_object_1_problem"}},"type":"object"},"ttisdv45-edit-request-content":{"allOf":[{"$ref":"#/components/schemas/ttisdv45-request-content"},{"required":["reference_images"],"properties":{"reference_images":{"maxItems":5,"items":{"description":"Image as Base64 encoded string or publicly accessible URL","type":"string"},"example":["https://example.com/reference-image-1.jpg","https://example.com/reference-image-2.jpg"],"minItems":1,"description":"Array of reference images for image editing.\nSeedream 4.5 preserves subject details, lighting, and color tone when editing.\n\n**Supported formats:**\n- Base64-encoded image strings\n- Publicly accessible image URLs\n\n**Image requirements:**\n- Minimum resolution: 256x256 pixels\n- Maximum file size: 10MB per image\n- Supported formats: JPG, JPEG, PNG\n","type":"array"}},"type":"object"}]},"team-group":{"example":{"name":"Design Team","group_id":10,"member_count":5,"parent_group_id":0},"properties":{"name":{"example":"Design Team","description":"Group name.","type":"string"},"group_id":{"example":10,"description":"Group identifier. Use in `group_ids` filter of team-credit-usage.","type":"integer"},"member_count":{"example":5,"description":"Number of members in this group.","type":"integer"},"parent_group_id":{"example":null,"description":"Identifier of the parent group when this group is a subgroup. `null` for top-level groups.","type":"integer","nullable":true}},"type":"object"},"inline_object_2":{"example":{"message":"Internal Server Error"},"properties":{"message":{"example":"Internal Server Error","type":"string"}},"type":"object"},"inline_object_3":{"example":{"message":"Service Unavailable. Please try again later."},"properties":{"message":{"example":"Service Unavailable. Please try again later.","type":"string"}},"type":"object"},"aspect-ratio":{"default":"16:9","enum":["16:9","9:16","1:1","4:3","3:4"],"description":"Output video aspect ratio:\n- `16:9`: Landscape (widescreen)\n- `9:16`: Portrait (vertical, mobile-optimized)\n- `1:1`: Square\n- `4:3`: Standard landscape\n- `3:4`: Standard portrait\n","type":"string"},"inline_object_4":{"example":{"data":{"generated":["https://openapi-generator.tech","https://openapi-generator.tech"],"task_id":"046b6c7f-0b8a-43b9-b35d-6489e6daee91","status":"CREATED"}},"required":["data"],"type":"object","properties":{"data":{"$ref":"#/components/schemas/task-detail_1"}}},"minimax-h3-max-r2v-request":{"required":["prompt"],"properties":{"reference_images":{"maxItems":9,"items":{"type":"string","format":"byte"},"example":["https://example.com/reference-1.jpg"],"description":"Up to 9 reference images that steer the subject and style. Each item is a publicly accessible URL or a base64-encoded image. Reference them in the prompt using @Image1, @Image2, ... @Image9 (1-indexed to the array order). Reference images, videos and audios together must also not exceed 12 files.","type":"array"},"duration":{"default":5,"minimum":5,"example":5,"description":"Video duration in seconds. Any integer from 5 to 15.","type":"integer","maximum":15},"prompt":{"minLength":1,"example":"@Image1 walks slowly across a sunlit room, handheld camera","maxLength":50000,"type":"string","description":"Text prompt describing the video to generate. Mention references as @Image1, @Image2, ... @Video1, @Video2, ... or @Audio1, @Audio2, ... matching their 1-indexed array order."},"webhook_url":{"format":"uri","description":"URL to receive a webhook notification when the video generation task completes. The webhook payload includes the task ID and status.","type":"string"},"seed":{"default":-1,"minimum":-1,"description":"Random seed for reproducible video generation. Use the same seed with the same prompt to get consistent results. Use `-1` for a random seed.","type":"integer","maximum":4294967295},"aspect_ratio":{"default":"adaptive","enum":["adaptive","film_horizontal_21_9","widescreen_16_9","classic_4_3","square_1_1","traditional_3_4","social_story_9_16"],"description":"Output video aspect ratio. Available options:\n- `adaptive`: the model picks it from the reference assets\n- `film_horizontal_21_9`: Ultra-wide cinematic (21:9)\n- `widescreen_16_9`: Standard widescreen (16:9)\n- `classic_4_3`: Classic TV format (4:3)\n- `square_1_1`: Square format (1:1)\n- `traditional_3_4`: Portrait classic (3:4)\n- `social_story_9_16`: Vertical/social media story (9:16)\n","type":"string"},"prompt_expansion_mode":{"default":"balanced","enum":["disabled","fast","balanced","quality"],"description":"Which prompt expander runs before the generation. `disabled` sends the prompt verbatim; `fast`, `balanced` and `quality` trade latency for richer prompt rewriting.","type":"string"},"reference_videos":{"maxItems":3,"items":{"type":"string"},"example":["https://example.com/reference-1.mp4"],"description":"Up to 3 reference videos that steer the motion. Each item must be a publicly accessible HTTPS URL or a video upload file_id (`upl_vid_...`). Reference them in the prompt using @Video1, @Video2 or @Video3. Each video must be 2 to 15 seconds and their combined duration must not exceed 15 seconds. Reference images, videos and audios together must also not exceed 12 files.","type":"array"},"enable_safety_checker":{"default":true,"description":"Enable content safety filtering to ensure generated videos comply with safety guidelines.","type":"boolean"},"reference_audios":{"maxItems":3,"items":{"type":"string"},"example":["https://example.com/reference-voice.mp3"],"description":"Up to 3 reference audios. Each item must be a publicly accessible HTTPS URL — unlike `reference_videos`, this field does not take upload file_ids. Reference them in the prompt using @Audio1, @Audio2 or @Audio3. Each audio must be 2 to 15 seconds and their combined duration must not exceed 15 seconds. Audio cannot be the only reference: at least one `reference_images` or `reference_videos` entry is required alongside it. Reference images, videos and audios together must also not exceed 12 files.","type":"array"}},"type":"object"},"inline_object_5_meta":{"required":["tracking_code"],"example":{"clean_search":true,"tracking_code":"sph"},"properties":{"clean_search":{"example":true,"description":"If true, It has been ensured that the search does not return disabled resources.","type":"boolean"},"tracking_code":{"example":"sph","description":"Search tracking code","type":"string","nullable":true}},"type":"object","nullable":true},"tti-nano-banana-pro-request":{"required":["prompt"],"title":"Nano Banana Pro Text-to-Image Request","type":"object","properties":{"reference_images":{"maxItems":14,"items":{"$ref":"#/components/schemas/tti_nano_banana_pro_request_reference_images_inner"},"example":[{"image":"https://example.com/reference.jpg","text":"Reference style","mime_type":"image/jpeg"}],"description":"Optional reference images for guided generation.\nEach image can include associated text and mime type.\n\n**Image requirements:**\n- Maximum 14 images\n- Supported formats: PNG, JPEG, WebP\n- Publicly accessible URLs or GCS format\n","type":"array"},"prompt":{"minLength":2,"example":"A suited raccoon smoking a pipe in a vintage study room","maxLength":12000,"type":"string","description":"Text prompt describing the image you want to generate.\n\n**Tips:**\n- Be specific about visual details, composition, and style\n- Nano Banana Pro excels at complex compositions and detailed scenes\n- Describe lighting, atmosphere, and camera angles for best results\n\n**Examples:**\n- Simple: \"A suited raccoon smoking a pipe\"\n- Detailed: \"A suited raccoon smoking a pipe in a vintage study room, warm lighting, leather armchair, bookshelves in background\"\n"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"resolution":{"default":"2K","enum":["1K","2K","4K","low","medium","high"],"example":"2K","description":"Resolution quality for the generated image.\n\n**Available resolutions:**\n- `1K`: Lower resolution, faster generation\n- `2K`: Standard resolution, balanced quality/speed (default)\n- `4K`: High resolution, best quality\n","type":"string"},"aspect_ratio":{"default":"1:1","enum":["auto","1:1","2:3","3:2","4:3","3:4","5:4","4:5","16:9","9:16","21:9"],"example":"1:1","description":"Aspect ratio for the generated image.\n\n**Available ratios:**\n- `auto`: Derived from the reference images, preserving ratios outside\n  this list (for example a 900x1050 reference returns 960x1120). With no\n  reference images the model picks the ratio itself.\n- `1:1`: Square (default)\n- `2:3`, `3:2`: Portrait/Landscape\n- `4:3`, `3:4`: Standard\n- `5:4`, `4:5`: Photo print\n- `16:9`, `9:16`: Widescreen/Social stories\n- `21:9`: Ultra-wide cinematic\n","type":"string"}}},"inline_object_5":{"example":{"meta":{"clean_search":true,"tracking_code":"sph"},"message":"No results found for this search"},"properties":{"message":{"example":"No results found for this search","type":"string"},"meta":{"$ref":"#/components/schemas/inline_object_5_meta"}},"type":"object"},"thumbnails":{"type":"array","items":{"$ref":"#/components/schemas/source"}},"upload-response":{"example":{"files":[{"upload_url":"https://openapi-generator.tech","asset_url":"https://cdn-magnific.freepik.com/uploads/109580722/upl_img_a1b2c3?token=exp=1783147635~hmac=...","headers":{"Content-Type":"image/png","x-goog-content-length-range":"0,1073741824"},"asset_url_expires_in":86400,"file_id":"upl_a1b2c3d4e5f6","expires_in":120},{"upload_url":"https://openapi-generator.tech","asset_url":"https://cdn-magnific.freepik.com/uploads/109580722/upl_img_a1b2c3?token=exp=1783147635~hmac=...","headers":{"Content-Type":"image/png","x-goog-content-length-range":"0,1073741824"},"asset_url_expires_in":86400,"file_id":"upl_a1b2c3d4e5f6","expires_in":120}]},"required":["files"],"type":"object","properties":{"files":{"type":"array","items":{"$ref":"#/components/schemas/upload-file-response"}}}},"inline_object_6":{"example":{"data":[{"name":"Sketch to Realism","tool_metadata":{"sort_order":999,"total_cost":5,"category":"general","icon":"workflow","description_key":"description_key","translation_key":"translation_key"},"sqid":"uqzQLDr2Aw"},{"name":"Sketch to Realism","tool_metadata":{"sort_order":999,"total_cost":5,"category":"general","icon":"workflow","description_key":"description_key","translation_key":"translation_key"},"sqid":"uqzQLDr2Aw"}]},"required":["data"],"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/flow-summary"}}}},"team-credit-usage-response":{"type":"array","items":{"$ref":"#/components/schemas/team_credit_usage_response_inner"}},"inline_object_7":{"example":{"data":{"name":"Sketch to Realism","tool_metadata":{"sort_order":999,"total_cost":5,"category":"general","icon":"workflow","description_key":"description_key","translation_key":"translation_key"},"sqid":"uqzQLDr2Aw","inputs":[{"required":true,"config":null,"key":"text_prompt","default":null,"nodeId":"4050c3f3-8a26-4953-97a8-cb97bceb4816","api_key":"text_prompt","presentation":{"mode":"textarea","type":"text"},"label":"Text #1","type":"text","id":"input-4050c3f3-8a26-4953-97a8-cb97bceb4816-1"},{"required":true,"config":null,"key":"text_prompt","default":null,"nodeId":"4050c3f3-8a26-4953-97a8-cb97bceb4816","api_key":"text_prompt","presentation":{"mode":"textarea","type":"text"},"label":"Text #1","type":"text","id":"input-4050c3f3-8a26-4953-97a8-cb97bceb4816-1"}]}},"required":["data"],"type":"object","properties":{"data":{"$ref":"#/components/schemas/flow-detail"}}},"audit-log-event":{"example":{"member":{"email":"admin@company.com","auth":{"api_key_id":"11111111-1111-4111-8111-111111111111","api_key_name":"CI pipeline","type":"api_key"},"user_id":10499812,"type":"user"},"action":{"data":{"operation":"grant","role":"admin","target_user_id":10511077},"resource_id":"18422","event_type":"team.member.role_changed","request_id":"req-7f3a9c1e","project_name":"Marketing Campaign Q4","correlation_id":"corr-2b8e","verb":"update","context":{},"status":"success","old_state":{"role":"member"},"new_state":{"role":"admin"},"duration_ms":42,"folder_name":"Q4 assets"},"date":"2026-07-30T09:14:52Z","category":"member","source":{"platform":"web","project":"magnific","referer":"referer"},"event_id":"b3d1f0a2-9c4e-4a1b-8f2d-1a2b3c4d5e6f"},"properties":{"member":{"$ref":"#/components/schemas/audit_log_event_member"},"action":{"$ref":"#/components/schemas/audit_log_event_action"},"date":{"example":"2026-07-30T09:14:52Z","format":"date-time","description":"When the event occurred (UTC, ISO-8601).","type":"string"},"source":{"$ref":"#/components/schemas/audit_log_event_source"},"category":{"example":"member","description":"Resource category the event belongs to.","type":"string","nullable":true},"event_id":{"example":"b3d1f0a2-9c4e-4a1b-8f2d-1a2b3c4d5e6f","description":"Unique identifier of the event.","type":"string"}},"type":"object","description":"A single enterprise audit-log event. On the public API the free-form objects\n(`action.data`, `action.old_state`, `action.new_state`) are narrowed to a vetted\nallow-list of keys; provider/inference internals, cross-system identifiers, internal\nbilling state and content-moderation flags are stripped and never returned here.\n"},"inline_object_8":{"example":{"workflow_run_identifier":"vCrK3Aa47y","status":"running"},"required":["status","workflow_run_identifier"],"type":"object","properties":{"status":{"example":"running","enum":["running"],"description":"Current execution status.","type":"string"},"workflow_run_identifier":{"example":"vCrK3Aa47y","description":"Unique identifier for this flow execution run. Matches the `run_id` in webhook events.","type":"string"}}},"image-with-aspect-ratio":{"example":{"width":100,"height":100,"url":"https://img.freepik.com/free-photo/image_8353-7579.jpg","aspect_ratio":"16:9"},"allOf":[{"$ref":"#/components/schemas/image_1"},{"required":["aspect_ratio"],"properties":{"aspect_ratio":{"$ref":"#/components/schemas/aspect-ratio_2"}},"type":"object"}]},"tti-nano-banana-pro-flash-request":{"required":["prompt"],"title":"Nano Banana Pro Flash Text-to-Image Request","type":"object","properties":{"reference_images":{"maxItems":14,"items":{"$ref":"#/components/schemas/tti_nano_banana_pro_request_reference_images_inner"},"example":[{"image":"https://example.com/reference.jpg","text":"Reference style","mime_type":"image/jpeg"}],"description":"Optional reference images for guided generation.\nEach image can include associated text and mime type.\n\n**Image requirements:**\n- Maximum 14 images\n- Supported formats: PNG, JPEG, WebP\n- Publicly accessible URLs or GCS format\n","type":"array"},"prompt":{"minLength":2,"example":"A suited raccoon smoking a pipe in a vintage study room","maxLength":12000,"type":"string","description":"Text prompt describing the image you want to generate.\n\n**Tips:**\n- Be specific about visual details, composition, and style\n- Nano Banana Pro Flash is optimized for speed while maintaining quality\n- Enable Google Search grounding for images that need real-world accuracy\n\n**Examples:**\n- Simple: \"A suited raccoon smoking a pipe\"\n- Detailed: \"A suited raccoon smoking a pipe in a vintage study room, warm lighting, leather armchair, bookshelves in background\"\n"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"aspect_ratio":{"default":"1:1","enum":["auto","1:1","2:3","3:2","4:3","3:4","5:4","4:5","16:9","9:16","21:9"],"example":"1:1","description":"Aspect ratio for the generated image.\n\n**Available ratios:**\n- `auto`: Derived from the reference images, preserving ratios outside\n  this list (for example a 900x1050 reference returns 960x1120). With no\n  reference images the model picks the ratio itself.\n- `1:1`: Square (default)\n- `2:3`, `3:2`: Portrait/Landscape\n- `4:3`, `3:4`: Standard\n- `5:4`, `4:5`: Photo print\n- `16:9`, `9:16`: Widescreen/Social stories\n- `21:9`: Ultra-wide cinematic\n","type":"string"},"resolution":{"default":"1K","enum":["1K","2K","4K","low","medium","high"],"example":"1K","description":"Resolution quality for the generated image.\n\n**Available resolutions:**\n- `1K`: Lower resolution, faster generation (default)\n- `2K`: Standard resolution, balanced quality/speed\n- `4K`: High resolution, best quality\n","type":"string"},"use_google_search_tool":{"default":false,"description":"Enable Google Search grounding during image generation.\nWhen enabled, the model uses Google Search to ground its output with real-world information,\nimproving accuracy for prompts that reference real places, people, brands, or current events.\n\n**Note:** When enabled, the task response may include grounding metadata with source information.\n","type":"boolean"}}},"item_subtype":{"example":"footage","enum":["footage","motion_graphics","other","template","template_aep","template_prproj"],"description":"The subtype of the video.","type":"string"},"colors_palette":{"maxItems":5,"items":{"$ref":"#/components/schemas/colors_palette_inner"},"minItems":1,"description":"Dominant colors to generate the image","type":"array"},"inline_object_9":{"example":{"data":{"app_id":"uqzQLDr2Aw","started_at":"2026-02-25T12:00:00Z","completed_at":"2026-02-25T12:02:00Z","result":{"videos":[{"id":"LSFgqqrswO","duration":0.80082819046101,"width":6,"created_at":"2026-02-11T10:14:15Z","height":1,"url":"https://pikaso.cdnpk.net/private/production/3280037299/render.png?token=...","tool":"text-to-image"},{"id":"LSFgqqrswO","duration":0.80082819046101,"width":6,"created_at":"2026-02-11T10:14:15Z","height":1,"url":"https://pikaso.cdnpk.net/private/production/3280037299/render.png?token=...","tool":"text-to-image"}],"audios":[{"id":"LSFgqqrswO","duration":0.80082819046101,"width":6,"created_at":"2026-02-11T10:14:15Z","height":1,"url":"https://pikaso.cdnpk.net/private/production/3280037299/render.png?token=...","tool":"text-to-image"},{"id":"LSFgqqrswO","duration":0.80082819046101,"width":6,"created_at":"2026-02-11T10:14:15Z","height":1,"url":"https://pikaso.cdnpk.net/private/production/3280037299/render.png?token=...","tool":"text-to-image"}],"images":[{"id":"LSFgqqrswO","duration":0.80082819046101,"width":6,"created_at":"2026-02-11T10:14:15Z","height":1,"url":"https://pikaso.cdnpk.net/private/production/3280037299/render.png?token=...","tool":"text-to-image"},{"id":"LSFgqqrswO","duration":0.80082819046101,"width":6,"created_at":"2026-02-11T10:14:15Z","height":1,"url":"https://pikaso.cdnpk.net/private/production/3280037299/render.png?token=...","tool":"text-to-image"}]},"error_message":"error_message","status":"completed","run_id":"omps2OH829"}},"required":["data"],"type":"object","properties":{"data":{"$ref":"#/components/schemas/run-detail"}}},"author-video":{"example":{"name":"John Doe","code":"merry-christmas","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","id":2147483647,"metas":{"assets":0,"downloads":0}},"required":["avatar","id","metas","name","slug"],"type":"object","properties":{"name":{"example":"John Doe","type":"string","minLength":1},"code":{"example":"merry-christmas","type":"string","minLength":1},"avatar":{"example":"https://avatar.cdnpk.net/61668527-220726032514.jpg","format":"uri","type":"string"},"slug":{"example":"merry-christmas","type":"string","minLength":1},"id":{"minimum":1,"type":"integer","maximum":9.2233720368548e+18},"metas":{"$ref":"#/components/schemas/author_video_metas"}}},"tti-nano-banana-2-1-request":{"required":["prompt"],"title":"Nano Banana 2.1 Text-to-Image Request","type":"object","properties":{"reference_images":{"maxItems":14,"items":{"$ref":"#/components/schemas/tti_nano_banana_2_1_request_reference_images_inner"},"example":[{"image":"https://example.com/product.png"}],"description":"Optional reference images for editing, composition, style or character\nand product consistency.\n\n**Image requirements:**\n- Maximum 14 images\n- Supported formats: PNG, JPEG, WebP\n- Public HTTPS URL or base64-encoded string\n","type":"array"},"aspect_ratio":{"default":"1:1","enum":["auto","1:1","2:3","3:2","3:4","4:3","4:5","5:4","9:16","16:9","21:9","1:4","4:1","1:8","8:1"],"example":"1:1","description":"Aspect ratio for the generated image.\n\n**Available ratios:**\n- `auto`: Let the model choose. With reference images it follows their\n  ratio, including ratios outside this list; without them it picks the\n  ratio that best fits the prompt.\n- `1:1`: Square (default)\n- `2:3`, `3:2`: Portrait/Landscape\n- `3:4`, `4:3`: Standard\n- `4:5`, `5:4`: Photo print\n- `9:16`, `16:9`: Social stories/Widescreen\n- `21:9`: Ultra-wide cinematic\n- `1:4`, `4:1`, `1:8`, `8:1`: Banners, strips and vertical panels. At\n  `1K` they render 512x2064, 2064x512, 352x2928 and 2928x352 pixels.\n","type":"string"},"prompt":{"minLength":2,"example":"Place the product from Image 1 on a marble kitchen counter, soft morning light","maxLength":12000,"type":"string","description":"Text description of the image to generate, or of the edit to apply to\nthe reference images. Refer to the references by their caption\n(\"Image 1\", \"Image 2\", ...).\n"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"resolution":{"default":"1K","enum":["1K","2K","4K"],"example":"1K","description":"Output resolution. It sets the price of the generation.\n\n**Available resolutions:**\n- `1K`: About 1 megapixel, 1024x1024 at `1:1` (default)\n- `2K`: About 4 megapixels, 2048x2048 at `1:1`\n- `4K`: About 16 megapixels, 4096x4096 at `1:1`\n","type":"string"},"thinking_level":{"example":"medium","enum":["minimal","medium","high"],"description":"How much the model reasons about the prompt before drawing. Higher\nlevels help with complex compositions and many constraints, at the cost\nof a longer generation time. It does not affect the price.\nWhen omitted, the model uses `medium`.\n","type":"string"},"use_google_search_tool":{"default":false,"description":"Ground the generation on Google Search results, useful for prompts about\ncurrent events, real places or recent products. It does not affect the\nprice.\n","type":"boolean"}}},"task":{"example":{"task_id":"046b6c7f-0b8a-43b9-b35d-6489e6daee91","status":"CREATED"},"required":["status","task_id"],"type":"object","properties":{"task_id":{"format":"uuid","description":"Task identifier","type":"string"},"status":{"enum":["CREATED","IN_PROGRESS","COMPLETED","FAILED"],"description":"Task status","type":"string"}}},"meta":{"example":{"guidance_scale":2,"seed":42,"prompt":"Crazy dog flying over the space","image":{"height":1024,"size":"square_1_1","width":1024},"num_inference_steps":8},"required":["guidance_scale","image","prompt","seed"],"type":"object","properties":{"num_inference_steps":{"default":8,"minimum":1,"example":8,"description":"Number of inference steps, higher values will generate more realistic images but will take longer to generate.\nValid values range `[1, 8]`, default `8`\n","type":"integer","maximum":8},"seed":{"minimum":0,"example":42,"description":"The seed value used to generate the image. Providing the same seed will result in the same image being\ngenerated. If omitted, random seed will be applied, producing a different image each time.\nValid values range `[0, 1000000]`.\n","type":"integer","maximum":1000000},"prompt":{"example":"Crazy dog flying over the space","description":"Prompt given to generate the image","type":"string"},"guidance_scale":{"default":1,"minimum":0,"example":2,"description":"Defines the level of fidelity to the prompt we give to the image, the lower the level, the greater the creativity of the AI.\nValid values range `[0.0, 2.0]`, default `1.0`\n","type":"number","maximum":2},"image":{"$ref":"#/components/schemas/meta_image"}}},"ttif2k-request-content":{"required":["prompt"],"properties":{"input_image_2":{"description":"Second base64-encoded reference image for multi-image generation.","type":"string","nullable":true},"input_image_3":{"description":"Third base64-encoded reference image for multi-image generation.","type":"string","nullable":true},"prompt":{"example":"a beautiful sunset over the ocean with dramatic clouds","description":"Text description of the image you want to generate.\n\n**FLUX.2 [klein]** is the fastest model in the FLUX.2 family, optimized for sub-second generation while maintaining high quality. It supports up to 4 reference images for style and subject transfer.\n\n**Tips for better results:**\n- Be specific about subjects, scenes, and visual details\n- Use reference images to guide style and composition\n- Combine prompt with reference images for best results\n\n**Examples:**\n- Simple: `\"a mountain landscape at sunset\"`\n- Detailed: `\"portrait of a person in natural lighting, soft focus background\"`\n- With style: `\"abstract art in the style of watercolor painting\"`\n","type":"string"},"resolution":{"default":"1k","enum":["1k","2k"],"example":"1k","description":"Resolution multiplier for the generated image.\n\n- `1k`: Uses base dimensions (default)\n- `2k`: Doubles the base dimensions (capped at 2048px per side)\n\nFinal dimensions are calculated by multiplying base dimensions by the resolution factor,\nthen scaling proportionally if either dimension exceeds 2048px, and aligning to multiples of 16.\n","type":"string"},"seed":{"minimum":0,"maximum":4294967295,"example":42,"description":"Random seed for reproducible results.\n\n**Use case:** Generate variations of the same image by using the same seed with modified prompts.\n\n**Valid range:** 0 to 4,294,967,295\n**Default:** Random seed (if not provided)\n","type":"integer","nullable":true},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"input_image":{"description":"Base64-encoded reference image for **style/subject transfer**.\n\n**Supported formats:** JPEG, PNG\n**Use cases:**\n- Style transfer from reference images\n- Subject preservation\n- Composition guidance\n\n**Note:** Supports up to 4 reference images using `input_image`, `input_image_2`, `input_image_3`, and `input_image_4`.\n","type":"string","nullable":true},"safety_tolerance":{"default":2,"minimum":0,"description":"Content moderation tolerance level.\n\n**Range:** 0 to 5\n- **0:** Most strict filtering\n- **5:** Least strict filtering\n**Default:** 2\n\n**Note:** Lower values filter more content. Choose based on your application requirements.\n","type":"integer","maximum":5},"output_format":{"description":"Output image format.\n\n**PNG:** Lossless, supports transparency, larger file\n**JPEG:** Lossy, smaller file, no transparency\n","enum":["jpeg","png"],"type":"string","nullable":true},"input_image_4":{"description":"Fourth base64-encoded reference image for multi-image generation.","type":"string","nullable":true},"aspect_ratio":{"default":"square_1_1","enum":["square_1_1","classic_4_3","traditional_3_4","widescreen_16_9","social_story_9_16","standard_3_2","portrait_2_3","horizontal_2_1","vertical_1_2","social_post_4_5"],"example":"square_1_1","description":"Aspect ratio of the generated image. Determines the proportional relationship between width and height.\n\n| Aspect Ratio | Base Dimensions (1k) |\n|--------------|---------------------|\n| `square_1_1` | 1024 × 1024 |\n| `widescreen_16_9` | 1344 × 768 |\n| `social_story_9_16` | 768 × 1344 |\n| `portrait_2_3` | 832 × 1216 |\n| `traditional_3_4` | 960 × 1280 |\n| `vertical_1_2` | 704 × 1408 |\n| `horizontal_2_1` | 1408 × 704 |\n| `social_post_4_5` | 896 × 1152 |\n| `standard_3_2` | 1216 × 832 |\n| `classic_4_3` | 1280 × 960 |\n","type":"string"}},"type":"object"},"source":{"example":{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512},"properties":{"height":{"example":512,"type":"integer"},"width":{"example":512,"type":"integer"},"url":{"example":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","format":"uri","type":"string"}},"type":"object"},"style-transfer-request-content":{"required":["image","reference_image"],"properties":{"engine":{"default":"balanced","enum":["balanced","definio","illusio","3d_cartoon","colorful_anime","caricature","real","super_real","softy"],"description":"Magnific model engines","type":"string"},"prompt":{"description":"Prompt for the AI model","type":"string"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"fixed_generation":{"default":false,"description":"When this option is enabled, using the same settings will consistently produce the same image.\nFixed generations are ideal for fine-tuning, as it allows for incremental changes to parameters (such as the prompt) to see subtle variations in the output.\nWhen disabled, expect each generation to introduce a degree of randomness, leading to more diverse outcomes.\n","type":"boolean"},"style_strength":{"default":100,"minimum":0,"description":"Percentage of style strength","type":"integer","maximum":100},"structure_strength":{"default":50,"minimum":0,"description":"Allows to maintain the structure of the original image","type":"integer","maximum":100},"is_portrait":{"default":false,"description":"Indicates whether the image should be processed as a portrait. When set to `true`, portrait-specific enhancements such as style and beautification can be applied.\n","type":"boolean"},"portrait_style":{"default":"standard","enum":["standard","pop","super_pop"],"description":"Optional setting to define the visual style applied to portrait images. Only used if `is_portrait` is `true`. The available options adjust the stylization level or aesthetic treatment of the portrait.\n","type":"string"},"portrait_beautifier":{"enum":["beautify_face","beautify_face_max"],"description":"Optional setting to enable facial beautification on portrait images. Only used if `is_portrait` is `true`. Options control the intensity or type of beautification applied.\n","type":"string"},"image":{"description":"Base64 or URL of the image to do the style transfer","type":"string"},"reference_image":{"description":"Base64 or URL of the reference image for style transfer","type":"string"},"flavor":{"default":"faithful","enum":["faithful","gen_z","psychedelia","detaily","clear","donotstyle","donotstyle_sharp"],"description":"Flavor of the transferring style","type":"string"}},"type":"object"},"run-request":{"required":["inputs"],"properties":{"inputs":{"description":"Map of input identifier to value. Use each input's `api_key` (recommended) or its `id` (UUID, legacy) as the key — both are accepted.\n\nValue types by input type:\n- `creation` (image/media): URL string, base64-encoded string, or existing creation sqid\n- `text`: Plain text string\n- `number`: Numeric value\n- `select`: Value from allowed options\n","type":"object","additionalProperties":{"$ref":"#/components/schemas/run_request_inputs_value"}},"webhook":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that receives status notifications during execution.\nThe webhook receives POST requests with the event payload (see webhook event schema).\nEvents are sent when the run starts (`initialized`) and when it finishes (`finished` or `failed`).\n","type":"string"}},"type":"object"},"license-information":{"example":{"type":"freemium","url":"https://www.freepik.com/profile/license/pdf/4350594"},"required":["type","url"],"type":"object","properties":{"type":{"enum":["freemium","premium"],"description":"The type of license.","type":"string"},"url":{"example":"https://www.freepik.com/profile/license/pdf/4350594","format":"uri","description":"The URL of the license.","type":"string"}}},"SfxCategory_parent":{"required":["id","name"],"description":"Parent category, if this is a subcategory","example":{"name":"Nature","id":1},"properties":{"name":{"example":"Nature","type":"string"},"id":{"example":1,"type":"integer"}},"type":"object","nullable":true},"regular-resource-type":{"example":"vector","enum":["photo","vector","psd"],"description":"The type of the resource.","type":"string"},"author_video_metas":{"example":{"assets":0,"downloads":0},"required":["assets","downloads"],"type":"object","properties":{"downloads":{"minimum":0,"description":"The number of downloads of this author.","type":"integer"},"assets":{"minimum":0,"description":"The number of assets of this author.","type":"integer"}}},"detail_url":{"example":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667327","format":"uri","description":"Url to the video's detail page in magnific","type":"string"},"runway_act_two_request_character":{"required":["type","uri"],"properties":{"type":{"enum":["video","image"],"description":"Type of character input (video or image)","type":"string"},"uri":{"format":"uri","description":"URL to the character video/image (must be publicly accessible)","type":"string"}},"type":"object","description":"The character to control. A visually recognizable face must be visible."},"input-definition":{"required":["id","key","required","type"],"example":{"required":true,"config":null,"key":"text_prompt","default":null,"nodeId":"4050c3f3-8a26-4953-97a8-cb97bceb4816","api_key":"text_prompt","presentation":{"mode":"textarea","type":"text"},"label":"Text #1","type":"text","id":"input-4050c3f3-8a26-4953-97a8-cb97bceb4816-1"},"properties":{"required":{"example":true,"description":"Whether this input must be provided when running the flow.","type":"boolean"},"config":{"$ref":"#/components/schemas/input_definition_config"},"key":{"example":"text_prompt","description":"(Deprecated) Legacy human-readable key. Superseded by `api_key`; may be absent in newer responses. Prefer `api_key`.\n","type":"string","deprecated":true},"default":{"description":"Default value if not provided by the caller. Null means no default.","nullable":true},"nodeId":{"example":"4050c3f3-8a26-4953-97a8-cb97bceb4816","format":"uuid","description":"UUID of the flow node this input feeds into.","type":"string"},"api_key":{"example":"text_prompt","description":"Human-friendly identifier for this input, matching the node name.\nRecommended identifier to use as the key in the `inputs` object when running the flow.\n","type":"string"},"presentation":{"$ref":"#/components/schemas/input_definition_presentation"},"label":{"example":"Text #1","description":"Human-readable label for display.","type":"string"},"type":{"example":"text","enum":["creation","text","number","select"],"description":"The type of input value expected:\n- `creation`: Image or media file (accepts URL, base64, or creation sqid)\n- `text`: Text prompt or string\n- `number`: Numeric value\n- `select`: Choice from predefined options\n","type":"string"},"id":{"example":"input-4050c3f3-8a26-4953-97a8-cb97bceb4816-1","description":"UUID-based identifier for this input. Format: `input-{nodeId}-{n}`.\nStill accepted as a key in the `inputs` object for backward compatibility; prefer `api_key`.\n","type":"string"}},"type":"object","description":"Defines a single input parameter for the flow.\nUse the `api_key` field (recommended) or the `id` field (legacy) as the identifier in the `inputs` object when calling the run endpoint.\n"},"formats":{"example":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"allOf":[{"$ref":"#/components/schemas/formats_1"},{"required":["items"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/format_1"}}},"type":"object"}]},"ai_related":{"required":["suggested"],"description":"Related resources and tags for this resource.","properties":{"suggested":{"description":"Other resources related to this one.","type":"array","items":{"$ref":"#/components/schemas/resource"}}},"type":"object","nullable":true},"runway_act_two_request_reference":{"required":["type","uri"],"properties":{"type":{"enum":["video"],"description":"Must be 'video'","type":"string"},"uri":{"format":"uri","description":"URL to the reference performance video (3-30 seconds)","type":"string"}},"type":"object","description":"Reference video of a person performing the desired actions"},"flow-detail":{"required":["inputs","name","sqid"],"example":{"name":"Sketch to Realism","tool_metadata":{"sort_order":999,"total_cost":5,"category":"general","icon":"workflow","description_key":"description_key","translation_key":"translation_key"},"sqid":"uqzQLDr2Aw","inputs":[{"required":true,"config":null,"key":"text_prompt","default":null,"nodeId":"4050c3f3-8a26-4953-97a8-cb97bceb4816","api_key":"text_prompt","presentation":{"mode":"textarea","type":"text"},"label":"Text #1","type":"text","id":"input-4050c3f3-8a26-4953-97a8-cb97bceb4816-1"},{"required":true,"config":null,"key":"text_prompt","default":null,"nodeId":"4050c3f3-8a26-4953-97a8-cb97bceb4816","api_key":"text_prompt","presentation":{"mode":"textarea","type":"text"},"label":"Text #1","type":"text","id":"input-4050c3f3-8a26-4953-97a8-cb97bceb4816-1"}]},"properties":{"name":{"example":"Sketch to Realism","description":"Human-readable name set by the creator.","type":"string"},"tool_metadata":{"$ref":"#/components/schemas/tool-metadata"},"sqid":{"example":"uqzQLDr2Aw","description":"Short unique identifier.","type":"string"},"inputs":{"description":"Dynamic input definitions. Each input corresponds to an entry node\nin the flow. The caller must provide values for all `required`\ninputs when calling the run endpoint.\n","type":"array","items":{"$ref":"#/components/schemas/input-definition"}}},"type":"object","description":"Full definition of a flow including dynamic inputs and cost."},"mystic-request":{"properties":{"adherence":{"default":50,"minimum":0,"description":"Note: This parameter only takes effect when a `\"style_reference\"` image is provided.\nIncreasing this value will make your generation more faithful to the prompt, but it may transfer the style a bit less accurately. Higher values can help fix small artifacts, anatomical errors and text readability. Lower values will give you more creative images and closer to the style reference.\n","type":"integer","maximum":100},"engine":{"default":"automatic","enum":["automatic","magnific_illusio","magnific_sharpy","magnific_sparkle"],"description":"Select the engine for the AI model. Available options:\n  * `automatic` - default choice\n  * `Illusio` - for smoother illustrations, landscapes, and nature. The softer looking one.\n  * `Sharpy` - better for realistic images like photographs and for a more grainy look. It provides the sharpest and most detailed images. If you use it for illustrations it will give them more texture and a less softer look.\n  * `Sparkle` - also good for realistic images. It's a middle ground between Illusio and Sharpy.\n","type":"string"},"prompt":{"description":"### AI Model Prompt Description\n\nThe prompt is a short text that describes the image you want to generate. It can range from simple descriptions, like `\"a cat\"`, to detailed scenarios, such as `\"a cat with wings, playing the guitar, and wearing a hat\"`. If no prompt is provided, the AI will generate a random image.\n\n#### Adding Characters to the Prompt\nYou can introduce characters into the prompt using the following syntax:\n- `@character_name`: Represents the character you want to include.\n  Example: `My friend @john is a great artist.`\n\n#### Modifying Character Strength\nTo adjust the influence or \"strength\" of a character in the image, use the following syntax:\n- `@character_name::strength`: Specify the character's strength by appending `::strength` to their name, where `strength` is a numerical value.\n  Example: `My friend @john::200 is a great artist.`\n\nHigher strength values will make the character more prominent in the generated image.\n","type":"string"},"resolution":{"default":"2k","enum":["1k","2k","4k"],"description":"Resolution of the image","type":"string"},"model":{"default":"realism","enum":["realism","fluid","zen","flexible","super_real","editorial_portraits"],"description":"* `zen` - for smoother, basic, and cleaner results. Fewer objects in the scene and less intricate details. The softer looking one.\n\n* `flexible` - good prompt adherence. However, it has results that are a bit more HDR and saturated than Realism or Fluid. It's especially good with illustrations, fantastical prompts, and for diving into the latent space in search of very specific visual styles.\n\n* `fluid` - the model that adheres best to prompts with great average quality for all kind of images. It can generate really creative images! It will always follow your input no matter what.\n\n* `realism` - with a more realistic color palette. It tries to give an extra boost of reality to your images, a kind of \"less AI look\". Works especially well with photographs but also magically works with illustrations too. IMPORTANT: you should use Zen, Flexible or Fluid if you are trying to generate something that is really fantastic or a known character, Realism may not follow your prompt well.\n\n* `super_real` - if reality is your priority, this is your model. Nearly as versatile as Flexible, it excels in realism outperforming Editorial Portraits in medium shots, though not as strong for close-ups.\n\n* `editorial_portraits` - the most amazing state-of-the-art generator for editorial portraits. You have never seen a level of realism like this before. Perfect for hyperrealistic close-up or medium shots. Unfortunately, in wide or distant shots, it generates anatomical problems and artifacts... but for close-ups, it is simply the best on the market. Tip: use the longest and most explanatory prompts possible, they really suit it well!\n","type":"string"},"styling":{"$ref":"#/components/schemas/mystic_request_styling"},"style_reference":{"format":"byte","description":"### Style Reference\nBase64 image to use as style reference. Using images as style references allows you to influence the aesthetic of your creation. This is possibly the most powerful tool of Mystic, as it truly lets you create incredibly unique images.\n","type":"string"},"hdr":{"default":50,"minimum":0,"description":"Note: This parameter only takes effect when a `\"style_reference\"` image is provided.\nIncreasing this value can give you a more detailed image, at the cost of a more 'AI look' and slightly worse style transfer. Lower values have a more natural and artistic look but may increase artifacts.\n","type":"integer","maximum":100},"structure_strength":{"default":50,"minimum":0,"description":"Note: This parameter only takes effect when a `\"structure_reference\"` image is provided.\nAllows to maintain the structure of the original image.\n","type":"integer","maximum":100},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"structure_reference":{"format":"byte","description":"### Structure Reference\nBase64 image to use as structure reference. Using images as structure references allows you to influence the shape of your final image. This feature enables various creative applications such as coloring sketches, transforming cartoons into realistic images, texturing basic 3D models, or converting real images into cartoons. The outcome is entirely controlled by your prompt, offering limitless creative possibilities.\n","type":"string"},"creative_detailing":{"default":33,"minimum":0,"description":"Higher values can achieve greater detail per pixel at higher resolutions at the cost of giving a somewhat more \"HDR\" or artificial look.\nVery high values can generate quite crazy things like eyes where they shouldn't appear, etc.\n\nValid values range `[0, 100]`, default `33`\n","type":"integer","maximum":100},"fixed_generation":{"default":false,"description":"When this option is enabled, using the same settings will consistently produce the same image.\nFixed generations are ideal for fine-tuning, as it allows for incremental changes to parameters (such as the prompt) to see subtle variations in the output.\nWhen disabled, expect each generation to introduce a degree of randomness, leading to more diverse outcomes.\n","type":"boolean"},"filter_nsfw":{"default":true,"description":"Controls **NSFW** (Not Safe For Work) content filtering during generation.\n\nThis parameter is always set to `true` by default and NSFW filtering **cannot be disabled** for standard API usage. Only authorized clients with special permissions can disable this filter.\n\n**Important:** If your use case requires disabling NSFW filtering, please contact our support team to discuss your requirements and potential authorization.\n","type":"boolean"},"aspect_ratio":{"default":"square_1_1","enum":["square_1_1","classic_4_3","traditional_3_4","widescreen_16_9","social_story_9_16","smartphone_horizontal_20_9","smartphone_vertical_9_20","standard_3_2","portrait_2_3","horizontal_2_1","vertical_1_2","social_5_4","social_post_4_5'"],"example":"square_1_1","description":"Image size with the aspect ratio. The aspect ratio is the proportional relationship between an image's width and height, expressed as *_width_height (e.g., square_1_1, widescreen_16_9). It is calculated by dividing the width by the height.\\\nIf not present, the default is `square_1_1`.\nNote: For the `fluid` model, only this values are valid:\n* square_1_1\n* social_story_9_16\n* widescreen_16_9\n* traditional_3_4\n* classic_4_3\n","type":"string"}},"type":"object","description":"### Model Compatibility and LoRA Usage\n\nThe Mystic API supports different model configurations with varying LoRA compatibility:\n\n**LoRA-Compatible Configuration:**\n- Use the default model (no `model` field specified)\n- No `structure_reference` or `style_reference` provided\n- LoRAs can be used via:\n  - Character syntax in prompt: `@character_name` or `@character_name::strength`\n  - `styling.characters` array\n  - `styling.styles` array\n\n**LoRA-Incompatible Configurations:**\n- **Specific Models**: `fluid`, `flexible` , `super_real` and `editorial_portraits` models ignore all LoRAs\n- **Structure Reference**: When `structure_reference` is provided, LoRAs are ignored\n- **Style Reference**: When `style_reference` is provided, LoRAs are ignored\n- **Combined References**: When both `structure_reference` and `style_reference` are provided, LoRAs are ignored\n\n**Important**: The API will not return errors for incompatible combinations. Instead, LoRAs will be silently ignored, and the request will proceed with the selected model configuration.\n"},"ttisd-request-content":{"required":["prompt"],"properties":{"guidance_scale":{"default":2.5,"minimum":0,"description":"Controls how closely the output image aligns with the input prompt. Higher values mean stronger prompt correlation.","type":"number","maximum":20},"seed":{"minimum":0,"description":"Random seed to control the stochasticity of image generation","type":"integer","maximum":2147483647},"prompt":{"description":"The text prompt used to generate the image","type":"string"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"aspect_ratio":{"default":"square_1_1","enum":["square_1_1","widescreen_16_9","social_story_9_16","portrait_2_3","traditional_3_4","standard_3_2","classic_4_3"],"description":"The aspect ratio of the generated image","type":"string"}},"type":"object"},"seedance_2_5_request_multishot_inner":{"required":["prompt"],"properties":{"duration":{"minimum":1,"description":"Duration of this shot in seconds.","type":"integer","maximum":12},"prompt":{"maxLength":40000,"description":"The prompt describing this shot. Prompts longer than 5,000 characters are accepted, but results may become less predictable.","type":"string"}},"type":"object"},"format_1":{"example":{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},"allOf":[{"$ref":"#/components/schemas/format"},{"required":["colorspace","name"],"properties":{"name":{"example":"image.jpg","description":"The name of the file.","type":"string"},"colorspace":{"example":"RGB","enum":["RGB","CMYK","UNKNOWN"],"description":"The colorspace of the file.","type":"string"}},"type":"object"}]},"ttisdv5l-request-content":{"required":["prompt"],"properties":{"seed":{"minimum":0,"example":12345,"description":"Random seed for reproducibility.\nUsing the same seed with identical parameters produces similar results.\nUseful for iterating on a design or creating variations.\n","type":"integer","maximum":4294967295},"prompt":{"example":"A futuristic cityscape at sunset with neon lights","maxLength":4096,"type":"string","description":"Text description of the image you want to generate.\n\n**Tips:**\n- Be specific about visual details, composition, and style\n- Seedream V5 Lite excels at high-quality image generation with improved detail and composition\n- Describe lighting, atmosphere, and camera angles for best results\n\n**Examples:**\n- Simple: \"A futuristic cityscape at sunset with neon lights\"\n- Detailed: \"A futuristic cityscape at sunset with neon lights, detailed architecture, volumetric lighting, cinematic composition\"\n"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"enable_safety_checker":{"default":true,"description":"Whether to enable the content safety checker.\nWhen enabled, the model filters potentially unsafe content.\n","type":"boolean"},"aspect_ratio":{"default":"square_1_1","enum":["square_1_1","widescreen_16_9","social_story_9_16","portrait_2_3","traditional_3_4","standard_3_2","classic_4_3","cinematic_21_9"],"example":"square_1_1","description":"The aspect ratio of the generated image. Seedream V5 Lite supports up to 4MP resolution.\n\nAvailable options:\n- `square_1_1`: Square format (2048x2048) - Instagram feed, profile pictures\n- `widescreen_16_9`: Landscape (2730x1536) - YouTube thumbnails, presentations\n- `social_story_9_16`: Portrait (1536x2730) - TikTok, Instagram Stories\n- `portrait_2_3`: Tall portrait (1672x2508) - Pinterest pins\n- `traditional_3_4`: Classic photo (1774x2364) - Traditional photography\n- `standard_3_2`: Photo print (2508x1672) - Standard prints\n- `classic_4_3`: Monitor ratio (2364x1774) - Classic displays\n- `cinematic_21_9`: Ultra-wide (3062x1312) - Cinematic banners\n","type":"string"}},"type":"object"},"request_16_reference_images_inner":{"required":["image","mime_type"],"properties":{"image":{"example":"https://example.com/reference-image.jpg","description":"Image URL (publicly accessible URL or GCS format)","type":"string"},"mime_type":{"example":"image/jpeg","enum":["image/png","image/jpeg","image/webp"],"description":"MIME type of the reference image","type":"string"}},"type":"object"},"creative-request":{"required":["image"],"properties":{"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"smart_grain":{"default":2,"minimum":0,"example":2,"description":"Smart grain intensity","type":"integer","maximum":100},"sharpen":{"default":0,"minimum":0,"example":0,"description":"Sharpening intensity","type":"integer","maximum":100},"image":{"example":"https://example.com/portrait.jpg","description":"Input image. Supports Base64 encoding or HTTPS URL (must be publicly accessible).","type":"string"}},"type":"object"},"tag_1":{"example":{"name":"Merry Christmas","slug":"merry-christmas"},"required":["name","slug"],"type":"object","properties":{"slug":{"example":"merry-christmas","type":"string","minLength":1},"name":{"example":"Merry Christmas","description":"The name of the tag.","type":"string","minLength":1}}},"ttifkp-request-content":{"required":["prompt"],"properties":{"prompt":{"example":"a beautiful sunset over the ocean with dramatic clouds","description":"Text description of the image you want to generate.\n\n**FLUX Kontext Pro** is an advanced text-to-image model that excels at understanding context\nand generating high-quality images. It supports optional image input to guide the generation.\n\n**Tips for better results:**\n- Be specific about subjects, scenes, and visual details\n- Describe lighting, atmosphere, and mood\n- Mention art style or photographic techniques if desired\n","type":"string"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"prompt_upsampling":{"default":false,"description":"Whether to perform upsampling on the prompt. If active, automatically modifies the prompt for more creative generation.","type":"boolean"},"guidance":{"default":3,"maximum":10,"description":"Guidance scale for the generation. Higher values make the model follow the prompt more closely.","minimum":1,"type":"number","nullable":true},"steps":{"default":50,"maximum":100,"description":"Number of inference steps. More steps generally produce higher quality but take longer.","minimum":1,"type":"integer","nullable":true},"input_image":{"description":"Optional URL to an input image that will guide the generation process.\nThe model will use this image as a reference while generating the output.\n","example":"https://example.com/reference-image.jpg","format":"uri","type":"string","nullable":true},"safety_tolerance":{"default":2,"minimum":0,"description":"Tolerance level for input and output moderation. Between 0 and 6, 0 being most strict, 6 being least strict.","type":"integer","maximum":6},"output_format":{"description":"Format of the output image","enum":["jpeg","png"],"type":"string","nullable":true},"seed":{"description":"Optional seed for reproducibility. If not provided, a random seed will be used.","type":"integer","nullable":true},"aspect_ratio":{"default":"square_1_1","enum":["square_1_1","classic_4_3","traditional_3_4","widescreen_16_9","social_story_9_16","standard_3_2","portrait_2_3","horizontal_2_1","vertical_1_2","social_post_4_5"],"example":"square_1_1","description":"Image size with the aspect ratio. The aspect ratio is the proportional relationship between an image's width and height, expressed as *_width_height (e.g., square_1_1, widescreen_16_9). It is calculated by dividing the width by the height.\\\nIf not present, the default is `square_1_1`.\n","type":"string"}},"type":"object"},"photo_available_formats":{"properties":{"jpg":{"$ref":"#/components/schemas/photo_formats"}},"description":"The available formats for the photo.","type":"object","nullable":true},"request_content_styling":{"properties":{"style":{"example":"cartoon","enum":["photo","digital-art","3d","painting","low-poly","pixel-art","anime","cyberpunk","comic","vintage","cartoon","vector","studio-shot","dark","sketch","mockup","2000s-pone","70s-vibe","watercolor","art-nouveau","origami","surreal","fantasy","traditional-japan"],"description":"Style to apply to the image","type":"string"},"effects":{"$ref":"#/components/schemas/request_content_styling_effects"},"colors":{"maxItems":5,"items":{"$ref":"#/components/schemas/colors_palette_inner"},"minItems":1,"description":"Dominant colors to generate the image","type":"array"}},"type":"object"},"kling-v3-request":{"properties":{"cfg_scale":{"default":0.5,"minimum":0,"description":"Guidance scale controlling prompt adherence versus creative freedom. Range: 0 to 1.\nValues above 1 are not supported for Kling 3 (only Kling 1.x models support cfg_scale up to 2).\n\n- **0**: Maximum creative freedom, loosest interpretation of the prompt\n- **0.5** (default): Balanced between prompt adherence and creativity\n- **1**: Strongest adherence to the prompt, least creative variation\n","format":"float","type":"number","maximum":1},"start_image_url":{"description":"URL of the image to use as the first frame of the video.\nRequired for image-to-video mode.\n\n**Image requirements:**\n- Minimum: 300x300 pixels\n- Maximum: 10MB file size\n- Aspect ratio: 1:2.5 to 2.5:1\n- Formats: JPG, JPEG, PNG\n","type":"string"},"prompt":{"maxLength":2500,"description":"Text prompt describing the desired video content. Maximum 2500 characters.\nRequired for text-to-video mode or when not using multi_prompt.\n\n**Tips for better results:**\n- Be specific about motion, camera angles, and actions\n- Describe the scene, characters, and atmosphere\n- Reference elements in your prompt as @Element1, @Element2\n- Reference voices with <<<voice_1>>> and <<<voice_2>>>\n","type":"string"},"webhook_url":{"format":"uri","description":"Optional callback URL that receives asynchronous notifications when the task changes status.\nThe payload includes the task status and result URL when completed.\n","type":"string"},"multi_shot":{"default":false,"description":"Enable multi-shot mode for multi-scene video generation.\nWhen true, use shot_type and multi_prompt to define scenes.\nWhen false (default), generates a single continuous video.\n","type":"boolean"},"shot_type":{"default":"customize","enum":["customize","intelligent"],"description":"Controls how multi-shot video generation is segmented:\n- `customize`: User provides explicit per-shot prompts and durations via the multi_prompt array. Each shot is defined manually.\n- `intelligent`: Enables automatic scene segmentation by Kling AI. Can be used without multi_prompt (Kling auto-segments the video based on the main prompt) or with multi_prompt (user-defined shots combined with AI segmentation).\n\nNote: This parameter maps to Kling's internal \"intelligence\" spelling for the intelligent option.\nDefaults to \"customize\" when multi_prompt is provided.\n","type":"string"},"negative_prompt":{"default":"blur, distort, and low quality","maxLength":2500,"type":"string","description":"Undesired elements to avoid in the generated video. Maximum 2500 characters."},"multi_prompt":{"description":"Multi-shot prompts with durations for sequential video generation.\nEach item specifies a prompt and duration (in seconds) for that shot.\nMaximum 6 shots. Total duration across all shots cannot exceed 15 seconds.\n\nOnly effective when shot_type is set. When multi_prompt is provided without an explicit shot_type, it defaults to \"customize\".\nWhen shot_type is \"intelligent\", Kling can auto-segment the video even without multi_prompt.\n","maxItems":6,"type":"array","items":{"$ref":"#/components/schemas/kling-v3-multi-prompt-item"}},"end_image_url":{"description":"URL of the image to use as the final frame of the video.\nOptional for image-to-video mode.\n\n**Image requirements:**\n- Same as start_image_url\n","type":"string"},"generate_audio":{"default":true,"description":"Whether to generate native audio for the video.","type":"boolean"},"duration":{"$ref":"#/components/schemas/kling-v3-duration"},"aspect_ratio":{"$ref":"#/components/schemas/kling-v3-aspect-ratio"}},"type":"object"},"photo_formats":{"required":["items","total"],"properties":{"total":{"example":1,"description":"The total number of files for that format.","type":"integer"},"items":{"type":"array","items":{"$ref":"#/components/schemas/photo_format"}}},"type":"object"},"download":{"example":{"signed_url":"https://img.freepik.com/premium-photo/close-up-cat-resting_1048944-9269194.jpg?t=st=1725276607~exp=1725280207~hmac=1538f1b294fc3a19a19e9f02ceeb6594a9a1e36a900de85d47bbd386e27dddbe","filename":"blackboard-template.zip","url":"https://downloadscdn5.freepik.com/d/1137445/blackboard-template.zip"},"required":["filename","url"],"type":"object","properties":{"signed_url":{"description":"The signed URL of the resource preview","example":"https://img.freepik.com/premium-photo/close-up-cat-resting_1048944-9269194.jpg?t=st=1725276607~exp=1725280207~hmac=1538f1b294fc3a19a19e9f02ceeb6594a9a1e36a900de85d47bbd386e27dddbe","format":"uri","type":"string","nullable":true},"url":{"example":"https://downloadscdn5.freepik.com/d/1137445/blackboard-template.zip","format":"uri","type":"string","minLength":1},"filename":{"example":"blackboard-template.zip","description":"Filename of the resource","type":"string","minLength":1}}},"photo_format":{"required":["size"],"properties":{"name":{"example":"image.jpg","description":"The name of the file. This property is not sent when the file id is null.","type":"string"},"size":{"example":100,"description":"The size of the photo in bytes.","type":"integer"},"is_remove_bg":{"example":true,"description":"Indicates that the file is the result of the remove background tool.","type":"boolean"},"colorspace":{"example":"RGB","enum":["RGB","CMYK","UNKNOWN"],"description":"The colorspace of the file. This property is not sent when the file id is null.","type":"string"},"id":{"minimum":1,"example":1,"description":"The id of the format. Null if doesn't exist","type":"integer","nullable":true}},"type":"object"},"ttirunway-request-content":{"required":["prompt","ratio"],"properties":{"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"ratio":{"example":"1920:1080","enum":["1920:1080","1080:1920","1024:1024","1360:768","1080:1080","1168:880","1440:1080","1080:1440","1808:768","2112:912","1280:720","720:1280","720:720","960:720","720:960","1680:720"],"description":"Image aspect ratio (width:height).\n\n**Available ratios:**\n- `1920:1080`: Landscape (16:9)\n- `1080:1920`: Portrait (9:16)\n- `1024:1024`: Square\n- `1280:720`: HD Landscape\n- `720:1280`: HD Portrait\n","type":"string"},"seed":{"minimum":0,"example":12345,"description":"Random seed for reproducibility.\nUsing the same seed with identical parameters produces the same image.\n","type":"integer","maximum":4294967295},"prompt":{"minLength":1,"example":"A serene mountain landscape at sunset with golden light","maxLength":1000,"type":"string","description":"Text prompt describing the desired image.\n\n**Tips:**\n- Be specific about visual details and composition\n- RunWay excels at photorealistic and artistic images\n- Reference images can be used with @tag syntax\n\n**Examples:**\n- Simple: \"A serene mountain landscape at sunset\"\n- Detailed: \"A majestic lion in the savanna at golden hour, cinematic lighting\"\n"}},"type":"object"},"i2v-wan-25-1080p-request-content":{"title":"Image to Video - WAN 2.5 1080p","description":"Generate 1080p video from image using WAN 2.5 model","allOf":[{"$ref":"#/components/schemas/wan-25-i2v-base"}]},"ltx-2-resolution":{"default":"1080p","enum":["1080p","1440p","2160p"],"example":"1080p","description":"Video resolution","type":"string"},"ltx-2-pro-t2v-request":{"required":["prompt"],"title":"LTX Video 2.0 Pro Text-to-Video Request","type":"object","allOf":[{"$ref":"#/components/schemas/ltx-2-base"},{"properties":{"resolution":{"$ref":"#/components/schemas/ltx-2-resolution"},"duration":{"$ref":"#/components/schemas/ltx-2-pro-duration"},"fps":{"$ref":"#/components/schemas/ltx-2-fps"}},"type":"object"}]},"request":{"required":["audio_url","video_url"],"properties":{"guidance_scale":{"default":1,"example":1,"format":"float","description":"Guidance strength for the sync process","type":"number"},"video_url":{"example":"https://example.com/input-video.mp4","description":"URL of the video to sync","type":"string"},"audio_url":{"example":"https://example.com/input-audio.mp3","description":"URL of the audio to sync","type":"string"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"return_private_url":{"default":false,"example":false,"type":"boolean","description":"If true, the private URL (gs URI) of the generated video will be returned"},"seed":{"default":0,"example":42,"type":"integer","description":"Seed for the syncing process"}},"type":"object"},"tag_2":{"example":{"name":"Merry Christmas","slug":"merry-christmas","url":"https://www.freepik.com/dog"},"allOf":[{"$ref":"#/components/schemas/tag_1"},{"properties":{"url":{"description":"It will not be null when some SEO rules like redirects and canonicals are applied.","example":"https://www.freepik.com/dog","format":"uri","type":"string","nullable":true}},"type":"object"}]},"video-edit-additional-settings":{"properties":{"audio_setting":{"$ref":"#/components/schemas/audio-setting"},"prompt_extend":{"default":true,"example":true,"type":"boolean","description":"Enable automatic prompt expansion to enrich shorter prompts with additional detail for better editing results."}},"type":"object","description":"Additional settings for video editing."},"ttifkm-request-content":{"required":["input_image","prompt"],"properties":{"input_image_2":{"description":"Optional URL to a second reference image. Flux Kontext Max supports up to 4 input images.","example":"https://example.com/reference-image-2.jpg","format":"uri","type":"string","nullable":true},"input_image_3":{"description":"Optional URL to a third reference image. Flux Kontext Max supports up to 4 input images.","example":"https://example.com/reference-image-3.jpg","format":"uri","type":"string","nullable":true},"prompt":{"example":"a beautiful sunset over the ocean with dramatic clouds","description":"Text description of the image or edit you want to generate.\n\n**FLUX Kontext Max** is the highest-quality tier of the Kontext family, delivering maximum prompt adherence\nand detail for context-aware image editing and generation.\n\n**Tips for better results:**\n- Be specific about subjects, scenes, and visual details\n- Describe the exact edit or transformation you want\n- Mention lighting, atmosphere, and art style if desired\n","type":"string"},"input_image_4":{"description":"Optional URL to a fourth reference image. Flux Kontext Max supports up to 4 input images.","example":"https://example.com/reference-image-4.jpg","format":"uri","type":"string","nullable":true},"prompt_upsampling":{"default":false,"description":"Whether to perform upsampling on the prompt. If active, automatically modifies the prompt for more creative generation.","type":"boolean"},"guidance":{"default":3,"maximum":10,"description":"Guidance scale for the generation. Higher values make the model follow the prompt more closely.","minimum":1,"type":"number","nullable":true},"seed":{"description":"Optional seed for reproducibility. If not provided, a random seed will be used.","type":"integer","nullable":true},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"input_image":{"example":"https://example.com/reference-image.jpg","format":"uri","description":"URL to the input image that guides the generation process.\nThe model uses this image as a reference while producing the output.\n","type":"string"},"safety_tolerance":{"default":2,"minimum":0,"description":"Tolerance level for input and output moderation. Between 0 and 6, 0 being most strict, 6 being least strict.","type":"integer","maximum":6},"output_format":{"description":"Format of the output image","enum":["jpeg","png"],"type":"string","nullable":true},"steps":{"default":50,"maximum":100,"description":"Number of inference steps. More steps generally produce higher quality but take longer.","minimum":1,"type":"integer","nullable":true},"aspect_ratio":{"default":"square_1_1","enum":["square_1_1","classic_4_3","traditional_3_4","widescreen_16_9","social_story_9_16","standard_3_2","portrait_2_3","horizontal_2_1","vertical_1_2","social_post_4_5"],"example":"square_1_1","description":"Image size with the aspect ratio. The aspect ratio is the proportional relationship between an image's width and height, expressed as *_width_height (e.g., square_1_1, widescreen_16_9). It is calculated by dividing the width by the height.\\\nIf not present, the default is `square_1_1`.\n","type":"string"}},"type":"object"},"video-edit-aspect-ratio":{"enum":["16:9","9:16","1:1","4:3","3:4"],"description":"Output video aspect ratio for editing. If not specified, the aspect ratio of the input video is preserved.\n- `16:9`: Landscape (widescreen)\n- `9:16`: Portrait (vertical, mobile-optimized)\n- `1:1`: Square\n- `4:3`: Standard landscape\n- `3:4`: Standard portrait\n","type":"string"},"request-content":{"required":["prompt"],"properties":{"guidance_scale":{"default":1,"minimum":0,"example":2,"description":"Defines the level of fidelity to the prompt when generating the image. A lower value allows for more creativity from the AI, while a higher value ensures closer adherence to the prompt.\nValid values range `[0.0, 2.0]`, default `1.0`.\n","type":"number","maximum":2},"seed":{"minimum":0,"example":123,"description":"Seed value for image generation. Using the same seed will produce the same image. If omitted, random seed will be applied, resulting in a different image each time.\nValid values range `[0, 1000000]`.\n","type":"integer","maximum":1000000},"negative_prompt":{"example":"b&w, grayscale, disfigured, bad quality","description":"Attributes to avoid in the generated image\nMinimum length: `3 characters`\n","type":"string","minLength":3},"styling":{"$ref":"#/components/schemas/request_content_styling"},"prompt":{"example":"Crazy dog flying over the space","description":"Text to generate image from\nMinimum length: `3 characters`\n","type":"string","minLength":3},"num_images":{"default":1,"minimum":1,"example":1,"description":"Specifies the number of images to generate in a single request.\nValid values range `[1, 4]`, default `1`.\n","type":"integer","maximum":4},"filter_nsfw":{"example":true,"description":"If true, the generated image will be filtered for NSFW content. If false, the image may contain NSFW content.\nDefault value is `true`.\n","type":"boolean"},"image":{"$ref":"#/components/schemas/image_size"}},"type":"object"},"search_icons_200_response_meta":{"example":{"pagination":{"last_page":1,"per_page":1,"total":1,"current_page":1}},"required":["pagination"],"type":"object","properties":{"pagination":{"$ref":"#/components/schemas/pagination"}}},"search_icons_200_response":{"example":{"data":[{"name":"a woman reads a book in a tablet sits in the luxurious back of the library","free_svg":true,"id":52912,"thumbnails":[{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512},{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512}],"tags":[{"name":"Dog","slug":"dog"},{"name":"Dog","slug":"dog"}],"family":{"name":"Outline","total":1200,"id":1},"slug":"a-woman-reads-a-book-in-a-tablet-sits-in-the-luxurious-back-of-the-library","style":{"name":"Meticulous Yellow shadow","id":50},"created":"2023-03-07T23:05:26Z","author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}},{"name":"a woman reads a book in a tablet sits in the luxurious back of the library","free_svg":true,"id":52912,"thumbnails":[{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512},{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512}],"tags":[{"name":"Dog","slug":"dog"},{"name":"Dog","slug":"dog"}],"family":{"name":"Outline","total":1200,"id":1},"slug":"a-woman-reads-a-book-in-a-tablet-sits-in-the-luxurious-back-of-the-library","style":{"name":"Meticulous Yellow shadow","id":50},"created":"2023-03-07T23:05:26Z","author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}}],"meta":{"pagination":{"last_page":1,"per_page":1,"total":1,"current_page":1}}},"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/icon_b2b"}},"meta":{"$ref":"#/components/schemas/search_icons_200_response_meta"}},"type":"object"},"ltx-2-base":{"properties":{"webhook_url":{"format":"uri","description":"Webhook URL to notify when the task is completed","type":"string"},"generate_audio":{"default":false,"example":false,"type":"boolean","description":"Whether to generate synchronized audio for the video"},"seed":{"minimum":0,"example":12345,"description":"Random seed for reproducibility. Use the same seed with identical parameters for similar results.","type":"integer","maximum":4294967295},"prompt":{"example":"A majestic eagle soaring through mountain valleys at sunset","maxLength":2000,"type":"string","description":"Text prompt describing the desired video content.\n\n**Tips:**\n- Be specific about scenes, subjects, and visual details\n- Describe motion and camera movements\n- Mention lighting and atmosphere\n\n**Example:** \"A majestic eagle soaring through mountain valleys at sunset, camera slowly panning to follow the flight\"\n"}},"type":"object"},"detail_b2b":{"example":{"explicit":0,"code":"gorgeous-woman-stretching-neck","url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667327","thumbnails":[{"width":100,"height":100,"url":"https://img.freepik.com/free-photo/image_8353-7579.jpg","aspect_ratio":"16:9"},{"width":100,"height":100,"url":"https://img.freepik.com/free-photo/image_8353-7579.jpg","aspect_ratio":"16:9"}],"tags":[{"name":"Merry Christmas","slug":"merry-christmas"},{"name":"Merry Christmas","slug":"merry-christmas"}],"options":[{"size":400,"width":4096,"container":"mp4","codec":"AVC Coding","active":true,"quality":"4k","is_original":true,"id":76989,"height":2304,"bit_rate":25.44,"aspect_ratio":"16:9"},{"size":400,"width":4096,"container":"mp4","codec":"AVC Coding","active":true,"quality":"4k","is_original":true,"id":76989,"height":2304,"bit_rate":25.44,"aspect_ratio":"16:9"}],"fps":"25","id":99332243,"name":"gorgeous woman stretching neck","previews":[{"width":100,"height":100,"url":"https://v1.cdnpk.net/videvo_files/video/premium/video0289/watermarked/_Geometric80s30_FPpreview.mp4","aspect_ratio":"16:9"},{"width":100,"height":100,"url":"https://v1.cdnpk.net/videvo_files/video/premium/video0289/watermarked/_Geometric80s30_FPpreview.mp4","aspect_ratio":"16:9"}],"duration":"00:00:28","is_ai_generated":true,"quality":"4k","created":"2000-01-23T04:56:07.000+00:00","author":{"name":"John Doe","code":"merry-christmas","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","id":2147483647,"metas":{"assets":0,"downloads":0}},"premium":0,"item_subtype":"footage","active":1,"aspect_ratio":"969"},"properties":{"explicit":{"example":0,"enum":[0,1],"type":"integer"},"code":{"example":"gorgeous-woman-stretching-neck","type":"string"},"url":{"example":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667327","format":"uri","description":"Url to the video's detail page in magnific","type":"string"},"thumbnails":{"minItems":1,"type":"array","items":{"$ref":"#/components/schemas/image-with-aspect-ratio"}},"tags":{"type":"array","items":{"$ref":"#/components/schemas/tag_1"}},"options":{"type":"array","items":{"$ref":"#/components/schemas/option"}},"fps":{"example":"25","enum":["24","25","30","50","60","gt60"],"description":"The fps of this video","type":"string"},"id":{"example":99332243,"minimum":1,"type":"integer","description":"schemas's id."},"name":{"example":"gorgeous woman stretching neck","description":"schemas's title.","type":"string"},"previews":{"minItems":1,"type":"array","items":{"$ref":"#/components/schemas/preview-with-aspect-ratio"}},"duration":{"example":"00:00:28","pattern":"^0[0-9]:[0-5][0-9]:[0-5][0-9]$","type":"string"},"active":{"example":1,"description":"1 if this video is active. 0, otherwise.","type":"integer"},"quality":{"$ref":"#/components/schemas/quality"},"created":{"format":"date-time","description":"The datetime when this video was created.","type":"string"},"author":{"$ref":"#/components/schemas/author-video"},"premium":{"example":0,"description":"1 if this video is premium. 0, otherwise.","type":"integer"},"item_subtype":{"$ref":"#/components/schemas/item_subtype"},"is_ai_generated":{"example":true,"description":"True if the resource is generated by AI, false otherwise.","type":"boolean"},"aspect_ratio":{"$ref":"#/components/schemas/aspect-ratio_2"}},"type":"object"},"get_icon_detail_by_id_200_response":{"example":{"data":{"style":{"name":"Meticulous Yellow shadow","id":50},"free_svg":true,"id":52912,"related":{"style":[{"name":"a woman reads a book in a tablet sits in the luxurious back of the library","free_svg":true,"thumbnails":[{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512},{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512}],"created":"2023-03-07T23:05:26Z","id":52912,"slug":"a-woman-reads-a-book-in-a-tablet-sits-in-the-luxurious-back-of-the-library","family":{"name":"Outline","total":1200,"id":1},"style":{"name":"Meticulous Yellow shadow","id":50},"author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}},{"name":"a woman reads a book in a tablet sits in the luxurious back of the library","free_svg":true,"thumbnails":[{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512},{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512}],"created":"2023-03-07T23:05:26Z","id":52912,"slug":"a-woman-reads-a-book-in-a-tablet-sits-in-the-luxurious-back-of-the-library","family":{"name":"Outline","total":1200,"id":1},"style":{"name":"Meticulous Yellow shadow","id":50},"author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}}],"variants":[{"name":"a woman reads a book in a tablet sits in the luxurious back of the library","free_svg":true,"thumbnails":[{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512},{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512}],"created":"2023-03-07T23:05:26Z","id":52912,"slug":"a-woman-reads-a-book-in-a-tablet-sits-in-the-luxurious-back-of-the-library","family":{"name":"Outline","total":1200,"id":1},"style":{"name":"Meticulous Yellow shadow","id":50},"author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}},{"name":"a woman reads a book in a tablet sits in the luxurious back of the library","free_svg":true,"thumbnails":[{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512},{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512}],"created":"2023-03-07T23:05:26Z","id":52912,"slug":"a-woman-reads-a-book-in-a-tablet-sits-in-the-luxurious-back-of-the-library","family":{"name":"Outline","total":1200,"id":1},"style":{"name":"Meticulous Yellow shadow","id":50},"author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}}],"visual_concept":[{"name":"a woman reads a book in a tablet sits in the luxurious back of the library","free_svg":true,"thumbnails":[{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512},{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512}],"created":"2023-03-07T23:05:26Z","id":52912,"slug":"a-woman-reads-a-book-in-a-tablet-sits-in-the-luxurious-back-of-the-library","family":{"name":"Outline","total":1200,"id":1},"style":{"name":"Meticulous Yellow shadow","id":50},"author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}},{"name":"a woman reads a book in a tablet sits in the luxurious back of the library","free_svg":true,"thumbnails":[{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512},{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512}],"created":"2023-03-07T23:05:26Z","id":52912,"slug":"a-woman-reads-a-book-in-a-tablet-sits-in-the-luxurious-back-of-the-library","family":{"name":"Outline","total":1200,"id":1},"style":{"name":"Meticulous Yellow shadow","id":50},"author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}}]},"thumbnails":[{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512},{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512}],"tags":[{"name":"Dog","slug":"dog"},{"name":"Dog","slug":"dog"}],"family":{"name":"Outline","total":1200,"id":1},"slug":"a-woman-reads-a-book-in-a-tablet-sits-in-the-luxurious-back-of-the-library","name":"a woman reads a book in a tablet sits in the luxurious back of the library","created":"2023-03-07T23:05:26Z","author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}}},"properties":{"data":{"$ref":"#/components/schemas/expanded_icon"}},"type":"object"},"classifier-request":{"required":["image"],"properties":{"image":{"$ref":"#/components/schemas/classifier_request_image"}},"type":"object"},"remove_image_background_request":{"properties":{"image_url":{"example":"https://img.freepik.com/free-vector/cute-cat-sitting-cartoon-vector-icon-illustration-animal-nature-icon-concept-isolated-premium-vector-flat-cartoon-style_138676-4148.jpg?w=2000&t=st=1725353998~exp=1725357598~hmac=a17f90afeeff454b36c0715f84eed2b388cd9c4a7ce59fcdff075fa41770e469","format":"uri","description":"The URL of the image whose background needs to be removed.","type":"string"}},"type":"object"},"result-classification":{"example":{"probability":0.94891726970673,"class_name":"not_ai"},"properties":{"probability":{"example":0.94891726970673,"description":"The probability of the classification","type":"number"},"class_name":{"example":"not_ai","enum":["not_ai","ai"],"description":"The type of classification","type":"string"}},"type":"object"},"seedance-1-5-pro-request":{"required":["prompt"],"properties":{"prompt":{"example":"A person saying 'Hello world' while waving at the camera","maxLength":2000,"type":"string","description":"The text content used for the video generation including dialogue, sounds, and scene description."},"seed":{"default":-1,"minimum":-1,"description":"Random seed for video generation. Use -1 for random seed.","type":"integer","maximum":4294967295},"duration":{"default":5,"minimum":4,"description":"Video duration in seconds (4-12)","type":"integer","maximum":12},"image":{"format":"byte","description":"Optional image to use as first frame for image-to-video generation. Supported formats: URL of the image or base64 encoding.","type":"string"},"webhook_url":{"format":"uri","description":"Webhook URL to notify the user when the task is completed","type":"string"},"generate_audio":{"default":true,"description":"Whether to generate synchronized audio (dialogue, foley, music) from the prompt","type":"boolean"},"camera_fixed":{"default":false,"description":"Whether the camera position should be fixed (tripod shot)","type":"boolean"},"aspect_ratio":{"default":"widescreen_16_9","enum":["film_horizontal_21_9","widescreen_16_9","classic_4_3","square_1_1","traditional_3_4","social_story_9_16","film_vertical_9_21"],"description":"Video aspect ratio","type":"string"}},"type":"object"},"preview":{"required":["height","url","width"],"example":{"height":500,"url":"https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm","width":300},"properties":{"height":{"example":500,"minimum":0,"type":"integer","description":"Resource image height."},"width":{"example":300,"minimum":0,"type":"integer","description":"Resource image width."},"url":{"example":"https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm","format":"uri","description":"Resource's url.","type":"string"}},"type":"object","description":"Information needed to preview a resource."},"remove_image_background_200_response":{"example":{"preview":"https://api.magnific.com/v1/ai/beta/images/download/037ea4eacad84a8c7/preview.png","high_resolution":"https://api.magnific.com/v1/ai/beta/images/download/037ead-44cd8ad84a8c7/high.png","original":"https://api.magnific.com/v1/ai/beta/images/original/037ea4ea-e8ad84a8c7/thumbnail.jpg","url":"https://api.magnific.com/v1/ai/beta/images/download/037ea4ea-720d-411e8ad84a8c7/high.png"},"properties":{"preview":{"format":"uri","description":"URL of the preview version of the image.","type":"string"},"high_resolution":{"format":"uri","description":"URL of the high-resolution image with the background removed.","type":"string"},"original":{"format":"uri","description":"URL of the original image.","type":"string"},"url":{"format":"uri","description":"Direct URL for downloading the high-resolution image.","type":"string"}},"type":"object"},"advanced-custom-elements-request":{"required":["element_description","element_name","reference_type"],"properties":{"reference_type":{"$ref":"#/components/schemas/advanced-custom-elements-reference-type"},"element_image_list":{"$ref":"#/components/schemas/advanced-custom-elements-image-list"},"element_video_list":{"$ref":"#/components/schemas/advanced-custom-elements-video-list"},"element_name":{"maxLength":20,"description":"Name of the custom element. Must not exceed 20 characters.","type":"string"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"element_voice_id":{"description":"Bind the element to an existing voice from the tone library. When empty, the element is not bound to a voice.\nThe voice ID can be obtained through the voice-related API. Only elements customized via video reference support voice binding.\n","type":"string"},"element_description":{"maxLength":100,"description":"Description of the custom element. Must not exceed 100 characters.","type":"string"},"tag_list":{"description":"Configure category tags for the element. One element can have multiple tags.","type":"array","items":{"$ref":"#/components/schemas/advanced-custom-elements-tag"}}},"type":"object"},"request_3":{"required":["image_url","prompt"],"properties":{"style":{"$ref":"#/components/schemas/style-enum"},"seed":{"description":"The same seed and the same prompt given to the same version of the model will output the same video every time","type":"integer"},"negative_prompt":{"default":"","description":"Negative prompt to be used for the generation","type":"string"},"prompt":{"description":"Prompt describing the video to generate","type":"string"},"resolution":{"$ref":"#/components/schemas/resolution_4"},"duration":{"enum":[5,8],"description":"The duration of the generated video in seconds. 8s videos cost double. 1080p videos are limited to 5 seconds","type":"integer"},"image_url":{"format":"uri","description":"URL of the image to use as the first frame","type":"string"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"}},"type":"object"},"search_item":{"allOf":[{"$ref":"#/components/schemas/base_item"},{"properties":{"premium":{"example":1,"description":"1 if this video is premium. 0, otherwise.","type":"integer"},"best_asset_for_ai":{"example":3242324,"description":"The id of the best asset for AI (mp4 with best resolution assets option-id).","type":"integer"}},"type":"object"}]},"upload-file-request":{"required":["content_type"],"properties":{"content_type":{"$ref":"#/components/schemas/upload-content-type"}},"type":"object"},"ttif2t-request-content":{"required":["prompt"],"properties":{"guidance_scale":{"default":2.5,"minimum":1,"example":2.5,"description":"Controls how closely the model follows your prompt.\n\n**Range:** 1.0 to 20.0\n**Default:** 2.5\n\n**Guidelines:**\n- **Low (1-3):** More creative freedom, less literal interpretation\n- **Medium (3-7):** Balanced between creativity and prompt accuracy\n- **High (7-20):** Strict adherence to prompt, less creative variation\n\n**Recommendation:** Start with default (2.5) and adjust if needed.\n","type":"number","maximum":20},"seed":{"minimum":0,"maximum":4294967295,"example":12345,"description":"Random seed for reproducible results.\n\n**Valid range:** 0 to 4,294,967,295\n**Default:** Random (if not provided)\n\n**Tip:** Save the seed from generations you like to create similar variations.\n","type":"integer","nullable":true},"prompt":{"example":"a serene landscape with mountains and a lake at sunset","description":"Text description of the image you want to generate.\n\n**FLUX.2 [turbo]** is optimized for speed while maintaining good quality. Perfect for rapid prototyping and testing.\n\n**Performance:**\n- Faster generation than Flux 2 Pro\n- Lower cost per generation\n- Great for iteration and experimentation\n\n**Tips:**\n- Works best with clear, descriptive prompts\n- Adjust guidance_scale for prompt adherence\n- Use seed for reproducibility\n\n**Examples:**\n- `\"mountain landscape at golden hour\"`\n- `\"portrait of a smiling person, natural lighting, soft focus\"`\n- `\"abstract geometric pattern with vibrant colors\"`\n","type":"string"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"image_size":{"$ref":"#/components/schemas/ttif2t_request_content_image_size"},"enable_safety_checker":{"default":true,"example":true,"type":"boolean","description":"Enable content safety filtering.\n\n**When enabled:** Filters potentially unsafe content (NSFW, violence, etc.)\n**When disabled:** No content filtering (use responsibly and in compliance with terms)\n\n**Recommendation:** Keep enabled for production applications.\n"},"output_format":{"default":"png","enum":["jpeg","png"],"example":"png","description":"Output image format.\n\n**PNG:**\n- Lossless compression\n- Supports transparency\n- Larger file size\n- Best for graphics and illustrations\n\n**JPEG:**\n- Lossy compression\n- Smaller file size\n- No transparency\n- Best for photos and realistic images\n","type":"string"}},"type":"object"},"resolution_4":{"enum":["360p","540p","720p","1080p"],"description":"The resolution of the generated video","type":"string"},"upload-content-type":{"enum":["image/png","image/jpeg","image/webp","video/mp4","video/webm","video/quicktime","audio/mpeg","audio/wav","audio/mp4","audio/webm","audio/ogg"],"description":"MIME type of the file to upload","type":"string"},"transition-request":{"required":["first_image_url","last_image_url","prompt"],"properties":{"last_image_url":{"format":"uri","description":"URL of the image to use as the last frame","type":"string"},"seed":{"description":"The same seed and the same prompt given to the same version of the model will output the same video every time","type":"integer"},"negative_prompt":{"default":"","description":"Negative prompt to be used for the generation","type":"string"},"prompt":{"description":"Prompt describing the video transition to generate","type":"string"},"resolution":{"$ref":"#/components/schemas/resolution_4"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"duration":{"default":5,"enum":[5,8],"description":"The duration of the generated video in seconds. 8s videos cost double. 1080p videos are limited to 5 seconds","type":"integer"},"first_image_url":{"format":"uri","description":"URL of the image to use as the first frame","type":"string"}},"type":"object"},"kling-v26-aspect-ratio":{"default":"widescreen_16_9","enum":["widescreen_16_9","social_story_9_16","square_1_1"],"description":"Aspect ratio for the generated video","type":"string"},"_v1_videos_get_filters_parameter_duration":{"properties":{"to":{"minimum":1,"type":"integer"},"from":{"minimum":1,"type":"integer"}},"type":"object"},"_v1_videos_get_filters_parameter_license":{"properties":{"free":{"type":"boolean"},"premium":{"type":"boolean"}},"type":"object"},"_v1_videos_get_filters_parameter_resolution":{"properties":{"4k":{"type":"boolean"},"1080":{"type":"boolean"},"720":{"type":"boolean"},"2k":{"type":"boolean"}},"type":"object"},"_v1_videos_get_filters_parameter_ai_generated":{"properties":{"excluded":{"example":true,"type":"boolean"},"only":{"example":true,"type":"boolean"}},"type":"object"},"_v1_videos_get_filters_parameter_video_tool":{"properties":{"mogrt":{"example":true,"type":"boolean"},"after-effects":{"example":true,"type":"boolean"},"premiere-pro":{"example":true,"type":"boolean"}},"type":"object"},"i2v-wan-25-480p-request-content":{"title":"Image to Video - WAN 2.5 480p","description":"Generate 480p video from image using WAN 2.5 model","allOf":[{"$ref":"#/components/schemas/wan-25-i2v-base"}]},"tti-ideogram-4-request":{"required":["prompt"],"title":"Ideogram 4 Text-to-Image Request","type":"object","properties":{"seed":{"minimum":0,"example":42,"description":"Seed for reproducible results. When omitted, a random seed is used.","type":"integer","maximum":2147483647},"negative_prompt":{"example":"blurry, low contrast","maxLength":2000,"type":"string","description":"What to leave out of the image. Descriptions in `prompt` take precedence\nover this field.\n"},"prompt":{"minLength":1,"example":"A vintage travel poster of a lighthouse at dusk with the text \"Ideogram 4\" in bold art deco letters","maxLength":10000,"type":"string","description":"Text description of the image to generate. Ideogram 4 is especially good\nat rendering text: put the words to draw in quotes.\n"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"rendering_speed":{"default":"DEFAULT","enum":["TURBO","DEFAULT","QUALITY"],"example":"DEFAULT","description":"Quality tier. It sets the price of the generation.\n\n**Available tiers:**\n- `TURBO`: Fastest and cheapest\n- `DEFAULT`: Balanced quality and speed (default)\n- `QUALITY`: Highest quality, slowest\n","type":"string"},"magic_prompt":{"default":"AUTO","enum":["AUTO","ON","OFF"],"example":"AUTO","description":"Whether Ideogram's Magic Prompt rewrites the prompt into a more detailed\none before generating. `AUTO` lets the model decide; use `OFF` to render\nthe prompt verbatim. It does not affect the price.\n","type":"string"},"aspect_ratio":{"default":"1:1","enum":["1:1","16:9","9:16","16:10","10:16","4:3","3:4","3:2","2:3","5:4","4:5","2:1","1:2","3:1","1:3"],"example":"1:1","description":"Aspect ratio for the generated image. The output is always about 4\nmegapixels: 2048x2048 at `1:1`, and the same area at the other ratios.\n\n**Available ratios:**\n- `1:1`: Square (default)\n- `16:9`, `9:16`: Widescreen/Social stories\n- `16:10`, `10:16`: Widescreen/Tall\n- `4:3`, `3:4`: Standard\n- `3:2`, `2:3`: Classic photo\n- `5:4`, `4:5`: Photo print\n- `2:1`, `1:2`, `3:1`, `1:3`: Banners and vertical panels\n","type":"string"}}},"video-edit-request":{"required":["video_url"],"title":"Video Edit - WAN 2.7","description":"Edit an existing video using WAN 2.7. Supports three modes:\n- Instruction-based editing: provide `prompt` with editing instructions (e.g., \"change the sky to sunset\")\n- Reference-image editing: provide `prompt` and `image_urls` to apply visual references to the video\n- Style transfer: provide `prompt` and `image_urls` with style reference images to transfer artistic styles\n","type":"object","properties":{"image_urls":{"maxItems":3,"items":{"type":"string","format":"uri"},"example":["https://example.com/reference1.jpg"],"description":"Reference images for editing or style transfer. Up to 3 images.\n\n**Supported formats:** JPEG, PNG, BMP, WEBP\n**Dimensions:** 240-8000px per side\n**Maximum file size:** 20MB each\n","type":"array"},"duration":{"default":0,"minimum":0,"example":0,"description":"Duration of the output video in seconds. Set to `0` to preserve the full duration of the input video.","type":"integer","maximum":10},"prompt":{"example":"Change the background to a futuristic cityscape with neon lights","maxLength":5000,"type":"string","description":"Editing instructions describing the desired changes. For reference-image or style-transfer modes, describe how the reference images should be applied."},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"video_url":{"example":"https://example.com/input-video.mp4","format":"uri","description":"URL of the input video to edit. Must be publicly accessible.\n\n**Supported formats:** MP4, MOV\n**Duration:** 2-10 seconds\n**Dimensions:** 240-4096px per side, aspect ratio between 1:8 and 8:1\n**Maximum file size:** 100MB\n","type":"string"},"negative_prompt":{"example":"watermark, text, distortion, blurry","maxLength":500,"type":"string","description":"Elements to avoid in the edited video."},"additional_settings":{"$ref":"#/components/schemas/video-edit-additional-settings"},"resolution":{"$ref":"#/components/schemas/resolution"},"seed":{"minimum":0,"example":12345,"description":"Random seed for reproducible generation. Use the same seed with identical parameters to reproduce results. Leave unset for random seed.","type":"integer","maximum":2147483647},"aspect_ratio":{"$ref":"#/components/schemas/video-edit-aspect-ratio"}}},"_v1_videos_get_filters_parameter":{"properties":{"category":{"$ref":"#/components/schemas/schema_1"},"video-tool":{"$ref":"#/components/schemas/_v1_videos_get_filters_parameter_video_tool"},"resolution":{"$ref":"#/components/schemas/_v1_videos_get_filters_parameter_resolution"},"topic":{"type":"array","items":{"type":"string","enum":["people","nature","business","background","food","travel","sports","events"]}},"ids":{"type":"string"},"aspect_ratio":{"type":"array","items":{"type":"string","enum":["1:1","4:3","9:16","16:9","256:135"]}},"fps":{"type":"array","items":{"type":"string","enum":["24","25","30","60","gt60"]}},"orientation":{"uniqueItems":true,"type":"array","items":{"type":"string","enum":["horizontal","vertical","square","panoramic"]}},"license":{"$ref":"#/components/schemas/_v1_videos_get_filters_parameter_license"},"duration":{"$ref":"#/components/schemas/_v1_videos_get_filters_parameter_duration"},"ai-generated":{"$ref":"#/components/schemas/_v1_videos_get_filters_parameter_ai_generated"},"author":{"minimum":1,"type":"integer"}},"type":"object"},"search_icons_filters_parameter":{"properties":{"free_svg":{"default":"all","enum":["all","free","premium"],"example":"free","description":"Filter by free svg, for free or premium item or all for both","type":"string"},"shape":{"example":"outline","enum":["outline","fill","lineal-color","hand-drawn"],"description":"Filter by shape.","type":"string"},"icon_type":{"example":["standard","sticker"],"description":"Filter of available icon types.","type":"array","items":{"type":"string","enum":["standard","animated","sticker","uicon"]}},"color":{"example":"red","enum":["gradient","solid-black","multicolor","azure","black","blue","chartreuse","cyan","gray","green","orange","red","rose","spring-green","violet","white","yellow"],"description":"Filter by color.","type":"string"},"period":{"default":"all","enum":["three-months","six-months","one-year","all"],"example":"all","description":"Filter by period.","type":"string"}},"type":"object"},"download_list":{"example":{"data":[{"signed_url":"https://img.freepik.com/premium-photo/close-up-cat-resting_1048944-9269194.jpg?t=st=1725276607~exp=1725280207~hmac=1538f1b294fc3a19a19e9f02ceeb6594a9a1e36a900de85d47bbd386e27dddbe","filename":"blackboard-template.zip","url":"https://downloadscdn5.freepik.com/d/1137445/blackboard-template.zip"},{"signed_url":"https://img.freepik.com/premium-photo/close-up-cat-resting_1048944-9269194.jpg?t=st=1725276607~exp=1725280207~hmac=1538f1b294fc3a19a19e9f02ceeb6594a9a1e36a900de85d47bbd386e27dddbe","filename":"blackboard-template.zip","url":"https://downloadscdn5.freepik.com/d/1137445/blackboard-template.zip"}]},"required":["data"],"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/download"}}}},"icon_b2b":{"example":{"name":"a woman reads a book in a tablet sits in the luxurious back of the library","free_svg":true,"id":52912,"thumbnails":[{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512},{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512}],"tags":[{"name":"Dog","slug":"dog"},{"name":"Dog","slug":"dog"}],"family":{"name":"Outline","total":1200,"id":1},"slug":"a-woman-reads-a-book-in-a-tablet-sits-in-the-luxurious-back-of-the-library","style":{"name":"Meticulous Yellow shadow","id":50},"created":"2023-03-07T23:05:26Z","author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}},"required":["author","created","family","free_svg","id","name","slug","style","thumbnails"],"type":"object","properties":{"name":{"example":"a woman reads a book in a tablet sits in the luxurious back of the library","type":"string"},"family":{"$ref":"#/components/schemas/icon_family"},"author":{"$ref":"#/components/schemas/author"},"thumbnails":{"type":"array","items":{"$ref":"#/components/schemas/source"}},"tags":{"type":"array","items":{"$ref":"#/components/schemas/tag"}},"style":{"$ref":"#/components/schemas/icon_style"},"slug":{"example":"a-woman-reads-a-book-in-a-tablet-sits-in-the-luxurious-back-of-the-library","type":"string"},"created":{"example":"2023-03-07T23:05:26Z","format":"date-time","type":"string"},"free_svg":{"example":true,"description":"If true, the icon has the svg for free downloading","type":"boolean"},"id":{"example":52912,"type":"integer"}}},"schema_4":{"type":"boolean"},"tag":{"example":{"name":"Dog","slug":"dog"},"properties":{"slug":{"example":"dog","type":"string"},"name":{"example":"Dog","type":"string"}},"type":"object"},"schema_3":{"uniqueItems":true,"type":"array","items":{"type":"string","enum":["horizontal","vertical","square","panoramic"]}},"schema_2":{"minimum":1,"type":"integer"},"_v1_videos_get_200_response":{"example":{"data":["",""],"meta":{"pagination":{"last_page":1,"per_page":1,"total":1,"current_page":1}}},"properties":{"data":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/search_item"}]}},"meta":{"$ref":"#/components/schemas/search_icons_200_response_meta"}},"type":"object"},"omni-human-1-5-resolution":{"default":"1080p","enum":["720p","1080p"],"description":"Video resolution. 1080p allows max 30 seconds audio, 720p allows max 60 seconds audio.","type":"string"},"_v1_videos__id__get_200_response":{"example":{"data":{"explicit":0,"code":"gorgeous-woman-stretching-neck","url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667327","thumbnails":[{"width":100,"height":100,"url":"https://img.freepik.com/free-photo/image_8353-7579.jpg","aspect_ratio":"16:9"},{"width":100,"height":100,"url":"https://img.freepik.com/free-photo/image_8353-7579.jpg","aspect_ratio":"16:9"}],"tags":[{"name":"Merry Christmas","slug":"merry-christmas"},{"name":"Merry Christmas","slug":"merry-christmas"}],"options":[{"size":400,"width":4096,"container":"mp4","codec":"AVC Coding","active":true,"quality":"4k","is_original":true,"id":76989,"height":2304,"bit_rate":25.44,"aspect_ratio":"16:9"},{"size":400,"width":4096,"container":"mp4","codec":"AVC Coding","active":true,"quality":"4k","is_original":true,"id":76989,"height":2304,"bit_rate":25.44,"aspect_ratio":"16:9"}],"fps":"25","id":99332243,"name":"gorgeous woman stretching neck","previews":[{"width":100,"height":100,"url":"https://v1.cdnpk.net/videvo_files/video/premium/video0289/watermarked/_Geometric80s30_FPpreview.mp4","aspect_ratio":"16:9"},{"width":100,"height":100,"url":"https://v1.cdnpk.net/videvo_files/video/premium/video0289/watermarked/_Geometric80s30_FPpreview.mp4","aspect_ratio":"16:9"}],"duration":"00:00:28","is_ai_generated":true,"quality":"4k","created":"2000-01-23T04:56:07.000+00:00","author":{"name":"John Doe","code":"merry-christmas","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","id":2147483647,"metas":{"assets":0,"downloads":0}},"premium":0,"item_subtype":"footage","active":1,"aspect_ratio":"969"}},"properties":{"data":{"$ref":"#/components/schemas/detail_b2b"}},"type":"object"},"style-enum":{"example":"anime","enum":["anime","3d_animation","clay","cyberpunk","comic"],"description":"The style of the generated video","type":"string"},"_v1_videos__id__download_get_200_response":{"example":{"data":{"filename":"blackboard-template.zip","url":"https://downloadscdn5.freepik.com/d/1137445/blackboard-template.zip"}},"required":["data"],"type":"object","properties":{"data":{"$ref":"#/components/schemas/download_b2b"}}},"tti-ideogram-4-5-request":{"required":["prompt"],"title":"Ideogram 4.5 Text-to-Image Request","type":"object","properties":{"quality":{"default":"medium","enum":["very_low","low","medium","high"],"example":"medium","description":"Quality tier. It sets the price of the generation.\n\n**Available tiers:**\n- `very_low`: Cheapest and fastest. Only available when `images` are sent\n  (editing); a text-only request with it is rejected.\n- `low`\n- `medium`: Default\n- `high`: Best quality, slowest\n","type":"string"},"seed":{"minimum":0,"example":42,"description":"Seed for reproducible results. When omitted, a random seed is used.","type":"integer","maximum":2147483647},"prompt":{"minLength":1,"example":"Turn image 1 into a vintage travel poster with the text \"Ideogram 4.5\" in bold art deco letters","maxLength":10000,"type":"string","description":"Text description of the image to generate, or of the edit to apply. When\n`images` are sent, refer to them by position: \"image 1\" is the first one\n(the image being edited) and \"image 2\" onwards are the references.\n"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"images":{"maxItems":5,"items":{"example":"https://example.com/source.png","type":"string"},"example":["https://example.com/source.png"],"minItems":1,"description":"Optional input images. Without them the request is text-to-image. With\nthem, the first image is the one being edited and the rest guide the\nedit as references.\n\n**Image requirements:**\n- Maximum 5 images\n- Supported formats: PNG, JPEG, WebP\n- Aspect ratio between 1:6 and 6:1\n- Public HTTPS URL or base64-encoded string\n","type":"array"},"magic_prompt":{"default":"auto","enum":["auto","on","off"],"example":"auto","description":"Whether Ideogram's Magic Prompt rewrites the prompt into a more detailed\none before generating. `auto` lets the model decide; use `off` for\nverbatim edit instructions. It does not affect the price.\n","type":"string"},"aspect_ratio":{"default":"auto","enum":["auto","1:1","4:5","5:4","3:4","4:3","2:3","3:2","9:16","16:9","1:2","2:1","1:3","3:1"],"example":"auto","description":"Aspect ratio for the generated image, on a canvas of about 4 megapixels.\n\n**Available ratios:**\n- `auto`: Let the model choose (default). With `images` it follows the\n  first image; without them it picks the canvas that best fits the prompt.\n- `1:1`: Square, 2048x2048\n- `4:5`, `5:4`: Photo print\n- `3:4`, `4:3`: Standard\n- `2:3`, `3:2`: Classic photo\n- `9:16`, `16:9`: Social stories/Widescreen\n- `1:2`, `2:1`, `1:3`, `3:1`: Banners and vertical panels\n","type":"string"}}},"get_image_to_prompt_task_status_200_response":{"example":{"data":{"generated":["https://openapi-generator.tech","https://openapi-generator.tech"],"task_id":"046b6c7f-0b8a-43b9-b35d-6489e6daee91","status":"CREATED"},"examples":"{}"},"required":["data"],"type":"object","properties":{"data":{"$ref":"#/components/schemas/task-detail"},"examples":{"type":"object"}}},"get_all_sound_effects_tasks_200_response":{"example":{"data":[{"generated":["https://openapi-generator.tech","https://openapi-generator.tech"],"task_id":"046b6c7f-0b8a-43b9-b35d-6489e6daee91","status":"CREATED"},{"generated":["https://openapi-generator.tech","https://openapi-generator.tech"],"task_id":"046b6c7f-0b8a-43b9-b35d-6489e6daee91","status":"CREATED"}]},"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/task-detail"}}},"type":"object"},"get_all_voiceover_tasks_200_response":{"example":{"data":[{"generated":["https://openapi-generator.tech","https://openapi-generator.tech"],"task_id":"046b6c7f-0b8a-43b9-b35d-6489e6daee91","status":"CREATED"},{"generated":["https://openapi-generator.tech","https://openapi-generator.tech"],"task_id":"046b6c7f-0b8a-43b9-b35d-6489e6daee91","status":"CREATED"}]},"required":["data"],"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/task-detail"}}}},"list_cloned_voices_200_response_data_inner_main_languages_inner":{"example":{"identifier":"en","name":"English","id":0},"properties":{"identifier":{"example":"en","type":"string"},"name":{"example":"English","type":"string"},"id":{"type":"integer"}},"type":"object"},"_v1_analytics_team_members_get_200_response":{"example":{"data":[{"email":"designer@company.com","role":"member","status":"active"},{"email":"designer@company.com","role":"member","status":"active"}]},"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/team-member"}}},"type":"object"},"MusicListArtist":{"required":["name"],"description":"Simplified artist object returned in search results (MeilisearchTrackSerializer). Contains only the artist name.","example":{"name":"John Doe"},"properties":{"name":{"example":"John Doe","description":"Artist name","type":"string"}},"type":"object","nullable":true},"_v1_analytics_team_api_keys_get_200_response":{"example":{"data":[{"created_at":"2026-01-15T10:30:00Z","display_name":"Production Backend","api_key_id":"fpk-abc123def456","status":"active"},{"created_at":"2026-01-15T10:30:00Z","display_name":"Production Backend","api_key_id":"fpk-abc123def456","status":"active"}]},"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/team-api-key"}}},"type":"object"},"icon_family":{"example":{"name":"Outline","total":1200,"id":1},"properties":{"name":{"example":"Outline","description":"Name of the icon family","type":"string"},"id":{"example":1,"description":"Id of the icon family","type":"integer"},"total":{"example":1200,"description":"Total of icons in the family","type":"integer"}},"type":"object","nullable":true},"_v1_analytics_team_groups_get_200_response":{"example":{"data":[{"name":"Design Team","group_id":10,"member_count":5,"parent_group_id":0},{"name":"Design Team","group_id":10,"member_count":5,"parent_group_id":0}]},"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/team-group"}}},"type":"object"},"tti-qwen-image-3-request":{"required":["prompt"],"title":"Qwen Image 3.0 Request","description":"A Qwen Image 3.0 request: generate an image from a text prompt, or edit\none guided by up to three images.\n\nThe call is asynchronous: it returns a `task_id`, and the image arrives as\na URL in the task's `generated` array. One image is generated per request.\n","type":"object","properties":{"seed":{"minimum":0,"example":42,"description":"Seed for reproducible results. When omitted, a random seed is used.","type":"integer","maximum":2147483647},"negative_prompt":{"example":"blurry, low quality, watermark","maxLength":500,"type":"string","description":"Content you do not want to appear in the image."},"prompt":{"minLength":1,"example":"A vertical outdoor portrait photograph with the warm ambiance of an afternoon street scene","maxLength":10000,"type":"string","description":"Text description of the image to generate, or of the edit to apply.\nWhen `images` are sent, refer to them by position: \"image 1\" is the\nfirst one, \"image 2\" the second.\n"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"images":{"maxItems":3,"items":{"example":"https://example.com/source.png","type":"string"},"minItems":1,"description":"Optional input images. Without them the request is text-to-image;\nwith them the model edits or combines them following the prompt.\nUp to 3 images.\n\nEach image is a public HTTPS URL, a base64-encoded string or an\nupload id (`upl_...`). At most 10 MB, ideally 384 to 2048 px per side.\n","type":"array"},"aspect_ratio":{"default":"1:1","enum":["1:1","16:9","9:16","4:3","3:4","3:2","2:3","1:2","2:1","4:5"],"example":"1:1","description":"Aspect ratio of the generated image. `1:1` renders at 1024x1024.\n","type":"string"}}},"_v1_analytics_team_projects_get_200_response":{"example":{"data":[{"project_reference":"a1b2c3d4-1111-4000-8000-000000000001","name":"Marketing Campaign Q4","budget":{"consumed":5000000,"available":10000000,"assigned":15000000}},{"project_reference":"a1b2c3d4-1111-4000-8000-000000000001","name":"Marketing Campaign Q4","budget":{"consumed":5000000,"available":10000000,"assigned":15000000}}]},"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/team-project"}}},"type":"object"},"photo_related":{"allOf":[{"required":["same_author","suggested"],"properties":{"suggested":{"description":"Other resources related to this one.","type":"array","items":{"$ref":"#/components/schemas/resource"}},"same_author":{"description":"Other resources created by this author.","type":"array","items":{"$ref":"#/components/schemas/resource"}}},"type":"object","description":"Related resources and tags for this resource."},{"$ref":"#/components/schemas/related_same_series"},{"$ref":"#/components/schemas/related_same_collection"}]},"_v1_analytics_team_credit_usage_post_request":{"properties":{"granularity":{"default":"day","enum":["day","week","month","year"],"example":"month","description":"Time bucket granularity for aggregation. Defaults to `day` if omitted.","type":"string"},"user_emails":{"maxItems":100,"items":{"type":"string","format":"email"},"example":["designer@company.com","producer@company.com"],"description":"Filter by the email addresses of team members (case-insensitive). Returns the\nconsumption made by those people directly; usage generated through API keys\nthey created carries no email and is not included — filter it with `api_key_ids`.\n\nCombined with `group_ids`, the results include both the listed people and the\nmembers of those groups. Emails that do not belong to the caller's team are\nignored, and when none of them does the response is empty. Callers without an\nOwner or Admin role only get data for their own email.\n","type":"array"},"project_references":{"example":["a1b2c3d4-1111-4000-8000-000000000001"],"description":"Filter by specific project references.","type":"array","items":{"type":"string","format":"uuid"}},"start_date":{"example":"2026-01-01","format":"date","description":"Start date for the query range (YYYY-MM-DD). Defaults to 7 days ago.","type":"string"},"api_key_ids":{"example":["api-key-1","api-key-2"],"description":"Filter by specific API key IDs.","type":"array","items":{"type":"string"}},"end_date":{"example":"2026-03-31","format":"date","description":"End date for the query range (YYYY-MM-DD). Defaults to today.","type":"string"},"group_ids":{"example":[10,20],"description":"Filter by specific team group IDs. Members of these groups are included in the results.","type":"array","items":{"minimum":1,"type":"integer"}}},"type":"object"},"expanded_icon":{"example":{"style":{"name":"Meticulous Yellow shadow","id":50},"free_svg":true,"id":52912,"related":{"style":[{"name":"a woman reads a book in a tablet sits in the luxurious back of the library","free_svg":true,"thumbnails":[{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512},{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512}],"created":"2023-03-07T23:05:26Z","id":52912,"slug":"a-woman-reads-a-book-in-a-tablet-sits-in-the-luxurious-back-of-the-library","family":{"name":"Outline","total":1200,"id":1},"style":{"name":"Meticulous Yellow shadow","id":50},"author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}},{"name":"a woman reads a book in a tablet sits in the luxurious back of the library","free_svg":true,"thumbnails":[{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512},{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512}],"created":"2023-03-07T23:05:26Z","id":52912,"slug":"a-woman-reads-a-book-in-a-tablet-sits-in-the-luxurious-back-of-the-library","family":{"name":"Outline","total":1200,"id":1},"style":{"name":"Meticulous Yellow shadow","id":50},"author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}}],"variants":[{"name":"a woman reads a book in a tablet sits in the luxurious back of the library","free_svg":true,"thumbnails":[{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512},{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512}],"created":"2023-03-07T23:05:26Z","id":52912,"slug":"a-woman-reads-a-book-in-a-tablet-sits-in-the-luxurious-back-of-the-library","family":{"name":"Outline","total":1200,"id":1},"style":{"name":"Meticulous Yellow shadow","id":50},"author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}},{"name":"a woman reads a book in a tablet sits in the luxurious back of the library","free_svg":true,"thumbnails":[{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512},{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512}],"created":"2023-03-07T23:05:26Z","id":52912,"slug":"a-woman-reads-a-book-in-a-tablet-sits-in-the-luxurious-back-of-the-library","family":{"name":"Outline","total":1200,"id":1},"style":{"name":"Meticulous Yellow shadow","id":50},"author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}}],"visual_concept":[{"name":"a woman reads a book in a tablet sits in the luxurious back of the library","free_svg":true,"thumbnails":[{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512},{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512}],"created":"2023-03-07T23:05:26Z","id":52912,"slug":"a-woman-reads-a-book-in-a-tablet-sits-in-the-luxurious-back-of-the-library","family":{"name":"Outline","total":1200,"id":1},"style":{"name":"Meticulous Yellow shadow","id":50},"author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}},{"name":"a woman reads a book in a tablet sits in the luxurious back of the library","free_svg":true,"thumbnails":[{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512},{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512}],"created":"2023-03-07T23:05:26Z","id":52912,"slug":"a-woman-reads-a-book-in-a-tablet-sits-in-the-luxurious-back-of-the-library","family":{"name":"Outline","total":1200,"id":1},"style":{"name":"Meticulous Yellow shadow","id":50},"author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}}]},"thumbnails":[{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512},{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512}],"tags":[{"name":"Dog","slug":"dog"},{"name":"Dog","slug":"dog"}],"family":{"name":"Outline","total":1200,"id":1},"slug":"a-woman-reads-a-book-in-a-tablet-sits-in-the-luxurious-back-of-the-library","name":"a woman reads a book in a tablet sits in the luxurious back of the library","created":"2023-03-07T23:05:26Z","author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}},"allOf":[{"$ref":"#/components/schemas/icon"},{"properties":{"tags":{"type":"array","items":{"$ref":"#/components/schemas/tag"}},"related":{"$ref":"#/components/schemas/icons_related"}},"type":"object"}]},"aspect-ratio_3":{"default":"widescreen_16_9","enum":["widescreen_16_9","classic_4_3","square_1_1","traditional_3_4","social_story_9_16"],"description":"The aspect ratio of the generated video","type":"string"},"upload-list-item":{"example":{"ttl_seconds":6,"expires_at":"2000-01-23T04:56:07.000+00:00","asset_url":"https://cdn-magnific.freepik.com/uploads/109580722/upl_img_a1b2c3?token=exp=1783147635~hmac=...","content_type":"content_type","created_at":"2000-01-23T04:56:07.000+00:00","asset_url_expires_in":86400,"file_id":"upl_a1b2c3d4e5f6","size_bytes":0},"properties":{"ttl_seconds":{"description":"Seconds until the file becomes eligible for auto-deletion (bucket lifecycle). Deletion is eventual, so the file may persist a little past this.","type":"integer"},"expires_at":{"format":"date-time","description":"Expiration timestamp (based on bucket lifecycle)","type":"string"},"asset_url":{"example":"https://cdn-magnific.freepik.com/uploads/109580722/upl_img_a1b2c3?token=exp=1783147635~hmac=...","format":"uri","description":"Readable URL for the file (image, video or audio), serving the original file. A fresh URL is signed on each listing and stays valid for about a day (asset_url_expires_in); an expired URL returns 403, so just list again to get a new one. Once the file itself is deleted (see ttl_seconds) no URL works. Use it as image_url/video_url/audio_url/reference in any endpoint that accepts a URL. Prefer file_id on AI endpoints when available.","type":"string"},"content_type":{"description":"MIME type of the file","type":"string"},"created_at":{"format":"date-time","description":"Upload timestamp","type":"string"},"asset_url_expires_in":{"example":86400,"description":"Seconds until asset_url expires (counted from this listing response).","type":"integer"},"file_id":{"example":"upl_a1b2c3d4e5f6","description":"Opaque identifier of the uploaded file. Use this value in reference_images, image_url, video_url, or similar fields.","type":"string"},"size_bytes":{"description":"File size in bytes","type":"integer"}},"type":"object"},"reference-character-image":{"required":["url"],"properties":{"url":{"example":"https://example.com/character1.jpg","format":"uri","description":"URL of the character reference image (must be publicly accessible).\n\n**Supported formats:** JPEG, PNG, BMP, WEBP\n**Dimensions:** 240-8000px per side\n**Maximum file size:** 20MB\n","type":"string"},"reference_voice":{"example":"https://example.com/voice1.wav","format":"uri","description":"Optional URL of a voice reference audio file for this character.","type":"string"}},"type":"object","description":"A reference character image with optional voice reference."},"slug":{"example":"merry-christmas","type":"string","minLength":1},"tti-qwen-image-3-pro-request":{"required":["prompt"],"title":"Qwen Image 3.0 Pro Request","description":"A Qwen Image 3.0 Pro request: the higher quality tier of Qwen Image 3.0,\nat 1K or 2K. Generate an image from a text prompt, or edit one guided by\nup to three images.\n\nThe call is asynchronous: it returns a `task_id`, and the image arrives as\na URL in the task's `generated` array. One image is generated per request.\n","type":"object","properties":{"seed":{"minimum":0,"example":42,"description":"Seed for reproducible results. When omitted, a random seed is used.","type":"integer","maximum":2147483647},"negative_prompt":{"example":"blurry, low quality, watermark","maxLength":500,"type":"string","description":"Content you do not want to appear in the image."},"prompt":{"minLength":1,"example":"A vertical outdoor portrait photograph with the warm ambiance of an afternoon street scene","maxLength":10000,"type":"string","description":"Text description of the image to generate, or of the edit to apply.\nWhen `images` are sent, refer to them by position: \"image 1\" is the\nfirst one, \"image 2\" the second.\n"},"resolution":{"default":"2k","enum":["1k","2k"],"example":"2k","description":"Output resolution. It sets the price of the generation.\n- `1k`: about 1 megapixel, 1024x1024 at `1:1`.\n- `2k`: about 4 megapixels, 2048x2048 at `1:1`. Default.\n","type":"string"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"images":{"maxItems":3,"items":{"example":"https://example.com/source.png","type":"string"},"minItems":1,"description":"Optional input images. Without them the request is text-to-image;\nwith them the model edits or combines them following the prompt.\nUp to 3 images.\n\nEach image is a public HTTPS URL, a base64-encoded string or an\nupload id (`upl_...`). At most 10 MB, ideally 384 to 2048 px per side.\n","type":"array"},"aspect_ratio":{"default":"1:1","enum":["1:1","16:9","9:16","4:3","3:4","3:2","2:3","1:2","2:1","4:5"],"example":"1:1","description":"Aspect ratio of the generated image. `1:1` renders at 1024x1024.\n","type":"string"}}},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"ttif2p-request-content":{"required":["prompt"],"properties":{"input_image_2":{"description":"Second base64-encoded input image for multi-image generation.","type":"string","nullable":true},"input_image_3":{"description":"Third base64-encoded input image for multi-image generation.","type":"string","nullable":true},"prompt":{"example":"a beautiful sunset over the ocean with dramatic clouds","description":"Text description of the image you want to generate.\n\n**FLUX.2 [pro]** delivers professional-grade image generation without requiring complex parameter tuning. The model automatically optimizes for quality and consistency.\n\n**Tips for better results:**\n- Be specific about subjects, scenes, and visual details\n- Describe lighting, atmosphere, and mood\n- Mention art style or photographic techniques if desired\n\n**Examples:**\n- Simple: `\"a cat sitting on a windowsill\"`\n- Detailed: `\"a fluffy orange tabby cat sitting on a rustic wooden windowsill, golden hour lighting, soft focus background\"`\n- Creative: `\"futuristic cityscape at night with neon lights reflecting on wet streets, cyberpunk aesthetic, dramatic lighting\"`\n","type":"string"},"input_image_4":{"description":"Fourth base64-encoded input image for multi-image generation.","type":"string","nullable":true},"height":{"default":768,"minimum":256,"example":768,"description":"Height of the image in pixels.\n\n**Valid range:** 256 to 1440 pixels\n**Default:** 768 pixels\n\n**Tip:** Total megapixels affect generation cost. Higher resolution = higher cost.\n","type":"integer","maximum":1440},"prompt_upsampling":{"default":false,"example":false,"type":"boolean","description":"Automatically enhance and expand your prompt for better generation results.\n\n**When to enable:**\n- Using simple, short prompts\n- Want AI to add creative details\n- Experimenting with variations\n\n**When to disable:**\n- Using detailed, specific prompts\n- Need exact control over output\n- Following brand guidelines\n"},"seed":{"minimum":0,"maximum":4294967295,"example":42,"description":"Random seed for reproducible results.\n\n**Use case:** Generate variations of the same image by using the same seed with slightly modified prompts.\n\n**Valid range:** 0 to 4,294,967,295\n**Default:** Random seed (if not provided)\n","type":"integer","nullable":true},"input_image":{"description":"Base64-encoded input image for **image-to-image generation** or **image editing**.\n\n**Supported formats:** JPEG, PNG, WebP\n**Use cases:**\n- Modify existing images\n- Style transfer\n- Composition refinement\n\n**Note:** Can provide up to 4 input images using `input_image`, `input_image_2`, `input_image_3`, and `input_image_4`.\n","type":"string","nullable":true},"width":{"default":1024,"minimum":256,"example":1024,"description":"Width of the image in pixels.\n\n**Valid range:** 256 to 1440 pixels\n**Default:** 1024 pixels\n\n**Common sizes:**\n- Square: 1024×1024\n- Landscape: 1440×768 (16:9)\n- Portrait: 768×1440 (9:16)\n","type":"integer","maximum":1440},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"}},"type":"object"},"list_cloned_voices_200_response":{"example":{"data":[{"provider":"elevenlabs","gender":"female","is_active":true,"example_mp3_url":"example_mp3_url","eleven_labs_voice":"pNInz6obpgDQGcFmaJgB","description":"A warm, professional tone","main_languages":[{"identifier":"en","name":"English","id":0},{"identifier":"en","name":"English","id":0}],"name":"My Custom Voice","accent_id":"accent_id","is_cloned":true,"status":"completed","last_used_at":"2000-01-23T04:56:07.000+00:00","deleted_at":"2000-01-23T04:56:07.000+00:00","preview_image_url":"preview_image_url","id":42},{"provider":"elevenlabs","gender":"female","is_active":true,"example_mp3_url":"example_mp3_url","eleven_labs_voice":"pNInz6obpgDQGcFmaJgB","description":"A warm, professional tone","main_languages":[{"identifier":"en","name":"English","id":0},{"identifier":"en","name":"English","id":0}],"name":"My Custom Voice","accent_id":"accent_id","is_cloned":true,"status":"completed","last_used_at":"2000-01-23T04:56:07.000+00:00","deleted_at":"2000-01-23T04:56:07.000+00:00","preview_image_url":"preview_image_url","id":42}]},"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/list_cloned_voices_200_response_data_inner"}}},"type":"object"},"data-icon-download":{"example":{"data":{"filename":"filename","url":"https://openapi-generator.tech"}},"properties":{"data":{"$ref":"#/components/schemas/data_icon_download_data"}},"type":"object"},"create_cloned_voice_request":{"required":["audios","name"],"properties":{"name":{"example":"My Custom Voice","maxLength":100,"type":"string","description":"User-defined voice name"},"audios":{"maxItems":5,"items":{"example":"https://example.com/sample.mp3","format":"uri","type":"string","maxLength":2048},"minItems":1,"description":"1 to 5 audio samples, each a public https URL (max 2048 chars).\nThe URLs are downloaded server-side (SSRF-protected, https only,\nno redirects); the combined downloaded size must not exceed 200 MB.\n","type":"array"},"description":{"maxLength":500,"example":"A warm, professional tone","description":"Optional voice description","type":"string","nullable":true},"remove_background_noise":{"default":false,"description":"Whether to remove background noise from the samples","type":"boolean"}},"type":"object"},"PaginatedMusicListResponse":{"example":{"count":150,"results":[{"favorites":350,"popularity":85,"cover_url":"cover_url","artist":{"name":"John Doe"},"moods":[{"name":"Happy"},{"name":"Energetic"}],"created_at":"2000-01-23T04:56:07.000+00:00","is_premium":true,"genres":[{"name":"Electronic"},{"name":"Ambient"}],"preview_url":"preview_url","download_url":"download_url","is_active":true,"file_url":"file_url","seconds":225,"title":"Summer Vibes","in_playlists":15,"downloads":1200,"id":1,"time":"3:45"},{"favorites":350,"popularity":85,"cover_url":"cover_url","artist":{"name":"John Doe"},"moods":[{"name":"Happy"},{"name":"Energetic"}],"created_at":"2000-01-23T04:56:07.000+00:00","is_premium":true,"genres":[{"name":"Electronic"},{"name":"Ambient"}],"preview_url":"preview_url","download_url":"download_url","is_active":true,"file_url":"file_url","seconds":225,"title":"Summer Vibes","in_playlists":15,"downloads":1200,"id":1,"time":"3:45"}]},"required":["count","results"],"type":"object","properties":{"count":{"example":150,"description":"Total number of results matching the query","type":"integer"},"results":{"type":"array","items":{"$ref":"#/components/schemas/MusicListItem"}}}},"loras-list":{"example":{"default":[{"name":"vintage-japanese","category":"illustration","preview":"https://www.example.com/4fef9987-75d0-44d1-b336-65f42f883bff.png","description":"Expect bold red colors and a sense of nostalgia, bringing to life classic Japanese elements.","training":{"quality":"quality","defaultScale":1.2,"status":"status"},"type":"character","id":1},{"name":"vintage-japanese","category":"illustration","preview":"https://www.example.com/4fef9987-75d0-44d1-b336-65f42f883bff.png","description":"Expect bold red colors and a sense of nostalgia, bringing to life classic Japanese elements.","training":{"quality":"quality","defaultScale":1.2,"status":"status"},"type":"character","id":1}],"customs":[{"name":"vintage-japanese","category":"illustration","preview":"https://www.example.com/4fef9987-75d0-44d1-b336-65f42f883bff.png","description":"Expect bold red colors and a sense of nostalgia, bringing to life classic Japanese elements.","training":{"quality":"quality","defaultScale":1.2,"status":"status"},"type":"character","id":1},{"name":"vintage-japanese","category":"illustration","preview":"https://www.example.com/4fef9987-75d0-44d1-b336-65f42f883bff.png","description":"Expect bold red colors and a sense of nostalgia, bringing to life classic Japanese elements.","training":{"quality":"quality","defaultScale":1.2,"status":"status"},"type":"character","id":1}]},"properties":{"default":{"description":"List of default Loras","type":"array","items":{"$ref":"#/components/schemas/lora-item"}},"customs":{"description":"List of custom Loras","type":"array","items":{"$ref":"#/components/schemas/lora-item"}}},"type":"object"},"create_cloned_voice_202_response_data":{"example":{"name":"My Custom Voice","id":42,"sqid":"a1b2c3","status":"pending"},"properties":{"name":{"example":"My Custom Voice","type":"string"},"id":{"example":42,"description":"Unique voice identifier","type":"integer"},"sqid":{"example":"a1b2c3","description":"Public short identifier of the voice","type":"string"},"status":{"example":"pending","description":"Voice cloning status","type":"string"}},"type":"object"},"itvko1-image-to-video-request":{"title":"Kling O1 Image to Video","properties":{"first_frame":{"example":"https://example.com/start-image.jpg","description":"First frame image (starting point of the video).\n\n**Supported formats:**\n- URL (must be publicly accessible)\n- Base64 encoded image\n\n**Requirements:**\n- Minimum resolution: 300x300px\n- Maximum file size: 10MB\n","type":"string"},"duration":{"default":"5","enum":["5","10"],"description":"Video duration in seconds.\n- `5`: 5-second video\n- `10`: 10-second video\n","type":"string"},"prompt":{"maxLength":2500,"description":"Text prompt describing the desired motion in the video.\n\n**Examples:**\n- \"Camera slowly pans across the landscape\"\n- \"Person walks toward the camera with soft wind blowing\"\n- \"Gentle zoom into the subject with bokeh effect\"\n","type":"string"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"last_frame":{"example":"https://example.com/end-image.jpg","description":"Last frame image (ending point of the video).\n\n**Supported formats:**\n- URL (must be publicly accessible)\n- Base64 encoded image\n","type":"string"},"aspect_ratio":{"default":"16:9","enum":["16:9","9:16","1:1"],"description":"Video aspect ratio:\n- `16:9`: Widescreen\n- `9:16`: Vertical\n- `1:1`: Square\n","type":"string"}},"type":"object","description":"Generate video using Kling O1 with first frame to last frame interpolation.\n\n**Best for:**\n- Creating smooth transitions between two images\n- Animating static images with controlled start/end points\n- Creating cinematic video sequences\n\n**Tips:**\n- Provide at least one frame (first_frame or last_frame)\n- For best results, provide both frames with similar compositions\n- Add a descriptive prompt to guide the motion\n"},"create_cloned_voice_202_response":{"example":{"data":{"name":"My Custom Voice","id":42,"sqid":"a1b2c3","status":"pending"},"success":true},"properties":{"data":{"$ref":"#/components/schemas/create_cloned_voice_202_response_data"},"success":{"example":true,"type":"boolean"}},"type":"object"},"resource_base":{"required":["author","id","image","licenses","title","url"],"example":{"title":"White t-shirt with copy space on gray background","licenses":[{"type":"freemium","url":"https://www.freepik.com/profile/license/pdf/4350594"},{"type":"freemium","url":"https://www.freepik.com/profile/license/pdf/4350594"}],"image":{"orientation":"horizontal","source":{"key":"large","size":"740x640","url":"https://img.freepik.com/free-photo/tshirt_53876-104920.jpg"},"type":"vector"},"id":15667327,"author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647},"url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm"},"properties":{"title":{"example":"White t-shirt with copy space on gray background","description":"Resource's title.","type":"string"},"licenses":{"description":"The licenses of this resource","type":"array","items":{"$ref":"#/components/schemas/license-information"}},"image":{"$ref":"#/components/schemas/resource-image"},"url":{"example":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm","format":"uri","description":"Resource's url","type":"string"},"id":{"example":15667327,"minimum":1,"type":"integer","description":"Resource's id."},"author":{"$ref":"#/components/schemas/author"}},"type":"object","description":"A resource within a list of resources from collection"},"delete_cloned_voice_200_response":{"example":{"success":true},"properties":{"success":{"example":true,"type":"boolean"}},"type":"object"},"list_my_flows_200_response_data_inner":{"example":{"name":"My Custom Sketch to Image","sqid":"uqzQLDr2Aw"},"properties":{"sqid":{"example":"uqzQLDr2Aw","description":"Short unique identifier of the flow.","type":"string"},"name":{"example":"My Custom Sketch to Image","description":"Human-readable name of the flow.","type":"string"}},"type":"object"},"list_my_flows_200_response":{"example":{"data":[{"name":"My Custom Sketch to Image","sqid":"uqzQLDr2Aw"},{"name":"My Custom Sketch to Image","sqid":"uqzQLDr2Aw"}]},"required":["data"],"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/list_my_flows_200_response_data_inner"}}}},"MoodSearchTag":{"required":["name"],"properties":{"name":{"example":"Happy","enum":["Dark","Dramatic","Elegant","Energetic","Epic","Exciting","Groovy","Happy","Hopeful","Laid Back","Melancholic","Peaceful","Playful","Sad","Sentimental","Soulful","Tension","Upbeat"],"description":"Mood name","type":"string"},"id":{"example":1,"description":"Mood identifier (may not always be present)","type":"integer"}},"type":"object","description":"Mood tag object returned by the search index"},"t2v-request_3":{"required":["prompt"],"properties":{"webhook_url":{"format":"uri","description":"Webhook URL to notify when the task is completed","type":"string"},"ratio":{"$ref":"#/components/schemas/aspect-ratio_5"},"duration":{"$ref":"#/components/schemas/duration_1"},"prompt":{"example":"A majestic eagle soaring over snow-capped mountains at golden hour","maxLength":2000,"type":"string","description":"Text prompt describing the video to generate. Maximum 2000 characters."}},"type":"object"},"aspect-ratio_5":{"default":"1280:720","enum":["1280:720","720:1280","1104:832","960:960","832:1104"],"description":"Aspect ratio of the generated video.\n- `1280:720`: Landscape (16:9)\n- `720:1280`: Portrait (9:16)\n- `1104:832`: Landscape (4:3)\n- `960:960`: Square (1:1)\n- `832:1104`: Portrait (3:4)\n","type":"string"},"duration_1":{"default":5,"enum":[5,8,10],"description":"Duration of the generated video in seconds (5, 8, or 10).","type":"integer"},"resource-image":{"example":{"orientation":"horizontal","source":{"key":"large","size":"740x640","url":"https://img.freepik.com/free-photo/tshirt_53876-104920.jpg"},"type":"vector"},"required":["orientation","source","type"],"type":"object","properties":{"orientation":{"$ref":"#/components/schemas/orientation"},"type":{"$ref":"#/components/schemas/regular-resource-type"},"source":{"$ref":"#/components/schemas/resource_image_source"}}},"loras-style-request":{"required":["images","name","quality"],"properties":{"name":{"pattern":"^[a-zA-Z0-9-_]+$","type":"string","description":"Name of the LoRA style. This name will be used to identify the style in the system."},"webhook_url":{"format":"uri","description":"Webhook URL to notify the user when the task is completed","type":"string"},"description":{"description":"Description of the LoRA style","type":"string"},"images":{"maxItems":20,"items":{"format":"uri","description":"Url of the image to train the LoRA style","type":"string"},"minItems":6,"description":"List of images to train the LoRA style","type":"array"},"quality":{"enum":["medium","high","ultra"],"description":"Quality of the LoRA style","type":"string"}},"type":"object"},"ttif2f-request-content":{"required":["prompt"],"properties":{"input_image_2":{"description":"Second base64-encoded input image for multi-image generation.","type":"string","nullable":true},"input_image_3":{"description":"Third base64-encoded input image for multi-image generation.","type":"string","nullable":true},"width":{"default":1024,"minimum":256,"example":1024,"description":"Width of the image in pixels.\n\n**Valid range:** 256 to 1920 pixels\n**Default:** 1024 pixels\n\n**Common sizes:**\n- Square: 1024×1024\n- Landscape: 1920×1080 (16:9)\n- Portrait: 1080×1920 (9:16)\n","type":"integer","maximum":1920},"input_image_4":{"description":"Fourth base64-encoded input image for multi-image generation.","type":"string","nullable":true},"height":{"default":768,"minimum":256,"example":768,"description":"Height of the image in pixels.\n\n**Valid range:** 256 to 1920 pixels\n**Default:** 768 pixels\n\n**Tip:** Total megapixels affect generation cost. Higher resolution = higher cost.\n","type":"integer","maximum":1920},"prompt_upsampling":{"default":false,"example":false,"type":"boolean","description":"Automatically enhance and expand your prompt for better generation results.\n\n**When to enable:**\n- Using simple, short prompts\n- Want AI to add creative details\n- Experimenting with variations\n\n**When to disable:**\n- Using detailed, specific prompts\n- Need exact control over output\n- Following brand guidelines\n"},"guidance":{"default":3,"maximum":10,"description":"Guidance scale for the generation. Higher values make the model follow the prompt more closely. Valid range: 1.5 to 10.0.","minimum":1.5,"type":"number","nullable":true},"seed":{"minimum":0,"maximum":4294967295,"example":42,"description":"Random seed for reproducible results.\n\n**Use case:** Generate variations of the same image by using the same seed with slightly modified prompts.\n\n**Valid range:** 0 to 4,294,967,295\n**Default:** Random seed (if not provided)\n","type":"integer","nullable":true},"steps":{"default":50,"maximum":50,"description":"Number of inference steps. More steps generally produce higher quality but take longer. Valid range: 1 to 50.","minimum":1,"type":"integer","nullable":true},"input_image":{"description":"Base64-encoded input image for **image-to-image generation** or **image editing**.\n\n**Supported formats:** JPEG, PNG, WebP\n**Use cases:**\n- Modify existing images\n- Style transfer\n- Composition refinement\n\n**Note:** Can provide up to 4 input images using `input_image`, `input_image_2`, `input_image_3`, and `input_image_4`.\n","type":"string","nullable":true},"safety_tolerance":{"default":5,"maximum":5,"description":"Tolerance level for input and output moderation. Between 0 and 5, 0 being most strict, 5 being least strict.","minimum":0,"type":"integer","nullable":true},"output_format":{"description":"Format of the output image","enum":["jpeg","png"],"type":"string","nullable":true},"prompt":{"example":"a beautiful sunset over the ocean with dramatic clouds","description":"Text description of the image you want to generate.\n\n**FLUX.2 [flex]** offers flexible, professional-grade image generation with fine-grained control over guidance, steps, and a wide resolution range for large-format output.\n\n**Tips for better results:**\n- Be specific about subjects, scenes, and visual details\n- Describe lighting, atmosphere, and mood\n- Mention art style or photographic techniques if desired\n\n**Examples:**\n- Simple: `\"a cat sitting on a windowsill\"`\n- Detailed: `\"a fluffy orange tabby cat sitting on a rustic wooden windowsill, golden hour lighting, soft focus background\"`\n- Creative: `\"futuristic cityscape at night with neon lights reflecting on wet streets, cyberpunk aesthetic, dramatic lighting\"`\n","type":"string"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"}},"type":"object"},"MusicDownloadResponse":{"example":{"title":"Summer Vibes","download_url":"https://cdn.freepik.com/music/track.mp3","id":1},"required":["download_url","id","title"],"type":"object","properties":{"title":{"example":"Summer Vibes","description":"Music title","type":"string"},"download_url":{"example":"https://cdn.freepik.com/music/track.mp3","description":"Direct URL to download the music file","type":"string"},"id":{"example":1,"description":"Unique identifier of the music item","type":"integer"}}},"resource_image_source":{"example":{"key":"large","size":"740x640","url":"https://img.freepik.com/free-photo/tshirt_53876-104920.jpg"},"required":["key","size","url"],"type":"object","properties":{"url":{"example":"https://img.freepik.com/free-photo/tshirt_53876-104920.jpg","format":"uri","description":"The orientation of this resource.","type":"string"},"size":{"example":"740x640","pattern":"^[1-9][0-9]+x[1-9][0-9]+$","type":"string","description":"The width and height of the image"},"key":{"example":"large","enum":["large"],"description":"The size of this image","type":"string"}}},"format":{"example":{"size":100,"id":1},"required":["id","size"],"type":"object","properties":{"size":{"example":100,"description":"The size of the file in bytes.","type":"integer"},"id":{"example":1,"description":"The id of the format. Null if doesn't exist","type":"integer","nullable":true}}},"kling-v3-multi-prompt-item":{"properties":{"duration":{"enum":["3","4","5","6","7","8","9","10","11","12","13","14","15"],"description":"Duration of this segment in seconds (3-15).","type":"string"},"prompt":{"maxLength":2500,"description":"Text prompt for this specific shot segment. Maximum 2500 characters.","type":"string"}},"type":"object","description":"Multi-shot prompt item with prompt text and duration for Kling V3."},"creation":{"description":"Metadata of the creation that produced the file. Present only when the file is linked to a creation owned by the user.\n","example":{"family":"image","preview":"https://openapi-generator.tech","public":false,"raw":"https://openapi-generator.tech","nsfw":false,"url":"https://cdn.freepik.com/creations/8421.png","large_preview":"https://openapi-generator.tech","metadata":"{}","identifier":"a1b2c3d4","status":"completed","created_at":"2023-03-07T23:05:26Z","tool":"text-to-image","user_id":159327,"id":8421},"properties":{"family":{"example":"image","type":"string","nullable":true},"preview":{"description":"Temporary URL of the preview media.","format":"uri","type":"string","nullable":true},"public":{"example":false,"type":"boolean"},"raw":{"description":"Temporary URL of the raw (original) media.","format":"uri","type":"string","nullable":true},"nsfw":{"example":false,"type":"boolean"},"tool":{"example":"text-to-image","type":"string"},"identifier":{"example":"a1b2c3d4","description":"Public short identifier of the creation.","type":"string"},"metadata":{"description":"Tool-specific metadata of the creation.","type":"object","nullable":true},"large_preview":{"description":"Temporary URL of the large preview media.","format":"uri","type":"string","nullable":true},"status":{"example":"completed","type":"string"},"created_at":{"example":"2023-03-07T23:05:26Z","format":"date-time","type":"string"},"url":{"description":"Temporary URL of the creation media.","example":"https://cdn.freepik.com/creations/8421.png","format":"uri","type":"string","nullable":true},"user_id":{"example":159327,"type":"integer"},"id":{"example":8421,"type":"integer"}},"type":"object","nullable":true},"kling-request-v26-text-to-video":{"required":["duration","prompt"],"properties":{"cfg_scale":{"default":0.5,"minimum":0,"description":"Flexibility in generation; The higher the value, the lower the model's degree of flexibility, and the stronger the relevance to the user's prompt.","format":"float","type":"number","maximum":1},"negative_prompt":{"maxLength":2500,"description":"Text prompt describing what to avoid in the generated video, cannot exceed 2500 characters","type":"string"},"prompt":{"maxLength":2500,"description":"Text prompt describing the desired video to generate, cannot exceed 2500 characters","type":"string"},"webhook_url":{"format":"uri","description":"Webhook URL to notify the user when the task is completed","type":"string"},"generate_audio":{"description":"Whether to generate audio for the video","type":"boolean"},"duration":{"enum":["5","10"],"description":"Duration of the generated video in seconds","type":"string"},"aspect_ratio":{"$ref":"#/components/schemas/kling-v26-aspect-ratio"}},"type":"object"},"resource_product":{"required":["type","url"],"example":{"type":"essential","url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm"},"properties":{"type":{"example":"essential","description":"The type of product","type":"string","deprecated":true},"url":{"description":"The url of product","example":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm","format":"uri","type":"string","deprecated":true}},"type":"object","deprecated":true},"runway-gen4-turbo-request":{"required":["image"],"properties":{"seed":{"minimum":0,"description":"Random seed for reproducibility","type":"integer","maximum":4294967295},"duration":{"default":10,"enum":[5,10],"description":"Duration of the generated video in seconds","type":"integer"},"image":{"example":"https://example.com/image.jpg","description":"Reference image. Supports Base64 encoding or HTTPS URL (must be publicly accessible).","type":"string"},"webhook_url":{"format":"uri","description":"Webhook URL to notify the user when the task is completed","type":"string"},"ratio":{"$ref":"#/components/schemas/runway-aspect-ratio"},"prompt":{"maxLength":1000,"description":"Text prompt describing what should appear in the video (1-1000 characters)","type":"string"}},"type":"object"},"ltx-2-fps":{"default":25,"enum":[25,50],"example":25,"description":"Frames per second for the generated video.\n**Note:** 50 FPS is only available for durations up to 10 seconds.\n","type":"integer"},"itvkv2-5-pro-request-content":{"required":["duration"],"title":"Image to Video","type":"object","properties":{"cfg_scale":{"default":0.5,"minimum":0,"description":"Flexibility in video generation; The higher the value, the lower the model's degree of flexibility, and the stronger the relevance to the user's prompt.","format":"float","type":"number","maximum":1},"negative_prompt":{"description":"Text prompt describing what to avoid in the generated video, cannot exceed 2500 characters","type":"string"},"prompt":{"description":"Text prompt describing the desired motion, cannot exceed 2500 characters","type":"string"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"image":{"description":"Reference Image. Supports Base64 encoding or URL (ensure accessibility). For URL, must be publicly accessible. The image file size cannot exceed 10MB, and the resolution should not be less than 300x300px. Aspect ratio should be between 1:2.5 ~ 2.5:1.","type":"string"},"duration":{"enum":["5","10"],"description":"Duration of the generated video in seconds","type":"string"}}},"SfxCategory":{"required":["id","name"],"example":{"name":"Weather","parent":{"name":"Nature","id":1},"id":5},"properties":{"name":{"example":"Weather","description":"Category name","type":"string"},"parent":{"$ref":"#/components/schemas/SfxCategory_parent"},"id":{"example":5,"description":"Category identifier","type":"integer"}},"type":"object","description":"Category of the sound effect, with optional parent category"},"ltx-2-fast-t2v-request":{"required":["prompt"],"title":"LTX Video 2.0 Fast Text-to-Video Request","type":"object","allOf":[{"$ref":"#/components/schemas/ltx-2-base"},{"properties":{"resolution":{"$ref":"#/components/schemas/ltx-2-resolution"},"duration":{"$ref":"#/components/schemas/ltx-2-fast-duration"},"fps":{"$ref":"#/components/schemas/ltx-2-fps"}},"type":"object"}]},"runway-aspect-ratio":{"default":"1280:720","enum":["1280:720","720:1280","1104:832","832:1104","960:960","1584:672"],"description":"Aspect ratio for the generated video (width:height)","type":"string"},"kling-request-v26-image-to-video":{"required":["duration","image"],"properties":{"cfg_scale":{"default":0.5,"minimum":0,"description":"Flexibility in generation; The higher the value, the lower the model's degree of flexibility, and the stronger the relevance to the user's prompt.","format":"float","type":"number","maximum":1},"negative_prompt":{"maxLength":2500,"description":"Text prompt describing what to avoid in the generated video, cannot exceed 2500 characters","type":"string"},"duration":{"enum":["5","10"],"description":"Duration of the generated video in seconds","type":"string"},"prompt":{"maxLength":2500,"description":"Text prompt describing the desired motion in the video, cannot exceed 2500 characters","type":"string"},"webhook_url":{"format":"uri","description":"Webhook URL to notify the user when the task is completed","type":"string"},"generate_audio":{"description":"Whether to generate audio for the video","type":"boolean"},"image":{"format":"byte","description":"Reference Image. Supports Base64 encoding or URL (ensure accessibility). For URL, must be publicly accessible. The image file size cannot exceed 10MB, and the resolution should not be less than 300x300px. Aspect ratio should be between 1:2.5 ~ 2.5:1.","type":"string"},"aspect_ratio":{"$ref":"#/components/schemas/kling-v26-aspect-ratio"}},"type":"object"},"ltx-2-fast-duration":{"default":6,"enum":[6,8,10,12,14,16,18,20],"example":6,"description":"Video duration in seconds. Fast model supports 6-20 seconds in 2-second increments.\n**Note:** Durations longer than 10 seconds require 25 FPS and 1080p resolution.\n","type":"integer"},"motion-control-request":{"required":["image_url","video_url"],"properties":{"cfg_scale":{"default":0.5,"minimum":0,"description":"The CFG (Classifier Free Guidance) scale controls how closely the model follows the prompt. Higher values mean stronger adherence to the prompt but less flexibility.","format":"float","type":"number","maximum":1},"video_url":{"format":"uri","description":"URL of the reference video containing the motion to transfer.\n\n**Requirements:**\n- Must be a publicly accessible URL\n- Duration: 3-30 seconds\n- Supported formats: MP4, MOV, WEBM, M4V\n","type":"string"},"prompt":{"maxLength":2500,"description":"Optional text prompt to guide the motion transfer. Cannot exceed 2500 characters.","type":"string"},"webhook_url":{"format":"uri","description":"Webhook URL to notify you when the task completes. When provided, the server will send a POST request to this URL with the task result.","type":"string"},"image_url":{"format":"uri","description":"URL of the character/reference image. The motion from the reference video will be transferred to this character.\n\n**Requirements:**\n- Must be a publicly accessible URL\n- Minimum resolution: 300x300 pixels\n- Maximum file size: 10MB\n- Supported formats: JPG, JPEG, PNG, WEBP\n","type":"string"},"character_orientation":{"default":"video","enum":["video","image"],"description":"How the model interprets spatial information and constrains output duration.\n\n- **video**: Orientation matches reference video. Better for complex motions. Maximum output duration: 30 seconds.\n- **image**: Orientation matches reference image. Better for following camera movements. Maximum output duration: 10 seconds.\n","type":"string"}},"type":"object"},"resource_related":{"example":{"serie":{"title":"White t-shirt with copy space on gray background","licenses":[{"type":"freemium","url":"https://www.freepik.com/profile/license/pdf/4350594"},{"type":"freemium","url":"https://www.freepik.com/profile/license/pdf/4350594"}],"image":{"orientation":"horizontal","source":{"key":"large","size":"740x640","url":"https://img.freepik.com/free-photo/tshirt_53876-104920.jpg"},"type":"vector"},"id":15667327,"author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647},"url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm"},"others":{"title":"White t-shirt with copy space on gray background","licenses":[{"type":"freemium","url":"https://www.freepik.com/profile/license/pdf/4350594"},{"type":"freemium","url":"https://www.freepik.com/profile/license/pdf/4350594"}],"image":{"orientation":"horizontal","source":{"key":"large","size":"740x640","url":"https://img.freepik.com/free-photo/tshirt_53876-104920.jpg"},"type":"vector"},"id":15667327,"author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647},"url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm"},"keywords":{"name":"Merry Christmas","slug":"merry-christmas"}},"required":["keywords","others","serie"],"type":"object","properties":{"serie":{"$ref":"#/components/schemas/resource_base"},"others":{"$ref":"#/components/schemas/resource_base"},"keywords":{"$ref":"#/components/schemas/tag_1"}}},"resolution":{"default":"1080P","enum":["720P","1080P"],"description":"Output video resolution:\n- `720P`: 720p HD (1280x720)\n- `1080P`: 1080p Full HD (1920x1080)\n","type":"string"},"resource_stats":{"example":{"downloads":0,"likes":0},"required":["downloads","likes"],"type":"object","properties":{"downloads":{"example":0,"description":"The number of downloads of this resource.","type":"integer"},"likes":{"example":0,"description":"The number of likes of this resource.","type":"integer"}}},"i2v-request":{"title":"Image to Video - WAN 2.7","description":"Generate video from an image or extend an existing video using WAN 2.7. Supports three modes:\n- First frame only: provide `start_image_url` to animate from a starting image\n- First + last frame: provide both `start_image_url` and `end_image_url` for controlled start-to-end animation\n- Video continuation: provide `video_url` to extend an existing video, optionally with `end_image_url` as the target ending frame\n","properties":{"start_image_url":{"example":"https://example.com/start-frame.jpg","format":"uri","description":"URL of the first-frame image to animate from. Must be publicly accessible.\n\n**Supported formats:** JPEG, PNG, BMP, WEBP\n**Dimensions:** 240-8000px per side, aspect ratio between 1:8 and 8:1\n**Maximum file size:** 20MB\n","type":"string"},"prompt":{"example":"The character walks forward slowly with wind blowing through their hair","maxLength":5000,"type":"string","description":"Optional text description to guide the video generation. Describe the desired motion, camera movements, and style."},"resolution":{"$ref":"#/components/schemas/resolution"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"video_url":{"example":"https://example.com/input-video.mp4","format":"uri","description":"URL of an existing video to continue or extend.\n\n**Supported formats:** MP4, MOV\n**Duration:** 2-10 seconds\n**Dimensions:** 240-4096px per side\n**Maximum file size:** 100MB\n","type":"string"},"additional_settings":{"$ref":"#/components/schemas/additional-settings"},"audio_url":{"format":"uri","description":"URL of an audio file to guide the video generation.\n\n**Supported formats:** WAV, MP3\n**Duration:** 2-30 seconds\n**Maximum file size:** 15MB\n","type":"string"},"end_image_url":{"example":"https://example.com/end-frame.jpg","format":"uri","description":"URL of the last-frame image. Use with `start_image_url` for controlled start-to-end animation, or with `video_url` as the target ending frame. Same format constraints as `start_image_url`.","type":"string"},"duration":{"default":5,"minimum":2,"example":5,"description":"Duration of the output video in seconds. When using video continuation (`video_url`), this is the total output length including the input video duration.","type":"integer","maximum":15},"seed":{"minimum":0,"example":12345,"description":"Random seed for reproducible generation. Use the same seed with identical parameters to reproduce results. Leave unset for random seed.","type":"integer","maximum":2147483647},"negative_prompt":{"example":"watermark, text, distortion, blurry, extra limbs","maxLength":500,"type":"string","description":"Elements to avoid in the generated video.\n\n**Examples:** \"blurry, low quality, watermark, text, distortion, extra limbs\"\n"}},"anyOf":[],"type":"object","nullable":true},"wan-25-i2v-base":{"required":["image","prompt"],"title":"WAN 2.5 Image-to-Video Base","type":"object","allOf":[{"$ref":"#/components/schemas/wan-25-base"},{"properties":{"image":{"example":"https://example.com/image.jpg","description":"URL of the keyframe or base image to animate. Must be publicly accessible.\n\n**Supported formats:** JPEG, PNG, WebP\n**Dimension constraints:** Each dimension (width and height) must be between 240px and 8000px.\n**Maximum file size:** 10MB\n**Recommended:** High quality image with clear subject\n","type":"string"}},"type":"object"}]},"photo_resource":{"additionalProperties":true,"allOf":[{"$ref":"#/components/schemas/resource_base"},{"required":["filename","meta","related","stats"],"properties":{"related":{"$ref":"#/components/schemas/resource_base"},"stats":{"$ref":"#/components/schemas/resource_stats"},"products":{"description":"These products of this resource","deprecated":true,"type":"array","items":{"$ref":"#/components/schemas/resource_product"}},"meta":{"$ref":"#/components/schemas/photo_meta"},"filename":{"description":"The filename of this resource.","type":"string"}},"type":"object","description":"A resource within a list of resources from collection"}]},"i2v-wan-25-720p-request-content":{"title":"Image to Video - WAN 2.5 720p","description":"Generate 720p video from image using WAN 2.5 model","allOf":[{"$ref":"#/components/schemas/wan-25-i2v-base"}]},"photo_meta":{"required":["available_formats","is_new","published_at"],"properties":{"is_new":{"example":true,"description":"True if this resource is new. False, otherwise.","type":"boolean"},"available_formats":{"$ref":"#/components/schemas/photo_available_formats"},"published_at":{"example":"2020-12-01T23:50:50Z","description":"The datetime when this resource was published.","type":"string"}},"type":"object"},"related_same_collection":{"properties":{"same_collection":{"$ref":"#/components/schemas/related_same_collection_same_collection"}},"type":"object"},"clean_search":{"example":true,"description":"If true, It has been ensured that the search does not return disabled resources.","type":"boolean"},"kling-v3-omni-aspect-ratio":{"default":"16:9","enum":["auto","16:9","9:16","1:1"],"description":"Aspect ratio for Kling V3 Omni video generation:\n- `auto`: Automatically match the input image aspect ratio (image-to-video only)\n- `16:9`: Landscape (widescreen)\n- `9:16`: Portrait (vertical)\n- `1:1`: Square\n","type":"string"},"i2v-request_3":{"required":["image","prompt"],"properties":{"seed":{"minimum":0,"description":"Random seed for reproducible video generation. Use the same seed with identical parameters to generate the same video.","type":"integer","maximum":4294967295},"duration":{"$ref":"#/components/schemas/duration_1"},"prompt":{"example":"The eagle spreads its wings and gracefully takes flight","maxLength":2000,"type":"string","description":"Text prompt describing the desired motion and video content. Maximum 2000 characters."},"webhook_url":{"format":"uri","description":"Webhook URL to notify when the task is completed","type":"string"},"ratio":{"$ref":"#/components/schemas/aspect-ratio_5"},"image":{"example":"https://example.com/image.jpg","description":"Source image for video generation. Supports Base64 encoding or HTTPS URL (must be publicly accessible).","type":"string"}},"type":"object"},"t2v-request":{"required":["prompt"],"title":"Text to Video - WAN 2.7","description":"Generate video from a text prompt using WAN 2.7. Supports configurable aspect ratios (16:9, 9:16, 1:1, 4:3, 3:4), resolutions (720P, 1080P), optional audio input, and duration from 2 to 15 seconds.","type":"object","properties":{"duration":{"default":5,"minimum":2,"example":5,"description":"Duration of the output video in seconds.","type":"integer","maximum":15},"prompt":{"example":"A serene mountain landscape at golden hour with mist rising through the valley, cinematic slow camera pan","maxLength":5000,"type":"string","description":"Text description of the video to generate. Describe the scene, characters, motion, camera movements, lighting, and style in detail for best results.\n\n**Tips:**\n- Be specific about scenes and visual details\n- Describe camera movements (zoom, pan, tilt)\n- Mention lighting and atmosphere\n\n**Examples:**\n- Simple: \"a cat sitting on a windowsill\"\n- Detailed: \"fluffy orange cat on wooden windowsill, looking at snow falling outside, soft warm lighting, cinematic slow camera pan\"\n"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"seed":{"minimum":0,"example":12345,"description":"Random seed for reproducible generation. Use the same seed with identical parameters to reproduce results. Leave unset for random seed.","type":"integer","maximum":2147483647},"negative_prompt":{"example":"watermark, text, distortion, blurry, extra limbs","maxLength":500,"type":"string","description":"Elements to avoid in the generated video. Use this to prevent unwanted artifacts or styles.\n\n**Examples:** \"blurry, low quality, watermark, text, distortion, extra limbs\"\n"},"audio_url":{"format":"uri","description":"URL of an audio file to guide the video generation. If not provided, the model may auto-generate audio.\n\n**Supported formats:** WAV, MP3\n**Duration:** 2-30 seconds\n**Maximum file size:** 15MB\n","type":"string"},"additional_settings":{"$ref":"#/components/schemas/additional-settings"},"resolution":{"$ref":"#/components/schemas/resolution"},"aspect_ratio":{"$ref":"#/components/schemas/aspect-ratio"}}},"related_same_series":{"properties":{"same_series":{"$ref":"#/components/schemas/related_same_series_same_series"}},"type":"object"},"GenreSearchTag":{"required":["name"],"properties":{"name":{"example":"Electronic","enum":["Acoustic","Afrobeat","Ambient","Blues","Children","Cinematic","Classical","Corporate","Country","Disco","Electronic","Funk","Hip Hop","Jazz","Latin","Lofi","Lounge","Pop","Reggae","RnB","Rock","Soul","Synthwave","World"],"description":"Genre name","type":"string"},"id":{"example":1,"description":"Genre identifier (may not always be present)","type":"integer"}},"type":"object","description":"Genre tag object returned by the search index"},"r2v-request":{"required":["prompt"],"title":"Reference to Video - WAN 2.7","properties":{"image_urls":{"description":"List of character reference images. Each image represents one character. Combined total with `video_urls` must not exceed 5.","type":"array","items":{"$ref":"#/components/schemas/reference-character-image"}},"start_image_url":{"example":"https://example.com/start-frame.jpg","format":"uri","description":"Optional first-frame image. If provided, the output aspect ratio is determined by this image instead of the `aspect_ratio` parameter.\n\n**Supported formats:** JPEG, PNG, BMP, WEBP\n**Dimensions:** 240-8000px per side\n**Maximum file size:** 20MB\n","type":"string"},"prompt":{"example":"Image 1 is dancing in a garden while Video 1 plays guitar in the background","maxLength":5000,"type":"string","description":"Text description of the video to generate. Reference characters using their position labels: \"Image 1\", \"Image 2\", \"Video 1\", etc.\n\n**Example:** \"Image 1 and Image 2 are walking together in a park while Video 1 plays guitar in the background.\"\n"},"resolution":{"$ref":"#/components/schemas/resolution"},"video_urls":{"description":"List of character reference videos. Each video represents one character. Combined total with `image_urls` must not exceed 5.","type":"array","items":{"$ref":"#/components/schemas/reference-character-video"}},"negative_prompt":{"example":"watermark, text, distortion, blurry, extra limbs","maxLength":500,"type":"string","description":"Elements to avoid in the generated video.\n\n**Examples:** \"blurry, low quality, watermark, text, distortion, extra limbs\"\n"},"additional_settings":{"$ref":"#/components/schemas/additional-settings"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"duration":{"default":5,"minimum":2,"example":5,"description":"Duration of the output video in seconds.","type":"integer","maximum":10},"seed":{"minimum":0,"example":12345,"description":"Random seed for reproducible generation. Use the same seed with identical parameters to reproduce results. Leave unset for random seed.","type":"integer","maximum":2147483647},"aspect_ratio":{"$ref":"#/components/schemas/aspect-ratio"}},"description":"Generate video featuring characters from reference images or videos using WAN 2.7.\nAt least one of `image_urls` or `video_urls` must be provided. The combined total of image and video references must not exceed 5.\nReference characters in the prompt as \"Image 1\", \"Image 2\", \"Video 1\", etc.\n","anyOf":[],"type":"object","nullable":true},"runway-act-two-request":{"required":["character","reference"],"properties":{"character":{"$ref":"#/components/schemas/runway_act_two_request_character"},"seed":{"minimum":0,"description":"Random seed for reproducibility","type":"integer","maximum":4294967295},"reference":{"$ref":"#/components/schemas/runway_act_two_request_reference"},"webhook_url":{"format":"uri","description":"Webhook URL to notify the user when the task is completed","type":"string"},"ratio":{"$ref":"#/components/schemas/runway-aspect-ratio"},"body_control":{"default":true,"description":"Enable body control for non-facial movements and gestures","type":"boolean"},"expression_intensity":{"default":3,"minimum":1,"description":"Intensity of character's expressions (1-5)","type":"integer","maximum":5}},"type":"object"},"vertical-type":{"example":"mockup","enum":["photo","vector","psd","icon","video","3d","font","mockup","template"],"description":"The vertical of the resource, used to drive the post-download experience.\nIt mirrors `type` for most resources, but resolves to `mockup` or\n`template` for PSD/Vector resources that match specific production lines.\n","type":"string"},"ttisd-edit-request-content":{"allOf":[{"$ref":"#/components/schemas/ttisd-request-content"},{"properties":{"reference_images":{"maxItems":5,"items":{"example":"iVBORw0KGgoAAAANSUhEUgAAASwAAAEsAQAAAABRBrPYAAABrElEQVR4nO3BMQEAAADCoPVPbQ0Po...","description":"Reference image as Base64 encoded string or publicly accessible URL","type":"string"},"example":["iVBORw0KGgoAAAANSUhEUgAAASwAAAEsAQAAAABRBrPYAAABrElEQVR4nO3BMQEAAADCoPVPbQ0Po...","https://example.com/reference-image.jpg"],"description":"Optional array of reference images for image editing. Each image can be provided as a Base64 encoded string or a publicly accessible URL.\nMaximum of 5 reference images allowed. If provided, the model will use these images as reference for editing or style transfer.\n","type":"array"}},"type":"object"}]},"additional-settings":{"properties":{"prompt_extend":{"default":true,"example":true,"type":"boolean","description":"Enable automatic prompt expansion to enrich shorter prompts with additional detail for better video output."}},"type":"object","description":"Additional generation settings."},"resource-type":{"example":"vector","enum":["photo","vector","psd","icon","video","3d","font"],"description":"The type of the resource.","type":"string"},"ttisdv45-request-content":{"required":["prompt"],"properties":{"seed":{"minimum":0,"example":12345,"description":"Random seed for reproducibility.\nUsing the same seed with identical parameters produces similar results.\nUseful for iterating on a design or creating variations.\n","type":"integer","maximum":4294967295},"prompt":{"example":"A professional marketing poster with elegant typography","maxLength":4096,"type":"string","description":"Text description of the image you want to generate.\n\n**Tips:**\n- Be specific about visual details, composition, and style\n- Seedream 4.5 excels at rendering text and typography\n- Describe lighting, atmosphere, and camera angles for best results\n\n**Examples:**\n- Simple: \"A modern logo design with clean typography\"\n- Detailed: \"Professional marketing poster for a tech startup, minimalist design, bold sans-serif typography, gradient blue background, high contrast\"\n"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"enable_safety_checker":{"default":true,"description":"Whether to enable the content safety checker.\nWhen enabled, the model filters potentially unsafe content.\n","type":"boolean"},"aspect_ratio":{"default":"square_1_1","enum":["square_1_1","widescreen_16_9","social_story_9_16","portrait_2_3","traditional_3_4","standard_3_2","classic_4_3","cinematic_21_9"],"example":"square_1_1","description":"The aspect ratio of the generated image. Seedream 4.5 supports up to 4MP resolution.\n\nAvailable options:\n- `square_1_1`: Square format (2048x2048) - Instagram feed, profile pictures\n- `widescreen_16_9`: Landscape (2730x1536) - YouTube thumbnails, presentations\n- `social_story_9_16`: Portrait (1536x2730) - TikTok, Instagram Stories\n- `portrait_2_3`: Tall portrait (1672x2508) - Pinterest pins\n- `traditional_3_4`: Classic photo (1774x2364) - Traditional photography\n- `standard_3_2`: Photo print (2508x1672) - Standard prints\n- `classic_4_3`: Monitor ratio (2364x1774) - Classic displays\n- `cinematic_21_9`: Ultra-wide (3062x1312) - Cinematic banners\n","type":"string"}},"type":"object"},"MusicDetail":{"example":{"favorites":350,"popularity":85,"cover_url":"cover_url","artist":{"cover_url":"cover_url","track_count":42,"name":"John Doe","bio":"bio","id":1},"moods":[{"cover_url":"cover_url","is_active":true,"order":1,"name":"Happy","id":1},{"cover_url":"cover_url","is_active":true,"order":1,"name":"Happy","id":1}],"created_at":"2000-01-23T04:56:07.000+00:00","is_premium":true,"genres":[{"cover_url":"cover_url","is_active":true,"order":1,"name":"Electronic","description":"description","id":1},{"cover_url":"cover_url","is_active":true,"order":1,"name":"Electronic","description":"description","id":1}],"preview_url":"preview_url","download_url":"download_url","is_active":true,"file_url":"file_url","seconds":225,"title":"Summer Vibes","in_playlists":15,"downloads":1200,"id":1,"time":"3:45"},"required":["id","title"],"type":"object","properties":{"time":{"example":"3:45","description":"Music duration formatted as minutes and seconds","type":"string"},"file_url":{"description":"Direct S3/CDN URL to the audio file","type":"string","nullable":true},"cover_url":{"description":"URL to the music cover image","type":"string","nullable":true},"artist":{"$ref":"#/components/schemas/MusicDetail_artist"},"moods":{"type":"array","items":{"$ref":"#/components/schemas/MoodItem"}},"created_at":{"format":"date-time","description":"Music creation timestamp","type":"string"},"is_premium":{"description":"Whether the music is premium","type":"boolean"},"genres":{"type":"array","items":{"$ref":"#/components/schemas/GenreItem"}},"preview_url":{"description":"Preview URL","type":"string","nullable":true},"download_url":{"description":"URL to download the music","type":"string","nullable":true},"is_active":{"description":"Whether the music is active","type":"boolean"},"title":{"example":"Summer Vibes","description":"Music title","type":"string"},"popularity":{"example":85,"description":"Popularity score","type":"integer"},"id":{"example":1,"description":"Unique identifier of the music item","type":"integer"},"seconds":{"example":225,"description":"Music duration in seconds","type":"integer"},"downloads":{"example":1200,"description":"Total number of downloads","type":"integer"},"favorites":{"example":350,"description":"Total number of favorites","type":"integer"},"in_playlists":{"example":15,"description":"Number of playlists containing this music","type":"integer"}}},"t2v-request_4":{"required":["prompt"],"properties":{"duration":{"$ref":"#/components/schemas/duration_2"},"seed":{"minimum":0,"description":"Random seed for reproducibility","type":"integer"},"negative_prompt":{"example":"blurry, low quality, distorted","maxLength":20000,"type":"string","description":"Text describing what to avoid in the generated video"},"prompt":{"example":"A serene mountain landscape at sunset with clouds moving slowly","maxLength":20000,"type":"string","description":"Text prompt describing the video to generate"},"webhook_url":{"format":"uri","description":"Webhook URL to notify when the task is completed","type":"string"},"generate_audio":{"default":true,"description":"Whether to generate audio for the video","type":"boolean"},"resolution":{"$ref":"#/components/schemas/resolution_5"},"aspect_ratio":{"$ref":"#/components/schemas/aspect-ratio_6"}},"type":"object"},"kling-v3-omni-request":{"properties":{"image_urls":{"description":"Reference images for style/appearance guidance.\nReference in your prompt as @Image1, @Image2, etc.\nMaximum 4 reference images.\n","type":"array","items":{"type":"string"}},"start_image_url":{"description":"Image to use as the first frame of the video.\nUse together with end_image_url to control both start and end frames in image-to-video mode.\n","type":"string"},"prompt":{"maxLength":2500,"description":"Text prompt describing the desired video content. Maximum 2500 characters.\n\n**Usage by mode:**\n- **Text-to-video:** Required unless multi_prompt is provided\n- **Image-to-video:** Either prompt or multi_prompt must be provided, but not both\n","type":"string"},"webhook_url":{"format":"uri","description":"Optional callback URL that receives asynchronous notifications when the task changes status.\nThe payload includes the task status and result URL when completed.\n","type":"string"},"image_url":{"description":"URL of the start frame image for image-to-video generation.\nRequired for image-to-video mode.\n\n**Image requirements:**\n- Minimum: 300x300 pixels\n- Maximum: 10MB file size\n- Formats: JPG, JPEG, PNG\n","type":"string"},"shot_type":{"default":"customize","enum":["customize"],"description":"Controls how multi-shot video generation is segmented for Kling 3 Omni.\n- `customize`: User provides explicit per-shot prompts via the multi_prompt array.\n\nCurrently only \"customize\" is supported for Omni endpoints.\n","type":"string"},"multi_prompt":{"description":"List of prompts for multi-shot video generation. Each item is a string prompt for that shot.\nUse with shot_type to control multi-shot behavior.\n\nOnly effective when shot_type is set. When multi_prompt is provided without an explicit shot_type, it defaults to \"customize\".\n","maxItems":6,"type":"array","items":{"type":"string"}},"end_image_url":{"description":"Image to use as the last frame of the video.\nOptional for image-to-video mode to guide the final frame.\n","type":"string"},"generate_audio":{"description":"Whether to generate native audio for the video.","type":"boolean"},"duration":{"$ref":"#/components/schemas/kling-v3-duration"},"aspect_ratio":{"$ref":"#/components/schemas/kling-v3-omni-aspect-ratio"}},"type":"object"},"duration_4":{"example":"00:00:28","pattern":"^0[0-9]:[0-5][0-9]:[0-5][0-9]$","type":"string"},"image_1":{"required":["height","url","width"],"properties":{"height":{"minimum":100,"example":100,"description":"The height of the image.","type":"integer","maximum":4096},"width":{"minimum":100,"example":100,"description":"The width of the image.","type":"integer","maximum":4096},"url":{"example":"https://img.freepik.com/free-photo/image_8353-7579.jpg","format":"uri","description":"The url of the image.","type":"string"}},"type":"object"},"resolution_2":{"default":"2k","enum":["720p","1k","2k","4k"],"description":"Output resolution for the video upscaling. The aspect ratio of the source video is preserved:\n- `720p`: HD output\n- `1k`: Standard definition output\n- `2k`: High definition output (default)\n- `4k`: Ultra high definition output\n","type":"string"},"GenreItem":{"example":{"cover_url":"cover_url","is_active":true,"order":1,"name":"Electronic","description":"description","id":1},"required":["id","name"],"type":"object","properties":{"name":{"example":"Electronic","enum":["Acoustic","Afrobeat","Ambient","Blues","Children","Cinematic","Classical","Corporate","Country","Disco","Electronic","Funk","Hip Hop","Jazz","Latin","Lofi","Lounge","Pop","Reggae","RnB","Rock","Soul","Synthwave","World"],"type":"string"},"is_active":{"type":"boolean"},"order":{"example":1,"type":"integer"},"cover_url":{"type":"string"},"description":{"type":"string"},"id":{"example":1,"type":"integer"}}},"MoodItem":{"example":{"cover_url":"cover_url","is_active":true,"order":1,"name":"Happy","id":1},"required":["id","name"],"type":"object","properties":{"name":{"example":"Happy","enum":["Dark","Dramatic","Elegant","Energetic","Epic","Exciting","Groovy","Happy","Hopeful","Laid Back","Melancholic","Peaceful","Playful","Sad","Sentimental","Soulful","Tension","Upbeat"],"type":"string"},"is_active":{"type":"boolean"},"cover_url":{"type":"string"},"order":{"example":1,"type":"integer"},"id":{"example":1,"type":"integer"}}},"get_all_style_transfer_tasks_200_response":{"example":{"data":[{"task_id":"046b6c7f-0b8a-43b9-b35d-6489e6daee91","status":"CREATED"},{"task_id":"046b6c7f-0b8a-43b9-b35d-6489e6daee91","status":"CREATED"}]},"required":["data"],"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/task"}}}},"apply_style_transfer_to_image_200_response":{"example":{"generated":["https://openapi-generator.tech","https://openapi-generator.tech"],"task_id":"046b6c7f-0b8a-43b9-b35d-6489e6daee91","task_status":"IN_PROGRESS"},"required":["generated","task_id","task_status"],"type":"object","properties":{"task_id":{"format":"uuid","description":"Task identifier","type":"string"},"generated":{"type":"array","items":{"format":"uri","description":"URL of the generated image","type":"string"}},"task_status":{"enum":["IN_PROGRESS","CREATED","COMPLETED","FAILED"],"description":"Task status","type":"string"}}},"resolution_5":{"default":"720p","enum":["720p","1080p","4k"],"description":"Resolution of the generated video.","type":"string"},"PaginatedSfxListResponse":{"example":{"count":250,"results":[{"download_count":580,"category":{"name":"Weather","parent":{"name":"Nature","id":1},"id":5},"file_url":"file_url","title":"Thunder Rumble","tags":["thunder","storm","weather"],"duration":5.2,"created_at":"2000-01-23T04:56:07.000+00:00","popularity":72,"is_premium":true,"id":1},{"download_count":580,"category":{"name":"Weather","parent":{"name":"Nature","id":1},"id":5},"file_url":"file_url","title":"Thunder Rumble","tags":["thunder","storm","weather"],"duration":5.2,"created_at":"2000-01-23T04:56:07.000+00:00","popularity":72,"is_premium":true,"id":1}]},"required":["count","results"],"type":"object","properties":{"count":{"example":250,"description":"Total number of results matching the query","type":"integer"},"results":{"type":"array","items":{"$ref":"#/components/schemas/SfxListItem"}}}},"get_style_transfer_task_status_200_response":{"example":{"data":{"generated":["https://openapi-generator.tech","https://openapi-generator.tech"],"task_id":"046b6c7f-0b8a-43b9-b35d-6489e6daee91","status":"CREATED"}},"required":["data"],"type":"object","properties":{"data":{"$ref":"#/components/schemas/task-detail"}}},"create_image_from_text_classic_200_response":{"example":{"data":[{"base64":"iVBORw0KGgoAAAANSUhEUgAAASwAAAEsAQAAAABRBrPYAAABrElEQVR4nO3BMQEAAADCoPVPbQ0Po...","has_nsfw":false},{"base64":"iVBORw0KGgoAAAANSUhEUgAAASwAAAEsAQAAAABRBrPYAAABrElEQVR4nO3BMQEAAADCoPVPbQ0Po...","has_nsfw":false}],"meta":{"guidance_scale":2,"seed":42,"prompt":"Crazy dog flying over the space","image":{"height":1024,"size":"square_1_1","width":1024},"num_inference_steps":8}},"required":["data","meta"],"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/image"}},"meta":{"$ref":"#/components/schemas/meta"}}},"i2v-request_4":{"required":["image","prompt"],"properties":{"duration":{"$ref":"#/components/schemas/duration_2"},"prompt":{"example":"The subject slowly turns their head and smiles","maxLength":20000,"type":"string","description":"Text prompt describing the video to generate"},"webhook_url":{"format":"uri","description":"Webhook URL to notify when the task is completed","type":"string"},"image_end":{"example":"https://example.com/image-end.jpg","description":"Optional last frame the video interpolates towards. Supports Base64 encoding or HTTPS URL (must be publicly accessible). Requires `image`.","type":"string"},"negative_prompt":{"maxLength":20000,"description":"Text describing what to avoid in the generated video","type":"string"},"image":{"example":"https://example.com/image.jpg","description":"Input image. Supports Base64 encoding or HTTPS URL (must be publicly accessible).","type":"string"},"seed":{"minimum":0,"description":"Random seed for reproducibility","type":"integer"},"generate_audio":{"default":true,"description":"Whether to generate audio for the video","type":"boolean"},"resolution":{"$ref":"#/components/schemas/resolution_5"},"aspect_ratio":{"$ref":"#/components/schemas/aspect-ratio_6"}},"type":"object"},"kling-v3-duration":{"default":"5","enum":["3","4","5","6","7","8","9","10","11","12","13","14","15"],"description":"Duration of the generated video in seconds.\n\n**Range:** 3-15 seconds\n**Note:** When using multi-shot mode, total duration across all shots cannot exceed 15 seconds.\n","type":"string"},"create_image_from_text_flux_200_response":{"example":{"data":{"task_id":"046b6c7f-0b8a-43b9-b35d-6489e6daee91","status":"CREATED"}},"required":["data"],"type":"object","properties":{"data":{"$ref":"#/components/schemas/task"}}},"postAiImageToVideoKlingV26Pro_request":{"anyOf":[{"$ref":"#/components/schemas/kling-request-v26-text-to-video"},{"$ref":"#/components/schemas/kling-request-v26-image-to-video"}]},"vector_related":{"example":{"same_series":{"items":[{"name":"White t-shirt with copy space on gray background","preview":{"height":500,"url":"https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm","width":300},"premium":true,"new":true,"id":15667327,"has_prompt":true,"is_ai_generated":true,"slug":"merry-christmas","url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm","type":"vector","author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}},{"name":"White t-shirt with copy space on gray background","preview":{"height":500,"url":"https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm","width":300},"premium":true,"new":true,"id":15667327,"has_prompt":true,"is_ai_generated":true,"slug":"merry-christmas","url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm","type":"vector","author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}}],"url":"https://www.freepik.com/serie/32689488"},"same_author":[{"name":"White t-shirt with copy space on gray background","preview":{"height":500,"url":"https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm","width":300},"premium":true,"new":true,"id":15667327,"has_prompt":true,"is_ai_generated":true,"slug":"merry-christmas","url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm","type":"vector","author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}},{"name":"White t-shirt with copy space on gray background","preview":{"height":500,"url":"https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm","width":300},"premium":true,"new":true,"id":15667327,"has_prompt":true,"is_ai_generated":true,"slug":"merry-christmas","url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm","type":"vector","author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}}],"suggested":[{"name":"White t-shirt with copy space on gray background","preview":{"height":500,"url":"https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm","width":300},"premium":true,"new":true,"id":15667327,"has_prompt":true,"is_ai_generated":true,"slug":"merry-christmas","url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm","type":"vector","author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}},{"name":"White t-shirt with copy space on gray background","preview":{"height":500,"url":"https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm","width":300},"premium":true,"new":true,"id":15667327,"has_prompt":true,"is_ai_generated":true,"slug":"merry-christmas","url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm","type":"vector","author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}}],"same_collection":{"items":[{"name":"White t-shirt with copy space on gray background","preview":{"height":500,"url":"https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm","width":300},"premium":true,"new":true,"id":15667327,"has_prompt":true,"is_ai_generated":true,"slug":"merry-christmas","url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm","type":"vector","author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}},{"name":"White t-shirt with copy space on gray background","preview":{"height":500,"url":"https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm","width":300},"premium":true,"new":true,"id":15667327,"has_prompt":true,"is_ai_generated":true,"slug":"merry-christmas","url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm","type":"vector","author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}}],"url":"https://www.freepik.com/collection/shining"}},"allOf":[{"required":["same_author","same_series","suggested"],"properties":{"suggested":{"description":"Other resources related to this one.","type":"array","items":{"$ref":"#/components/schemas/resource"}},"same_author":{"description":"Other resources created by this author.","type":"array","items":{"$ref":"#/components/schemas/resource"}}},"type":"object","description":"Related resources and tags for this resource."},{"$ref":"#/components/schemas/related_same_series"},{"$ref":"#/components/schemas/related_same_collection"}]},"ref2v-request":{"required":["image_urls","prompt"],"properties":{"image_urls":{"maxItems":3,"items":{"type":"string","format":"uri"},"example":["https://example.com/character1.jpg","https://example.com/character2.jpg"],"minItems":1,"description":"Array of reference image URLs (1-3 images) for character or object consistency. Images must be publicly accessible HTTPS URLs.","type":"array"},"seed":{"minimum":0,"description":"Random seed for reproducibility","type":"integer"},"negative_prompt":{"example":"blurry, low quality, distorted","maxLength":20000,"type":"string","description":"Text describing what to avoid in the generated video"},"prompt":{"example":"The character walks through a futuristic city at night","maxLength":20000,"type":"string","description":"Text prompt describing the video to generate with the reference subjects"},"webhook_url":{"format":"uri","description":"Webhook URL to notify when the task is completed","type":"string"},"generate_audio":{"default":true,"description":"Whether to generate audio for the video including dialogue and sound effects","type":"boolean"},"resolution":{"$ref":"#/components/schemas/resolution_5"},"aspect_ratio":{"$ref":"#/components/schemas/aspect-ratio_6"}},"type":"object"},"create_video_minimax_hailuo_02_768p_request":{"oneOf":[{"$ref":"#/components/schemas/itvminimax-768p-request-content"},{"$ref":"#/components/schemas/ttvminimax-768p-request-content"}]},"aspect-ratio_4":{"default":"widescreen_16_9","enum":["widescreen_16_9","classic_4_3","square_1_1","traditional_3_4","social_story_9_16","portrait_2_3","landscape_3_2","cinematic_21_9"],"description":"The aspect ratio of the generated video","type":"string"},"SfxListItem":{"required":["id","title"],"example":{"download_count":580,"category":{"name":"Weather","parent":{"name":"Nature","id":1},"id":5},"file_url":"file_url","title":"Thunder Rumble","tags":["thunder","storm","weather"],"duration":5.2,"created_at":"2000-01-23T04:56:07.000+00:00","popularity":72,"is_premium":true,"id":1},"properties":{"download_count":{"example":580,"description":"Total number of downloads","type":"integer"},"category":{"$ref":"#/components/schemas/SfxCategory"},"popularity":{"example":72,"description":"Popularity score","type":"integer"},"title":{"example":"Thunder Rumble","description":"Sound effect title","type":"string"},"tags":{"example":["thunder","storm","weather"],"description":"Tags associated with the sound effect","type":"array","items":{"type":"string"}},"file_url":{"description":"Direct CDN URL to the audio file","type":"string","nullable":true},"created_at":{"format":"date-time","description":"Creation timestamp","type":"string"},"duration":{"example":5.2,"format":"float","description":"Duration in seconds","type":"number"},"is_premium":{"description":"Whether the sound effect is premium","type":"boolean"},"id":{"example":1,"description":"Unique identifier of the sound effect","type":"integer"}},"type":"object","description":"Sound effect item returned by search results. Fields are only included when non-null in the search index."},"create_video_minimax_hailuo_02_1080p_request":{"oneOf":[{"$ref":"#/components/schemas/itvminimax-1080p-request-content"},{"$ref":"#/components/schemas/ttvminimax-1080p-request-content"}]},"kling-v3-aspect-ratio":{"default":"16:9","enum":["16:9","9:16","1:1"],"description":"Aspect ratio for the generated video:\n- `16:9`: Landscape (widescreen) - ideal for YouTube, presentations\n- `9:16`: Portrait (vertical) - ideal for TikTok, Instagram Stories, Reels\n- `1:1`: Square - ideal for Instagram posts, social media\n","type":"string"},"t2v-request_5":{"required":["prompt"],"properties":{"duration":{"$ref":"#/components/schemas/duration_3"},"seed":{"minimum":0,"description":"Random seed for reproducibility","type":"integer","maximum":4294967295},"negative_prompt":{"example":"blurry, low quality, distorted","maxLength":2000,"type":"string","description":"Text describing what to avoid in the generated video"},"prompt":{"example":"A serene mountain landscape at sunset with clouds moving slowly","maxLength":20000,"type":"string","description":"Text prompt describing the video to generate"},"webhook_url":{"format":"uri","description":"Webhook URL to notify when the task is completed","type":"string"},"generate_audio":{"default":true,"description":"Whether to generate audio for the video","type":"boolean"},"resolution":{"$ref":"#/components/schemas/resolution_6"},"aspect_ratio":{"$ref":"#/components/schemas/aspect-ratio_6"}},"type":"object"},"create_video_minimax_hailuo_23_768p_request":{"oneOf":[{"$ref":"#/components/schemas/itvminimax23-768p-request-content"},{"$ref":"#/components/schemas/ttvminimax23-768p-request-content"}]},"create_video_minimax_hailuo_23_1080p_request":{"oneOf":[{"$ref":"#/components/schemas/itvminimax23-1080p-request-content"},{"$ref":"#/components/schemas/ttvminimax23-1080p-request-content"}]},"create_video_minimax_hailuo_23_768p_fast_request":{"oneOf":[{"$ref":"#/components/schemas/itvminimax23-768p-fast-request-content"},{"$ref":"#/components/schemas/ttvminimax23-768p-fast-request-content"}]},"kling-v3-omni-video-reference-request":{"required":["video_url"],"title":"Kling 3 Omni Video Reference Request","description":"Generate video using Kling 3 Omni with a reference video for motion/style guidance.\n\n**Required:** The `video_url` parameter is required for this endpoint. Reference the video in your prompt using `@Video1`.\n\n**Best for:**\n- Transferring motion patterns from reference videos\n- Maintaining visual consistency with reference material\n- Creating videos that follow a specific style or movement pattern\n","type":"object","properties":{"cfg_scale":{"default":0.5,"minimum":0,"description":"Guidance scale controlling prompt adherence versus creative freedom. Range: 0 to 1.\nValues above 1 are not supported for Kling 3 (only Kling 1.x models support cfg_scale up to 2).\n\n- **0**: Maximum creative freedom, loosest interpretation of the prompt\n- **0.5** (default): Balanced between prompt adherence and creativity\n- **1**: Strongest adherence to the prompt, least creative variation\n","format":"float","type":"number","maximum":1},"video_url":{"format":"uri","description":"**Required.** URL of the reference video to use as a creative guide for video-to-video generation.\nReference in your prompt as `@Video1`.\n\n**Video constraints:**\n- Duration: 3-10 seconds\n- Resolution: 720-2160px (minimum 720px width or height)\n- Max file size: 200MB\n- Frame rate: 24-60 FPS\n- Formats: `.mp4` or `.mov` only\n","type":"string"},"duration":{"$ref":"#/components/schemas/kling-v3-duration"},"prompt":{"maxLength":2500,"description":"Text prompt describing the desired video content. Maximum 2500 characters.\nReference the video in your prompt as @Video1.\n\n**Tips for better results:**\n- Be specific about actions, camera movements, and mood\n- Reference @Video1 to indicate how the reference video should influence generation\n","type":"string"},"webhook_url":{"format":"uri","description":"Optional callback URL that receives asynchronous notifications when the task changes status.\nThe payload includes the task status and result URL when completed.\n","type":"string"},"negative_prompt":{"default":"blur, distort, and low quality","maxLength":2500,"type":"string","description":"Undesired elements to avoid in the generated video. Maximum 2500 characters."},"image_url":{"description":"URL of the start frame image for image-to-video generation with video reference.\n\n**Image requirements:**\n- Minimum: 300x300 pixels\n- Maximum: 10MB file size\n- Formats: JPG, JPEG, PNG\n","type":"string"},"aspect_ratio":{"$ref":"#/components/schemas/kling-v3-omni-aspect-ratio"}}},"resolution_6":{"default":"720p","enum":["720p","1080p"],"description":"Resolution of the generated video. Veo 3.1 Lite supports 720p and 1080p.","type":"string"},"create_video_minimax_hailuo_23_1080p_fast_request":{"oneOf":[{"$ref":"#/components/schemas/itvminimax23-1080p-fast-request-content"},{"$ref":"#/components/schemas/ttvminimax23-1080p-fast-request-content"}]},"i2v-request_5":{"required":["image","prompt"],"properties":{"duration":{"$ref":"#/components/schemas/duration_3"},"prompt":{"example":"The subject slowly turns their head and smiles","maxLength":20000,"type":"string","description":"Text prompt describing the video to generate"},"resolution":{"$ref":"#/components/schemas/resolution_6"},"seed":{"minimum":0,"description":"Random seed for reproducibility","type":"integer","maximum":4294967295},"negative_prompt":{"maxLength":2000,"description":"Text describing what to avoid in the generated video","type":"string"},"image":{"example":"https://example.com/image.jpg","description":"Input image. Supports Base64 encoding or HTTPS URL (must be publicly accessible).","type":"string"},"generate_audio":{"default":true,"description":"Whether to generate audio for the video","type":"boolean"},"webhook_url":{"format":"uri","description":"Webhook URL to notify when the task is completed","type":"string"},"aspect_ratio":{"$ref":"#/components/schemas/aspect-ratio_6"}},"type":"object"},"omni-human-1-5-request":{"required":["audio_url","image_url"],"properties":{"turbo_mode":{"default":false,"description":"Enable faster generation with potentially reduced quality","type":"boolean"},"prompt":{"example":"A person speaking naturally with subtle head movements","maxLength":2000,"type":"string","description":"Optional text guidance for the generation. Can describe desired motion, expression, or style."},"webhook_url":{"format":"uri","description":"Webhook URL to notify the user when the task is completed","type":"string"},"audio_url":{"example":"https://example.com/audio.mp3","format":"uri","description":"URL of the audio file that drives the animation. Must be publicly accessible. Supported formats: MP3, OGG, WAV, M4A, AAC. Duration limits: 720p max 60 seconds, 1080p max 30 seconds.","type":"string"},"image_url":{"example":"https://example.com/human-figure.jpg","format":"uri","description":"URL of the human figure image to animate. Image must be publicly accessible, contain a visible human figure, and be in jpg, jpeg, png, or webp format.","type":"string"},"resolution":{"$ref":"#/components/schemas/omni-human-1-5-resolution"}},"type":"object"},"detect_ai_image_200_response":{"example":{"data":[{"probability":0.94891726970673,"class_name":"not_ai"},{"probability":0.94891726970673,"class_name":"not_ai"}]},"required":["data"],"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/result-classification"}}}},"SfxDetail":{"required":["id","title"],"example":{"download_count":580,"category":{"name":"Weather","parent":{"name":"Nature","id":1},"id":5},"file_url":"file_url","title":"Thunder Rumble","tags":["thunder","storm","weather"],"duration":5.2,"created_at":"2000-01-23T04:56:07.000+00:00","popularity":72,"is_premium":true,"id":1},"properties":{"download_count":{"example":580,"description":"Total number of downloads","type":"integer"},"category":{"$ref":"#/components/schemas/SfxCategory"},"popularity":{"example":72,"description":"Popularity score","type":"integer"},"title":{"example":"Thunder Rumble","description":"Sound effect title","type":"string"},"tags":{"example":["thunder","storm","weather"],"description":"Tags associated with the sound effect","type":"array","items":{"type":"string"}},"file_url":{"description":"Direct CDN URL to the audio file","type":"string","nullable":true},"created_at":{"format":"date-time","description":"Creation timestamp","type":"string"},"duration":{"example":5.2,"format":"float","description":"Duration in seconds","type":"number"},"is_premium":{"description":"Whether the sound effect is premium","type":"boolean"},"id":{"example":1,"description":"Unique identifier of the sound effect","type":"integer"}},"type":"object","description":"Full details of a sound effect"},"get_available_loras_list_200_response":{"example":{"data":[{"default":[{"name":"vintage-japanese","category":"illustration","preview":"https://www.example.com/4fef9987-75d0-44d1-b336-65f42f883bff.png","description":"Expect bold red colors and a sense of nostalgia, bringing to life classic Japanese elements.","training":{"quality":"quality","defaultScale":1.2,"status":"status"},"type":"character","id":1},{"name":"vintage-japanese","category":"illustration","preview":"https://www.example.com/4fef9987-75d0-44d1-b336-65f42f883bff.png","description":"Expect bold red colors and a sense of nostalgia, bringing to life classic Japanese elements.","training":{"quality":"quality","defaultScale":1.2,"status":"status"},"type":"character","id":1}],"customs":[{"name":"vintage-japanese","category":"illustration","preview":"https://www.example.com/4fef9987-75d0-44d1-b336-65f42f883bff.png","description":"Expect bold red colors and a sense of nostalgia, bringing to life classic Japanese elements.","training":{"quality":"quality","defaultScale":1.2,"status":"status"},"type":"character","id":1},{"name":"vintage-japanese","category":"illustration","preview":"https://www.example.com/4fef9987-75d0-44d1-b336-65f42f883bff.png","description":"Expect bold red colors and a sense of nostalgia, bringing to life classic Japanese elements.","training":{"quality":"quality","defaultScale":1.2,"status":"status"},"type":"character","id":1}]},{"default":[{"name":"vintage-japanese","category":"illustration","preview":"https://www.example.com/4fef9987-75d0-44d1-b336-65f42f883bff.png","description":"Expect bold red colors and a sense of nostalgia, bringing to life classic Japanese elements.","training":{"quality":"quality","defaultScale":1.2,"status":"status"},"type":"character","id":1},{"name":"vintage-japanese","category":"illustration","preview":"https://www.example.com/4fef9987-75d0-44d1-b336-65f42f883bff.png","description":"Expect bold red colors and a sense of nostalgia, bringing to life classic Japanese elements.","training":{"quality":"quality","defaultScale":1.2,"status":"status"},"type":"character","id":1}],"customs":[{"name":"vintage-japanese","category":"illustration","preview":"https://www.example.com/4fef9987-75d0-44d1-b336-65f42f883bff.png","description":"Expect bold red colors and a sense of nostalgia, bringing to life classic Japanese elements.","training":{"quality":"quality","defaultScale":1.2,"status":"status"},"type":"character","id":1},{"name":"vintage-japanese","category":"illustration","preview":"https://www.example.com/4fef9987-75d0-44d1-b336-65f42f883bff.png","description":"Expect bold red colors and a sense of nostalgia, bringing to life classic Japanese elements.","training":{"quality":"quality","defaultScale":1.2,"status":"status"},"type":"character","id":1}]}]},"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/loras-list"}}},"type":"object"},"SfxDownloadResponse":{"example":{"title":"Thunder Rumble","download_url":"https://cdn.freepik.com/sfx/thunder-rumble.mp3","id":1},"required":["download_url","id","title"],"type":"object","properties":{"title":{"example":"Thunder Rumble","description":"Sound effect title","type":"string"},"download_url":{"example":"https://cdn.freepik.com/sfx/thunder-rumble.mp3","description":"Direct URL to download the sound effect file","type":"string"},"id":{"example":1,"description":"Unique identifier of the sound effect","type":"integer"}}},"getRecentCreations_200_response_meta":{"example":{"pagination":{"last_page":1,"per_page":1,"total":1,"current_page":1}},"properties":{"pagination":{"$ref":"#/components/schemas/pagination"}},"type":"object"},"duration_3":{"default":8,"enum":[4,6,8],"description":"Duration of the generated video in seconds (4, 6, or 8).","type":"integer"},"getRecentCreations_200_response":{"example":{"data":[{"name":"My awesome creation","tool_name":"text-to-image","external_id":"8421","folder_id":98764,"folder_reference":"1e041aff-d0cf-48e0-a424-e8b2853ea8f8","creation":{"family":"image","preview":"https://openapi-generator.tech","public":false,"raw":"https://openapi-generator.tech","nsfw":false,"url":"https://cdn.freepik.com/creations/8421.png","large_preview":"https://openapi-generator.tech","metadata":"{}","identifier":"a1b2c3d4","status":"completed","created_at":"2023-03-07T23:05:26Z","tool":"text-to-image","user_id":159327,"id":8421},"reference":"4fef9987-75d0-44d1-b336-65f42f883bff","updated_at":"2023-03-07T23:05:26Z","created_at":"2023-03-07T23:05:26Z","thumbnail":{"url":"https://cdn.freepik.com/thumbnails/8421.jpg"},"user_id":159327,"id":1337},{"name":"My awesome creation","tool_name":"text-to-image","external_id":"8421","folder_id":98764,"folder_reference":"1e041aff-d0cf-48e0-a424-e8b2853ea8f8","creation":{"family":"image","preview":"https://openapi-generator.tech","public":false,"raw":"https://openapi-generator.tech","nsfw":false,"url":"https://cdn.freepik.com/creations/8421.png","large_preview":"https://openapi-generator.tech","metadata":"{}","identifier":"a1b2c3d4","status":"completed","created_at":"2023-03-07T23:05:26Z","tool":"text-to-image","user_id":159327,"id":8421},"reference":"4fef9987-75d0-44d1-b336-65f42f883bff","updated_at":"2023-03-07T23:05:26Z","created_at":"2023-03-07T23:05:26Z","thumbnail":{"url":"https://cdn.freepik.com/thumbnails/8421.jpg"},"user_id":159327,"id":1337}],"meta":{"pagination":{"last_page":1,"per_page":1,"total":1,"current_page":1}}},"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/recent_creation"}},"meta":{"$ref":"#/components/schemas/getRecentCreations_200_response_meta"}},"type":"object"},"schema_1":{"type":"string","enum":["footage","motion_graphics"]},"request_2":{"required":["audio_url","image_url","resolution"],"properties":{"resolution":{"$ref":"#/components/schemas/resolution_3"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"image_url":{"example":"https://example.com/portrait.jpg","description":"URL of the portrait image to animate into a talking video. The image should contain a clearly visible face for best lip-sync results. Must be a publicly accessible URL.","type":"string"},"audio_url":{"example":"https://example.com/speech-audio.mp3","description":"URL of the audio file for lip synchronization. The person in the image will speak in sync with this audio. Must be a publicly accessible URL. Supported formats include MP3, WAV, and M4A.","type":"string"}},"type":"object"},"search_resources_filters_parameter_orientation":{"properties":{"square":{"default":0,"description":"Filters results to only include resources with a square orientation. Set to 1 to enable, 0 to disable.","type":"number"},"landscape":{"default":0,"description":"Filters results to only include resources with a landscape orientation. Set to 1 to enable, 0 to disable.","type":"number"},"portrait":{"default":0,"description":"Filters results to only include resources with a portrait orientation. Set to 1 to enable, 0 to disable.","type":"number"},"panoramic":{"default":0,"description":"Filters results to only include resources with a panoramic orientation. Set to 1 to enable, 0 to disable.","type":"number"}},"type":"object"},"icon":{"example":{"name":"a woman reads a book in a tablet sits in the luxurious back of the library","free_svg":true,"thumbnails":[{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512},{"height":512,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png","width":512}],"created":"2023-03-07T23:05:26Z","id":52912,"slug":"a-woman-reads-a-book-in-a-tablet-sits-in-the-luxurious-back-of-the-library","family":{"name":"Outline","total":1200,"id":1},"style":{"name":"Meticulous Yellow shadow","id":50},"author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}},"required":["author","created","family","free_svg","id","name","slug","style","thumbnails"],"type":"object","properties":{"name":{"example":"a woman reads a book in a tablet sits in the luxurious back of the library","type":"string"},"family":{"$ref":"#/components/schemas/icon_family"},"thumbnails":{"type":"array","items":{"$ref":"#/components/schemas/source"}},"created":{"example":"2023-03-07T23:05:26Z","format":"date-time","type":"string"},"author":{"$ref":"#/components/schemas/author"},"slug":{"example":"a-woman-reads-a-book-in-a-tablet-sits-in-the-luxurious-back-of-the-library","type":"string"},"style":{"$ref":"#/components/schemas/icon_style"},"free_svg":{"example":true,"description":"If true, the icon has the svg for free downloading","type":"boolean"},"id":{"example":52912,"type":"integer"}}},"reference-character-video":{"required":["url"],"properties":{"url":{"example":"https://example.com/character1.mp4","format":"uri","description":"URL of the character reference video (must be publicly accessible).\n\n**Supported formats:** MP4, MOV\n**Maximum file size:** 100MB\n","type":"string"},"reference_voice":{"example":"https://example.com/voice1.wav","format":"uri","description":"Optional URL of a voice reference audio file for this character.","type":"string"}},"type":"object","description":"A reference character video with optional voice reference."},"kling-4k-t2v-request":{"required":["prompt"],"properties":{"cfg_scale":{"default":0.5,"minimum":0,"description":"Guidance scale controlling prompt adherence versus creative freedom. Range: 0 to 1.\n\n- **0**: Maximum creative freedom, loosest interpretation of the prompt\n- **0.5** (default): Balanced between prompt adherence and creativity\n- **1**: Strongest adherence to the prompt, least creative variation\n","format":"float","type":"number","maximum":1},"negative_prompt":{"default":"blur, distort, and low quality","maxLength":2500,"type":"string","description":"Undesired elements to avoid in the generated video. Maximum 2500 characters."},"prompt":{"maxLength":2500,"description":"Text prompt describing the desired video content. Maximum 2500 characters.\n\n**Tips for better results:**\n- Be specific about motion, camera angles, and actions\n- Describe the scene, characters, and atmosphere\n","type":"string"},"webhook_url":{"format":"uri","description":"Optional callback URL that receives asynchronous notifications when the task changes status.\nThe payload includes the task status and result URL when completed.\n","type":"string"},"duration":{"default":"5","enum":["3","4","5","6","7","8","9","10","11","12","13","14","15"],"description":"Duration of the generated video in seconds.\n\n**Range:** 3-15 seconds\n","type":"string"},"aspect_ratio":{"default":"16:9","enum":["16:9","9:16","1:1"],"description":"Aspect ratio for the generated video:\n- `16:9`: Landscape (widescreen) - ideal for YouTube, presentations\n- `9:16`: Portrait (vertical) - ideal for TikTok, Instagram Stories, Reels\n- `1:1`: Square - ideal for Instagram posts, social media\n","type":"string"}},"type":"object"},"kling-v3-turbo-t2v-request":{"required":["prompt"],"properties":{"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"prompt":{"minLength":1,"example":"A beautiful sunset over the ocean, gentle waves, cinematic lighting","maxLength":3072,"type":"string","description":"Text prompt describing the video you want to generate. Maximum 3072 characters; 2500 or fewer is recommended.\n\n**Tips for better results:**\n- Be specific about the scene, subjects, motion, and camera movement\n- Describe the lighting, atmosphere, and visual style\n- Add negative descriptions inline (for example, \"no text, no blur\") to steer the model away from unwanted elements\n"},"duration":{"default":"5","enum":["3","4","5","6","7","8","9","10","11","12","13","14","15"],"description":"Duration of the generated video in seconds.\n\n**Range:** 3-15 seconds\n","type":"string"},"aspect_ratio":{"default":"16:9","enum":["16:9","9:16","1:1"],"description":"Aspect ratio of the generated video:\n- `16:9`: Landscape (widescreen) - ideal for YouTube, presentations\n- `9:16`: Portrait (vertical) - ideal for TikTok, Instagram Stories, Reels\n- `1:1`: Square - ideal for Instagram posts, social media\n","type":"string"}},"type":"object"},"schema_5":{"type":"array","items":{"type":"string","enum":["24","25","30","60","gt60"]}},"search_resources_filters_parameter_content_type":{"properties":{"vector":{"default":0,"description":"Filters results to only include resources of type vector. Set to 1 to enable, 0 to disable.","type":"number"},"photo":{"default":0,"description":"Filters results to only include resources of type photo. Set to 1 to enable, 0 to disable.","type":"number"},"template":{"default":0,"description":"Filters results to only include templates (PSD and vector resources designed to be customized, such as flyers, invitations or social media posts). Set to 1 to enable, 0 to disable. Only applied when `term` is provided.","type":"number"},"mockup":{"default":0,"description":"Filters results to only include mockups. Set to 1 to enable, 0 to disable. Only applied when `term` is provided.","type":"number"},"psd":{"default":0,"description":"Filters results to only include resources of type PSD (Photoshop Document). Set to 1 to enable, 0 to disable.","type":"number"}},"type":"object"},"schema_6":{"type":"array","items":{"type":"string","enum":["people","nature","business","background","food","travel","sports","events"]}},"request_4":{"required":["image_url","prompt"],"properties":{"style":{"$ref":"#/components/schemas/style-enum"},"generate_audio_switch":{"default":false,"description":"When set to true, PixVerse-V5.5 generates synchronized audio (background music, sound effects, or dialogue) together with the video.","type":"boolean"},"duration":{"default":5,"enum":[5,8,10],"description":"The duration of the generated video in seconds. 8s videos cost double. 10s videos are only available up to 720p. 1080p videos are limited to 5 or 8 seconds.","type":"integer"},"prompt":{"description":"Prompt describing the video to generate","type":"string"},"resolution":{"$ref":"#/components/schemas/resolution_4"},"thinking_type":{"$ref":"#/components/schemas/thinking-type"},"image_url":{"format":"uri","description":"URL of the image to use as the first frame","type":"string"},"seed":{"description":"The same seed and the same prompt given to the same version of the model will output the same video every time","type":"integer"},"negative_prompt":{"default":"","description":"Negative prompt to be used for the generation","type":"string"},"aspect_ratio":{"$ref":"#/components/schemas/aspect-ratio_3"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"generate_multi_clip_switch":{"default":false,"description":"When set to true, PixVerse-V5.5 produces multi-clip output with dynamic camera changes within a single generation.","type":"boolean"},"camera_movement":{"$ref":"#/components/schemas/camera-movement"}},"type":"object"},"kling-v3-turbo-i2v-request":{"required":["image"],"properties":{"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"image":{"example":"https://example.com/my-image.jpg","description":"First-frame image used to start the video. Supports Base64 encoding (including a `data:image/...;base64,...` data URI)\nor a publicly accessible image URL.\n\n**Image requirements:**\n- Minimum: 300x300 pixels\n- Maximum: 50MB file size\n- Aspect ratio: 1:2.5 to 2.5:1\n- Formats: JPG, JPEG, PNG\n- Only the first frame is supported\n","type":"string"},"duration":{"default":"5","enum":["3","4","5","6","7","8","9","10","11","12","13","14","15"],"description":"Duration of the generated video in seconds.\n\n**Range:** 3-15 seconds\n","type":"string"},"prompt":{"example":"The subject slowly turns their head and smiles","maxLength":2500,"type":"string","description":"Optional text prompt to guide the motion and animation style. If omitted, motion is inferred from the\nsource image. Maximum 2500 characters.\n\n**Tips for better results:**\n- Describe the movement, camera behavior, and visual style\n- Add negative descriptions inline (for example, \"no text, no blur\") to steer the model away from unwanted elements\n"}},"type":"object"},"resource_meta":{"example":{"is_new":true,"available_formats":{"ai":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"png":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"psd":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"eps":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"atn":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"fonts":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"jpg":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"3d-render":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"svg":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"zip":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"resources":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]}},"published_at":"2020-12-01T23:50:50Z"},"required":["available_formats","is_new","published_at"],"type":"object","properties":{"is_new":{"example":true,"description":"True if this resource is new. False, otherwise.","type":"boolean"},"available_formats":{"$ref":"#/components/schemas/available_formats_1"},"published_at":{"example":"2020-12-01T23:50:50Z","description":"The datetime when this resource was published.","type":"string"}}},"schema_7":{"type":"string"},"search_resources_filters_parameter_license":{"properties":{"freemium":{"default":0,"description":"Filters results to only include resources with a freemium license. Set to 1 to enable, 0 to disable.","type":"number"},"premium":{"default":0,"description":"Filters results to only include resources with a premium license. Set to 1 to enable, 0 to disable.","type":"number"}},"type":"object"},"ltx-2-pro-duration":{"default":6,"enum":[6,8,10],"example":6,"description":"Video duration in seconds. Pro model supports 6, 8, or 10 seconds.","type":"integer"},"minimax-h3-request":{"required":["prompt"],"properties":{"reference_images":{"maxItems":9,"items":{"type":"string","format":"byte"},"example":["https://example.com/reference-1.jpg"],"description":"Up to 9 reference images for reference-to-video generation. Each item is a publicly accessible URL or a base64-encoded image. Reference them in the prompt using @Image1, @Image2, ... @Image9 (1-indexed to the array order). Each image must be JPG, JPEG, PNG, WEBP, HEIC or HEIF, no larger than 30 MB, 256 to 5760 px per side, with an aspect ratio from 0.4 to 2.5. Mutually exclusive with `image` and `image_end`.","type":"array"},"duration":{"default":5,"minimum":4,"example":5,"description":"Video duration in seconds. Any integer from 4 to 15. H3 accepts 4-second clips, unlike H3 Max, whose floor is 5.","type":"integer","maximum":15},"prompt":{"minLength":1,"example":"A cinematic shot of a cat walking through a neon-lit alley at night","maxLength":7000,"type":"string","description":"Text prompt describing the video to generate. Chinese and English are supported. Mention reference images as @Image1, @Image2, ... matching their 1-indexed array order. For best instruction following keep it under roughly 500 Chinese characters or 1,000 English words."},"webhook_url":{"format":"uri","description":"URL to receive a webhook notification when the video generation task completes. The webhook payload includes the task ID and status.","type":"string"},"aigc_watermark":{"default":false,"description":"Whether the provider stamps a visible AI-generated-content watermark on the output video.","type":"boolean"},"image_end":{"format":"byte","description":"Optional image to use as the last frame for image-to-video generation. Requires `image`: the provider rejects a last frame with no first frame. Together they generate a transition video between the two. Mutually exclusive with `reference_images`. Accepts a publicly accessible URL or a base64-encoded image.","type":"string"},"image":{"format":"byte","description":"Optional image to use as the first frame for image-to-video generation. Accepts a publicly accessible URL or a base64-encoded image. Mutually exclusive with `reference_images`.","type":"string"},"reference_videos":{"maxItems":3,"items":{"type":"string"},"example":["https://example.com/reference-1.mp4"],"description":"Up to 3 reference videos. Each item must be a publicly accessible HTTPS URL or a video upload file_id (`upl_vid_...`). Reference them in the prompt using @Video1, @Video2 or @Video3. Each video must be MP4 or MOV (H.264 or H.265), 2 to 15 seconds, 23.976 to 60 fps, no larger than 50 MB, 256 to 5760 px per side, with an aspect ratio from 0.4 to 2.5, and their combined duration must not exceed 15 seconds. Mutually exclusive with `image` and `image_end`. **These are billed**: their combined duration is added to the output duration, capped at 15 seconds.","type":"array"},"reference_audios":{"maxItems":3,"items":{"type":"string","format":"uri"},"example":["https://example.com/reference-voice.mp3"],"description":"Up to 3 reference audios. Each item must be a publicly accessible HTTPS URL — unlike `reference_videos`, this field does not take upload file_ids. Reference them in the prompt using @Audio1, @Audio2 or @Audio3. Each audio must be WAV or MP3, 2 to 15 seconds and no larger than 15 MB, and their combined duration must not exceed 15 seconds. Audio cannot be the only reference: at least one `reference_images` or `reference_videos` entry is required alongside it. Mutually exclusive with `image` and `image_end`. Adds nothing to the price.","type":"array"},"aspect_ratio":{"default":"widescreen_16_9","enum":["adaptive","film_horizontal_21_9","widescreen_16_9","classic_4_3","square_1_1","traditional_3_4","social_story_9_16"],"description":"Output video aspect ratio. Available options:\n- `adaptive`: infer the ratio from the reference images\n- `film_horizontal_21_9`: Ultra-wide cinematic (21:9)\n- `widescreen_16_9`: Standard widescreen (16:9)\n- `classic_4_3`: Classic TV format (4:3)\n- `square_1_1`: Square format (1:1)\n- `traditional_3_4`: Portrait classic (3:4)\n- `social_story_9_16`: Vertical/social media story (9:16)\n\n**`adaptive` needs something to adapt to.** It only means anything when the request carries `reference_images`; on a text-only request there is nothing to infer from and it falls back to `widescreen_16_9`.\n\n**Note:** ignored when `image` or `image_end` is supplied — in keyframe mode the output always follows the aspect ratio of the supplied image.\n","type":"string"}},"type":"object"},"search_resources_filters_parameter_people":{"properties":{"gender":{"example":"female","enum":["male","female"],"description":"Filter by gender of the people","type":"string"},"age":{"example":"child","enum":["infant","child","teen","young-adult","adult","senior","elder"],"description":"Filter by age of the people","type":"string"},"include":{"default":0,"example":1,"type":"number","description":"Filter by included people"},"number":{"example":"2","enum":["1","2","3","more_than_three"],"description":"Filter by number of people","type":"string"},"exclude":{"default":0,"example":1,"type":"number","description":"Filter by excluded people"},"ethnicity":{"example":"black","enum":["south-asian","middle-eastern","east-asian","black","hispanic","indian","white","multiracial","southeast-asian"],"description":"Filter by ethnicity of the people","type":"string"}},"type":"object"},"aspect-ratio_1":{"default":"16:9","enum":["16:9","9:16","1:1","4:3","3:4","21:9","9:21","5:4","4:5"],"description":"Output video aspect ratio:\n- `16:9`: Landscape (widescreen)\n- `9:16`: Portrait (vertical, mobile-optimized)\n- `1:1`: Square\n- `4:3`: Standard landscape\n- `3:4`: Standard portrait\n- `21:9`: Ultra-wide cinematic\n- `9:21`: Ultra-tall vertical\n- `5:4`: Classic landscape\n- `4:5`: Classic portrait\n","type":"string"},"itvke-request-content":{"required":["images"],"properties":{"duration":{"enum":["5","10"],"description":"Duration of the generated video in seconds","type":"string"},"prompt":{"maxLength":2500,"description":"Positive text prompt","type":"string"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"negative_prompt":{"maxLength":2500,"description":"Negative text prompt","type":"string"},"images":{"description":"Array of up to 4 images to use for video generation. Images must be at least 300x300px, aspect ratio between 1:2.5 ~ 2.5:1, and under 10MB","maxItems":4,"type":"array","items":{"description":"Image URL (must be accessible). Supported formats: jpg, jpeg, png","type":"string"}},"aspect_ratio":{"default":"widescreen_16_9","enum":["widescreen_16_9","social_story_9_16","square_1_1"],"description":"Aspect ratio for the generated video","type":"string"}},"type":"object"},"base_item":{"properties":{"name":{"example":"Cat looking at the camera","type":"string"},"code":{"example":"cat-looking-at-the-camera","pattern":"^[a-z0-9-]+$","type":"string"},"duration":{"example":"00:00:28","pattern":"^0[0-9]:[0-5][0-9]:[0-5][0-9]$","type":"string"},"id":{"example":76989,"type":"integer","minimum":1},"aspect_ratio":{"$ref":"#/components/schemas/aspect-ratio_2"},"is_ai_generated":{"example":true,"description":"True if the resource is generated by AI, false otherwise.","type":"boolean"},"quality":{"$ref":"#/components/schemas/quality"},"thumbnails":{"minItems":1,"type":"array","items":{"$ref":"#/components/schemas/image-with-aspect-ratio"}},"created":{"format":"date-time","description":"The datetime when this video was created.","type":"string"},"item_subtype":{"$ref":"#/components/schemas/item_subtype"},"previews":{"minItems":1,"type":"array","items":{"$ref":"#/components/schemas/preview-with-aspect-ratio"}},"active":{"example":true,"description":"True if this video is active. False, otherwise.","type":"boolean"},"url":{"example":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667327","format":"uri","description":"Url to the video's detail page in magnific","type":"string"},"author":{"$ref":"#/components/schemas/author-video"}},"type":"object"},"i2v-request_2":{"required":["image_url"],"title":"Image to Video - Happy Horse 1.1","description":"Animate a single image into video using Happy Horse 1.1. The image is used as the first frame; an optional text prompt guides motion and style.","type":"object","properties":{"seed":{"minimum":0,"example":12345,"description":"Random seed for reproducibility. Use the same seed with identical parameters to improve reproducibility (does not guarantee identical results). Leave unset for a random seed.","type":"integer","maximum":2147483647},"duration":{"$ref":"#/components/schemas/duration"},"prompt":{"example":"The character walks forward slowly with wind blowing through their hair","maxLength":2500,"type":"string","description":"Text prompt to guide the animation. Optional but recommended for better control over the generated video content."},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"image_url":{"example":"https://example.com/start-frame.jpg","format":"uri","description":"URL of the image to use as the first frame for image-to-video generation.\n\n**Supported formats:** JPEG, JPG, PNG, BMP, WEBP\n**Pixel dimensions:** at least 300px (width and height)\n**Aspect ratio:** between 1:2.5 and 2.5:1\n**Maximum file size:** 10 MB\n","type":"string"},"resolution":{"$ref":"#/components/schemas/resolution"}}},"flexible-optimized-for":{"default":"enhance_skin","enum":["enhance_skin","improve_lighting","enhance_everything","transform_to_real","no_make_up"],"description":"Optimization target for flexible skin enhancer","type":"string"},"camera-movement":{"enum":["horizontal_left","horizontal_right","vertical_up","vertical_down","zoom_in","zoom_out","crane_up","quickly_zoom_in","quickly_zoom_out","smooth_zoom_in","camera_rotation","robo_arm","super_dolly_out","whip_pan","hitchcock","left_follow","right_follow","pan_left","pan_right","fix_bg"],"description":"The type of camera movement to apply to the video","type":"string"},"r2v-request_2":{"required":["image_urls","prompt"],"title":"Reference to Video - Happy Horse 1.1","description":"Generate video guided by 1 to 9 reference images that define characters, objects or scenes using Happy Horse 1.1. In the prompt, reference each image by its 1-based positional index (`character1`, `character2`, ...). The order matches the array order.\n","type":"object","properties":{"image_urls":{"maxItems":9,"items":{"$ref":"#/components/schemas/reference-image"},"minItems":1,"description":"Ordered array of reference images. Array position determines the character reference number in the prompt (1st item → `character1`, 2nd → `character2`, etc.).\n\n**Supported formats:** JPEG, JPG, PNG, WEBP\n**Recommended resolution:** shortest side at least 400 px (720P or higher recommended)\n**Maximum file size:** 10 MB per image\n","type":"array"},"seed":{"minimum":0,"example":12345,"description":"Random seed for reproducibility. Use the same seed with identical parameters to improve reproducibility (does not guarantee identical results). Leave unset for a random seed.","type":"integer","maximum":2147483647},"duration":{"default":5,"minimum":3,"example":5,"description":"Duration of the generated video in seconds.","type":"integer","maximum":15},"prompt":{"minLength":1,"example":"character1 and character2 walk together through a sunlit forest path","maxLength":5000,"type":"string","description":"Text prompt describing the desired elements and visual style of the generated video. Supports any language. Requests with prompts longer than 5000 characters are rejected by validation; the upstream provider further treats 5000 non-Chinese characters or 2500 Chinese characters as the effective ceiling.\n\nUse `character1`, `character2`, ... in the prompt to reference the corresponding image in the `image_urls` array; the order matches the array order.\n\n**Example:** \"character1 and character2 walk together through a sunlit forest path\"\n"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"resolution":{"$ref":"#/components/schemas/resolution"},"watermark":{"default":false,"example":false,"type":"boolean","description":"Whether to add a watermark to the generated video. The watermark appears in the bottom-right corner with the fixed text \"Happy Horse\"."},"aspect_ratio":{"$ref":"#/components/schemas/aspect-ratio_1"}}},"lora-item":{"example":{"name":"vintage-japanese","category":"illustration","preview":"https://www.example.com/4fef9987-75d0-44d1-b336-65f42f883bff.png","description":"Expect bold red colors and a sense of nostalgia, bringing to life classic Japanese elements.","training":{"quality":"quality","defaultScale":1.2,"status":"status"},"type":"character","id":1},"required":["category","description","id","name","preview","training","type"],"type":"object","properties":{"name":{"example":"vintage-japanese","description":"Lora name","type":"string"},"category":{"example":"illustration","description":"Lora category","type":"string"},"preview":{"example":"https://www.example.com/4fef9987-75d0-44d1-b336-65f42f883bff.png","format":"uri","description":"Preview image URL for the Lora","type":"string"},"description":{"example":"Expect bold red colors and a sense of nostalgia, bringing to life classic Japanese elements.","description":"Lora description","type":"string","nullable":true},"training":{"$ref":"#/components/schemas/lora_item_training"},"type":{"example":"character","description":"Lora type","type":"string"},"id":{"example":1,"minimum":1,"type":"integer","description":"Lora ID"}}},"t2v-wan-25-1080p-request-content":{"title":"Text to Video - WAN 2.5 1080p","description":"Generate 1080p video from text prompt using WAN 2.5 model","allOf":[{"$ref":"#/components/schemas/wan-25-t2v-base"}]},"ltx-2-pro-i2v-request":{"required":["image_url","prompt"],"title":"LTX Video 2.0 Pro Image-to-Video Request","type":"object","allOf":[{"$ref":"#/components/schemas/ltx-2-base"},{"properties":{"resolution":{"$ref":"#/components/schemas/ltx-2-resolution"},"duration":{"$ref":"#/components/schemas/ltx-2-pro-duration"},"fps":{"$ref":"#/components/schemas/ltx-2-fps"},"image_url":{"example":"https://example.com/image.jpg","format":"uri","description":"URL of the image to use as the first frame of the video.\nMust be publicly accessible.\n**Supported formats:** JPEG, PNG, WebP\n","type":"string"}},"type":"object"}]},"audio-setting":{"default":"auto","enum":["auto","origin"],"description":"Audio handling mode for the edited video:\n- `auto`: Automatically generate or adapt audio for the edited video\n- `origin`: Preserve the original audio from the input video\n","type":"string"},"quality":{"example":"4k","enum":["720p","1080p","2k","4k"],"description":"The quality of this video","type":"string"},"ltx-2-fast-i2v-request":{"required":["image_url","prompt"],"title":"LTX Video 2.0 Fast Image-to-Video Request","type":"object","allOf":[{"$ref":"#/components/schemas/ltx-2-base"},{"properties":{"resolution":{"$ref":"#/components/schemas/ltx-2-resolution"},"duration":{"$ref":"#/components/schemas/ltx-2-fast-duration"},"fps":{"$ref":"#/components/schemas/ltx-2-fps"},"image_url":{"example":"https://example.com/image.jpg","format":"uri","description":"URL of the image to use as the first frame of the video.\nMust be publicly accessible.\n**Supported formats:** JPEG, PNG, WebP\n","type":"string"}},"type":"object"}]},"t2v-request_1":{"required":["prompt"],"title":"Text to Video - Happy Horse 1.0","description":"Generate video from a text prompt using Happy Horse 1.0. Supports configurable aspect ratios (16:9, 9:16, 1:1, 4:3, 3:4), resolutions (720P, 1080P), and duration from 3 to 15 seconds.","type":"object","properties":{"seed":{"minimum":0,"example":12345,"description":"Random seed for reproducibility. Use the same seed with identical parameters to improve reproducibility (does not guarantee identical results). Leave unset for a random seed.","type":"integer","maximum":2147483647},"duration":{"$ref":"#/components/schemas/duration"},"prompt":{"minLength":1,"example":"A serene mountain landscape at golden hour with mist rising through the valley, cinematic slow camera pan","maxLength":2500,"type":"string","description":"Text prompt describing the desired video content. Describe the scene, characters, motion, camera movements, lighting, and style in detail for best results.\n\n**Tips:**\n- Be specific about scenes and visual details\n- Describe camera movements (zoom, pan, tilt)\n- Mention lighting and atmosphere\n"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"resolution":{"$ref":"#/components/schemas/resolution"},"aspect_ratio":{"$ref":"#/components/schemas/aspect-ratio"}}},"image-upscale-request-content":{"required":["image"],"properties":{"engine":{"default":"automatic","enum":["automatic","magnific_illusio","magnific_sharpy","magnific_sparkle"],"description":"Magnific model engines","type":"string"},"scale_factor":{"default":"2x","enum":["2x","4x","8x","16x"],"description":"Configure scale factor of the image. For higher scales, the image will take longer to process","type":"string"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"optimized_for":{"default":"standard","enum":["standard","soft_portraits","hard_portraits","art_n_illustration","videogame_assets","nature_n_landscapes","films_n_photography","3d_renders","science_fiction_n_horror"],"description":"Styles to optimize the upscale process","type":"string"},"creativity":{"default":0,"minimum":-10,"description":"Increase or decrease AI's creativity.\nValid values range `[-10, 10]`, default `0`.\n","type":"integer","maximum":10},"hdr":{"default":0,"minimum":-10,"description":"Increase or decrease the level of definition and detail.\nValid values range `[-10, 10]`, default `0`.\n","type":"integer","maximum":10},"resemblance":{"default":0,"minimum":-10,"description":"Adjust the level of resemblance to the original image.\nValid values range `[-10, 10]`, default `0`.\n","type":"integer","maximum":10},"fractality":{"default":0,"minimum":-10,"description":"Control the strength of the prompt and intricacy per square pixel.\nValid values range `[-10, 10]`, default `0`.\n","type":"integer","maximum":10},"image":{"format":"byte","description":"Base64 image to upscale\nThe resulted image can't exceed maximum allowed size of 25.3 million pixels.\n","type":"string"},"filter_nsfw":{"default":false,"description":"Controls **NSFW** (Not Safe For Work) content filtering on the upscaled image.\n\nWhen set to `true`, the output image will be scanned and filtered to prevent NSFW content from being returned.\n\nDefault is `false`.\n","type":"boolean"},"prompt":{"description":"Prompt to guide the upscale process. Reusing the same prompt for AI-generated images will improve the results","type":"string"}},"type":"object"},"icon_style":{"example":{"name":"Meticulous Yellow shadow","id":50},"required":["id","name"],"type":"object","properties":{"name":{"example":"Meticulous Yellow shadow","description":"Style name","type":"string"},"id":{"example":50,"description":"Style ID","type":"integer"}}},"ttifpv11-request-content":{"required":["prompt"],"properties":{"seed":{"description":"Optional seed for reproducibility. If not provided, a random seed will be used.","type":"integer","nullable":true},"safety_tolerance":{"default":2,"minimum":0,"description":"Tolerance level for input and output moderation. Between 0 and 6, 0 being most strict, 6 being least strict.","type":"integer","maximum":6},"prompt":{"description":"The prompt to use for image generation.","type":"string"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"output_format":{"description":"Format of the output image","enum":["jpeg","png"],"type":"string","nullable":true},"prompt_upsampling":{"default":false,"description":"Whether to perform upsampling on the prompt. If active, automatically modifies the prompt for more creative generation.","type":"boolean"},"aspect_ratio":{"default":"square_1_1","enum":["square_1_1","classic_4_3","traditional_3_4","widescreen_16_9","social_story_9_16","standard_3_2","portrait_2_3","horizontal_2_1","vertical_1_2","social_post_4_5"],"example":"square_1_1","description":"Image size with the aspect ratio. The aspect ratio is the proportional relationship between an image's width and height, expressed as *_width_height (e.g., square_1_1, widescreen_16_9). It is calculated by dividing the width by the height.\\\nIf not present, the default is `square_1_1`.\n","type":"string"}},"type":"object"},"advanced-custom-elements-reference-type":{"enum":["image_refer","video_refer"],"description":"Reference method for defining the element's appearance:\n- `image_refer`: Multi-Image Elements. The element appearance is defined from reference images (element_image_list). Supported formats: .jpg, .jpeg, .png. Max 10MB per image. Min 300px dimensions. Aspect ratio between 1:2.5 and 2.5:1.\n- `video_refer`: Video Character Elements. The element appearance is defined from a reference video (element_video_list). Only .mp4/.mov formats, 1080P, 3-8 seconds duration, 16:9 or 9:16 aspect ratio, max 200MB.\n","type":"string"},"upload-file-response":{"example":{"upload_url":"https://openapi-generator.tech","asset_url":"https://cdn-magnific.freepik.com/uploads/109580722/upl_img_a1b2c3?token=exp=1783147635~hmac=...","headers":{"Content-Type":"image/png","x-goog-content-length-range":"0,1073741824"},"asset_url_expires_in":86400,"file_id":"upl_a1b2c3d4e5f6","expires_in":120},"required":["asset_url","asset_url_expires_in","expires_in","file_id","headers","upload_url"],"type":"object","properties":{"upload_url":{"format":"uri","description":"Pre-signed URL for PUT upload. Send the raw file bytes including ALL the headers returned in 'headers'.","type":"string"},"asset_url":{"example":"https://cdn-magnific.freepik.com/uploads/109580722/upl_img_a1b2c3?token=exp=1783147635~hmac=...","format":"uri","description":"Readable URL for the uploaded file (image, video or audio), serving the original file. Valid once the PUT to upload_url completes. Use it as image_url/video_url/audio_url/reference in any endpoint that accepts a URL. Prefer file_id on AI endpoints when available.","type":"string"},"headers":{"example":{"Content-Type":"image/png","x-goog-content-length-range":"0,1073741824"},"description":"Headers that MUST be included in the PUT request (they are part of the URL signature).","type":"object","additionalProperties":{"type":"string"}},"asset_url_expires_in":{"example":86400,"description":"Seconds until asset_url expires (counted from this response, not from upload).","type":"integer"},"file_id":{"example":"upl_a1b2c3d4e5f6","description":"Opaque identifier of the uploaded file. Use this value in reference_images, image_url, video_url, or similar fields. It is NOT a URL and can only be used through the API by the same user that uploaded it.","type":"string"},"expires_in":{"example":120,"description":"Seconds until the upload_url expires","type":"integer"}}},"minimax-h3-max-request":{"required":["prompt"],"properties":{"enable_safety_checker":{"default":true,"description":"Enable content safety filtering to ensure generated videos comply with safety guidelines.","type":"boolean"},"duration":{"default":5,"minimum":5,"example":5,"description":"Video duration in seconds. Any integer from 5 to 15.","type":"integer","maximum":15},"prompt":{"minLength":1,"example":"A cinematic shot of a cat walking through a neon-lit alley at night","maxLength":50000,"type":"string","description":"Text prompt describing the video to generate."},"webhook_url":{"format":"uri","description":"URL to receive a webhook notification when the video generation task completes. The webhook payload includes the task ID and status.","type":"string"},"image_end":{"format":"byte","description":"Optional image to use as the last frame for image-to-video generation. Requires `image`: the provider rejects a last frame with no first frame. Accepts a publicly accessible URL or a base64-encoded image.","type":"string"},"image":{"format":"byte","description":"Optional image to use as the first frame for image-to-video generation. Its aspect ratio determines the aspect ratio of the output. Accepts a publicly accessible URL or a base64-encoded image.","type":"string"},"prompt_expansion_mode":{"default":"balanced","enum":["disabled","fast","balanced","quality"],"description":"Which prompt expander runs before the generation. `disabled` sends the prompt verbatim; `fast`, `balanced` and `quality` trade latency for richer prompt rewriting.","type":"string"},"seed":{"default":-1,"minimum":-1,"description":"Random seed for reproducible video generation. Use the same seed with the same prompt to get consistent results. Use `-1` for a random seed.","type":"integer","maximum":4294967295},"aspect_ratio":{"default":"widescreen_16_9","enum":["film_horizontal_21_9","widescreen_16_9","classic_4_3","square_1_1","traditional_3_4","social_story_9_16"],"description":"Output video aspect ratio. Available options:\n- `film_horizontal_21_9`: Ultra-wide cinematic (21:9)\n- `widescreen_16_9`: Standard widescreen (16:9)\n- `classic_4_3`: Classic TV format (4:3)\n- `square_1_1`: Square format (1:1)\n- `traditional_3_4`: Portrait classic (3:4)\n- `social_story_9_16`: Vertical/social media story (9:16)\n\n**Note:** only applies to text-to-video requests. When `image` is supplied the output follows the aspect ratio of that image.\n","type":"string"}},"type":"object"},"i2v-request_1":{"required":["image_url"],"title":"Image to Video - Happy Horse 1.0","description":"Animate a single image into video using Happy Horse 1.0. The image is used as the first frame; an optional text prompt guides motion and style.","type":"object","properties":{"seed":{"minimum":0,"example":12345,"description":"Random seed for reproducibility. Use the same seed with identical parameters to improve reproducibility (does not guarantee identical results). Leave unset for a random seed.","type":"integer","maximum":2147483647},"duration":{"$ref":"#/components/schemas/duration"},"prompt":{"example":"The character walks forward slowly with wind blowing through their hair","maxLength":2500,"type":"string","description":"Text prompt to guide the animation. Optional but recommended for better control over the generated video content."},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"image_url":{"example":"https://example.com/start-frame.jpg","format":"uri","description":"URL of the image to use as the first frame for image-to-video generation.\n\n**Supported formats:** JPEG, JPG, PNG, BMP, WEBP\n**Pixel dimensions:** at least 300px (width and height)\n**Aspect ratio:** between 1:2.5 and 2.5:1\n**Maximum file size:** 10 MB\n","type":"string"},"resolution":{"$ref":"#/components/schemas/resolution"}}},"aspect-ratio_2":{"example":"969","enum":["4:3","16:9","256:135","9:16","1:1"],"description":"The aspect ratio of this item","type":"string"},"team-api-key":{"example":{"created_at":"2026-01-15T10:30:00Z","display_name":"Production Backend","api_key_id":"fpk-abc123def456","status":"active"},"properties":{"api_key_id":{"example":"fpk-abc123def456","description":"API key identifier. Use in `api_key_ids` filter of team-credit-usage.","type":"string"},"display_name":{"example":"Production Backend","description":"User-defined name for this API key.","type":"string"},"created_at":{"example":"2026-01-15T10:30:00Z","format":"date-time","description":"When the API key was created.","type":"string"},"status":{"example":"active","enum":["active","inactive"],"description":"API key status.","type":"string"}},"type":"object"},"tracking_code":{"example":"sph","description":"Search tracking code","type":"string","nullable":true},"search_resources_filters_parameter_ai_generated":{"properties":{"excluded":{"default":0,"description":"Excludes AI-generated images from the results. Set to 1 to exclude, 0 to include.","type":"number"},"only":{"default":0,"description":"Filters results to only include AI-generated images. Set to 1 to include only AI-generated images, 0 to include all images.","type":"number"}},"type":"object"},"r2v-request_1":{"required":["image_urls","prompt"],"title":"Reference to Video - Happy Horse 1.0","description":"Generate video guided by 1 to 9 reference images that define characters, objects or scenes using Happy Horse 1.0. In the prompt, reference each image by its 1-based positional index (`character1`, `character2`, ...). The order matches the array order.\n","type":"object","properties":{"image_urls":{"maxItems":9,"items":{"$ref":"#/components/schemas/reference-image"},"minItems":1,"description":"Ordered array of reference images. Array position determines the character reference number in the prompt (1st item → `character1`, 2nd → `character2`, etc.).\n\n**Supported formats:** JPEG, JPG, PNG, WEBP\n**Recommended resolution:** shortest side at least 400 px (720P or higher recommended)\n**Maximum file size:** 10 MB per image\n","type":"array"},"seed":{"minimum":0,"example":12345,"description":"Random seed for reproducibility. Use the same seed with identical parameters to improve reproducibility (does not guarantee identical results). Leave unset for a random seed.","type":"integer","maximum":2147483647},"duration":{"default":5,"minimum":3,"example":5,"description":"Duration of the generated video in seconds.","type":"integer","maximum":15},"prompt":{"minLength":1,"example":"character1 and character2 walk together through a sunlit forest path","maxLength":5000,"type":"string","description":"Text prompt describing the desired elements and visual style of the generated video. Supports any language. Requests with prompts longer than 5000 characters are rejected by validation; the upstream provider further treats 5000 non-Chinese characters or 2500 Chinese characters as the effective ceiling.\n\nUse `character1`, `character2`, ... in the prompt to reference the corresponding image in the `image_urls` array; the order matches the array order.\n\n**Example:** \"character1 and character2 walk together through a sunlit forest path\"\n"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"resolution":{"$ref":"#/components/schemas/resolution"},"watermark":{"default":false,"example":false,"type":"boolean","description":"Whether to add a watermark to the generated video. The watermark appears in the bottom-right corner with the fixed text \"Happy Horse\"."},"aspect_ratio":{"$ref":"#/components/schemas/aspect-ratio"}}},"seedance-2-mini-request":{"required":["prompt"],"properties":{"reference_images":{"maxItems":9,"items":{"type":"string","format":"byte"},"example":["https://example.com/reference-1.jpg","https://example.com/reference-2.jpg"],"description":"Up to 9 reference images for reference-to-video generation. Each item is a publicly accessible URL or a base64-encoded image. Reference them in the prompt using @Image1, @Image2, ... @Image9 (1-indexed to the array order). Mutually exclusive with `image` and `image_end`.","type":"array"},"duration":{"default":5,"enum":[4,5,6,7,8,9,10,11,12,13,14,15],"description":"Video duration in seconds. Any integer from 4 to 15.","type":"integer"},"prompt":{"example":"A cinematic shot of a cat walking through a neon-lit alley at night","maxLength":40000,"type":"string","description":"Text prompt describing the video to generate. Mention references as @Image1, @Image2, ... @Video1, @Video2, ... or @Audio1, @Audio2, ... matching their 1-indexed array order. Maximum 40000 characters. Prompts longer than 5,000 characters are accepted, but results may become less predictable."},"webhook_url":{"format":"uri","description":"URL to receive a webhook notification when the video generation task completes. The webhook payload includes the task ID and status.","type":"string"},"no_music":{"default":false,"description":"Suppress background music in the generated native audio. Only applies when `sound_effects` is enabled.","type":"boolean"},"reference_audios":{"maxItems":3,"items":{"type":"string"},"example":["https://example.com/reference-voice.mp3"],"description":"Up to 3 reference audios, to guide the generated soundtrack with a voice, a piece of music or an ambience. Each item must be a publicly accessible HTTPS URL — unlike `reference_images` and `reference_videos`, this field does not take upload file_ids. Reference them in the prompt using @Audio1, @Audio2, or @Audio3.\n\n**The audio is not copied into the video.** The model composes its own soundtrack, guided by the rhythm and character of what you send: a 120 BPM reference produces a soundtrack at that tempo, but it is a new recording, not your file muxed into the result. A reference with a clear beat, music or speech gives the model something to follow; a flat tone or near-silence does not.\n\nRequirements for each item: MP3 or WAV, 2 to 15 seconds, no larger than 15 MB, and the combined duration of all of them must not exceed 15 seconds.\n\nRequires at least one `reference_images` or `reference_videos` entry — the model rejects a request whose only reference is audio. Mutually exclusive with `image` and `image_end`.\n","type":"array"},"image_end":{"format":"byte","description":"Optional image to use as the last frame for image-to-video generation. Requires `image`: the provider rejects a last frame with no first frame. Together they generate a transition video between the two. Mutually exclusive with `reference_images`, `reference_videos` and `reference_audios`. Accepts a publicly accessible URL or a base64-encoded image.","type":"string"},"sound_effects":{"default":true,"description":"Whether to generate native audio (sound effects and ambience) for the video. Set to `false` to generate a silent video. Ignored when `reference_audios` are attached: the reference audio is what the soundtrack is built from.","type":"boolean"},"image":{"format":"byte","description":"Optional image to use as the first frame for image-to-video generation. Accepts a publicly accessible URL or a base64-encoded image. Mutually exclusive with `reference_images`, `reference_videos` and `reference_audios`.","type":"string"},"reference_videos":{"maxItems":3,"items":{"type":"string"},"example":["https://example.com/reference-1.mp4"],"description":"Up to 3 reference videos. Each item must be a publicly accessible HTTPS URL or a video upload file_id (`upl_vid_...`). Reference them in the prompt using @Video1, @Video2, or @Video3. Each video must be MP4 or MOV, 2 to 15 seconds, 24 to 60 fps, no larger than 50 MB, with 409600 to 2086876 pixels and an aspect ratio from 0.4 to 2.5. Combined duration must not exceed 15 seconds. Mutually exclusive with `image` and `image_end`.","type":"array"},"camera_fixed":{"default":false,"description":"When set to `true`, the camera position stays fixed (tripod shot) throughout the video. When `false`, the model may apply natural camera movements.","type":"boolean"},"seed":{"default":-1,"minimum":-1,"description":"Random seed for reproducible video generation. Use the same seed with the same prompt to get consistent results. Use `-1` for a random seed.","type":"integer","maximum":4294967295},"aspect_ratio":{"default":"widescreen_16_9","enum":["film_horizontal_21_9","widescreen_16_9","classic_4_3","square_1_1","traditional_3_4","social_story_9_16","film_vertical_9_21"],"description":"Output video aspect ratio. Available options:\n- `film_horizontal_21_9`: Ultra-wide cinematic (21:9)\n- `widescreen_16_9`: Standard widescreen (16:9)\n- `classic_4_3`: Classic TV format (4:3)\n- `square_1_1`: Square format (1:1)\n- `traditional_3_4`: Portrait classic (3:4)\n- `social_story_9_16`: Vertical/social media story (9:16)\n- `film_vertical_9_21`: Ultra-tall vertical (9:21)\n\n**Note:** This parameter only applies to text-to-video and reference-to-video requests. When an `image` (first frame) is provided for image-to-video generation, `aspect_ratio` is ignored: the output video inherits the aspect ratio of the start frame.\n","type":"string"}},"type":"object"},"vfx-request":{"required":["video"],"properties":{"motion_filter_kernel_size":{"example":5,"description":"Kernel size for motion blur filter. Only applicable when filter_type is 2 (motion_blur).","type":"integer"},"filter_type":{"$ref":"#/components/schemas/filter-type"},"motion_filter_decay_factor":{"example":0.8,"description":"Decay factor for motion blur filter. Only applicable when filter_type is 2 (motion_blur).","type":"number"},"webhook_url":{"format":"uri","description":"Webhook URL to notify when the task is completed","type":"string"},"bloom_filter_contrast":{"example":1.2,"description":"Contrast value for bloom filter effect. Only applicable when filter_type is 7 (bloom).","type":"number"},"fps":{"default":24,"minimum":1,"description":"Frames per second for the output video","type":"integer","maximum":60},"video":{"example":"https://example.com/video.mp4","format":"uri","description":"URL of the video to apply effects to. Must be publicly accessible.","type":"string"}},"type":"object"},"search_resources_filters_parameter_vector":{"properties":{"type":{"enum":["jpg","ai","eps","svg"],"description":"File type for vectors","type":"string"},"style":{"enum":["watercolor","flat","cartoon","geometric","gradient","isometric","3d","hand-drawn"],"description":"Style type for vectors, ignored if content_type exists and it is not vector","type":"string"}},"type":"object"},"aspect_ratio":{"default":"square_1_1","enum":["square_1_1","classic_4_3","traditional_3_4","widescreen_16_9","social_story_9_16","smartphone_horizontal_20_9","smartphone_vertical_9_20","standard_3_2","portrait_2_3","horizontal_2_1","vertical_1_2","social_5_4","social_post_4_5"],"example":"square_1_1","description":"Image size with the aspect ratio. The aspect ratio is the proportional relationship between an image's width and height, expressed as *_width_height (e.g., square_1_1, widescreen_16_9). It is calculated by dividing the width by the height.\\\nIf not present, the default is `square_1_1`.\nNote: For the `fluid` model, only this values are valid:\n* square_1_1\n* social_story_9_16\n* widescreen_16_9\n* traditional_3_4\n* classic_4_3\n","type":"string"},"pagination":{"example":{"last_page":1,"per_page":1,"total":1,"current_page":1},"properties":{"last_page":{"example":1,"description":"The total number of pages.","type":"integer"},"per_page":{"example":1,"description":"The limit of resources per page.","type":"integer"},"current_page":{"example":1,"description":"The current page.","type":"integer"},"total":{"example":1,"description":"The total number of resources.","type":"integer"}},"type":"object","description":"Metainformation about pagination"},"detail_photo":{"allOf":[{"$ref":"#/components/schemas/detail_resource"},{"required":["available_formats","dimensions","related_resources","related_tags","type"],"properties":{"available_formats":{"$ref":"#/components/schemas/photo_available_formats"},"related_resources":{"$ref":"#/components/schemas/photo_related"},"related_tags":{"type":"array","items":{"$ref":"#/components/schemas/tag_2"}},"type":{"example":"photo","enum":["photo"],"type":"string"},"dimensions":{"$ref":"#/components/schemas/dimensions"}},"type":"object","description":"Photo details."}]},"ttifd-request-content":{"properties":{"seed":{"minimum":1,"description":"Seed for the image generation. If not provided, a random seed will be used.","type":"integer","maximum":4294967295},"styling":{"$ref":"#/components/schemas/ttifd_request_content_styling"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"prompt":{"description":"The prompt is a short text that describes the image you want to generate. It can range from simple descriptions, like `\"a cat\"`, to detailed scenarios, such as `\"a cat with wings, playing the guitar, and wearing a hat\"`. If no prompt is provided, the AI will generate a random image.\n","type":"string"},"aspect_ratio":{"default":"square_1_1","enum":["square_1_1","classic_4_3","traditional_3_4","widescreen_16_9","social_story_9_16","standard_3_2","portrait_2_3","horizontal_2_1","vertical_1_2","social_post_4_5"],"example":"square_1_1","description":"Image size with the aspect ratio. The aspect ratio is the proportional relationship between an image's width and height, expressed as *_width_height (e.g., square_1_1, widescreen_16_9). It is calculated by dividing the width by the height.\\\nIf not present, the default is `square_1_1`.\n","type":"string"}},"type":"object"},"dimensions":{"required":["height","width"],"example":{"width":2000,"height":3000},"properties":{"width":{"example":2000,"minimum":0,"type":"integer","description":"Width of the resource image in pixels."},"height":{"example":3000,"minimum":0,"type":"integer","description":"Height of the resource image in pixels."}},"type":"object","description":"Resource's dimensions."},"aspect-ratio_6":{"default":"16:9","enum":["16:9","9:16"],"description":"Aspect ratio of the generated video. 16:9 for landscape, 9:16 for portrait.","type":"string"},"wan-3-0-request":{"required":["prompt"],"title":"Wan 3.0 Video Request","description":"Wan 3.0, Alibaba's unified video model. One request covers text-to-video,\nfirst/last frame image-to-video and reference-guided generation from\nimages, videos and audios. The mode follows from the fields you send.\n\nReferences (`image_urls`, `video_urls`, `audio_urls`) and keyframes\n(`start_image_url`, `end_image_url`) are mutually exclusive: a request\nthat mixes them is rejected.\n\n**Reference videos are billed.** The provider charges this model as the\noutput duration PLUS the combined duration of the reference videos,\ncapped at 15 seconds, and that is what the API charges. Reference images\nand audios add nothing to the price.\n","type":"object","properties":{"image_urls":{"description":"Up to 10 reference images for characters, objects, scenes or style.\nEach item is a public HTTPS URL, a base64-encoded image or an upload\nid (`upl_...`). JPEG, PNG (no alpha channel), BMP or WEBP, at most\n20 MB, 240 to 8000 px per side, aspect ratio up to 8:1. Mutually\nexclusive with `start_image_url` and `end_image_url`.\n","maxItems":10,"type":"array","items":{"type":"string"}},"start_image_url":{"example":"https://example.com/start-frame.jpg","description":"Optional first frame of the video. A public HTTPS URL, a base64-encoded\nimage or an upload id (`upl_...`). When supplied, the output follows\nthe aspect ratio of this image and `aspect_ratio` is ignored. JPEG,\nPNG (no alpha channel), BMP or WEBP, at most 20 MB, 240 to 8000 px\nper side. Mutually exclusive with every reference field.\n","type":"string"},"prompt":{"minLength":1,"example":"Image 1 walks along a beach at sunset while the waves roll in, saying 'What a day'","maxLength":20000,"type":"string","description":"Text description of the video to generate, including action and\ndialogue. Chinese and English are supported. Refer to references by\ntheir position in each list: \"Image 1\" is the first item of\n`image_urls`, \"Video 1\" the first item of `video_urls`, \"Audio 1\" the\nfirst item of `audio_urls`.\n"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"video_urls":{"description":"Up to 5 reference videos for motion, appearance or voice. Each item is\na public HTTPS URL or a video upload id (`upl_vid_...`). MP4 or MOV,\n1 to 15 seconds each and at most 15 seconds combined, at most 100 MB,\n240 to 4096 px per side, aspect ratio up to 8:1. The combined\nduration plus `duration` must not exceed 30 seconds. Mutually\nexclusive with `start_image_url` and `end_image_url`.\n\n**These are billed**: their combined duration is added to the output\nduration, capped at 15 seconds.\n","maxItems":5,"type":"array","items":{"type":"string"}},"seed":{"minimum":0,"example":12345,"description":"Random seed for reproducible generation. Fixing it improves reproducibility but does not guarantee identical results.","type":"integer","maximum":2147483647},"end_image_url":{"example":"https://example.com/end-frame.jpg","description":"Optional last frame of the video. Requires `start_image_url`: the\nprovider rejects a last frame with no first frame. Same formats and limits as\n`start_image_url`. Mutually exclusive with every reference field.\n","type":"string"},"audio_urls":{"description":"Up to 5 reference audios for voice timbre or soundtrack. Each item is\na public HTTPS URL. WAV or MP3, 1 to 15 seconds each and at most 15\nseconds combined, at most 15 MB. Mutually exclusive with\n`start_image_url` and `end_image_url`. Adds nothing to the price.\n","maxItems":5,"type":"array","items":{"type":"string","format":"uri"}},"resolution":{"default":"1080P","enum":["480P","720P","1080P"],"description":"Output video resolution. It sets the price per second. The value is the\nshort side of the MP4; the long side follows the aspect ratio.\n- `480P`: 480p SD (854x480 at 16:9)\n- `720P`: 720p HD\n- `1080P`: 1080p Full HD\n","type":"string"},"generate_audio":{"default":true,"example":true,"type":"boolean","description":"Whether to generate a synchronized audio track (dialogue, sound effects, music) with the video. It does not affect the price."},"duration":{"default":5,"minimum":2,"example":5,"description":"Duration of the output video in seconds. It sets the price together with `resolution`.","type":"integer","maximum":30},"aspect_ratio":{"default":"16:9","enum":["16:9","9:16","1:1","4:3","3:4"],"description":"Output video aspect ratio. Defaults to `16:9` when not specified.\nIgnored when `start_image_url` is supplied: the output then follows the\naspect ratio of that image.\n- `16:9`: Landscape (widescreen)\n- `9:16`: Portrait (vertical, mobile-optimized)\n- `1:1`: Square\n- `4:3`: Standard landscape\n- `3:4`: Standard portrait\n","type":"string"}}},"search_resources_filters_parameter_psd":{"properties":{"type":{"enum":["jpg","psd"],"description":"File type for psd","type":"string"}},"type":"object"},"download_b2b":{"example":{"filename":"blackboard-template.zip","url":"https://downloadscdn5.freepik.com/d/1137445/blackboard-template.zip"},"required":["filename","url"],"type":"object","properties":{"filename":{"example":"blackboard-template.zip","description":"Filename of the resource","type":"string","minLength":1},"url":{"example":"https://downloadscdn5.freepik.com/d/1137445/blackboard-template.zip","format":"uri","type":"string","minLength":1}}},"search_resources_filters_parameter":{"properties":{"content_type":{"$ref":"#/components/schemas/search_resources_filters_parameter_content_type"},"orientation":{"$ref":"#/components/schemas/search_resources_filters_parameter_orientation"},"color":{"enum":["black","blue","gray","green","orange","red","white","yellow","purple","cyan","pink"],"description":"Filters results by the predominant color in the resources.","type":"string"},"people":{"$ref":"#/components/schemas/search_resources_filters_parameter_people"},"ids":{"example":"1,2,3,4,5","description":"Filter by list of ids. This filter is incompatible with any other filters. In case of using this filter, the rest of filters will be ignored.","type":"string"},"vector":{"$ref":"#/components/schemas/search_resources_filters_parameter_vector"},"author":{"default":0,"description":"Filters results to include resources by a specific author, identified by their author ID.","type":"number"},"license":{"$ref":"#/components/schemas/search_resources_filters_parameter_license"},"psd":{"$ref":"#/components/schemas/search_resources_filters_parameter_psd"},"ai-generated":{"$ref":"#/components/schemas/search_resources_filters_parameter_ai_generated"},"period":{"enum":["last-month","last-quarter","last-semester","last-year"],"description":"Filters results based on the time period in which the resources were added.","type":"string"}},"type":"object"},"video-edit-request_1":{"required":["prompt","video_url"],"title":"Video Edit - Happy Horse 1.0","description":"Edit an existing video using natural-language instructions with Happy Horse 1.0, optionally guided by up to 5 reference images. Reference images from the prompt using `@Image1`..`@Image5` tokens (1-based, in array order). Output is capped at 15 seconds.\n","type":"object","properties":{"video_url":{"example":"https://example.com/input-video.mp4","format":"uri","description":"URL of the source video to be edited.\n\n**Supported formats:** MP4, MOV with H.264 codec\n**Duration:** between 3 and 60 seconds (the output is capped at 15 seconds)\n**Frame rate:** greater than 8 fps\n**Dimensions:** longer side at most 2160 px and shorter side at least 320 px\n**Aspect ratio:** between 1:2.5 and 2.5:1\n**Maximum file size:** 100 MB\n","type":"string"},"image_urls":{"maxItems":5,"items":{"type":"string","format":"uri"},"example":["https://example.com/reference1.jpg"],"description":"Up to 5 reference images that guide the edit. Reference them from the prompt using `@Image1`..`@Image5` (1-based, in array order).\n\n**Supported formats:** JPEG, JPG, PNG, WEBP\n**Minimum dimension:** 300 px\n**Aspect ratio:** between 1:2.5 and 2.5:1\n**Maximum file size:** 10 MB per image\n","type":"array"},"prompt":{"minLength":1,"example":"Replace the background with a futuristic cityscape at night","maxLength":2500,"type":"string","description":"Text prompt describing the desired editing instructions. To reference an image from `image_urls` inside the prompt, use the tokens `@Image1`..`@Image5` (1-based, matching the array order).\n\n**Example:** \"Replace the background with a futuristic cityscape at night\"\n"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"resolution":{"$ref":"#/components/schemas/resolution"},"audio_setting":{"$ref":"#/components/schemas/audio-setting_1"},"seed":{"minimum":0,"example":12345,"description":"Random seed for reproducibility. Use the same seed with identical parameters to improve reproducibility (does not guarantee identical results). Leave unset for a random seed.","type":"integer","maximum":2147483647}}},"task-detail":{"example":{"generated":["https://openapi-generator.tech","https://openapi-generator.tech"],"task_id":"046b6c7f-0b8a-43b9-b35d-6489e6daee91","status":"CREATED"},"allOf":[{"$ref":"#/components/schemas/task"},{"required":["generated"],"properties":{"generated":{"type":"array","items":{"format":"uri","description":"URL of the generated image","type":"string"}}},"type":"object"}]},"detail_ai":{"allOf":[{"$ref":"#/components/schemas/detail_resource"},{"required":["available_formats","dimensions","model_subtype","model_type","related_resources","related_tags","type"],"properties":{"available_formats":{"$ref":"#/components/schemas/photo_available_formats"},"model_type":{"example":"Dall-E","type":"string","nullable":true},"related_resources":{"$ref":"#/components/schemas/ai_related"},"model_subtype":{"example":"niji","type":"string","nullable":true},"type":{"example":"photo","enum":["photo"],"type":"string"},"related_tags":{"type":"array","items":{"$ref":"#/components/schemas/tag_2"}},"dimensions":{"$ref":"#/components/schemas/dimensions"}},"type":"object","description":"AI photo details."}]},"flavor":{"enum":["sublime","photo","photo_denoiser"],"description":"Image processing flavor that determines the upscaling style and optimization for different image types:\n- `sublime`: Optimized for artistic and illustrated images with smooth gradients and vibrant colors\n- `photo`: Optimized for photographic images, preserving natural colors and realistic details\n- `photo_denoiser`: Specialized for photos with noise reduction, ideal for low-light or grainy photographs\n","type":"string"},"filter-type":{"default":1,"enum":[1,2,3,4,5,6,7,8],"example":1,"description":"Type of visual effect filter to apply to the video.\n\n**Available filters:**\n- `1`: Film grain - Adds cinematic grain texture\n- `2`: Motion blur - Creates motion blur effect\n- `3`: Fish eye - Applies fish eye lens distortion\n- `4`: VHS - Retro VHS tape effect\n- `5`: Shake - Camera shake effect\n- `6`: VGA - Low resolution VGA effect\n- `7`: Bloom - Glowing bloom effect (use bloom_filter_contrast to adjust)\n- `8`: Anamorphic lens - Cinematic anamorphic lens effect\n","type":"integer"},"relight-request-advanced-settings":{"properties":{"engine":{"default":"automatic","enum":["automatic","balanced","cool","real","illusio","fairy","colorful_anime","hard_transform","softy"],"description":"Balanced: Well-rounded, general-purpose option.\nCool: Brighter with cooler tones.\nReal: Aims to enhance photographic quality. Experimental.\nIllusio: Optimized for illustrations and drawings.\nFairy: Suited for fantasy-themed images.\nColorful Anime: Ideal for anime, cartoons, and vibrant colors.\nHard Transform: Significantly alters the original image.\nSofty: Slightly softer effect, suitable for graphic designs.\n","type":"string"},"fixed_generation":{"default":false,"description":"When this option is enabled, using the same settings will consistently produce the same image. Fixed generations are ideal for fine-tuning, as it allows for incremental changes to parameters (such as the prompt) to see subtle variations in the output. When disabled, expect each generation to introduce a degree of randomness, leading to more diverse outcomes.\n","type":"boolean"},"whites":{"default":50,"minimum":0,"description":"Adjust the level of white color in the image.\nValid values range `[0, 100]`, default `50`.\n","type":"integer","maximum":100},"blacks":{"default":50,"minimum":0,"description":"Adjust the level of black color in the image.\nValid values range `[0, 100]`, default `50`.\n","type":"integer","maximum":100},"brightness":{"default":50,"minimum":0,"description":"Adjust the level of brightness in the image.\nValid values range `[0, 100]`, default `50`.\n","type":"integer","maximum":100},"contrast":{"default":50,"minimum":0,"description":"Adjust the level of contrast in the image.\nValid values range `[0, 100]`, default `50`.\n","type":"integer","maximum":100},"saturation":{"default":50,"minimum":0,"description":"Adjust the level of saturation in the image.\nValid values range `[0, 100]`, default `50`.\n","type":"integer","maximum":100},"transfer_light_a":{"default":"automatic","enum":["automatic","low","medium","normal","high","high_on_faces"],"description":"Adjusts the intensity of light transfer. Advanced feature requiring practice to use effectively.","type":"string"},"transfer_light_b":{"default":"automatic","enum":["automatic","composition","straight","smooth_in","smooth_out","smooth_both","reverse_both","soft_in","soft_out","soft_mid","strong_mid","style_shift","strong_shift"],"description":"Also modifies light transfer intensity. Can be combined with the previous control for varied effects. Complex to master but offers more control","type":"string"}},"type":"object"},"minimax-live-i2v-request":{"required":["image_url","prompt"],"properties":{"webhook_url":{"format":"uri","description":"Webhook URL to notify when the task is completed","type":"string"},"prompt_optimizer":{"default":true,"description":"Enable automatic prompt enhancement for better video generation results","type":"boolean"},"image_url":{"example":"https://example.com/illustration.jpg","format":"uri","description":"URL of the source image to animate. Works best with illustrations and artwork.","type":"string"},"prompt":{"example":"The illustration comes to life with gentle movements [Static shot]","maxLength":2000,"type":"string","description":"Text description of the video motion to generate.\nSupports camera movements in square brackets:\n- [Truck left], [Truck right]: Camera moves horizontally\n- [Pan left], [Pan right]: Camera rotates horizontally\n- [Push in], [Pull out]: Camera moves closer/further\n- [Pedestal up], [Pedestal down]: Camera moves vertically\n- [Tilt up], [Tilt down]: Camera tilts\n- [Zoom in], [Zoom out]: Lens zoom\n- [Shake]: Camera shake effect\n- [Tracking shot]: Camera follows subject\n- [Static shot]: No camera movement\n"}},"type":"object"},"thinking-type":{"default":"enabled","enum":["enabled","disabled","auto"],"description":"Prompt reasoning enhancement mode. Controls how PixVerse-V5.5 optimizes the input prompt before generation.\n * `enabled` - The model rewrites the prompt automatically for better results.\n * `disabled` - The prompt is used exactly as written, with no rewriting.\n * `auto` - The model decides whether to rewrite the prompt based on the input.\n","type":"string"},"audio-setting_1":{"default":"auto","enum":["auto","origin"],"description":"Audio handling mode for the edited video:\n- `auto`: The model decides whether to regenerate audio based on the prompt — if the prompt involves audio descriptions, audio may be regenerated; otherwise the original audio is preserved\n- `origin`: Force-preserve the input video's original audio without regeneration\n","type":"string"},"request_5":{"required":["end_image_url","first_image_url","prompt"],"properties":{"style":{"$ref":"#/components/schemas/style-enum"},"generate_audio_switch":{"default":false,"description":"When set to true, PixVerse-V5.5 generates synchronized audio (background music, sound effects, or dialogue) together with the video.","type":"boolean"},"duration":{"default":5,"enum":[5,8,10],"description":"The duration of the generated video in seconds. 8s videos cost double. 10s videos are only available up to 720p. 1080p videos are limited to 5 or 8 seconds.","type":"integer"},"prompt":{"description":"Prompt describing the video transition to generate","type":"string"},"end_image_url":{"format":"uri","description":"URL of the image to use as the last frame","type":"string"},"thinking_type":{"$ref":"#/components/schemas/thinking-type"},"first_image_url":{"format":"uri","description":"URL of the image to use as the first frame","type":"string"},"seed":{"description":"The same seed and the same prompt given to the same version of the model will output the same video every time","type":"integer"},"negative_prompt":{"default":"","description":"Negative prompt to be used for the generation","type":"string"},"aspect_ratio":{"$ref":"#/components/schemas/aspect-ratio_3"},"resolution":{"$ref":"#/components/schemas/resolution_4"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"camera_movement":{"$ref":"#/components/schemas/camera-movement"}},"type":"object"},"t2v-request_2":{"required":["prompt"],"title":"Text to Video - Happy Horse 1.1","description":"Generate video from a text prompt using Happy Horse 1.1. Supports 9 aspect ratios (16:9, 9:16, 1:1, 4:3, 3:4, 21:9, 9:21, 5:4, 4:5), resolutions (720P, 1080P), and duration from 3 to 15 seconds.","type":"object","properties":{"seed":{"minimum":0,"example":12345,"description":"Random seed for reproducibility. Use the same seed with identical parameters to improve reproducibility (does not guarantee identical results). Leave unset for a random seed.","type":"integer","maximum":2147483647},"duration":{"$ref":"#/components/schemas/duration"},"prompt":{"minLength":1,"example":"A serene mountain landscape at golden hour with mist rising through the valley, cinematic slow camera pan","maxLength":2500,"type":"string","description":"Text prompt describing the desired video content. Describe the scene, characters, motion, camera movements, lighting, and style in detail for best results.\n\n**Tips:**\n- Be specific about scenes and visual details\n- Describe camera movements (zoom, pan, tilt)\n- Mention lighting and atmosphere\n"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"resolution":{"$ref":"#/components/schemas/resolution"},"aspect_ratio":{"$ref":"#/components/schemas/aspect-ratio_1"}}},"request_6":{"required":["image_url","prompt"],"properties":{"style":{"$ref":"#/components/schemas/style-enum"},"generate_audio_switch":{"default":false,"description":"When set to `true`, PixVerse-V6 generates synchronized audio (background music, sound effects, or dialogue) together with the video.","type":"boolean"},"duration":{"default":5,"minimum":1,"description":"Duration of the generated video in seconds. PixVerse-V6 accepts any\ninteger value from `1` to `15` (PixVerse-V5.5 only accepted `5`, `8`\nor `10`).\n","type":"integer","maximum":15},"prompt":{"description":"Prompt describing the video to generate.","type":"string"},"resolution":{"$ref":"#/components/schemas/resolution_4"},"thinking_type":{"$ref":"#/components/schemas/thinking-type"},"image_url":{"format":"uri","description":"URL of the image to use as the first frame.","type":"string"},"seed":{"description":"The same seed and the same prompt given to the same version of the model will output the same video every time.","type":"integer"},"negative_prompt":{"default":"","description":"Negative prompt to be used for the generation.","type":"string"},"aspect_ratio":{"$ref":"#/components/schemas/aspect-ratio_3"},"generate_multi_clip_switch":{"default":false,"description":"When set to `true`, PixVerse-V6 produces multi-clip output with dynamic camera changes within a single generation.","type":"boolean"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"last_frame_image":{"format":"uri","description":"Optional URL of the image to use as the last frame. When provided,\nPixVerse-V6 generates a transition between `image_url` (first frame)\nand `last_frame_image` (last frame) within the same endpoint.\n","type":"string"},"camera_movement":{"$ref":"#/components/schemas/camera-movement"}},"type":"object"},"request_11":{"required":["image"],"properties":{"webhook_url":{"example":"https://example.com/webhook","format":"uri","description":"Webhook URL to notify the user when the task is completed","type":"string"},"image":{"example":"https://example.com/image.jpg","description":"Input image for prompt generation. Can be base64-encoded string or URL.","type":"string"}},"type":"object"},"seedance-2-request":{"required":["prompt"],"properties":{"reference_images":{"maxItems":9,"items":{"type":"string","format":"byte"},"example":["https://example.com/reference-1.jpg","https://example.com/reference-2.jpg"],"description":"Up to 9 reference images for reference-to-video generation. Each item is a publicly accessible URL or a base64-encoded image. Reference them in the prompt using @Image1, @Image2, ... @Image9 (1-indexed to the array order). Mutually exclusive with `image` and `image_end`.","type":"array"},"duration":{"default":5,"enum":[4,5,6,7,8,9,10,11,12,13,14,15],"description":"Video duration in seconds. Any integer from 4 to 15.","type":"integer"},"prompt":{"example":"A cinematic shot of a cat walking through a neon-lit alley at night","maxLength":40000,"type":"string","description":"Text prompt describing the video to generate. Mention references as @Image1, @Image2, ... @Video1, @Video2, ... or @Audio1, @Audio2, ... matching their 1-indexed array order. Maximum 40000 characters. Prompts longer than 5,000 characters are accepted, but results may become less predictable."},"webhook_url":{"format":"uri","description":"URL to receive a webhook notification when the video generation task completes. The webhook payload includes the task ID and status.","type":"string"},"no_music":{"default":false,"description":"Suppress background music in the generated native audio. Only applies when `sound_effects` is enabled.","type":"boolean"},"reference_audios":{"maxItems":3,"items":{"type":"string"},"example":["https://example.com/reference-voice.mp3"],"description":"Up to 3 reference audios, to guide the generated soundtrack with a voice, a piece of music or an ambience. Each item must be a publicly accessible HTTPS URL — unlike `reference_images` and `reference_videos`, this field does not take upload file_ids. Reference them in the prompt using @Audio1, @Audio2, or @Audio3.\n\n**The audio is not copied into the video.** The model composes its own soundtrack, guided by the rhythm and character of what you send: a 120 BPM reference produces a soundtrack at that tempo, but it is a new recording, not your file muxed into the result. A reference with a clear beat, music or speech gives the model something to follow; a flat tone or near-silence does not.\n\nRequirements for each item: MP3 or WAV, 2 to 15 seconds, no larger than 15 MB, and the combined duration of all of them must not exceed 15 seconds.\n\nRequires at least one `reference_images` or `reference_videos` entry — the model rejects a request whose only reference is audio. Mutually exclusive with `image` and `image_end`.\n","type":"array"},"enable_safety_checker":{"default":true,"description":"Enable content safety filtering to ensure generated videos comply with safety guidelines. When `true`, the model filters unsafe content.","type":"boolean"},"image_end":{"format":"byte","description":"Optional image to use as the last frame for image-to-video generation. Requires `image`: the provider rejects a last frame with no first frame. Together they generate a transition video between the two. Mutually exclusive with `reference_images`, `reference_videos` and `reference_audios`. Accepts a publicly accessible URL or a base64-encoded image.","type":"string"},"camera_fixed":{"default":false,"description":"When set to `true`, the camera position stays fixed (tripod shot) throughout the video. When `false`, the model may apply natural camera movements.","type":"boolean"},"image":{"format":"byte","description":"Optional image to use as the first frame for image-to-video generation. Accepts a publicly accessible URL or a base64-encoded image. Mutually exclusive with `reference_images`, `reference_videos` and `reference_audios`.","type":"string"},"reference_videos":{"maxItems":3,"items":{"type":"string"},"example":["https://example.com/reference-1.mp4"],"description":"Up to 3 reference videos. Each item must be a publicly accessible HTTPS URL or a video upload file_id (`upl_vid_...`). Reference them in the prompt using @Video1, @Video2, or @Video3. Each video must be MP4 or MOV, 2 to 15 seconds, 24 to 60 fps, no larger than 50 MB, with 409600 to 2086876 pixels and an aspect ratio from 0.4 to 2.5. Combined duration must not exceed 15 seconds. Mutually exclusive with `image` and `image_end`.","type":"array"},"seed":{"default":-1,"minimum":-1,"description":"Random seed for reproducible video generation. Use the same seed with the same prompt to get consistent results. Use `-1` for a random seed.","type":"integer","maximum":4294967295},"sound_effects":{"default":true,"description":"Whether to generate native audio (sound effects and ambience) for the video. Set to `false` to generate a silent video. Ignored when `reference_audios` are attached: the reference audio is what the soundtrack is built from.","type":"boolean"},"aspect_ratio":{"default":"widescreen_16_9","enum":["film_horizontal_21_9","widescreen_16_9","classic_4_3","square_1_1","traditional_3_4","social_story_9_16","film_vertical_9_21"],"description":"Output video aspect ratio. Available options:\n- `film_horizontal_21_9`: Ultra-wide cinematic (21:9)\n- `widescreen_16_9`: Standard widescreen (16:9)\n- `classic_4_3`: Classic TV format (4:3)\n- `square_1_1`: Square format (1:1)\n- `traditional_3_4`: Portrait classic (3:4)\n- `social_story_9_16`: Vertical/social media story (9:16)\n- `film_vertical_9_21`: Ultra-tall vertical (9:21)\n\n**Note:** This parameter only applies to text-to-video and reference-to-video requests. When an `image` (first frame) is provided for image-to-video generation, `aspect_ratio` is ignored: the output video inherits the aspect ratio of the start frame.\n","type":"string"}},"type":"object"},"200-image-to-prompt-task-completed":{"type":"object"},"request_12":{"required":["prompt","type"],"properties":{"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"prompt":{"example":"A beautiful landscape","maxLength":2500,"type":"string","description":"Text prompt to improve for AI generation. Can be empty to generate a creative prompt."},"type":{"example":"image","enum":["image","video"],"description":"Type of generation (image or video)","type":"string"},"language":{"default":"en","example":"en","description":"Language code for the improved prompt (ISO 639-1 format). Defaults to English if not specified.","type":"string","pattern":"^[a-z]{2}$"}},"type":"object"},"list_cloned_voices_200_response_data_inner":{"example":{"provider":"elevenlabs","gender":"female","is_active":true,"example_mp3_url":"example_mp3_url","eleven_labs_voice":"pNInz6obpgDQGcFmaJgB","description":"A warm, professional tone","main_languages":[{"identifier":"en","name":"English","id":0},{"identifier":"en","name":"English","id":0}],"name":"My Custom Voice","accent_id":"accent_id","is_cloned":true,"status":"completed","last_used_at":"2000-01-23T04:56:07.000+00:00","deleted_at":"2000-01-23T04:56:07.000+00:00","preview_image_url":"preview_image_url","id":42},"properties":{"name":{"example":"My Custom Voice","description":"User-defined voice name","type":"string"},"gender":{"example":"female","description":"Voice gender","type":"string","nullable":true},"accent_id":{"description":"Accent identifier","type":"string","nullable":true},"example_mp3_url":{"description":"URL of a sample audio clip","type":"string","nullable":true},"eleven_labs_voice":{"example":"pNInz6obpgDQGcFmaJgB","description":"Provider-specific voice ID","type":"string"},"description":{"example":"A warm, professional tone","description":"Optional voice description","type":"string","nullable":true},"main_languages":{"type":"array","items":{"$ref":"#/components/schemas/list_cloned_voices_200_response_data_inner_main_languages_inner"}},"is_active":{"example":true,"type":"boolean"},"provider":{"example":"elevenlabs","description":"Voice provider","type":"string"},"is_cloned":{"example":true,"type":"boolean"},"last_used_at":{"description":"ISO 8601 timestamp of last usage","format":"date-time","type":"string","nullable":true},"status":{"example":"completed","description":"Voice cloning status","type":"string"},"deleted_at":{"description":"ISO 8601 timestamp if soft-deleted","format":"date-time","type":"string","nullable":true},"preview_image_url":{"description":"URL of the voice's preview image","type":"string","nullable":true},"id":{"example":42,"description":"Unique voice identifier","type":"integer"}},"type":"object"},"elevenlabs-v4-request":{"required":["text","voice_id"],"properties":{"stability":{"default":0.5,"minimum":0,"example":0.5,"description":"Controls voice consistency and expressiveness. Lower values produce more expressive, varied delivery; higher values produce more consistent, stable output.","type":"number","maximum":1},"similarity_boost":{"default":0.75,"minimum":0,"example":0.75,"description":"Controls how closely the generated voice matches the original voice. Higher values produce closer matching.","type":"number","maximum":1},"voice_id":{"maxLength":255,"minLength":1,"example":"21m00Tcm4TlvDq8ikWAM","description":"The unique identifier of the ElevenLabs voice to use for synthesis. You can find voice IDs in the ElevenLabs voice library.","type":"string","pattern":"^[a-zA-Z0-9_-]+$"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"text":{"minLength":1,"example":"[excited] Welcome to Magnific! [pause 0.5s] Let's create something amazing.","maxLength":10000,"type":"string","description":"The text to convert to speech, up to 10,000 characters. Supports UTF-8 characters including accented letters and non-Latin scripts.\n\nInline audio tags in square brackets direct the performance instead of being read aloud, e.g. `[excited]`, `[whispers]`, `[laughs]` or `[pause 1s]`.\n"}},"type":"object"},"request_16":{"required":["prompt"],"properties":{"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"model":{"default":"clip","enum":["clip","pro"],"example":"clip","description":"Lyria 3 generation model variant.\n\n**Available models:**\n- `clip`: Faster generation optimized for short clips (default)\n- `pro`: Higher-fidelity generation for professional-quality tracks\n","type":"string"},"reference_images":{"example":[{"image":"https://example.com/mood-reference.jpg","mime_type":"image/jpeg"}],"description":"Optional reference images to guide the mood and style of the generated music.\nEach entry must include the image URL and its MIME type.\n\n**Image requirements:**\n- Publicly accessible URLs or GCS format\n- Supported formats: PNG, JPEG, WebP\n","type":"array","items":{"$ref":"#/components/schemas/request_16_reference_images_inner"}},"prompt":{"minLength":10,"example":"Cinematic ambient track with warm synth pads, soft piano, and a gentle build","maxLength":2000,"type":"string","description":"Text description of the music you want to generate with Lyria 3.\nBe specific about genre, mood, instruments, and tempo for best results.\n\n**Tips for effective prompts:**\n- Include genre: \"cinematic\", \"jazz\", \"electronic\", \"ambient\"\n- Describe mood: \"dramatic\", \"playful\", \"tense\", \"peaceful\"\n- Mention instruments: \"grand piano\", \"saxophone\", \"synth pads\", \"percussion\"\n- Add tempo hints: \"andante\", \"fast-paced\", \"steady groove\"\n"}},"type":"object"},"request-content_3":{"required":["image"],"properties":{"sharpen":{"default":7,"minimum":0,"description":"Image sharpness intensity control. Higher values increase edge definition and clarity in the upscaled image.\nValid values range from 0 (no sharpening) to 100 (maximum sharpness). Default is 7.\n","type":"integer","maximum":100},"smart_grain":{"default":7,"minimum":0,"description":"Intelligent grain/texture enhancement for the upscaled image. Helps preserve natural film grain and texture detail.\nHigher values add more fine-grained texture to prevent the upscaled image from looking too smooth or artificial.\nValid values range from 0 (no grain) to 100 (maximum grain). Default is 7.\n","type":"integer","maximum":100},"image":{"description":"Source image to upscale. Accepts either:\n- A publicly accessible HTTPS URL pointing to the image\n- A base64-encoded image string\n\nThis image will be enhanced with AI-powered upscaling technology that intelligently adds details and improves image quality while increasing resolution.\n","type":"string"},"ultra_detail":{"default":30,"minimum":0,"description":"Ultra detail enhancement level for the image upscaling process. This parameter controls how much fine detail\nthe AI adds to the upscaled image, such as textures, patterns, and micro-details.\nHigher values create more intricate details. Valid values range from 0 to 100. Default is 30.\n","type":"integer","maximum":100},"webhook_url":{"format":"uri","description":"Optional callback URL that will receive asynchronous notifications when the upscaling task completes.\nThe webhook will be called with the task status and the upscaled image URL.\n","type":"string"},"scale_factor":{"$ref":"#/components/schemas/request_content_3_scale_factor"},"filter_nsfw":{"default":false,"description":"Enable NSFW content filtering on the output image","type":"boolean"},"flavor":{"$ref":"#/components/schemas/flavor"}},"type":"object"},"request_13":{"required":["duration_seconds","text"],"properties":{"prompt_influence":{"default":0.3,"minimum":0,"example":0.3,"description":"The influence of the prompt on the generated audio. A value between 0 and 1.","type":"number","maximum":1},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"loop":{"default":false,"description":"Whether to create a sound effect that loops smoothly","type":"boolean"},"text":{"example":"A cat meowing","maxLength":2500,"type":"string","description":"The text to convert to sound effects"},"duration_seconds":{"minimum":0.5,"example":5,"description":"The duration of the generated audio in seconds","type":"number","maximum":22}},"type":"object"},"advanced-custom-elements-refer-video":{"required":["video_url"],"properties":{"video_url":{"description":"Reference video URL. Only .mp4/.mov formats supported. Must be 1080P with duration between 3 and 8 seconds, aspect ratio 16:9 or 9:16. Max file size: 200MB.","type":"string"}},"type":"object"},"lora_item_training":{"example":{"quality":"quality","defaultScale":1.2,"status":"status"},"properties":{"quality":{"description":"Training quality","type":"string","nullable":true},"defaultScale":{"example":1.2,"description":"Default scale","type":"number"},"status":{"description":"Training status","type":"string"}},"type":"object"},"advanced-custom-elements-tag":{"required":["tag_id"],"properties":{"tag_id":{"$ref":"#/components/schemas/advanced-custom-elements-tag-id"}},"type":"object"},"request_8":{"required":["prompt"],"properties":{"style":{"$ref":"#/components/schemas/style-enum"},"seed":{"description":"The same seed and the same prompt given to the same version of the model will output the same video every time","type":"integer"},"duration":{"default":5,"enum":[5,8],"description":"The duration of the generated video in seconds. 8s videos cost double. 1080p videos are limited to 5 seconds.","type":"integer"},"prompt":{"description":"Text prompt describing the video to generate","type":"string"},"resolution":{"$ref":"#/components/schemas/resolution_4"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"negative_prompt":{"default":"","description":"Negative prompt to be used for the generation","type":"string"},"aspect_ratio":{"$ref":"#/components/schemas/aspect-ratio_3"}},"type":"object"},"_v1_analytics_team_credit_usage_post_200_response":{"example":{"data":[{"date":"2026-01-01T00:00:00Z","consumptions":[{"user_usages":[{"user_email":"designer@company.com","user_reference":"usr_a3f81c2d9e4b7f60","project_name":"Marketing Campaign","api_key_id":"d98b3edd-38c6-4f03-a9bd-da6eff110782","group_name":"Design Team","project_reference":"a1b2c3d4-1111-4000-8000-000000000001","api_key_name":"prod-batch","user_credits":1200,"user_uses":30},{"user_email":"designer@company.com","user_reference":"usr_a3f81c2d9e4b7f60","project_name":"Marketing Campaign","api_key_id":"d98b3edd-38c6-4f03-a9bd-da6eff110782","group_name":"Design Team","project_reference":"a1b2c3d4-1111-4000-8000-000000000001","api_key_name":"prod-batch","user_credits":1200,"user_uses":30}],"tool_name":"pikaso-tti-flux-dev","user_uses":45,"user_credits":1800,"tool":"AI Image Models"},{"user_usages":[{"user_email":"designer@company.com","user_reference":"usr_a3f81c2d9e4b7f60","project_name":"Marketing Campaign","api_key_id":"d98b3edd-38c6-4f03-a9bd-da6eff110782","group_name":"Design Team","project_reference":"a1b2c3d4-1111-4000-8000-000000000001","api_key_name":"prod-batch","user_credits":1200,"user_uses":30},{"user_email":"designer@company.com","user_reference":"usr_a3f81c2d9e4b7f60","project_name":"Marketing Campaign","api_key_id":"d98b3edd-38c6-4f03-a9bd-da6eff110782","group_name":"Design Team","project_reference":"a1b2c3d4-1111-4000-8000-000000000001","api_key_name":"prod-batch","user_credits":1200,"user_uses":30}],"tool_name":"pikaso-tti-flux-dev","user_uses":45,"user_credits":1800,"tool":"AI Image Models"}]},{"date":"2026-01-01T00:00:00Z","consumptions":[{"user_usages":[{"user_email":"designer@company.com","user_reference":"usr_a3f81c2d9e4b7f60","project_name":"Marketing Campaign","api_key_id":"d98b3edd-38c6-4f03-a9bd-da6eff110782","group_name":"Design Team","project_reference":"a1b2c3d4-1111-4000-8000-000000000001","api_key_name":"prod-batch","user_credits":1200,"user_uses":30},{"user_email":"designer@company.com","user_reference":"usr_a3f81c2d9e4b7f60","project_name":"Marketing Campaign","api_key_id":"d98b3edd-38c6-4f03-a9bd-da6eff110782","group_name":"Design Team","project_reference":"a1b2c3d4-1111-4000-8000-000000000001","api_key_name":"prod-batch","user_credits":1200,"user_uses":30}],"tool_name":"pikaso-tti-flux-dev","user_uses":45,"user_credits":1800,"tool":"AI Image Models"},{"user_usages":[{"user_email":"designer@company.com","user_reference":"usr_a3f81c2d9e4b7f60","project_name":"Marketing Campaign","api_key_id":"d98b3edd-38c6-4f03-a9bd-da6eff110782","group_name":"Design Team","project_reference":"a1b2c3d4-1111-4000-8000-000000000001","api_key_name":"prod-batch","user_credits":1200,"user_uses":30},{"user_email":"designer@company.com","user_reference":"usr_a3f81c2d9e4b7f60","project_name":"Marketing Campaign","api_key_id":"d98b3edd-38c6-4f03-a9bd-da6eff110782","group_name":"Design Team","project_reference":"a1b2c3d4-1111-4000-8000-000000000001","api_key_name":"prod-batch","user_credits":1200,"user_uses":30}],"tool_name":"pikaso-tti-flux-dev","user_uses":45,"user_credits":1800,"tool":"AI Image Models"}]}]},"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/team_credit_usage_response_inner"}}},"type":"object"},"request_14":{"required":["description"],"properties":{"audio":{"example":"https://example.com/input-audio.wav","description":"Audio input - either a publicly accessible HTTPS URL or base64 encoded audio. Supported formats: WAV, MP3, FLAC, OGG, M4A. Mutually exclusive with `video`.","type":"string"},"x2":{"default":0,"example":400,"minimum":0,"type":"integer","description":"Bounding box x2 coordinate (right edge) in pixels for sound source localization. Only applicable for video input."},"y2":{"default":0,"example":300,"minimum":0,"type":"integer","description":"Bounding box y2 coordinate (bottom edge) in pixels for sound source localization. Only applicable for video input."},"sample_fps":{"default":2,"minimum":1,"example":2,"description":"Frame sampling rate in FPS for video processing. Higher values provide more temporal precision but increase processing time.","type":"number","maximum":5},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"predict_spans":{"default":false,"example":false,"type":"boolean","description":"Enable span prediction for better isolation of non-ambient sounds like speech or musical notes."},"y1":{"default":0,"example":50,"minimum":0,"type":"integer","description":"Bounding box y1 coordinate (top edge) in pixels for sound source localization. Only applicable for video input."},"x1":{"default":0,"example":100,"minimum":0,"type":"integer","description":"Bounding box x1 coordinate (left edge) in pixels for sound source localization. Only applicable for video input."},"video":{"example":"https://example.com/input-video.mp4","description":"Video input - either a publicly accessible HTTPS URL or base64 encoded video. Supported formats: MP4, MOV, WEBM, AVI. Mutually exclusive with `audio`.","type":"string"},"description":{"example":"A person speaking","maxLength":2500,"type":"string","description":"Text description of the sound to isolate from the input audio or video. Be specific about the type of sound you want to extract."},"reranking_candidates":{"default":1,"minimum":1,"example":1,"description":"Number of reranking candidates for quality vs latency trade-off. Higher values produce better quality but slower processing.","type":"integer","maximum":8}},"type":"object"},"_v1_analytics_audit_logs_events_get_200_response_meta":{"example":{"next_cursor":"eyJzIjpbMTcyMjMyOF19","pagination":{"last_page":1,"per_page":1,"total":1,"current_page":1}},"properties":{"pagination":{"$ref":"#/components/schemas/pagination"},"next_cursor":{"example":"eyJzIjpbMTcyMjMyOF19","description":"Cursor for the next page, or `null` when there are no more pages.","type":"string","nullable":true}},"type":"object"},"search_resources_200_response_meta":{"example":{"last_page":1,"total":1,"clean_search":true,"per_page":1,"current_page":1},"allOf":[{"$ref":"#/components/schemas/pagination"},{"properties":{"clean_search":{"$ref":"#/components/schemas/clean_search"}},"type":"object"}]},"_v1_analytics_audit_logs_events_get_200_response":{"example":{"data":[{"member":{"email":"admin@company.com","auth":{"api_key_id":"11111111-1111-4111-8111-111111111111","api_key_name":"CI pipeline","type":"api_key"},"user_id":10499812,"type":"user"},"action":{"data":{"operation":"grant","role":"admin","target_user_id":10511077},"resource_id":"18422","event_type":"team.member.role_changed","request_id":"req-7f3a9c1e","project_name":"Marketing Campaign Q4","correlation_id":"corr-2b8e","verb":"update","context":{},"status":"success","old_state":{"role":"member"},"new_state":{"role":"admin"},"duration_ms":42,"folder_name":"Q4 assets"},"date":"2026-07-30T09:14:52Z","category":"member","source":{"platform":"web","project":"magnific","referer":"referer"},"event_id":"b3d1f0a2-9c4e-4a1b-8f2d-1a2b3c4d5e6f"},{"member":{"email":"admin@company.com","auth":{"api_key_id":"11111111-1111-4111-8111-111111111111","api_key_name":"CI pipeline","type":"api_key"},"user_id":10499812,"type":"user"},"action":{"data":{"operation":"grant","role":"admin","target_user_id":10511077},"resource_id":"18422","event_type":"team.member.role_changed","request_id":"req-7f3a9c1e","project_name":"Marketing Campaign Q4","correlation_id":"corr-2b8e","verb":"update","context":{},"status":"success","old_state":{"role":"member"},"new_state":{"role":"admin"},"duration_ms":42,"folder_name":"Q4 assets"},"date":"2026-07-30T09:14:52Z","category":"member","source":{"platform":"web","project":"magnific","referer":"referer"},"event_id":"b3d1f0a2-9c4e-4a1b-8f2d-1a2b3c4d5e6f"}],"meta":{"next_cursor":"eyJzIjpbMTcyMjMyOF19","pagination":{"last_page":1,"per_page":1,"total":1,"current_page":1}}},"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/audit-log-event"}},"meta":{"$ref":"#/components/schemas/_v1_analytics_audit_logs_events_get_200_response_meta"}},"type":"object"},"search_resources_200_response":{"example":{"data":[{"id":15667327,"filename":"filename","url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm","related":{"serie":{"title":"White t-shirt with copy space on gray background","licenses":[{"type":"freemium","url":"https://www.freepik.com/profile/license/pdf/4350594"},{"type":"freemium","url":"https://www.freepik.com/profile/license/pdf/4350594"}],"image":{"orientation":"horizontal","source":{"key":"large","size":"740x640","url":"https://img.freepik.com/free-photo/tshirt_53876-104920.jpg"},"type":"vector"},"id":15667327,"author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647},"url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm"},"others":{"title":"White t-shirt with copy space on gray background","licenses":[{"type":"freemium","url":"https://www.freepik.com/profile/license/pdf/4350594"},{"type":"freemium","url":"https://www.freepik.com/profile/license/pdf/4350594"}],"image":{"orientation":"horizontal","source":{"key":"large","size":"740x640","url":"https://img.freepik.com/free-photo/tshirt_53876-104920.jpg"},"type":"vector"},"id":15667327,"author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647},"url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm"},"keywords":{"name":"Merry Christmas","slug":"merry-christmas"}},"meta":{"is_new":true,"available_formats":{"ai":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"png":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"psd":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"eps":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"atn":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"fonts":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"jpg":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"3d-render":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"svg":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"zip":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"resources":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]}},"published_at":"2020-12-01T23:50:50Z"},"licenses":[{"type":"freemium","url":"https://www.freepik.com/profile/license/pdf/4350594"},{"type":"freemium","url":"https://www.freepik.com/profile/license/pdf/4350594"}],"image":{"orientation":"horizontal","source":{"key":"large","size":"740x640","url":"https://img.freepik.com/free-photo/tshirt_53876-104920.jpg"},"type":"vector"},"stats":{"downloads":0,"likes":0},"products":[{"type":"essential","url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm"},{"type":"essential","url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm"}],"title":"White t-shirt with copy space on gray background","author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}},{"id":15667327,"filename":"filename","url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm","related":{"serie":{"title":"White t-shirt with copy space on gray background","licenses":[{"type":"freemium","url":"https://www.freepik.com/profile/license/pdf/4350594"},{"type":"freemium","url":"https://www.freepik.com/profile/license/pdf/4350594"}],"image":{"orientation":"horizontal","source":{"key":"large","size":"740x640","url":"https://img.freepik.com/free-photo/tshirt_53876-104920.jpg"},"type":"vector"},"id":15667327,"author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647},"url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm"},"others":{"title":"White t-shirt with copy space on gray background","licenses":[{"type":"freemium","url":"https://www.freepik.com/profile/license/pdf/4350594"},{"type":"freemium","url":"https://www.freepik.com/profile/license/pdf/4350594"}],"image":{"orientation":"horizontal","source":{"key":"large","size":"740x640","url":"https://img.freepik.com/free-photo/tshirt_53876-104920.jpg"},"type":"vector"},"id":15667327,"author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647},"url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm"},"keywords":{"name":"Merry Christmas","slug":"merry-christmas"}},"meta":{"is_new":true,"available_formats":{"ai":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"png":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"psd":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"eps":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"atn":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"fonts":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"jpg":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"3d-render":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"svg":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"zip":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]},"resources":{"total":1,"items":[{"name":"image.jpg","size":100,"colorspace":"RGB","id":1},{"name":"image.jpg","size":100,"colorspace":"RGB","id":1}]}},"published_at":"2020-12-01T23:50:50Z"},"licenses":[{"type":"freemium","url":"https://www.freepik.com/profile/license/pdf/4350594"},{"type":"freemium","url":"https://www.freepik.com/profile/license/pdf/4350594"}],"image":{"orientation":"horizontal","source":{"key":"large","size":"740x640","url":"https://img.freepik.com/free-photo/tshirt_53876-104920.jpg"},"type":"vector"},"stats":{"downloads":0,"likes":0},"products":[{"type":"essential","url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm"},{"type":"essential","url":"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm"}],"title":"White t-shirt with copy space on gray background","author":{"name":"John Doe","avatar":"https://avatar.cdnpk.net/61668527-220726032514.jpg","slug":"merry-christmas","assets":0,"id":2147483647}}],"meta":{"last_page":1,"total":1,"clean_search":true,"per_page":1,"current_page":1}},"properties":{"data":{"description":"A list of resources.","type":"array","items":{"$ref":"#/components/schemas/search_resources_200_response_data_inner"}},"meta":{"$ref":"#/components/schemas/search_resources_200_response_meta"}},"type":"object"},"seedance-2-5-request":{"required":["prompt"],"properties":{"reference_images":{"description":"Up to 30 reference images (subjects, characters, products or style references). Each item is a publicly accessible URL or a base64-encoded image. Reference them in the prompt using @Image1, @Image2, ... @Image30 (1-indexed to the array order). Mutually exclusive with `image` and `image_end`.","maxItems":30,"type":"array","items":{"type":"string","format":"byte"}},"task_type":{"enum":["auto","reference","edit","extend"],"description":"How the reference videos are used. Setting any value requires at least one reference video; without one the request is rejected with 400. When the field is omitted, a request WITH reference videos behaves as `reference`, and a request without them is plain generation (the field plays no part). `reference` generates a NEW video guided by the references. `edit` modifies the source video named in the prompt: the output keeps that video's aspect ratio and duration, so `duration` must be omitted and `aspect_ratio` must be omitted or `adaptive`; billing uses the measured duration of the longest reference video as the output seconds, plus the usual reference-video surcharge. `extend` continues the source video: the output is the generated continuation and lasts `duration` seconds (default 5) with the source video's aspect ratio, so `aspect_ratio` must be omitted or `adaptive`; billing uses `duration` plus the reference surcharge. `auto` lets the model infer the task from the prompt; the request is sent exactly as given, with no server-side defaults for `duration` or `aspect_ratio`, and when `duration` is omitted billing assumes the output follows the longest reference video. Requests that violate these constraints are rejected with 400 and the offending field named in `invalid_params`, before any credits are consumed.","type":"string"},"prompt":{"example":"A cinematic shot of a cat walking through a neon-lit alley at night","maxLength":40000,"type":"string","description":"Text prompt describing the video to generate. To use references, mention them as @Image1, @Video1, @Audio1, ... matching the 1-indexed order of each reference array. Maximum 40000 characters. Prompts longer than 5,000 characters are accepted, but results may become less predictable."},"camera_motion":{"enum":["static","moveLeft","moveRight","moveUp","moveDown","pushIn","pullOut","zoomIn","zoomOut","panLeft","panRight","tiltUp","tiltDown","truckLeft","truckRight","pedestalUp","pedestalDown","superDollyIn","superDollyOut","crashZoomIn","crashZoomOut","doubleDolly","jibUp","jibDown","craneUp","craneDown","craneOverTheHead","orbitLeft","orbitRight","360Orbit","leftCircling","rightCircling","leftWalking","rightWalking","upwardTilt","downwardTilt","fisheye","overhead","objectPov","whipPan","dutchAngle","dirtyLens","lensCrack","lensFlare","focusChange","lowShutter","fpvDrone","handheld","headTracking","snorricam","stageLeft","stageRight","scenicShot","carChasing","throughObjectIn","timelapseHuman","timelapseLandscape"],"description":"Optional camera movement to guide the shot. Each value is expanded into a descriptive instruction appended to the prompt.","type":"string"},"image_end":{"format":"byte","description":"Optional image to use as the last frame for image-to-video generation. Requires `image`. When provided together with `image`, the model generates a transition video between the first and last frame. Mutually exclusive with `reference_images` and `reference_videos`.","type":"string"},"camera_fixed":{"default":false,"description":"When `true`, the camera position stays fixed (tripod shot). When `false`, the model may apply natural camera movements.","type":"boolean"},"output_format":{"default":"mp4","enum":["mp4","mov"],"description":"Container format of the generated video. `mov` trades file size for colour fidelity; `mp4` is the default.","type":"string"},"duration":{"minimum":4,"description":"Video duration in seconds. Any integer from 4 to 30. When omitted the server applies 5, with two exceptions: with `task_type: edit` the field must not be sent at all (the output keeps the source video's duration; sending it returns 400), and with `task_type: auto` no default is applied (nothing is dispatched and the model decides). The default is applied server-side, not declared in the schema, so generated clients no longer auto-fill it — the API behaviour for an omitted value is unchanged.","type":"integer","maximum":30},"webhook_url":{"format":"uri","description":"URL to receive a webhook notification when the video generation task completes. The webhook payload includes the task ID and status.","type":"string"},"no_music":{"default":false,"description":"Suppress background music in the generated native audio. Only applies when `sound_effects` is enabled.","type":"boolean"},"aspect_ratio":{"enum":["adaptive","film_horizontal_21_9","widescreen_16_9","classic_4_3","square_1_1","traditional_3_4","social_story_9_16","film_vertical_9_21"],"description":"Output video aspect ratio, per task. Text-to-video and reference-to-video generation: defaults to `widescreen_16_9`; `adaptive` pins no ratio and lets the model choose from the prompt and references. Image-to-video (`image` first frame): ignored — the output inherits the start frame's ratio. `task_type: edit` or `extend`: the output always follows the source video's ratio, so the field must be omitted or `adaptive`; any fixed value returns 400.","type":"string"},"seed":{"default":-1,"minimum":-1,"description":"Random seed for reproducible video generation. Use `-1` for a random seed.","type":"integer","maximum":4294967295},"multishot":{"description":"Optional multishot sequence of up to 6 shots. When provided, the shots drive the generation and replace the top-level `prompt` (which is still required). If any shot has a `duration`, all shots must have one and the durations must sum to `duration`.","maxItems":6,"type":"array","items":{"$ref":"#/components/schemas/seedance_2_5_request_multishot_inner"}},"image":{"format":"byte","description":"Optional image to use as the first frame for image-to-video generation. Accepts a publicly accessible URL or a base64-encoded image. Mutually exclusive with `reference_images` and `reference_videos`.","type":"string"},"reference_videos":{"maxItems":10,"items":{"type":"string"},"example":["https://example.com/reference-1.mp4"],"description":"Up to 10 reference videos. Each item must be a publicly accessible HTTPS URL or a video upload file_id (`upl_vid_...`). Reference them in the prompt using @Video1, @Video2, ... @Video10 (1-indexed to the array order). Each video must be MP4 or MOV, 2 to 30 seconds, 24 to 60 fps, no larger than 200 MB, with 409600 to 8295044 pixels and an aspect ratio from 0.4 to 2.5. Combined duration must not exceed 30 seconds. Mutually exclusive with `image` and `image_end`.","type":"array"},"sound_effects":{"default":true,"description":"Whether to generate native audio (sound effects and ambience) for the video.","type":"boolean"},"enable_safety_checker":{"default":true,"description":"Enable content safety filtering to ensure generated videos comply with safety guidelines.","type":"boolean"},"reference_audios":{"description":"Up to 10 reference audios (2-60s each, mp3 or wav). Each item is a publicly accessible URL: unlike `reference_images`, this field does not take upload file_ids. Reference them in the prompt using @Audio1, @Audio2, ... @Audio10 (1-indexed to the array order).\n\n**The audio is not copied into the video.** The model composes its own soundtrack, guided by the rhythm and character of what you send: a 120 BPM reference produces a soundtrack at that tempo, but it is a new recording, not your file muxed into the result. A reference with a clear beat, music or speech gives the model something to follow; a flat tone or near-silence does not.\n","maxItems":10,"type":"array","items":{"type":"string","format":"uri"}}},"type":"object"},"request_content_styling_effects":{"properties":{"framing":{"example":"portrait","enum":["portrait","macro","panoramic","aerial-view","close-up","cinematic","high-angle","low-angle","symmetry","fish-eye","first-person"],"description":"Effects - Framing to apply to the image","type":"string"},"color":{"example":"b&w","enum":["b&w","pastel","sepia","dramatic","vibrant","orange&teal","film-filter","split","electric","pastel-pink","gold-glow","autumn","muted-green","deep-teal","duotone","terracotta&teal","red&blue","cold-neon","burgundy&blue"],"description":"Effects - Color to apply to the image","type":"string"},"lightning":{"example":"warm","enum":["studio","warm","cinematic","volumetric","golden-hour","long-exposure","cold","iridescent","dramatic","hardlight","redscale","indoor-light"],"description":"Effects - Lightning to apply to the image","type":"string"}},"type":"object"},"run_request_inputs_value":{"oneOf":[{"type":"string"},{"type":"number"}]},"get_resource_detail_by_id_200_response_data":{"anyOf":[{"$ref":"#/components/schemas/detail_vector"},{"$ref":"#/components/schemas/detail_psd"},{"$ref":"#/components/schemas/detail_photo"},{"$ref":"#/components/schemas/detail_ai"}]},"flexible-request":{"required":["image"],"properties":{"smart_grain":{"default":2,"minimum":0,"example":2,"description":"Smart grain intensity","type":"integer","maximum":100},"image":{"example":"https://example.com/portrait.jpg","description":"Input image. Supports Base64 encoding or HTTPS URL (must be publicly accessible).","type":"string"},"webhook_url":{"example":"https://www.example.com/webhook","format":"uri","description":"Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.\n","type":"string"},"optimized_for":{"$ref":"#/components/schemas/flexible-optimized-for"},"sharpen":{"default":0,"minimum":0,"example":0,"description":"Sharpening intensity","type":"integer","maximum":100}},"type":"object"},"flow-summary":{"example":{"name":"Sketch to Realism","tool_metadata":{"sort_order":999,"total_cost":5,"category":"general","icon":"workflow","description_key":"description_key","translation_key":"translation_key"},"sqid":"uqzQLDr2Aw"},"properties":{"name":{"example":"Sketch to Realism","description":"Human-readable name of the flow.","type":"string"},"tool_metadata":{"$ref":"#/components/schemas/tool-metadata"},"sqid":{"example":"uqzQLDr2Aw","description":"Short unique identifier of the flow.","type":"string"}},"type":"object","description":"Summary of a flow as returned in list endpoints."}},"securitySchemes":{"magnificApiKey":{"in":"header","name":"x-magnific-api-key","type":"apiKey","description":"Your Magnific API key. Required for authentication. [Learn how to obtain an API key](https://docs.magnific.com/quickstart)\n"}},"examples":{"200-improve-prompt-task-completed":{"description":"Response when an improve-prompt task has been successfully completed","summary":"Success - Task completed","value":{"data":{"generated":["A breathtaking landscape featuring majestic snow-capped mountains in the background, lush green valleys in the foreground, with a crystal-clear river winding through the scene. Golden hour lighting casts warm tones across the terrain. Shot with a wide-angle lens, cinematic composition, high detail, photorealistic style."],"task_id":"046b6c7f-0b8a-43b9-b35d-6489e6daee91","status":"COMPLETED"}}},"200-task-created":{"summary":"Success - Task created","value":{"data":{"generated":[],"task_id":"046b6c7f-0b8a-43b9-b35d-6489e6daee91","status":"CREATED"}}},"200-list-my-flows":{"summary":"Success - List of user's own flows","value":{"data":[{"sqid":"uqzQLDr2Aw","name":"My Custom Sketch to Image"},{"sqid":"n0LYQDBl58","name":"Product Background Remover"},{"sqid":"hCivqLJltZ","name":"Anime Style Transfer"}]}},"200-analytics-team-members":{"summary":"Success - List of team members.","value":{"data":[{"email":"designer@company.com","role":"admin","status":"active"},{"email":"developer@company.com","role":"member","status":"active"},{"email":"intern@company.com","role":"member","status":"invited"}]}},"request-tti-required-params":{"summary":"Request - Text to image required params","value":{"prompt":"Crazy dog in the space"}},"request-tti-portrait-image-size":{"summary":"Request - Generate image using one of the fixed sizes","value":{"prompt":"Crazy dog in the space","image":{"size":"portrait_2_3"}}},"request-image-relight-required-params":{"summary":"Example - Relight only required params","value":{"image":"iVBORw0KGgoAAAANSUhEUgAAASwAAAEsAQAAAABRBrPYAAABrElEQVR4nO3BMQEAAADCoPVPbQ0Po..."}},"request-change-camera-required-params":{"description":"Minimal request with only the required image parameter. Uses default values for all other settings (horizontal_angle=0, vertical_angle=0, zoom=5, output_format=png).","summary":"Change Camera - Required parameters only","value":{"image":"https://example.com/product-photo.jpg"}},"request-tti-styling-params":{"summary":"Request - Generate image with custom styling","value":{"prompt":"Crazy dog in the space","styling":{"style":"anime","effects":{"framing":"portrait","color":"pastel","lightning":"warm"},"colors":[{"color":"#FF5733","weight":1}]}}},"200-flux-dev-task-completed":{"summary":"Success - Task completed","value":{"data":{"generated":["https://ai-statics.freepik.com/completed_task_image.jpg"],"task_id":"046b6c7f-0b8a-43b9-b35d-6489e6daee92","status":"COMPLETED"}}},"request-change-camera-all-params":{"description":"Full request with all available parameters including camera angle rotation, tilt, zoom, seed for reproducibility, output format, and webhook notification.","summary":"Change Camera - All parameters","value":{"seed":42,"horizontal_angle":45,"image":"https://example.com/product-photo.jpg","webhook_url":"https://www.example.com/webhook","zoom":7,"output_format":"png","vertical_angle":15}},"200-detail-vector-b2b":{"summary":"Success - Detail Vector resource information","value":{"data":{"download_size":1024,"related_resources":{"same_series":{"url":"https://www.freepik.com/serie/32689488","items":[{"name":"Sports bike","preview":{"height":200,"width":300,"url":"https://www.freepik.com/free-vector/sports-bike_770011.jpg"},"url":"https://www.freepik.com/free-vector/sports-bike_770011.htm","new":true,"id":770011,"has_prompt":true,"premium":false,"slug":"sports-bike","is_ai_generated":true,"type":"vector","author":{"name":"flaticon","avatar":"https://avatar.cdnpk.net/744082.jpg","slug":"flaticon","assets":100,"id":744082}}]},"same_author":[{"name":"Sports car","preview":{"height":200,"width":300,"url":"https://www.freepik.com/free-vector/sports-car_770011.jpg"},"url":"https://www.freepik.com/free-vector/sports-car_770011.htm","new":true,"id":770011,"has_prompt":true,"premium":false,"slug":"sports-car","is_ai_generated":true,"type":"vector","author":{"name":"flaticon","avatar":"https://avatar.cdnpk.net/744082.jpg","slug":"flaticon","assets":100,"id":744082}}],"suggested":[{"name":"Sports car","preview":{"height":200,"width":300,"url":"https://www.freepik.com/free-vector/sports-car_770011.jpg"},"url":"https://www.freepik.com/free-vector/sports-car_770011.htm","new":true,"id":770011,"has_prompt":true,"premium":false,"slug":"sports-car","is_ai_generated":true,"type":"vector","author":{"name":"flaticon","avatar":"https://avatar.cdnpk.net/744082.jpg","slug":"flaticon","assets":100,"id":744082}}],"same_collection":{"url":"https://www.freepik.com/collection/shining","items":[{"name":"Sports car","preview":{"height":200,"width":300,"url":"https://www.freepik.com/free-vector/sports-car_770011.jpg"},"url":"https://www.freepik.com/free-vector/sports-car_770011.htm","new":true,"id":770011,"has_prompt":true,"premium":false,"slug":"sports-car","is_ai_generated":true,"type":"vector","author":{"name":"flaticon","avatar":"https://avatar.cdnpk.net/744082.jpg","slug":"flaticon","assets":100,"id":744082}}]}},"premium":false,"new":true,"related_tags":[{"slug":"coloring-pages","name":"coloring pages"},{"slug":"kawaii-coloring-page","name":"kawaii coloring page"},{"slug":"cute-kawaii","name":"cute kawaii"},{"slug":"adorable","name":"adorable"},{"slug":"chibi","name":"chibi"},{"slug":"line-art","name":"line art"}],"id":770011,"name":"Sports car","available_formats":{"jpg":{"total":2,"items":[{"name":"Sports car","colorspace":"RGB","size":100,"id":444},{"name":"Sports car","colorspace":"RGB","size":200,"id":555}]}},"preview":{"height":200,"width":300,"url":"https://www.freepik.com/free-vector/sports-car_770011.jpg"},"vertical":"vector","is_ai_generated":false,"created":"2020-01-01T00:00:00Z","has_prompt":false,"license":"https://www.freepik.com/profile/license/pdf/4350594","slug":"sports-car","url":"https://www.freepik.com/free-vector/sports-car_770011.htm","type":"vector","author":{"name":"flaticon","avatar":"https://avatar.cdnpk.net/744082.jpg","slug":"flaticon","assets":100,"id":744082}}}},"request-flux-kontext-max-all-params":{"summary":"Complete request with all parameters","value":{"input_image_2":"https://example.com/reference-image-2.jpg","input_image_3":"https://example.com/reference-image-3.jpg","prompt":"turn the sky into a dramatic sunset with orange and purple clouds, cinematic lighting, highly detailed","input_image_4":"https://example.com/reference-image-4.jpg","prompt_upsampling":false,"guidance":3,"seed":42,"webhook_url":"https://your-app.com/webhooks/flux-kontext-max","input_image":"https://example.com/reference-image.jpg","safety_tolerance":2,"output_format":"png","steps":50,"aspect_ratio":"widescreen_16_9"}},"200-mystic-task-completed":{"summary":"Success - Task completed","value":{"data":{"generated":["https://ai-statics.freepik.com/completed_task_image.jpg"],"status":"COMPLETED","task_id":"046b6c7f-0b8a-43b9-b35d-6489e6daee91","has_nsfw":[false]}}},"request-text-to-icon":{"summary":"Request - Text to icon","value":{"webhook_url":"https://example.com/webhook","prompt":"Sliced avocado and chips"}},"request-classifier-image-base64":{"summary":"Request - Image Base 64","value":{"image":"/9j/4AAQSkZJRgABAQEASABIAAD/4gKwSUNDX1BST0ZJTEUAAQEAAAKgbGNtcwQwAABtbnRyUkdCIFhZWiAH6AALAA4ADgAIADphY3NwQVBQTAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA9tYAAQAAAADTLWxjbXMAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA1kZXNjAAABIAAAAEBjcHJ0AAABYAAAADZ3dHB0AAABmAAAABRjaGFkAAABrAAAACxyWFlaAAAB2AAAABRiWFlaAAAB7AAAABRnWFlaAAACAAAAABRyVFJDAAACFAAAACBnVFJDAAACFAAAACBiVFJDAAACFAAAACBjaHJtAAACNAAAACRkbW5kAAACWAAAACRkbWRkAAACfAAAACRtbHVjAAAAAAAAAAEAAAAMZW5VUwAAACQAAAAcAEcASQBNAFAAIABiAHUAaQBsAHQALQBpAG4AIABzAFIARwBCbWx1YwAAAAAAAAABAAAADGVuVVMAAAAaAAAAHABQAHUAYgBsAGkAYwAgAEQAbwBtAGEAaQBuAABYWVogAAAAAAAA9tYAAQAAAADTLXNmMzIAAAAAAAEMQgAABd7///MlAAAHkwAA/ZD///uh///9ogAAA9wAAMBuWFlaIAAAAAAAAG+gAAA49QAAA5BYWVogAAAAAAAAJJ8AAA..."}},"200-detail-psd-b2b":{"summary":"Success - Detail PSD resource information","value":{"data":{"download_size":1024,"related_resources":{"same_series":{"url":"https://www.freepik.com/serie/32689488","items":[{"name":"Sports bike","preview":{"height":200,"width":300,"url":"https://www.freepik.com/free-vector/sports-bike_770011.jpg"},"url":"https://www.freepik.com/free-vector/sports-bike_770011.htm","new":true,"id":770011,"has_prompt":true,"premium":false,"slug":"sports-bike","is_ai_generated":true,"type":"vector","author":{"name":"flaticon","avatar":"https://avatar.cdnpk.net/744082.jpg","slug":"flaticon","assets":100,"id":744082}}]},"same_author":[{"name":"Sports bike","preview":{"height":200,"width":300,"url":"https://www.freepik.com/free-vector/sports-bike_770011.jpg"},"url":"https://www.freepik.com/free-vector/sports-bike_770011.htm","new":true,"id":770011,"has_prompt":true,"premium":false,"slug":"sports-bike","is_ai_generated":true,"type":"vector","author":{"name":"flaticon","avatar":"https://avatar.cdnpk.net/744082.jpg","slug":"flaticon","assets":100,"id":744082}}],"suggested":[{"name":"Sports bike","preview":{"height":200,"width":300,"url":"https://www.freepik.com/free-vector/sports-bike_770011.jpg"},"url":"https://www.freepik.com/free-vector/sports-bike_770011.htm","new":true,"id":770011,"has_prompt":true,"premium":false,"slug":"sports-bike","is_ai_generated":true,"type":"vector","author":{"name":"flaticon","avatar":"https://avatar.cdnpk.net/744082.jpg","slug":"flaticon","assets":100,"id":744082}}],"same_collection":{"url":"https://www.freepik.com/collection/shining","items":[{"name":"Sports bike","preview":{"height":200,"width":300,"url":"https://www.freepik.com/free-vector/sports-bike_770011.jpg"},"url":"https://www.freepik.com/free-vector/sports-bike_770011.htm","new":true,"id":770011,"has_prompt":true,"premium":false,"slug":"sports-bike","is_ai_generated":true,"type":"vector","author":{"name":"flaticon","avatar":"https://avatar.cdnpk.net/744082.jpg","slug":"flaticon","assets":100,"id":744082}}]}},"premium":true,"new":true,"related_tags":[{"slug":"coloring-pages","name":"coloring pages"},{"slug":"kawaii-coloring-page","name":"kawaii coloring page"},{"slug":"cute-kawaii","name":"cute kawaii"},{"slug":"adorable","name":"adorable"},{"slug":"chibi","name":"chibi"},{"slug":"line-art","name":"line art"}],"id":770012,"name":"T-shirts mockup psd in black","available_formats":{"jpg":{"total":2,"items":[{"name":"T-shirts mockup psd in black","colorspace":"RGB","size":100,"id":444},{"name":"T-shirts mockup psd in black","colorspace":"RGB","size":200,"id":555}]},"ai":{"total":1,"items":[{"name":"T-shirts mockup psd in black","colorspace":"RGB","size":100,"id":444}]}},"preview":{"height":200,"width":300,"url":"https://www.freepik.com/premium-psd/t-shirts-mockup-psd-black_17860378.htm"},"vertical":"mockup","is_ai_generated":false,"created":"2020-01-01T00:00:00Z","has_prompt":false,"license":"https://www.freepik.com/profile/license/pdf/4350594","slug":"t-shirts-mockup-psd-in-black","url":"https://www.freepik.com/premium-psd/t-shirts-mockup-psd-black_17860378.htm","type":"psd","author":{"name":"flaticon","avatar":"https://avatar.cdnpk.net/744082.jpg","slug":"flaticon","assets":100,"id":744082}}}},"request-classifier-image-url":{"summary":"Request - Image url","value":{"image":"https://img.freepik.com/free-photo/travel-trekking-summer-landscape-mountains-green-grass-trees-blue-sky_146671-18447.jpg"}},"request-text-to-icon-preview-all":{"summary":"Request - Text to icon preview all","value":{"num_inference_steps":20,"prompt":"Sliced avocado and chips","webhook_url":"https://example.com/webhook","style":"color","guidance_scale":7}},"200-analytics-team-credit-usage":{"description":"The first two rows share the same `tool` category and would be indistinguishable\nwithout `tool_name`. They are distinct consumptions: sum them, do not de-duplicate.\n\nThe last consumptions show the entries that carry no email. None of them is\nmissing data: all are real usage, counted in the parent totals. One is\nattributable to an API key, one to a person whose account no longer exists but\nwhose `user_reference` still matches their earlier entries, and the last to\nneither — reconcile that one against the parent totals.\n","summary":"Success - Team credit usage with per-user breakdown.","value":{"data":[{"date":"2026-01-01T00:00:00+00:00","consumptions":[{"user_usages":[{"user_email":"designer@company.com","user_reference":"usr_a3f81c2d9e4b7f60","project_name":"Marketing Campaign","group_name":"Design Team","user_uses":30,"user_credits":1200,"project_reference":"a1b2c3d4-1111-4000-8000-000000000001"},{"user_uses":15,"user_email":"developer@company.com","user_credits":600,"user_reference":"usr_5c09e7b21f8a43d6"}],"tool_name":"pikaso-tti-flux-dev","user_uses":45,"user_credits":1800,"tool":"AI Image Models"},{"user_usages":[{"user_uses":45,"user_email":"designer@company.com","user_credits":1800,"user_reference":"usr_a3f81c2d9e4b7f60"}],"tool_name":"pikaso-image-ai_image_generator-nano_banana_2","user_uses":45,"user_credits":1800,"tool":"AI Image Models"},{"user_usages":[{"api_key_id":"d98b3edd-38c6-4f03-a9bd-da6eff110782","user_email":null,"api_key_name":"prod-batch","user_credits":4800,"user_uses":120}],"tool_name":"pikaso-image-ai_image_generator-nano_banana_2","user_uses":120,"user_credits":4800,"tool":"AI Image Models"},{"user_usages":[{"user_uses":10,"user_email":null,"user_credits":900,"user_reference":"usr_7b1d4e0af62c9835"},{"user_uses":4,"user_email":null,"user_credits":360,"user_reference":null}],"tool_name":"magnific-premium-photo-download","user_uses":14,"user_credits":1260,"tool":"Asset Download"}]}]}},"200-classifier":{"summary":"Response - Success","value":{"data":[{"probability":0.94891726970673,"class_name":"not_ai"},{"probability":0.051082730293274,"class_name":"ai"}]}},"200-detail-ai-b2b":{"summary":"Success - Detail AI Photo information","value":{"data":{"download_size":1024,"related_resources":{"suggested":[{"name":"Sports bike","preview":{"height":200,"width":300,"url":"https://www.freepik.com/free-vector/sports-bike_770011.jpg"},"url":"https://www.freepik.com/free-vector/sports-bike_770011.htm","new":true,"id":770011,"has_prompt":true,"premium":false,"slug":"sports-bike","is_ai_generated":true,"type":"vector","author":{"name":"flaticon","avatar":"https://avatar.cdnpk.net/744082.jpg","slug":"flaticon","assets":100,"id":744082}}]},"premium":true,"new":true,"model_type":"Midjourney","model_subtype":"Midjourney 5","related_tags":[{"slug":"coloring-pages","name":"coloring pages"},{"slug":"kawaii-coloring-page","name":"kawaii coloring page"},{"slug":"cute-kawaii","name":"cute kawaii"},{"slug":"adorable","name":"adorable"},{"slug":"chibi","name":"chibi"},{"slug":"line-art","name":"line art"}],"id":770012,"name":"Abstract of white lines background generative ai","available_formats":{"jpg":{"total":1,"items":[{"size":100}]}},"preview":{"height":200,"width":300,"url":"https://www.freepik.com/premium-photo/abstract-white-lines-background-generative-ai_39178780.htm"},"vertical":"photo","is_ai_generated":true,"author":{"name":"flaticon","avatar":"https://avatar.cdnpk.net/744082.jpg","slug":"flaticon","assets":100,"id":744082},"created":"2020-01-01T00:00:00Z","has_prompt":true,"url":"https://www.freepik.com/premium-photo/abstract-white-lines-background-generative-ai_39178780.htm","slug":"abstract-white-lines-background-generative-ai","license":"https://www.freepik.com/profile/license/pdf/4350594","type":"photo","dimensions":{"width":1000,"height":1000}}}},"request-seedream-v5-lite-all-params":{"summary":"Complete request - Seedream V5 Lite","value":{"enable_safety_checker":true,"prompt":"A futuristic cityscape at sunset with neon lights, detailed architecture, volumetric lighting, cinematic composition","webhook_url":"https://your-app.com/webhooks/seedream-v5-lite","seed":12345,"aspect_ratio":"widescreen_16_9"}},"200-analytics-team-groups":{"summary":"Success - List of team groups.","value":{"data":[{"name":"Design Team","group_id":10,"member_count":5,"parent_group_id":null},{"name":"Branding","group_id":15,"member_count":2,"parent_group_id":10},{"name":"Marketing Team","group_id":20,"member_count":8,"parent_group_id":null}]}},"request-tti-all-params":{"summary":"Request - Text to image all params","value":{"guidance_scale":2,"seed":42,"negative_prompt":"b&w, earth, cartoon, ugly","prompt":"Crazy dog in the space","image":{"size":"square_1_1"},"num_images":1,"filter_nsfw":true,"styling":{"style":"anime","effects":{"framing":"portrait","color":"pastel","lightning":"warm"},"colors":[{"color":"#FF5733","weight":1},{"color":"#33FF57","weight":1}]}}},"request-seedream-v5-pro-required-params":{"summary":"Minimal request - Seedream 5.0 Pro","value":{"prompt":"A futuristic cityscape at sunset with neon lights"}},"request-magnific-one-required-params":{"description":"Only `prompt` is required; everything else falls back to its default\n(`quality` mode, `high` quality, `2k`, `1:1`).\n","summary":"Minimum request","value":{"prompt":"A lighthouse on a cliff at dusk"}},"request-seedream-v5-pro-all-params":{"summary":"Complete request - Seedream 5.0 Pro","value":{"seed":12345,"prompt":"A futuristic cityscape at sunset with neon lights, detailed architecture, volumetric lighting, cinematic composition","resolution":"2k","webhook_url":"https://your-app.com/webhooks/seedream-v5-pro","thinking_level":"high","aspect_ratio":"widescreen_16_9"}},"200-loras":{"summary":"Loras response","value":{"data":{"default":[{"name":"vintage-japanese","category":"illustration","preview":"https://example.com/vintage-japanese-preview.jpg","description":"Expect bold red colors and a sense of nostalgia, bringing to life classic Japanese elements.","training":{"status":"completed","defaultScale":1.2},"type":"style","id":1},{"name":"sara","category":"people","preview":"https://example.com/sara-preview.jpg","description":"sara","training":{"status":"completed","defaultScale":1.2},"type":"character","id":2},{"name":"glasses","category":"glasses","preview":"https://example.com/glasses-preview.jpg","description":"glasses","training":{"status":"completed","defaultScale":1.2},"type":"product","id":3}],"customs":[{"name":"sara","category":"photography","preview":"https://example.com/sara-preview.jpg","description":"","training":{"quality":null,"defaultScale":1,"status":"completed"},"type":"character","id":110}]}}},"200-latent-sync-task-completed":{"summary":"Success - Latent-Sync task completed","value":{"data":{"generated":["https://ai-statics.freepik.com/lip-sync-completed-video.mp4"],"task_id":"046b6c7f-0b8a-43b9-b35d-6489e6daee91","status":"COMPLETED"}}},"request-seedream-v5-pro-edit-required-params":{"summary":"Minimal request - Seedream 5.0 Pro Edit","value":{"prompt":"Make the background a snowy mountain landscape","reference_images":["https://example.com/reference-image-1.jpg"]}},"200-download-photo":{"summary":"Success - Download photo","value":{"data":{"filename":"9126.jpg","url":"https://downloadscdn7.freepik.com/188544/10/9126.jpg?filename=painting-mountain-lake-with-mountain-background&token=exp=1691754014~hmac=36873e9be562d19e95671ec4032feb0c"}}},"request-veed-fabric-1-0-all-params":{"summary":"Request - Veed Fabric 1.0 all params","value":{"resolution":"720p","webhook_url":"https://my-webhook-url.com/endpoint","image_url":"https://example.com/portrait.jpg","audio_url":"https://example.com/speech-audio.mp3"}},"request-gpt-image-2-5-edit-all-params":{"description":"Composes one image from three references. Editing is billed as flat units of\nthe low tier by quality (low x1, medium x4, high x6) times num_images;\nresolution does not change the price of an edit.\n","summary":"Every parameter","value":{"reference_images":["https://example.com/subject.jpg","https://example.com/background.jpg","upl_img_0123456789abcdef"],"prompt":"Place the subject from Image0 on the background of Image1, in the style of Image2","resolution":"1k","quality":"high","aspect_ratio":"square_1_1","num_images":2,"output_format":"png","webhook_url":"https://www.example.com/webhook","variant":"sunburst","moderation":"auto","background":"transparent"}},"request-seedream-v5-pro-edit-all-params":{"summary":"Complete request - Seedream 5.0 Pro Edit","value":{"reference_images":["https://example.com/reference-image-1.jpg","https://example.com/reference-image-2.jpg"],"resolution":"2k","prompt":"Make the background a snowy mountain landscape, keep the subject and lighting","webhook_url":"https://your-app.com/webhooks/seedream-v5-pro-edit","seed":12345,"thinking_level":"fast","aspect_ratio":"square_1_1"}},"200-download-ai-resource":{"summary":"Success - Download ai resource","value":{"data":{"url":"https://downloadscdn5.freepik.com/d/999999/23/99999/8888888/lovely-cats.zip?token=exp=1689689298~hmac=1234567890abcde","filename":"lovely-cats.zip","prompt":"There are three lovely cats in the picture. They are playing with each other. They are very cute."}}},"request-veed-fabric-1-0-required-params":{"summary":"Request - Veed Fabric 1.0 required params","value":{"resolution":"720p","image_url":"https://example.com/portrait.jpg","audio_url":"https://example.com/speech-audio.mp3"}},"request-flux-2-flex-required-params":{"summary":"Minimal request with required parameters only","value":{"prompt":"a beautiful sunset over mountains with dramatic clouds"}},"request-flux-2-flex-all-params":{"summary":"Complete request with all parameters","value":{"width":1920,"webhook_url":"https://your-app.com/webhooks/flux-2-flex","height":1080,"prompt_upsampling":false,"guidance":3,"seed":42,"safety_tolerance":5,"output_format":"png","steps":50,"prompt":"a futuristic cityscape at night with neon lights reflecting on wet streets, cyberpunk aesthetic, dramatic lighting, highly detailed"}},"request-recraft-v4-required-params":{"description":"The minimum request. Renders a 1024x1024 image, with the prompt rewritten by\nthe LLM first (`enhance_prompt` defaults to true).\n","summary":"Only the required parameter","value":{"prompt":"A storefront sign that reads OPEN DAILY 9AM, flat vector poster style"}},"200-icon-detail":{"summary":"Success - Icon detail"},"request-flux-2-turbo-required-params":{"summary":"Minimal request with required parameters only","value":{"prompt":"mountain landscape at golden hour with mist"}},"200-b2b-videos-full-list-pagination":{"summary":"All elements with pagination","value":{"data":[{"name":"Cute cat looking at the camera","code":"cute-cat-looking-camera","duration":"00:25","aspect-ratio":"16:9","id":70000,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667335","is_ai_generated":false,"quality":"720p","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2019-01-01T00:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":true,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Cute cat looking at the camera","code":"cute-cat-looking-camera","duration":"00:25","aspect-ratio":"16:9","id":70001,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667336","is_ai_generated":false,"quality":"720p","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2019-01-01T00:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":false,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Portrait of a young man smiling","code":"portrait-young-man-smiling","duration":"00:07","aspect-ratio":"16:9","id":70002,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667337","is_ai_generated":false,"quality":"1080p","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2023-01-01T01:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":true,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Flying along Taksin Bridge","code":"flying-along-taksin-bridge","duration":"00:26","aspect-ratio":"16:9","id":70003,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667338","is_ai_generated":false,"quality":"4k","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2023-01-01T01:00:00Z","item_subtype":"footage","previews":[{"height":264,"width":468,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg"}],"active":true,"premium":true,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Vaccine killing virus","code":"vaccine-killing-virus","duration":"00:27","aspect-ratio":"16:9","id":70004,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667339","is_ai_generated":false,"quality":"1080p","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2023-01-01T01:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":false,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Two friends meet on the street","code":"two-friends-meet-street","duration":"00:19","aspect-ratio":"16:9","id":70005,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_156673340","is_ai_generated":false,"quality":"4k","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2023-01-01T01:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":false,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Cute cat looking at the camera","code":"cute-cat-looking-camera","duration":"00:25","aspect-ratio":"16:9","id":70006,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_156673341","is_ai_generated":false,"quality":"720p","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2019-01-01T00:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":true,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Cute cat looking at the camera","code":"cute-cat-looking-camera","duration":"00:25","aspect-ratio":"16:9","id":70007,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_156673342","is_ai_generated":false,"quality":"720p","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2019-01-01T00:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":false,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Portrait of a young man smiling","code":"portrait-young-man-smiling","duration":"00:07","aspect-ratio":"16:9","id":70008,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_156673343","is_ai_generated":false,"quality":"1080p","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2023-01-01T01:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":true,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Flying along Taksin Bridge","code":"flying-along-taksin-bridge","duration":"00:26","aspect-ratio":"16:9","id":70009,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_156673344","is_ai_generated":false,"quality":"4k","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2023-01-01T01:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":true,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Vaccine killing virus","code":"vaccine-killing-virus","duration":"00:27","aspect-ratio":"16:9","id":70010,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_156673345","is_ai_generated":false,"quality":"1080p","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2023-01-01T01:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":false,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Two friends meet on the street","code":"two-friends-meet-street","duration":"00:19","aspect-ratio":"16:9","id":70011,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_156673346","is_ai_generated":false,"quality":"4k","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2023-01-01T01:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":false,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Cute cat looking at the camera","code":"cute-cat-looking-camera","duration":"00:25","aspect-ratio":"16:9","id":70012,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_156673347","is_ai_generated":false,"quality":"720p","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2019-01-01T00:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":true,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Cute cat looking at the camera","code":"cute-cat-looking-camera","duration":"00:25","aspect-ratio":"16:9","id":70013,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_156673348","is_ai_generated":false,"quality":"720p","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2019-01-01T00:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":false,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Portrait of a young man smiling","code":"portrait-young-man-smiling","duration":"00:07","aspect-ratio":"16:9","id":70014,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667334","is_ai_generated":false,"quality":"1080p","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2023-01-01T01:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":true,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Flying along Taksin Bridge","code":"flying-along-taksin-bridge","duration":"00:26","aspect-ratio":"16:9","id":70015,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667349","is_ai_generated":false,"quality":"4k","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2023-01-01T01:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":true,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Vaccine killing virus","code":"vaccine-killing-virus","duration":"00:27","aspect-ratio":"16:9","id":70016,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667350","is_ai_generated":false,"quality":"1080p","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2023-01-01T01:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":false,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Two friends meet on the street","code":"two-friends-meet-street","duration":"00:19","aspect-ratio":"16:9","id":70017,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667351","is_ai_generated":false,"quality":"4k","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2023-01-01T01:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":false,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Cute cat looking at the camera","code":"cute-cat-looking-camera","duration":"00:25","aspect-ratio":"16:9","id":70018,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667352","is_ai_generated":false,"quality":"720p","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2019-01-01T00:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":true,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Cute cat looking at the camera","code":"cute-cat-looking-camera","duration":"00:25","aspect-ratio":"16:9","id":70019,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667353","is_ai_generated":false,"quality":"720p","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2019-01-01T00:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":false,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Portrait of a young man smiling","code":"portrait-young-man-smiling","duration":"00:07","aspect-ratio":"16:9","id":70020,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667354","is_ai_generated":false,"quality":"1080p","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2023-01-01T01:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":true,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Flying along Taksin Bridge","code":"flying-along-taksin-bridge","duration":"00:26","aspect-ratio":"16:9","id":70021,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667355","is_ai_generated":false,"quality":"4k","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2023-01-01T01:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":true,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Vaccine killing virus","code":"vaccine-killing-virus","duration":"00:27","aspect-ratio":"16:9","id":70022,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667356","is_ai_generated":false,"quality":"1080p","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2023-01-01T01:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":false,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Two friends meet on the street","code":"two-friends-meet-street","duration":"00:19","aspect-ratio":"16:9","id":70023,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667357","is_ai_generated":false,"quality":"4k","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2023-01-01T01:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":false,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Cute cat looking at the camera","code":"cute-cat-looking-camera","duration":"00:25","aspect-ratio":"16:9","id":70024,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_1566735","is_ai_generated":false,"quality":"720p","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2019-01-01T00:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":true,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Cute cat looking at the camera","code":"cute-cat-looking-camera","duration":"00:25","aspect-ratio":"16:9","id":70025,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_1566735","is_ai_generated":false,"quality":"720p","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2019-01-01T00:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":false,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Portrait of a young man smiling","code":"portrait-young-man-smiling","duration":"00:07","aspect-ratio":"16:9","id":70026,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667359","is_ai_generated":false,"quality":"1080p","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2023-01-01T01:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":true,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Flying along Taksin Bridge","code":"flying-along-taksin-bridge","duration":"00:26","aspect-ratio":"16:9","id":70027,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667360","is_ai_generated":false,"quality":"4k","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2023-01-01T01:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":true,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Vaccine killing virus","code":"vaccine-killing-virus","duration":"00:27","aspect-ratio":"16:9","id":70028,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667361","is_ai_generated":false,"quality":"1080p","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2023-01-01T01:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":false,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Two friends meet on the street","code":"two-friends-meet-street","duration":"00:19","aspect-ratio":"16:9","id":70029,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667362","is_ai_generated":false,"quality":"4k","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2023-01-01T01:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":false,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Cute cat looking at the camera","code":"cute-cat-looking-camera","duration":"00:25","aspect-ratio":"16:9","id":70030,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667363","is_ai_generated":false,"quality":"720p","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2019-01-01T00:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":true,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Cute cat looking at the camera","code":"cute-cat-looking-camera","duration":"00:25","aspect-ratio":"16:9","id":70031,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667364","is_ai_generated":false,"quality":"720p","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2019-01-01T00:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":false,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Portrait of a young man smiling","code":"portrait-young-man-smiling","duration":"00:07","aspect-ratio":"16:9","id":70032,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667365","is_ai_generated":false,"quality":"1080p","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2023-01-01T01:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":true,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Flying along Taksin Bridge","code":"flying-along-taksin-bridge","duration":"00:26","aspect-ratio":"16:9","id":70033,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667366","is_ai_generated":false,"quality":"4k","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2023-01-01T01:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":true,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Vaccine killing virus","code":"vaccine-killing-virus","duration":"00:27","aspect-ratio":"16:9","id":70034,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667367","is_ai_generated":false,"quality":"1080p","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2023-01-01T01:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":false,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Two friends meet on the street","code":"two-friends-meet-street","duration":"00:19","aspect-ratio":"16:9","id":70035,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667368","is_ai_generated":false,"quality":"4k","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2023-01-01T01:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":false,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Cute cat looking at the camera","code":"cute-cat-looking-camera","duration":"00:25","aspect-ratio":"16:9","id":70036,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667369","is_ai_generated":false,"quality":"720p","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2019-01-01T00:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":true,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Cute cat looking at the camera","code":"cute-cat-looking-camera","duration":"00:25","aspect-ratio":"16:9","id":70037,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667370","is_ai_generated":false,"quality":"720p","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2019-01-01T00:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":false,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Portrait of a young man smiling","code":"portrait-young-man-smiling","duration":"00:07","aspect-ratio":"16:9","id":70038,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667371","is_ai_generated":false,"quality":"1080p","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2023-01-01T01:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":true,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Flying along Taksin Bridge","code":"flying-along-taksin-bridge","duration":"00:26","aspect-ratio":"16:9","id":70039,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667372","is_ai_generated":false,"quality":"4k","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2023-01-01T01:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":true,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Vaccine killing virus","code":"vaccine-killing-virus","duration":"00:27","aspect-ratio":"16:9","id":70040,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667373","is_ai_generated":false,"quality":"1080p","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2023-01-01T01:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":false,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Two friends meet on the street","code":"two-friends-meet-street","duration":"00:19","aspect-ratio":"16:9","id":70041,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667374","is_ai_generated":false,"quality":"4k","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2023-01-01T01:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":false,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Cute cat looking at the camera","code":"cute-cat-looking-camera","duration":"00:25","aspect-ratio":"16:9","id":70042,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667375","is_ai_generated":false,"quality":"720p","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2019-01-01T00:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":true,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Cute cat looking at the camera","code":"cute-cat-looking-camera","duration":"00:25","aspect-ratio":"16:9","id":70043,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667376","is_ai_generated":false,"quality":"720p","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2019-01-01T00:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":false,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Portrait of a young man smiling","code":"portrait-young-man-smiling","duration":"00:07","aspect-ratio":"16:9","id":70044,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667377","is_ai_generated":false,"quality":"1080p","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2023-01-01T01:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":true,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Flying along Taksin Bridge","code":"flying-along-taksin-bridge","duration":"00:26","aspect-ratio":"16:9","id":70045,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667378","is_ai_generated":false,"quality":"4k","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2023-01-01T01:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":true,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Vaccine killing virus","code":"vaccine-killing-virus","duration":"00:27","aspect-ratio":"16:9","id":70046,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667379","is_ai_generated":false,"quality":"1080p","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2023-01-01T01:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":false,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Two friends meet on the street","code":"two-friends-meet-street","duration":"00:19","aspect-ratio":"16:9","id":70047,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667380","is_ai_generated":false,"quality":"4k","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2023-01-01T01:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":false,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Cute cat looking at the camera","code":"cute-cat-looking-camera","duration":"00:25","aspect-ratio":"16:9","id":70048,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667381","is_ai_generated":false,"quality":"720p","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2019-01-01T00:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":true,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}},{"name":"Cute cat looking at the camera","code":"cute-cat-looking-camera","duration":"00:25","aspect-ratio":"16:9","id":70049,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667382","is_ai_generated":false,"quality":"720p","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2019-01-01T00:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":false,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}}],"meta":{"pagination":{"last_page":40,"per_page":50,"total":2000,"current_page":1}}}},"request-loras-styles":{"summary":"Request - LoRAs styles training","value":{"name":"my-awesome-style","webhook_url":"https://my-webhook-url.com/endpoint","description":"string","images":["string","string","string","string","string","string","string","string"],"quality":"high"}},"request-gpt-image-2-5-edit-required-params":{"description":"A prompt and at least one reference image. With the default\n`aspect_ratio: auto`, the output keeps the reference's aspect ratio — including\nratios outside the preset list.\n","summary":"Minimum request","value":{"prompt":"Put the product on a marble surface, keep the label unchanged","reference_images":["https://example.com/product.jpg"]}},"request-gpt-image-2-5-required-params":{"description":"Only `prompt` is required; everything else falls back to its default (1k,\n`aspect_ratio: auto` so the model picks the shape, medium quality, png,\n`flare`).\n","summary":"Minimum request","value":{"prompt":"A vintage travel poster for Mars, bold sans-serif title, muted orange palette"}},"request-loras-characters":{"summary":"Request - LoRAs characters training","value":{"name":"my-awesome-character","gender":"male","webhook_url":"https://my-webhook-url.com/endpoint","quality":"high","images":["string","string","string","string","string","string","string","string"],"description":"string"}},"request-gpt-image-2-5-all-params":{"description":"A 2K widescreen batch of three JPEGs rendered by the editing-precision model.\nBilled as quality tier x resolution multiplier x num_images — here medium x2\nx3. Note that `xhigh` and `max` are currently billed at the `high` price.\n","summary":"Every parameter","value":{"prompt":"A vintage travel poster for Mars, bold sans-serif title reading VISIT MARS, muted orange palette, subtle grain","resolution":"2k","output_compression":85,"quality":"medium","aspect_ratio":"widescreen_16_9","variant":"sunburst","output_format":"jpeg","webhook_url":"https://www.example.com/webhook","num_images":3,"moderation":"auto","background":"opaque"}},"request-flux-2-klein-required-params":{"summary":"Minimum required parameters","value":{"prompt":"a beautiful sunset over the ocean with dramatic clouds"}},"request-seedream-v4-5-required-params":{"summary":"Minimal request - Seedream 4.5","value":{"prompt":"A professional marketing poster with elegant typography"}},"200-analytics-audit-logs-events":{"summary":"Success - Enterprise audit-log events.","value":{"data":[{"member":{"email":"admin@company.com","auth":{"api_key_id":null,"api_key_name":null,"type":"session"},"type":"user","user_id":10499812},"action":{"correlation_id":"corr-2b8e","resource_id":"18422","event_type":"team.member.role_changed","request_id":"req-7f3a9c1e","data":{"operation":"grant","role":"admin","target_user_id":10511077},"project_name":null,"verb":"update","status":"success","context":{},"old_state":{"role":"member"},"new_state":{"role":"admin"},"duration_ms":42,"folder_name":null},"date":"2026-07-30T09:14:52+00:00","source":{"platform":"web","project":"magnific","referer":null},"category":"member","event_id":"b3d1f0a2-9c4e-4a1b-8f2d-1a2b3c4d5e6f"},{"member":{"email":"admin@company.com","auth":{"api_key_id":"11111111-1111-4111-8111-111111111111","api_key_name":"CI pipeline","type":"api_key"},"type":"user","user_id":10499812},"action":{"correlation_id":null,"resource_id":"a1b2c3d4-1111-4000-8000-000000000001","event_type":"project.folder.shared","request_id":"req-5a1b2c3d","data":{"folder_reference":"a1b2c3d4-1111-4000-8000-000000000001","share_type":"group","outcome":"shared","permission":"editor","group_id":10},"project_name":"Marketing Campaign Q4","verb":"create","status":"success","context":{},"old_state":null,"new_state":null,"duration_ms":18,"folder_name":"Q4 assets"},"date":"2026-07-30T08:02:11+00:00","source":{"platform":"api","project":"magnific","referer":null},"category":"folder","event_id":"c4e2a1b3-0d5f-4b2c-9a3e-2b3c4d5e6f70"}],"meta":{"pagination":{"last_page":5,"per_page":20,"current_page":1,"total":92},"next_cursor":"eyJzIjpbMTcyMjMyOF19"}}},"request-flux-2-klein-all-params":{"summary":"Complete request with all parameters","value":{"seed":42,"resolution":"2k","prompt":"a futuristic cityscape at night with neon lights reflecting on wet streets, cyberpunk aesthetic","webhook_url":"https://your-app.com/webhooks/flux-2-klein","output_format":"png","safety_tolerance":2,"aspect_ratio":"widescreen_16_9"}},"request-recraft-v4-1-required-params":{"description":"The minimum request. Defaults to `tier: mid` and `variant: standard`, so it\nrenders a 1024x1024 image and is billed as Recraft V4.\n","summary":"Only the required parameter","value":{"prompt":"A storefront sign that reads OPEN DAILY 9AM, flat vector poster style"}},"request-reimagine-flux-all-params":{"summary":"Request - Reimagine Flux all params","value":{"imagination":"wild","prompt":"Un hermoso atardecer sobre un océano tranquilo","webhook_url":"https://api.ejemplo.com/webhook","image":"iVBORw0KGgoAAAANSUhEUgAA...","aspect_ratio":"square_1_1"}},"request-recraft-v4-1-all-params":{"description":"A utility render at the pro tier: 2688x1536, no invented colour or ornament,\nprompt sent verbatim. Billed as Recraft V4 Pro, since `tier` is what sets the\nprice — `variant` does not.\n","summary":"Every parameter","value":{"enhance_prompt":false,"prompt":"A mobile app settings screen with a title Settings and three rows: Notifications, Privacy, About","tier":"pro","variant":"utility","webhook_url":"https://www.example.com/webhook","aspect_ratio":"widescreen_16_9"}},"request-latent-sync-required-params":{"summary":"Request - Latent-Sync Lip Sync required params","value":{"video_url":"https://example.com/input-video.mp4","audio_url":"https://example.com/input-audio.mp3"}},"request-reimagine-flux-required-params":{"summary":"Request - Reimagine Flux required params","value":{"image":"iVBORw0KGgoAAAANSUhEUgAA..."}},"request-magnific-one-all-params":{"description":"One 4k widescreen image in `quality` mode, guided by two style references.\nBilled once at the `high` / `4k` price; the references do not change it.\n","summary":"Every parameter","value":{"quality":"high","reference_images":["https://example.com/style-reference-1.jpg","https://example.com/style-reference-2.jpg"],"prompt":"Editorial photo of a lighthouse on a basalt cliff at dusk, long exposure sea, warm window light","mode":"quality","webhook_url":"https://www.example.com/webhook","resolution":"4k","aspect_ratio":"16:9"}},"request-flux-2-turbo-all-params":{"summary":"Complete request with all parameters","value":{"guidance_scale":3.5,"seed":12345,"prompt":"portrait of a smiling person, natural lighting, soft focus background, professional photography","webhook_url":"https://your-app.com/webhooks/flux-2-turbo","image_size":{"width":1024,"height":1024},"enable_safety_checker":true,"output_format":"png"}},"request-flux-2-pro-all-params":{"summary":"Complete request with all parameters","value":{"seed":42,"prompt":"a futuristic cityscape at night with neon lights reflecting on wet streets, cyberpunk aesthetic, dramatic lighting, highly detailed","webhook_url":"https://your-app.com/webhooks/flux-2-pro","height":768,"prompt_upsampling":false,"width":1440}},"request-gpt-image-2-required-params":{"description":"Only `prompt` is required; everything else falls back to its default (1k, square, high quality, png).","summary":"Minimum request","value":{"prompt":"A vintage travel poster for Mars, bold sans-serif title, muted orange palette"}},"request-seedream-v5-lite-required-params":{"summary":"Minimal request - Seedream V5 Lite","value":{"prompt":"A futuristic cityscape at sunset with neon lights"}},"200-tasks-list":{"summary":"Success - Return all tasks","value":{"data":[{"task_id":"046b6c7f-0b8a-43b9-b35d-6489e6daee91","status":"IN_PROGRESS"},{"task_id":"046b6c7f-0b8a-43b9-b35d-6489e6daee92","status":"COMPLETED"},{"task_id":"046b6c7f-0b8a-43b9-b35d-6489e6daee93","status":"COMPLETED"},{"task_id":"046b6c7f-0b8a-43b9-b35d-6489e6daee93","status":"CREATED"}]}},"request-magnific-one-draft":{"description":"Sixteen quick variations, each exactly `3:4`. `quality` and `resolution` are\nignored in `draft` mode; the whole sheet is billed once, at the `medium` /\n`2k` price.\n","summary":"Draft contact sheet","value":{"mode":"draft","prompt":"Poster concepts for a jazz festival by the sea","tiles":16,"aspect_ratio":"3:4"}},"request-gpt-image-2-all-params":{"description":"A 2K widescreen batch of three medium-quality JPEGs. Billed as\nquality tier x resolution multiplier x num_images — here medium x2 x3.\n","summary":"Every parameter","value":{"prompt":"A vintage travel poster for Mars, bold sans-serif title reading VISIT MARS, muted orange palette, subtle grain","resolution":"2k","output_compression":85,"quality":"medium","background":"opaque","output_format":"jpeg","webhook_url":"https://www.example.com/webhook","num_images":3,"moderation":"auto","aspect_ratio":"widescreen_16_9"}},"request-flux-2-pro-required-params":{"summary":"Minimal request with required parameters only","value":{"prompt":"a beautiful sunset over mountains with dramatic clouds"}},"200-b2b-get-download-video-response":{"summary":"Download video response","value":{"data":{"filename":"_import_61490450321f37.49858282.mov","url":"https://joy1.videvo.net/verify_download_video.php?path=video/free/video0466&vid=_import_61490450321f37.49858282.mov&source=freepik&videvo_id=1109082&filename=1109082_1080p_4k_2k_4096x2160.mov&verify=lkdadslfjads3434"}}},"request-z-image-all-params":{"summary":"Complete request - Z-Image","value":{"num_inference_steps":8,"seed":42,"prompt":"A cyberpunk city street at night, neon signs reflecting on wet pavement, flying cars in the distance, highly detailed, cinematic lighting","webhook_url":"https://your-app.com/webhooks/z-image","image_size":"square_hd","output_format":"png","enable_safety_checker":true}},"request-flux-kontext-max-required-params":{"summary":"Minimal request with required parameters only","value":{"prompt":"turn the sky into a dramatic sunset with orange and purple clouds","input_image":"https://example.com/reference-image.jpg"}},"request-z-image-required-params":{"summary":"Minimal request - Z-Image","value":{"prompt":"A suited raccoon smoking a cigar"}},"request-gpt-image-2-edit-required-params":{"description":"A prompt and at least one reference image.","summary":"Minimum request","value":{"prompt":"Put the product on a marble surface, keep the label unchanged","reference_images":["https://example.com/product.jpg"]}},"request-image-upscale-all-params":{"summary":"Example - Upscaler request with all params","value":{"engine":"magnific_sparkle","scale_factor":"2x","webhook_url":"https://httpbin.org/post","optimized_for":"standard","creativity":2,"hdr":1,"resemblance":0,"fractality":-1,"image":"iVBORw0KGgoAAAANSUhEUgAAASwAAAEsAQAAAABRBrPYAAABrElEQVR4nO3BMQEAAADCoPVPbQ0Po...","prompt":"Crazy dog in the space"}},"request-runway-4-5-t2v-all-params":{"summary":"Request - Generate video from text using RunWay Gen 4.5 (all parameters)","value":{"webhook_url":"https://example.com/webhook","ratio":"1280:720","duration":10,"prompt":"A majestic eagle soaring over snow-capped mountains at golden hour, cinematic lighting"}},"200-b2b-full-list-pagination":{"summary":"Success - Found matched resources in English","value":{"data":[{"id":770011,"products":[],"url":"https://www.freepik.com/free-icon/sports-car_770011.htm","stats":{"downloads":52527,"likes":137},"related":{"serie":[],"others":[],"keywords":[]},"licenses":[{"type":"freemium","url":"https://www.freepik.com/profile/license/pdf/770011?lang=en"}],"image":{"orientation":"square","type":"photo","source":{"key":"large","size":"128x128","url":"https://img.flaticon.com/icons/png/512/67/67994.png"}},"filename":"sports-car.zip","meta":{"is_new":true,"available_formats":{"jpg":{"total":2,"items":[{"name":"Sports car","colorspace":"RGB","size":100,"id":444},{"name":"Sports car","colorspace":"RGB","size":200,"id":555}]}},"published_at":"2022-01-14T20:45:28Z"},"title":"Sports car","author":{"name":"flaticon","id":744082,"slug":"flaticon","avatar":"https://avatar.cdnpk.net/744082.jpg"}},{"id":1540200,"products":[{"type":"essential","url":"https://www.freepik.com/profile/license/pdf/1540200?lang=en"}],"url":"https://www.freepik.com/free-vector/grey-car-logo-collection_1540200.htm","stats":{"downloads":1639,"likes":18},"related":{"serie":[],"others":[],"keywords":[]},"licenses":[{"type":"freemium","url":"https://www.freepik.com/profile/license/pdf/1540200?lang=en"}],"image":{"orientation":"square","type":"vector","source":{"key":"large","size":"626x626","url":"https://"}},"filename":"grey-car-logo-collection.zip","meta":{"is_new":true,"available_formats":{"jpg":{"total":2,"items":[{"size":100,"id":444},{"size":200,"id":555}]}},"published_at":"2022-01-14T16:06:23Z"},"title":"Grey car logo collection","author":{"name":"magnific","id":23,"slug":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg"}}],"meta":{"last_page":32,"per_page":2,"current_page":1,"total":63}}},"request-gpt-image-2-edit-all-params":{"description":"Composes one image from three references. Editing is billed as flat units of\nthe low tier by quality (low x1, medium x4, high x6) times num_images;\nresolution does not change the price of an edit.\n","summary":"Every parameter","value":{"reference_images":["https://example.com/subject.jpg","https://example.com/background.jpg","upl_img_0123456789abcdef"],"prompt":"Place the subject from Image0 on the background of Image1, in the style of Image2","resolution":"1k","quality":"high","background":"auto","output_format":"png","webhook_url":"https://www.example.com/webhook","num_images":2,"moderation":"auto","aspect_ratio":"square_1_1"}},"request-veed-fabric-1-0-fast-required-params":{"summary":"Request - Veed Fabric 1.0 Fast required params","value":{"resolution":"720p","image_url":"https://example.com/portrait.jpg","audio_url":"https://example.com/speech-audio.mp3"}},"request-runway-4-5-t2v-required-params":{"summary":"Request - Generate video from text using RunWay Gen 4.5 (required only)","value":{"prompt":"A serene ocean wave crashing on a sandy beach at sunset"}},"request-style-transfer-required-params":{"summary":"Request - Image Style Transfer required params","value":{"image":"iVBORw0KGgoAAAANSUhEUgAA...","reference_image":"iVBORw0KGgoAAAANSUhEUgAA..."}},"request-recraft-v4-all-params":{"description":"A widescreen render at 1344x768, with the prompt sent exactly as written.\n","summary":"Every parameter","value":{"webhook_url":"https://www.example.com/webhook","aspect_ratio":"widescreen_16_9","enhance_prompt":false,"prompt":"A storefront sign that reads OPEN DAILY 9AM, flat vector poster style, cream and navy palette, bold rounded display type"}},"request-runway-4-5-i2v-all-params":{"summary":"Request - Generate video from image using RunWay Gen 4.5 (all parameters)","value":{"seed":12345,"duration":8,"image":"https://storage.googleapis.com/fc-freepik-pro-rev1-eu-static/landing-api/examples/freepik__upload__53227.png","webhook_url":"https://example.com/webhook","ratio":"1280:720","prompt":"The subject slowly opens their eyes and smiles warmly, with a gentle camera zoom"}},"request-seedream-v4-5-all-params":{"summary":"Complete request - Seedream 4.5","value":{"enable_safety_checker":true,"prompt":"Professional marketing poster for a tech startup, minimalist design, bold sans-serif typography, gradient blue background, high contrast","webhook_url":"https://your-app.com/webhooks/seedream-v4-5","seed":12345,"aspect_ratio":"widescreen_16_9"}},"request-style-transfer-all-params":{"summary":"Request - Image Style Transfer all params","value":{"engine":"colorful_anime","prompt":"Transform the image into a modern artistic style","webhook_url":"https://my-webhook-url.com/endpoint","fixed_generation":true,"style_strength":85,"structure_strength":60,"is_portrait":true,"portrait_style":"pop","portrait_beautifier":"beautify_face_max","reference_image":"iVBORw0KGgoAAAANSUhEUgAA...","image":"iVBORw0KGgoAAAANSUhEUgAA...","flavor":"gen_z"}},"200-veed-fabric-1-0-task-completed":{"summary":"Success - Veed Fabric 1.0 task completed","value":{"data":{"generated":["https://ai-statics.freepik.com/lip-sync-veed-fabric-1-0-output.mp4"],"task_id":"046b6c7f-0b8a-43b9-b35d-6489e6daee91","status":"COMPLETED"}}},"request-itv-kling-elements-std-all-params":{"summary":"Request - Kling Elements Standard all params","value":{"duration":"5","prompt":"A beautiful sunset over a calm ocean","webhook_url":"https://webhook.site/123e4567-e89b-12d3-a456-426614174000","negative_prompt":"ugly, deformed, bad anatomy","images":["https://img.freepik.com/foto-gratis/hermosa-foto-olas-mar-cielo-rosa-morado-sol-brillando-hora-dorada_181624-3784.jpg?ga=GA1.1.937563726.1730992487&semt=ais_hybrid&w=740"],"aspect_ratio":"widescreen_16_9"}},"request-runway-4-5-i2v-required-params":{"summary":"Request - Generate video from image using RunWay Gen 4.5 (required only)","value":{"image":"https://storage.googleapis.com/fc-freepik-pro-rev1-eu-static/landing-api/examples/freepik__upload__53227.png","prompt":"The camera slowly pans across the scene revealing more details"}},"request-text-to-icon-all":{"summary":"Request - Text to icon all","value":{"style":"color","prompt":"Sliced avocado and chips","webhook_url":"https://example.com/webhook","format":"svg","num_inference_steps":20,"guidance_scale":7}},"request-latent-sync-all-params":{"summary":"Request - Latent-Sync Lip Sync all params","value":{"guidance_scale":1.2,"video_url":"https://example.com/input-video.mp4","audio_url":"https://example.com/input-audio.mp3","webhook_url":"https://my-webhook-url.com/endpoint","return_private_url":true,"seed":42}},"request-image-to-prompt-url":{"description":"Example request using an image URL for image-to-prompt generation","summary":"Image to Prompt Request - URL Example","value":{"webhook_url":"https://your-app.com/webhooks/image-to-prompt","image":"https://example.com/sample-image.jpg"}},"request-veed-fabric-1-0-fast-all-params":{"summary":"Request - Veed Fabric 1.0 Fast all params","value":{"resolution":"720p","webhook_url":"https://my-webhook-url.com/endpoint","image_url":"https://example.com/portrait.jpg","audio_url":"https://example.com/speech-audio.mp3"}},"request-itv-kling-elements-std-required-params":{"summary":"Request - Kling Elements Standard required params","value":{"images":["https://img.freepik.com/foto-gratis/disparo-aislado-gatito-jengibre-sentado-frente-blanco-mirando-derecha_181624-45937.jpg?semt=ais_hybrid&w=740"]}},"request-itv-kling-elements-pro-required-params":{"summary":"Request - Kling Elements Standard required params","value":{"images":["https://img.freepik.com/foto-gratis/disparo-aislado-gatito-jengibre-sentado-frente-blanco-mirando-derecha_181624-45937.jpg?semt=ais_hybrid&w=740"]}},"request-itv-kling-elements-pro-all-params":{"summary":"Request - Kling Elements Standard all params","value":{"duration":"5","prompt":"A beautiful sunset over a calm ocean","webhook_url":"https://webhook.site/123e4567-e89b-12d3-a456-426614174000","negative_prompt":"ugly, deformed, bad anatomy","images":["https://img.freepik.com/foto-gratis/hermosa-foto-olas-mar-cielo-rosa-morado-sol-brillando-hora-dorada_181624-3784.jpg?ga=GA1.1.937563726.1730992487&semt=ais_hybrid&w=740"],"aspect_ratio":"widescreen_16_9"}},"request-image-to-prompt-base64":{"description":"Example request using base64-encoded image for image-to-prompt generation","summary":"Image to Prompt Request - Base64 Example","value":{"webhook_url":"https://your-app.com/webhooks/image-to-prompt","image":"data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABgAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/2wBDAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/wAARCAABAAEDASIAAhEBAxEB/8QAFQABAQAAAAAAAAAAAAAAAAAAAAv/xAAUEAEAAAAAAAAAAAAAAAAAAAAA/8QAFQEBAQAAAAAAAAAAAAAAAAAAAAX/xAAUEQEAAAAAAAAAAAAAAAAAAAAA/9oADAMBAAIRAxEAPwA/gA=="}},"200-task-failed":{"summary":"Success - Task failed","value":{"data":{"generated":[],"task_id":"046b6c7f-0b8a-43b9-b35d-6489e6daee91","status":"FAILED"}}},"200-detail-photo-b2b":{"summary":"Success - Detail Photo resource information","value":{"data":{"download_size":1024,"related_resources":{"same_series":{"url":"https://www.freepik.com/serie/32689488","items":[{"name":"Sports bike","preview":{"height":200,"width":300,"url":"https://www.freepik.com/free-vector/sports-bike_770011.jpg"},"url":"https://www.freepik.com/free-vector/sports-bike_770011.htm","new":true,"id":770011,"has_prompt":true,"premium":false,"slug":"sports-bike","is_ai_generated":true,"type":"vector","author":{"name":"flaticon","avatar":"https://avatar.cdnpk.net/744082.jpg","slug":"flaticon","assets":100,"id":744082}}]},"same_author":[{"name":"Sports bike","preview":{"height":200,"width":300,"url":"https://www.freepik.com/free-vector/sports-bike_770011.jpg"},"url":"https://www.freepik.com/free-vector/sports-bike_770011.htm","new":true,"id":770011,"has_prompt":true,"premium":false,"slug":"sports-bike","is_ai_generated":true,"type":"vector","author":{"name":"flaticon","avatar":"https://avatar.cdnpk.net/744082.jpg","slug":"flaticon","assets":100,"id":744082}}],"suggested":[{"name":"Sports bike","preview":{"height":200,"width":300,"url":"https://www.freepik.com/free-vector/sports-bike_770011.jpg"},"url":"https://www.freepik.com/free-vector/sports-bike_770011.htm","new":true,"id":770011,"has_prompt":true,"premium":false,"slug":"sports-bike","is_ai_generated":true,"type":"vector","author":{"name":"flaticon","avatar":"https://avatar.cdnpk.net/744082.jpg","slug":"flaticon","assets":100,"id":744082}}],"same_collection":{"url":"https://www.freepik.com/collection/shining/2552","items":[{"name":"Sports bike","preview":{"height":200,"width":300,"url":"https://www.freepik.com/free-vector/sports-bike_770011.jpg"},"url":"https://www.freepik.com/free-vector/sports-bike_770011.htm","new":true,"id":770011,"has_prompt":true,"premium":false,"slug":"sports-bike","is_ai_generated":true,"type":"vector","author":{"name":"flaticon","avatar":"https://avatar.cdnpk.net/744082.jpg","slug":"flaticon","assets":100,"id":744082}}]}},"premium":true,"new":true,"related_tags":[{"name":"coloring pages","slug":"coloring-pages","url":"https://www.freepik.com/free-photos-vectors/coloring-pages"},{"slug":"kawaii-coloring-page","name":"kawaii coloring page"},{"slug":"cute-kawaii","name":"cute kawaii"},{"slug":"adorable","name":"adorable"},{"slug":"chibi","name":"chibi"},{"slug":"line-art","name":"line art"}],"id":770012,"name":"Abstract of white lines background generative ai","available_formats":{"jpg":{"total":1,"items":[{"size":100}]}},"preview":{"height":200,"width":300,"url":"https://www.freepik.com/premium-photo/abstract-white-lines-background-generative-ai_39178780.htm"},"vertical":"photo","is_ai_generated":false,"dimensions":{"width":1000,"height":1000},"url":"https://www.freepik.com/premium-photo/abstract-white-lines-background-generative-ai_39178780.htm","created":"2020-01-01T00:00:00Z","has_prompt":false,"slug":"abstract-white-lines-background-generative-ai","license":"https://www.freepik.com/profile/license/pdf/4350594","type":"photo","author":{"name":"flaticon","avatar":"https://avatar.cdnpk.net/744082.jpg","slug":"flaticon","assets":100,"id":744082}}}},"200-download-vector-or-psd":{"summary":"Success - Download resource","value":{"data":{"filename":"Mother-and-daughter.zip","url":"https://downloadscdn5.freepik.com/d/999999/23/99999/8888888/mother-and-daughter.zip?token=exp=1689689298~hmac=1234567890abcde"}}},"request-improve-prompt-image":{"description":"Example request to improve a prompt for image generation using Gemini","summary":"Improve Prompt Request - Image Type","value":{"type":"image","prompt":"A beautiful landscape"}},"200-b2b-get-video-detail":{"summary":"Video detail","value":{"data":{"name":"Cute cat looking at the camera","code":"cute-cat-looking-camera","duration":"00:25","aspect-ratio":"16:9","id":70000,"url":"https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667335","is_ai_generated":false,"quality":"720p","thumbnails":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"},{"width":1280,"height":720,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg","aspect-ratio":"16:9"}],"created":"2019-01-01T00:00:00Z","item_subtype":"footage","previews":[{"width":468,"height":264,"url":"https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg","aspect-ratio":"16:9"}],"active":true,"premium":true,"author":{"name":"Magnific","code":"magnific","avatar":"https://avatar.cdnpk.net/23.jpg","slug":"magnific","id":23,"metas":{"downloads":555,"assets":2330000}}}}},"200-veed-fabric-1-0-fast-task-completed":{"summary":"Success - Veed Fabric 1.0 Fast task completed","value":{"data":{"generated":["https://ai-statics.freepik.com/lip-sync-veed-fabric-1-0-fast-output.mp4"],"task_id":"046b6c7f-0b8a-43b9-b35d-6489e6daee91","status":"COMPLETED"}}},"200-task-in-progress":{"summary":"Success - Task in progress","value":{"data":{"generated":[],"task_id":"046b6c7f-0b8a-43b9-b35d-6489e6daee91","status":"IN_PROGRESS"}}},"request-improve-prompt-video":{"description":"Example request to improve a prompt for video generation using OpenAI","summary":"Improve Prompt Request - Video Type","value":{"prompt":"A cat playing with a ball","type":"video","language":"en"}},"200-task-completed":{"summary":"Success - Task completed","value":{"data":{"generated":["https://ai-statics.freepik.com/completed_task_image.jpg"],"task_id":"046b6c7f-0b8a-43b9-b35d-6489e6daee91","status":"COMPLETED"}}},"request-recraft-v4-pro-all-params":{"description":"A widescreen render at 2688x1536, with the prompt sent exactly as written.\n","summary":"Every parameter","value":{"webhook_url":"https://www.example.com/webhook","aspect_ratio":"widescreen_16_9","enhance_prompt":false,"prompt":"A storefront sign that reads OPEN DAILY 9AM, flat vector poster style, cream and navy palette, bold rounded display type"}},"request-recraft-v4-pro-required-params":{"description":"The minimum request. Renders a 2048x2048 image — V4 Pro doubles every V4\ndimension — with the prompt rewritten by the LLM first.\n","summary":"Only the required parameter","value":{"prompt":"A storefront sign that reads OPEN DAILY 9AM, flat vector poster style"}},"200-analytics-team-api-keys":{"summary":"Success - List of team API keys.","value":{"data":[{"api_key_id":"fpk-abc123def456","display_name":"Production Backend","created_at":"2026-01-15T10:30:00+00:00","status":"active"},{"api_key_id":"fpk-xyz789ghi012","display_name":"Staging","created_at":"2026-03-20T14:00:00+00:00","status":"active"}]}},"request-improve-prompt-all-params":{"description":"Example request with all available parameters including webhook","summary":"Improve Prompt Request - All Parameters","value":{"webhook_url":"https://your-app.com/webhooks/improve-prompt","prompt":"Un paisaje hermoso con montañas","type":"image","language":"es"}},"request-image-upscale-required-params":{"summary":"Request - Image upscaling required params","value":{"image":"iVBORw0KGgoAAAANSUhEUgAAASwAAAEsAQAAAABRBrPYAAABrElEQVR4nO3BMQEAAADCoPVPbQ0Po..."}},"200-analytics-team-projects":{"summary":"Success - List of team projects.","value":{"data":[{"project_reference":"a1b2c3d4-1111-4000-8000-000000000001","name":"Marketing Campaign Q4","budget":{"consumed":5000000,"available":10000000,"assigned":15000000}},{"project_reference":"b2c3d4e5-2222-4000-8000-000000000002","name":"Product Launch Assets","budget":null},{"project_reference":"c3d4e5f6-3333-4000-8000-000000000003","name":"Social Media Templates","budget":null}]}},"request-image-relight-all-params":{"summary":"Example - Relight request with all params","value":{"style":"smooth","light_transfer_strength":100,"transfer_light_from_reference_image":"iVBORw0KGgoAAAANSUhEUgAAASwAAAEsAQAAAABRBrPYAAABrElEQVR4nO3BMQEAAADCoPVPbQ0Po...","image":"iVBORw0KGgoAAAANSUhEUgAAASwAAAEsAQAAAABRBrPYAAABrElEQVR4nO3BMQEAAADCoPVPbQ0Po...","interpolate_from_original":false,"change_background":true,"prompt":"A sunlit forest clearing at golden hour","advanced_settings":{"engine":"illusio","fixed_generation":true,"whites":60,"blacks":60,"brightness":30,"contrast":40,"saturation":50,"transfer_light_a":"low","transfer_light_b":"soft_in"}}}},"parameters":{"term":{"name":"term","schema":{"type":"string"},"example":"nature","in":"query","description":"Search term. If only term comes, it is searched for term, if only slug comes, it is searched for slug and if both come, it is searched for slug","required":false},"accept-language":{"name":"Accept-Language","schema":{"type":"string"},"example":"en-US","in":"header","description":"Specifies the search query language using the ISO 639-1 (2-letter\nlanguage code) and the ISO 3166-1 (2-letter country code) for language variants.\nThe API will use \"en-US\" as a default language for processing if a code is not\nprovided, or does not exist.\n","required":false},"term-required":{"name":"term","schema":{"type":"string"},"example":"nature","in":"query","description":"Search term. This filter is required whenever the author filter parameter is not in the request. In case you use it with some of these params, response will be error 400, Bad request. This is a temporary causality.","required":true},"family-id":{"name":"family-id","schema":{"minimum":1,"type":"integer"},"example":30955,"in":"query","description":"Icon family id.","required":false},"sfx-id":{"name":"sfx-id","schema":{"type":"integer"},"example":1,"in":"path","description":"Unique numeric identifier of the sound effect","required":true},"per_page":{"name":"per_page","schema":{"type":"integer"},"example":100,"description":"Results per page. It must be greater than 0.","in":"query"},"slug":{"name":"slug","schema":{"type":"string"},"example":"dog","in":"query","description":"Search by slug","required":false},"resource_id_string":{"name":"resource-id","schema":{"type":"string"},"example":30955,"in":"path","description":"Photo, video or PSD resource ID","required":true},"basic-order":{"name":"order","schema":{"default":"relevance","enum":["relevance","recent"],"type":"string"},"example":"relevance","in":"query","description":"Define order of results.\n- Note: If the term or slug parameter is used, the order will be the similarity of the search.\n","required":false},"icon-id":{"name":"id","schema":{"type":"integer"},"example":30955,"in":"path","description":"Icon resource ID","required":true},"resource-id":{"name":"resource-id","schema":{"type":"integer"},"example":30955,"in":"path","description":"Photo, video or PSD resource ID","required":true},"page-with-reduced-maximum":{"name":"page","schema":{"type":"integer"},"example":1,"in":"query","description":"Page number. It must be greater than 0 and less than or equal to 100.","required":false},"order_relevance_recent":{"name":"order","schema":{"default":"relevance","enum":["relevance","recent"],"type":"string"},"example":"recent","in":"query","description":"Specifies the order in which search results are returned. The available options allow you to prioritize results based on different criteria:\n - `relevance`: Prioritizes results that are most relevant to the search query.\n - `recent`: Sorts results by the most recent updates.\n","required":false},"resource-format":{"in":"path","schema":{"example":"svg","enum":["psd","ai","eps","atn","fonts","resources","png","jpg","3d-render","svg","mockup"],"type":"string"},"required":true,"description":"Resource format","name":"resource-format"},"image-size-custom":{"name":"image_size","schema":{"$ref":"#/components/schemas/download_resource_by_id_image_size_parameter"},"example":"2000px","in":"query","description":"Resizes the photo to a specified size while maintaining aspect ratio. Accepts a pixel value (100px to 2000px) or \nkeywords small(1000px), medium(1500px), large(2000px), original corresponding to standard website sizes.\nThe size depends on the image orientation, the longest side of the image will be resized to the specified size.\nIf not specified, the highest resolution is provided. Applicable only to photos.\n","required":false},"limit":{"name":"limit","schema":{"type":"integer"},"example":100,"in":"query","description":"Limit results per page. It must be greater than 0.","required":false},"thumbnail-size":{"name":"thumbnail_size","schema":{"type":"string"},"example":"128, 512","in":"query","description":"Size of the thumbnail. \nIf the size is not specified, the API will return 128 as a default size.\n","required":false},"music-id":{"name":"music-id","schema":{"type":"integer"},"example":1,"in":"path","description":"Unique numeric identifier of the music item","required":true},"icon-format-b2b":{"name":"format","schema":{"type":"string","enum":["svg","png","gif","mp4","aep","json","psd","eps"]},"example":"svg","description":"These are the formats available for download\n- Note: gif, mp4, aep, json, psd and eps are not available for standard and sticker icon types.\n","in":"query"},"icon-png-size":{"in":"query","name":"png_size","schema":{"default":512,"enum":[512,256,128,64,32,24,16],"type":"integer"},"description":"These are the sizes available for png_url formats.\n- Note: Only apply to format png.\n"},"page":{"name":"page","schema":{"type":"integer"},"example":1,"in":"query","description":"Page number. It must be greater than 0.","required":false},"order-videos":{"in":"query","schema":{"default":"relevance","enum":["relevance","recent","random"],"type":"string"},"required":false,"description":"Define order of results.\n","name":"order"},"video-id":{"name":"id","schema":{"minimum":1,"type":"integer"},"example":30955,"in":"path","description":"Video id","required":true},"video-option-id":{"name":"option-id","schema":{"minimum":1,"type":"integer"},"example":12345,"in":"path","description":"Video option id","required":true}},"responses":{"400-bad-request":{"description":"Bad Request - The server could not understand the request due to invalid syntax.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inline_object"},"examples":{"invalid_query":{"summary":"Parameter 'query' is not valid","value":{"message":"Parameter 'query' must not be empty"}},"invalid_page":{"summary":"Parameter 'page' is not valid","value":{"message":"Parameter 'page' must be greater than 0"}},"generic_bad_request":{"summary":"Bad Request","value":{"message":"Parameter ':attribute' is not valid"}},"invalid_filter":{"summary":"Parameter 'filter' is not valid","value":{"message":"Parameter 'filter' is not valid"}}}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/inline_object_1"},"examples":{"invalid_page":{"summary":"Parameter 'page' is not valid","value":{"message":"Validation error","invalid_params":[{"field":"page","reason":"Parameter 'page' must be greater than 0"},{"field":"per_page","reason":"Parameter 'per_page' must be greater than 0"}]}}}}}},"task-list-200-default-response":{"description":"OK - Returns a list of tasks for the current type of Task","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"}}}},"404-not-found-for-search":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inline_object_5"}}}},"401-unauthorized":{"description":"Unauthorized - The client must authenticate itself to get the requested response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inline_object"},"examples":{"missing_api_key":{"summary":"API key is not provided","value":{"message":"Missing API key"}},"invalid_api_key":{"summary":"API key is not valid","value":{"message":"Invalid API key"}}}}}},"run-detail-200-response":{"description":"OK - Run status and result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inline_object_9"},"examples":{"running":{"summary":"Run still in progress","value":{"data":{"app_id":"uqzQLDr2Aw","started_at":"2026-02-25T12:00:00+00:00","status":"running","result":null,"error_message":null,"completed_at":null,"run_id":"omps2OH829"}}},"failed":{"summary":"Failed run","value":{"data":{"app_id":"uqzQLDr2Aw","started_at":"2026-02-25T12:00:00+00:00","status":"failed","result":null,"error_message":"Node 'image-upscaler' failed: input image exceeds maximum resolution","completed_at":"2026-02-25T12:01:30+00:00","run_id":"omps2OH829"}}},"completed":{"summary":"Completed run with image results","value":{"data":{"app_id":"uqzQLDr2Aw","started_at":"2026-02-25T12:00:00+00:00","status":"completed","result":{"videos":[],"audios":[],"images":[{"id":"abc123","duration":null,"width":1024,"created_at":"2026-02-25T12:02:00+00:00","height":1024,"tool":"text-to-image","url":"https://pikaso.cdnpk.net/private/production/1234567890/render.png?token=exp_1234567890~hmac_abc123"}]},"error_message":null,"completed_at":"2026-02-25T12:02:00+00:00","run_id":"omps2OH829"}}}}}}},"task-detail-200-default-response":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inline_object_4"},"examples":{"success - created task":{"$ref":"#/components/examples/200-task-created"},"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - failed task":{"$ref":"#/components/examples/200-task-failed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"422-unprocessable-entity":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inline_object"},"examples":{"generic":{"summary":"Generic message for 422 errors","value":{"message":"Unprocessable entity"}}}}}},"429-too-many-requests":{"description":"Too Many Requests - The client has sent too many requests in a given amount of time.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inline_object"},"examples":{"generic":{"summary":"Generic message for 429 errors","value":{"message":"Too many requests"}},"edit_limit_reached":{"summary":"Free user icon edit limits has been reached.","value":{"message":"Limit for free users reached."}},"download_limit_reached":{"summary":"The download limits has been reached.","value":{"message":"The user can't download more items because the download limits has been reached."}}}}}},"404-not-found":{"description":"Not Found - The server can not find the requested resource.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inline_object"},"examples":{"resource_not_found":{"summary":"Resource with provided id does not exist","value":{"message":"Resource not found"}},"resources_not_found":{"summary":"Resources not found","value":{"message":"Resources not found"}},"user_not_found":{"summary":"User with provided id does not exist","value":{"message":"User not found"}},"country_not_found":{"summary":"Country with provided code does not exist","value":{"message":"Country not found"}},"video_not_found":{"summary":"Video with provided id does not exist","value":{"message":"Video not found"}},"generic_not_found":{"summary":"Not Found","value":{"message":"Not found"}},"ai_resource_not_found":{"summary":"AI resource with provided id does not exist","value":{"message":"AI resource not found"}},"video_assets_not_found":{"summary":"Video with provided id has not associated assets","value":{"message":"Video not found"}},"collection_not_found":{"summary":"Collection with provided id does not exist","value":{"message":"Collection not found"}},"icon_not_found":{"summary":"Icon with provided id does not exist","value":{"message":"Icon not found"}},"author_not_found":{"summary":"Author with provided id does not exist","value":{"message":"Author not found"}},"developer_not_found":{"summary":"Developer with provided email does not exist","value":{"message":"Developer not found"}}}}}},"403-forbidden":{"description":"Forbidden - The client does not have permission to access the requested resource.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inline_object"},"examples":{"item_is_premium":{"summary":"The user cannot download this item because it is premium","value":{"message":"The user cannot download this item because it is premium"}},"user_not_owner":{"summary":"Collection author id is different from current user's id","value":{"message":"User is not owner of requested collection"}},"user_not_authorized":{"summary":"User has not privileges to access some resource","value":{"message":"User is not authorized to access this resource"}},"creator_not_authorized":{"summary":"Creator has not privileges to access some resource","value":{"message":"Creator is not authorized to access this resource"}},"transaction_stats_access_denied":{"summary":"Group admin is not allowed to access the requested transaction stats","value":{"message":"Access denied to transaction stats for the current role"}},"credit_filter_not_allowed":{"summary":"Group admin tried to use a credit-usage filter dimension not allowed for their role","value":{"message":"Credit filter not allowed for the current role"}}}}}},"list-200-response":{"description":"OK - List of flows.","content":{"application/json":{"example":{"data":[{"name":"Sketch to Realism","tool_metadata":{"sort_order":999,"total_cost":5,"category":"general","icon":"workflow","description_key":null,"translation_key":null},"sqid":"uqzQLDr2Aw"},{"name":"Product Photoshoot","tool_metadata":{"sort_order":999,"total_cost":8,"category":"general","icon":"workflow","description_key":null,"translation_key":null},"sqid":"n0LYQDBl58"},{"name":"Anime Style Transfer","tool_metadata":{"sort_order":999,"total_cost":5,"category":"general","icon":"workflow","description_key":null,"translation_key":null},"sqid":"hCivqLJltZ"}]},"schema":{"$ref":"#/components/schemas/inline_object_6"}}}},"500-internal-server-error":{"description":"Internal Server Error - The server has encountered a situation it doesn't know how to handle.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inline_object_2"}}}},"detail-200-response":{"description":"OK - Flow definition with inputs and cost.","content":{"application/json":{"example":{"data":{"name":"Sketch to Realism","tool_metadata":{"sort_order":999,"total_cost":5,"category":"general","icon":"workflow","description_key":null,"translation_key":null},"sqid":"uqzQLDr2Aw","inputs":[{"required":true,"config":{"mediaType":"image"},"key":"image","default":null,"nodeId":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","api_key":"image","presentation":null,"label":"Image","type":"creation","id":"input-a1b2c3d4-e5f6-7890-abcd-ef1234567890-1"}]}},"schema":{"$ref":"#/components/schemas/inline_object_7"}}}},"run-202-response":{"description":"Accepted - Flow execution started. Use the webhook to receive results.","content":{"application/json":{"example":{"status":"running","workflow_run_identifier":"vCrK3Aa47y"},"schema":{"$ref":"#/components/schemas/inline_object_8"}}}},"503-service-unavailable":{"description":"Service Unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inline_object_3"}}}}}},"paths":{"/v1/ai/skin-enhancer/{task-id}":{"get":{"summary":"Skin Enhancer - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"tags":["skin-enhancer"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/sound-effects/{sfx-id}/download":{"get":{"tags":["Sound Effects"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SfxDownloadResponse"}}}},"404":{"$ref":"#/components/responses/404-not-found"},"500":{"$ref":"#/components/responses/500-internal-server-error"}},"parameters":[{"name":"sfx-id","schema":{"type":"integer"},"example":1,"in":"path","description":"Unique numeric identifier of the sound effect","required":true}],"description":"Get a direct download URL for a sound effect audio file. Returns the sound effect ID, title, and a CDN-hosted download link.","summary":"Download a sound effect","operationId":"download_sound_effect"}},"/v1/ai/image-to-video/wan-2-5-i2v-720p/{task-id}":{"get":{"tags":["image-to-video"],"description":"Get the status of a WAN 2.5 Image-to-Video 720p task","summary":"WAN 2.5 I2V 720p - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/ai/text-to-video/happy-horse-1-1/{task-id}":{"get":{"tags":["text-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Retrieve the status and result of a specific Happy Horse 1.1 text-to-video task by its ID.","summary":"Happy Horse 1.1 T2V - Get task status","operationId":"get_happy_horse_1_1_t2v_task"}},"/v1/ai/text-to-image/flux-2-pro/{task-id}":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task status retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Retrieve the status and results of a specific Flux 2 Pro generation task.","summary":"Flux 2 Pro - Get task status","operationId":"get_flux_2_pro_task"}},"/v1/ai/text-to-image/runway/{task-id}":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"404":{"$ref":"#/components/responses/404-not-found"},"200":{"description":"OK - Get the task detail","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"}}}}},"400":{"$ref":"#/components/responses/400-bad-request"},"500":{"$ref":"#/components/responses/500-internal-server-error"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Get the status and result of a specific RunWay text-to-image task","summary":"Get RunWay text-to-image task by ID","operationId":"get_runway_text_to_image_task_status"}},"/v1/ai/image-to-video/kling-o1-pro-video-reference":{"post":{"tags":["image-to-video","kling-o1-pro-video-reference","background_tasks"],"operationId":"postAiImageToVideoKlingO1ProVideoReference","responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/task-detail-200-default-response"}}}},"400":{"$ref":"#/components/responses/400-bad-request"},"500":{"$ref":"#/components/responses/500-internal-server-error"}},"summary":"Kling O1 Pro - Create video with reference","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/itvko1-video-reference-request"}}}}}},"/v1/ai/image-to-video/wan-2-5-i2v-1080p/{task-id}":{"get":{"tags":["image-to-video"],"description":"Get the status of a WAN 2.5 Image-to-Video 1080p task","summary":"WAN 2.5 I2V 1080p - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/ai/text-to-image/seedream-v4-edit":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of all Seedream v4 edit tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Seedream 4 Edit - List tasks","description":"Get the status of all Seedream v4 edit tasks","operationId":"get_all_seedream_v4_edit_tasks"},"post":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The request has succeeded and the Seedream v4 edit process has started.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Convert descriptive text input into images using AI. This endpoint accepts a variety of parameters to customize the generated images.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ttisd-edit-request-content"}}}},"summary":"Seedream 4 - Edit image","operationId":"create_image_from_text_seedream_v4_edit"}},"/v1/ai/improve-prompt/{task-id}":{"get":{"tags":["improve-prompt"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-improve-prompt-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string","format":"uuid"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Get the status of one improve-prompt task","summary":"Improve Prompt - Get task status","operationId":"get_improve_prompt_task_status"}},"/v1/ai/image-to-video/happy-horse-1-1/{task-id}":{"get":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Retrieve the status and result of a specific Happy Horse 1.1 image-to-video task by its ID.","summary":"Happy Horse 1.1 I2V - Get task status","operationId":"get_happy_horse_1_1_i2v_task"}},"/v1/ai/video/seedance-2-mini":{"get":{"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"}},"summary":"Seedance 2.0 Mini - List all tasks","tags":["video"],"operationId":"get_seedance_2_mini_tasks"}},"/v1/ai/image-to-video/kling-o1-std-video-reference":{"post":{"tags":["image-to-video","kling-o1-std-video-reference","background_tasks"],"operationId":"postAiImageToVideoKlingO1StdVideoReference","responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/task-detail-200-default-response"}}}},"400":{"$ref":"#/components/responses/400-bad-request"},"500":{"$ref":"#/components/responses/500-internal-server-error"}},"summary":"Kling O1 Standard - Create video with reference","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/itvko1-video-reference-request"}}}}}},"/v1/ai/text-to-image/flux-2-flex/{task-id}":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task status retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Retrieve the status and results of a specific Flux 2 Flex generation task.","summary":"Flux 2 Flex - Get task status","operationId":"get_flux_2_flex_task"}},"/v1/ai/video-edit/wan-2-7":{"get":{"tags":["video-edit"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"WAN 2.7 Video Edit - List tasks","description":"Retrieve the list of all WAN 2.7 video edit tasks for the authenticated user.","operationId":"get_all_wan_27_video_edit_tasks"},"post":{"tags":["video-edit"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Edit an existing video using WAN 2.7. Transform video content with text instructions, apply visual references, or transfer artistic styles.\n\n**Three editing modes:**\n- **Instruction-based editing**: Provide `prompt` with editing instructions (e.g., \"change the sky to sunset\")\n- **Reference-image editing**: Provide `prompt` and `image_urls` to apply visual references to the video\n- **Style transfer**: Provide `prompt` and `image_urls` with style reference images to transfer artistic styles\n\n**Key features:**\n- 720P and 1080P resolution support\n- Up to 3 reference images for editing or style transfer\n- Set `duration` to `0` to preserve the full input video duration\n- Configurable audio handling: auto-generate or preserve original\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/video-edit-request"}}}},"summary":"WAN 2.7 - Edit video","operationId":"create_video_wan_27_edit"}},"/v1/ai/video/seedance-2-pro-1080p":{"get":{"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Seedance 2.0 Pro 1080p - List tasks","tags":["video"],"operationId":"get_all_seedance_2_pro_1080p_tasks"},"post":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate 1080p video using Seedance 2.0 Pro. Supports text-to-video and image-to-video with optional first and last frame images for transition videos. Also supports reference-to-video: attach up to 9 reference images via `reference_images` and mention them in the prompt with @Image1..@Image9.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/seedance-2-request"}}}},"summary":"Seedance 2.0 Pro 1080p - Create video from text or image","operationId":"create_video_seedance_2_pro_1080p"}},"/v1/ai/text-to-image/seedream-v4":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of all Seedream v4 tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Seedream 4 - List tasks","description":"Get the status of all Seedream v4 tasks","operationId":"get_all_seedream_v4_tasks"},"post":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The request has succeeded and the Seedream v4 process has started.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Convert descriptive text input into images using AI. This endpoint accepts a variety of parameters to customize the generated images.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ttisd-request-content"}}}},"summary":"Seedream 4 - Create image from text","operationId":"create_image_from_text_seedream_v4"}},"/v1/ai/reference-to-video/happy-horse-1-1/{task-id}":{"get":{"tags":["reference-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Retrieve the status and result of a specific Happy Horse 1.1 reference-to-video task by its ID.","summary":"Happy Horse 1.1 R2V - Get task status","operationId":"get_happy_horse_1_1_r2v_task"}},"/v1/ai/image-to-video/kling-o1":{"get":{"summary":"Kling O1 - List tasks","description":"Get the list of the kling-o1 tasks","tags":["image-to-video","kling-o1"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The list of the kling-o1 tasks is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/ai/image-to-video/pixverse-v5/{task-id}":{"get":{"summary":"PixVerse V5 - Get task status","parameters":[{"in":"path","schema":{"type":"string","format":"uuid"},"required":true,"description":"ID of the task","name":"task-id"}],"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/ai/image-to-video/kling-v2-5-720p":{"get":{"summary":"Kling 2.5 720p - List tasks","description":"Get the list of the kling-v2-5-720p tasks","tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The list of the kling-v2-5-720p tasks is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}},"post":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of the kling-v2-5-720p task","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_image_from_text_flux_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a video from an image using the Kling 2.5 model at 720p resolution. For 1080p, use `/v1/ai/image-to-video/kling-v2-5-pro`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/itvkv2-5-pro-request-content"}}}},"summary":"Kling 2.5 720p - Create video from image","operationId":"create_video_kling_2_5_720p"}},"/v1/ai/text-to-image/flux-2-turbo/{task-id}":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task status retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Retrieve the status and results of a specific Flux 2 Turbo generation task.","summary":"Flux 2 Turbo - Get task status","operationId":"get_flux_2_turbo_task"}},"/v1/ai/image-to-video/pixverse-v5-transition/{task-id}":{"get":{"summary":"PixVerse V5 Transition - Get task status","parameters":[{"in":"path","schema":{"type":"string","format":"uuid"},"required":true,"description":"ID of the task","name":"task-id"}],"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/ai/video/seedance-2-pro-480p":{"get":{"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Seedance 2.0 Pro 480p - List tasks","tags":["video"],"operationId":"get_all_seedance_2_pro_480p_tasks"},"post":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate 480p video using Seedance 2.0 Pro. Supports text-to-video and image-to-video with optional first and last frame images for transition videos. Also supports reference-to-video: attach up to 9 reference images via `reference_images` and mention them in the prompt with @Image1..@Image9.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/seedance-2-request"}}}},"summary":"Seedance 2.0 Pro 480p - Create video from text or image","operationId":"create_video_seedance_2_pro_480p"}},"/v1/ai/image-to-video/ltx-2-pro/{task-id}":{"get":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"LTX Video 2.0 Pro I2V - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"operationId":"get_ltx_2_pro_i2v_task"}},"/v1/ai/text-to-image/ideogram-4":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of all Ideogram 4 tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Get the status of all Ideogram 4 tasks","description":"Get the status of all Ideogram 4 image generation tasks","operationId":"get_all_ideogram_4_tasks"},"post":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The request has succeeded and the Ideogram 4 process has started.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate images from text with Ideogram 4.\n\n**Key Features:**\n- Accurate text rendering for posters, logos and typography\n- 15 aspect ratios, from `3:1` to `1:3`, always at about 4 megapixels\n- Optional negative prompt, Magic Prompt control and seed\n\n**Best for:**\n- Posters, flyers and social graphics with legible text\n- Logos and typographic designs\n\n**Credits:** the price is set by `rendering_speed` (`TURBO`, `DEFAULT` or\n`QUALITY`). The other parameters do not affect it.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/tti-ideogram-4-request"}}}},"summary":"Create image from text - Ideogram 4","operationId":"create_image_from_text_ideogram_4"}},"/v1/ai/image-to-video/kling-v2-5-pro":{"get":{"summary":"Kling 2.5 Pro - List tasks","description":"Get the list of the kling-v2-5-pro tasks","tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The list of the kling-v2-5-pro tasks is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}},"post":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of the kling-v2-5-pro task","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_image_from_text_flux_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a video from an image using the Kling 2.5 Pro model.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/itvkv2-5-pro-request-content"}}}},"summary":"Kling 2.5 Pro - Create video from image","operationId":"create_video_kling_2_5_pro"}},"/v1/ai/image-to-video/ltx-2-fast/{task-id}":{"get":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"LTX Video 2.0 Fast I2V - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"operationId":"get_ltx_2_fast_i2v_task"}},"/v1/ai/text-to-image/flux-2-klein/{task-id}":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task status retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Retrieve the status and results of a specific FLUX.2 [klein] generation task.","summary":"Flux 2 Klein - Get task status","operationId":"get_flux_2_klein_task"}},"/v1/ai/video/seedance-2-pro-4k":{"get":{"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Seedance 2.0 Pro 4K - List tasks","tags":["video"],"operationId":"get_all_seedance_2_pro_4k_tasks"},"post":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate 4K video using Seedance 2.0 Pro. Supports text-to-video and image-to-video with optional first and last frame images for transition videos. Also supports reference-to-video: attach up to 9 reference images via `reference_images` and mention them in the prompt with @Image1..@Image9.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/seedance-2-request"}}}},"summary":"Seedance 2.0 Pro 4K - Create video from text or image","operationId":"create_video_seedance_2_pro_4k"}},"/v1/ai/video/kling-v3-motion-control-std/{task-id}":{"get":{"tags":["video","kling-v3-motion-control-std"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Retrieve the status and result of a specific Kling 3 Standard Motion Control video generation task by its task ID.","summary":"Kling 3 Standard Motion Control - Get task status","operationId":"getAiVideoKlingV3MotionControlStdTask"}},"/v1/ai/audio-isolation":{"get":{"tags":["audio-isolation"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - List of audio isolation tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_sound_effects_tasks_200_response"},"examples":{"success":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Audio Isolation - List tasks","description":"Get the status of all audio isolation tasks","operationId":"get_all_audio_isolation_tasks"},"post":{"tags":["audio-isolation"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Isolate and extract specific sounds from audio or video files using SAM Audio AI technology.\nDescribe the sound you want to isolate, and the API separates it from background noise.\n\n**Use cases:**\n- Extract speech from noisy recordings\n- Isolate musical instruments from a mix\n- Separate specific sound effects from video audio\n- Remove background noise while preserving target sounds\n\n**Input options:**\n- Provide either an `audio` URL/base64 or a `video` URL/base64 (mutually exclusive)\n- Supported audio formats: WAV, MP3, FLAC, OGG, M4A\n- Supported video formats: MP4, MOV, WEBM, AVI\n- For video input, use bounding box coordinates (x1, y1, x2, y2) to focus on a specific region\n\n**Output:** WAV audio file containing the isolated sound\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/request_14"},"examples":{"audio-input":{"summary":"Isolate speech from audio","value":{"description":"A person speaking","audio":"https://example.com/noisy-recording.wav"}},"video-input":{"summary":"Isolate sound from video region","value":{"y1":50,"x2":400,"y2":300,"video":"https://example.com/concert.mp4","x1":100,"description":"Piano playing","sample_fps":2}}}}}},"summary":"Audio Isolation - Extract sounds from audio/video","operationId":"create_audio_isolation_task"}},"/v1/ai/text-to-image/nano-banana-2-1":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of all Nano Banana 2.1 tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Get the status of all Nano Banana 2.1 tasks","description":"Get the status of all Nano Banana 2.1 image generation tasks","operationId":"get_all_nano_banana_2_1_tasks"},"post":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The request has succeeded and the Nano Banana 2.1 process has started.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate or edit images with Google's Nano Banana 2.1 model.\n\n**Key Features:**\n- Text-to-image and image editing in the same endpoint: send up to 14\n  reference images to edit, combine, or keep characters and products\n  consistent\n- Wide aspect ratio range, from `8:1` banners to `1:8` vertical strips,\n  plus `auto` to follow the reference images\n- Optional `thinking_level` for complex prompts\n- Optional Google Search grounding\n- Resolutions up to 4K\n\n**Best for:**\n- Product and brand visuals built from reference images\n- Character and product consistency across generations\n- Complex prompts with many constraints\n\n**Credits:** the price is set by `resolution` (`1K`, `2K` or `4K`).\n`thinking_level` and `use_google_search_tool` do not affect it.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/tti-nano-banana-2-1-request"}}}},"summary":"Create image from text - Nano Banana 2.1","operationId":"create_image_from_text_nano_banana_2_1"}},"/v1/ai/image-upscaler/{task-id}":{"get":{"tags":["image-upscaler"],"description":"Get the status of the upscaling task","summary":"Upscaler Creative - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/ai/video/kling-v2-6-motion-control-pro":{"post":{"tags":["video","kling-v2-6-motion-control-pro","background_tasks"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/task-detail-200-default-response"}}}},"400":{"$ref":"#/components/responses/400-bad-request"},"500":{"$ref":"#/components/responses/500-internal-server-error"}},"description":"Transfer motion from a reference video to a character image using Kling 2.6 Pro. The model preserves the character's appearance while applying motion patterns from the reference video.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/motion-control-request"}}}},"summary":"Kling 2.6 Pro - Motion control video","operationId":"postAiVideoKlingV26MotionControlPro"}},"/v1/ai/text-to-image/seedream-v4/{task-id}":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Get the status of the Seedream v4 task","summary":"Seedream 4 - Get task status","operationId":"get_seedream_v4_task_status"}},"/v1/ai/video/kling-v3/{task-id}":{"get":{"tags":["video","kling-v3"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Retrieve the status and result of a specific Kling 3 video generation task by its task ID.","summary":"Kling 3 - Get task status","operationId":"getAiVideoKlingV3Task"}},"/v1/ai/image-upscaler-precision/{task-id}":{"get":{"tags":["upscaler-precision"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string","format":"uuid"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Returns the current status and output URL of a specific precision upscaler task. The output URL is included only if the task has completed successfully.","summary":"Upscaler Precision - Get task status","operationId":"getAiImageUpscalerPrecisionTask"}},"/v1/ai/text-to-image/nano-banana-pro":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of all Nano Banana Pro tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Get the status of all Nano Banana Pro tasks","description":"Get the status of all Nano Banana Pro image generation tasks","operationId":"get_all_nano_banana_pro_tasks"},"post":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The request has succeeded and the Nano Banana Pro process has started.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate high-quality images from text descriptions using Google's Nano Banana Pro model (Gemini 3).\n\n**Key Features:**\n- Advanced image generation with complex compositions\n- Support for reference images for guided generation\n- Multiple aspect ratios and resolutions\n- High-quality output up to 4K resolution\n\n**Best for:**\n- High-quality image generation\n- Complex scene compositions\n- Reference-guided generation\n- Professional visual content\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/tti-nano-banana-pro-request"}}}},"summary":"Create image from text - Nano Banana Pro","operationId":"create_image_from_text_nano_banana_pro"}},"/v1/ai/text-to-image/seedream-v4-edit/{task-id}":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Get the status of the Seedream v4 edit task","summary":"Seedream 4 Edit - Get task status","operationId":"get_seedream_v4_edit_task_status"}},"/v1/ai/beta/text-to-image/reimagine-flux":{"post":{"tags":["reimagine-flux"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"Success - The image has been generated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/task-detail"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Flux Reimagine - Transform image","description":"(Beta, synchronous) Reimagine Flux is a new AI model that allows you to generate images from text prompts.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/reimagine-flux-request"},"examples":{"all-params":{"$ref":"#/components/examples/request-reimagine-flux-all-params"},"required-params":{"$ref":"#/components/examples/request-reimagine-flux-required-params"}}}}}}},"/v1/ai/image-upscaler-precision-v2/{task-id}":{"get":{"tags":["upscaler-precision"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string","format":"uuid"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Returns the current status and output URL of a specific precision upscaler V2 task. The output URL is included only if the task has completed successfully.","summary":"Upscaler Precision V2 - Get task status","operationId":"getAiImageUpscalerPrecisionV2Task"}},"/v1/ai/classifier/image":{"post":{"tags":["classifier"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The request has succeeded, and the image has been classified.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/detect_ai_image_200_response"},"examples":{"success":{"$ref":"#/components/examples/200-classifier"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Accepts an image file as input and analyzes it to determine the probability that the image was generated by artificial intelligence, providing a confidence score.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/classifier-request"},"examples":{"image-base64":{"$ref":"#/components/examples/request-classifier-image-base64"},"image-url":{"$ref":"#/components/examples/request-classifier-image-url"}}}}},"summary":"Analyzes an image to determine its likelihood of being AI-generated","operationId":"detect_ai_image"}},"/v1/ai/flows":{"get":{"tags":["flows"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"200":{"$ref":"#/components/responses/list-200-response"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"500":{"$ref":"#/components/responses/500-internal-server-error"}},"parameters":[{"name":"search","schema":{"maxLength":200,"type":"string"},"example":"cartoon","in":"query","description":"Filter flows by name (case-insensitive substring match).","required":false}],"description":"Returns all flows **published as tools** that the authenticated user can execute.\nEach item includes the flow identifier, name, and tool metadata.\n\nFlows are visual AI pipelines built in [Magnific Spaces](https://www.magnific.com/spaces).\nEach flow chains together multiple AI tools (upscale, generate, edit, etc.) and can be executed via API.\n\n**Use this endpoint to discover** runnable flows, then call the detail endpoint to get input definitions before running them.\n","summary":"Flows - List flows","operationId":"list_flows"}},"/v1/ai/video/kling-v3-omni/{task-id}":{"get":{"tags":["video","kling-v3-omni"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Retrieve the status and result of a specific Kling 3 Omni video generation task by its task ID.","summary":"Kling 3 Omni - Get task status","operationId":"getAiVideoKlingV3OmniTask"}},"/v1/ai/video-upscaler/{task-id}":{"get":{"tags":["video-upscaler"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string","format":"uuid"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Returns the current status and output URL of a specific video upscaler task. The output URL is included only if the task has completed successfully.","summary":"Video Upscaler - Get task status","operationId":"getAiVideoUpscalerTask"}},"/v1/ai/text-to-image/seedream-v4-5/{task-id}":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Get the status of a specific Seedream 4.5 image generation task","summary":"Seedream 4.5 - Get task status","operationId":"get_seedream_v4_5_task_status"}},"/v1/ai/image-to-video/runway-4-5":{"get":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"RunWay Gen 4.5 I2V - List tasks","description":"Retrieve the status of all RunWay Gen 4.5 image-to-video generation tasks for the authenticated user.","operationId":"get_all_runway_45_i2v_tasks"},"post":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate high-quality videos from images using RunWay Gen 4.5 model.\n\n**Features:**\n- Transform static images into dynamic videos\n- Precise motion control via text prompts\n- Multiple aspect ratios for different use cases\n- Duration options: 5, 8, or 10 seconds\n- Reproducible results with seed parameter\n\n**Supported aspect ratios:**\n- `1280:720`: Landscape (16:9) - ideal for YouTube, presentations\n- `720:1280`: Portrait (9:16) - ideal for TikTok, Instagram Reels\n- `1104:832`: Landscape (4:3) - classic format\n- `960:960`: Square (1:1) - ideal for Instagram posts\n- `832:1104`: Portrait (3:4) - ideal for Pinterest\n\n**Use cases:** Product animations, social media content, marketing videos, and bringing photos to life.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/i2v-request_3"},"examples":{"all-params":{"$ref":"#/components/examples/request-runway-4-5-i2v-all-params"},"required-only":{"$ref":"#/components/examples/request-runway-4-5-i2v-required-params"}}}}},"summary":"Create video from image - RunWay Gen 4.5","operationId":"create_video_runway_45_i2v"}},"/v1/ai/text-to-image/seedream-v4-5":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of all Seedream 4.5 tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Seedream 4.5 - List tasks","description":"Get the status of all Seedream 4.5 image generation tasks","operationId":"get_all_seedream_v4_5_tasks"},"post":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The request has succeeded and the Seedream 4.5 process has started.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate high-quality images from text descriptions using ByteDance's Seedream 4.5 model.\n\n**Key Features:**\n- Superior typography and text rendering\n- Excellent poster composition and branded visuals\n- Up to 4MP resolution support (2048x2048)\n- Enhanced editing consistency\n\n**Best for:**\n- Marketing materials with text\n- Professional posters and banners\n- Branded visual content\n- High-resolution image generation\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ttisdv45-request-content"},"examples":{"required-params":{"$ref":"#/components/examples/request-seedream-v4-5-required-params"},"all-params":{"$ref":"#/components/examples/request-seedream-v4-5-all-params"}}}}},"summary":"Seedream 4.5 - Create image from text","operationId":"create_image_from_text_seedream_v4_5"}},"/v1/ai/gemini-2-5-flash-image-preview":{"get":{"summary":"Gemini 2.5 Flash - List tasks","tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}},"post":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Gemini 2.5 Flash - Create or edit image","description":"This endpoint allows you to generate or edit images using the Gemini 2.5 Flash model. You can provide a prompt for image generation, or include reference images for image editing and style transfer. The model supports both text-to-image generation and image-to-image editing with up to 3 reference images.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/request-content_7"}}}}}},"/v1/ai/text-to-video/pixverse-v5":{"get":{"summary":"PixVerse V5 Text-to-Video - List tasks","description":"List PixVerse-V5 text-to-video tasks.","tags":["text-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}},"post":{"tags":["text-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a video from a text prompt using the PixVerse-V5 text-to-video model. Control aspect ratio, resolution, duration and visual style directly from the request body.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/request_8"}}}},"summary":"PixVerse V5 - Create video from text","operationId":"create_pixverse_v5_text_to_video"}},"/v1/ai/text-to-image/seedream-v4-5-edit/{task-id}":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Get the status of a specific Seedream 4.5 image editing task","summary":"Seedream 4.5 Edit - Get task status","operationId":"get_seedream_v4_5_edit_task_status"}},"/v1/ai/video-upscaler-precision/{task-id}":{"get":{"tags":["video-upscaler-precision"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string","format":"uuid"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Returns the current status and output URL of a specific video upscaler precision task. The output URL is included only if the task has completed successfully.","summary":"Video Upscaler Precision - Get task status","operationId":"getAiVideoUpscalerPrecisionTask"}},"/v1/ai/text-to-video/runway-4-5":{"get":{"tags":["text-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"RunWay Gen 4.5 T2V - List tasks","description":"Retrieve the status of all RunWay Gen 4.5 text-to-video generation tasks for the authenticated user.","operationId":"get_all_runway_45_t2v_tasks"},"post":{"tags":["text-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate high-quality videos from text descriptions using RunWay Gen 4.5 model.\n\n**Features:**\n- State-of-the-art text-to-video generation\n- Multiple aspect ratios for different use cases\n- Duration options: 5, 8, or 10 seconds\n- High visual fidelity and motion quality\n\n**Supported aspect ratios:**\n- `1280:720`: Landscape (16:9) - ideal for YouTube, presentations\n- `720:1280`: Portrait (9:16) - ideal for TikTok, Instagram Reels\n- `1104:832`: Landscape (4:3) - classic format\n- `960:960`: Square (1:1) - ideal for Instagram posts\n- `832:1104`: Portrait (3:4) - ideal for Pinterest\n\n**Use cases:** Social media content, marketing videos, creative projects, and visual storytelling.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/t2v-request_3"},"examples":{"all-params":{"$ref":"#/components/examples/request-runway-4-5-t2v-all-params"},"required-only":{"$ref":"#/components/examples/request-runway-4-5-t2v-required-params"}}}}},"summary":"Create video from text - RunWay Gen 4.5","operationId":"create_video_runway_45_t2v"}},"/v1/ai/reference-to-video/kling-v3-omni/{task-id}":{"get":{"tags":["reference-to-video","kling-v3-omni-r2v"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Retrieve the status and result of a specific Kling 3 Omni reference-to-video task (Pro or Standard) by its task ID.","summary":"Kling 3 Omni Reference-to-Video - Get task status","operationId":"getAiReferenceToVideoKlingV3OmniTask"}},"/v1/ai/text-to-image/seedream-v5-lite-edit":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of all Seedream V5 Lite edit tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Seedream V5 Lite Edit - List tasks","description":"Get the status of all Seedream V5 Lite image editing tasks","operationId":"get_all_seedream_v5_lite_edit_tasks"},"post":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The request has succeeded and the Seedream V5 Lite edit process has started.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Edit images using ByteDance's Seedream V5 Lite model with text guidance.\n\n**Key Features:**\n- Preserves subject details, lighting, and color tone\n- Supports up to 5 reference images\n- Enhanced editing consistency\n- Up to 4MP output resolution\n\n**Best for:**\n- Image-to-image editing\n- Style transfer with consistency\n- Multi-image reference editing\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ttisdv5l-edit-request-content"}}}},"summary":"Seedream V5 Lite - Edit image","operationId":"create_image_edit_seedream_v5_lite"}},"/v1/ai/image-to-video/happy-horse-1-1":{"get":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Happy Horse 1.1 I2V - List tasks","description":"Retrieve the list of all Happy Horse 1.1 image-to-video tasks for the authenticated user.","operationId":"get_all_happy_horse_1_1_i2v_tasks"},"post":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Animate a single image into a high-quality AI video using Happy Horse 1.1, Alibaba's image-to-video model. The image is used as the first frame and an optional text prompt guides motion and style.\n\n**Key features:**\n- 720P and 1080P resolution support\n- Duration: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, or 15 seconds\n- Optional prompt up to 2500 characters\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/i2v-request_2"}}}},"summary":"Happy Horse 1.1 - Create video from image","operationId":"create_video_happy_horse_1_1_i2v"}},"/v1/ai/text-to-video/pixverse-v6":{"get":{"summary":"PixVerse V6 Text-to-Video - List tasks","description":"List PixVerse-V6 text-to-video tasks.","tags":["text-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}},"post":{"tags":["text-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a video from a text prompt using the PixVerse-V6 text-to-video model.\n\nCompared to PixVerse-V5.5, version 6 adds:\n- Flexible duration: any integer from `1` to `15` seconds (previously fixed to `5`, `8` or `10`).\n- Extended aspect ratios: `2:3`, `3:2` and `21:9` in addition to `16:9`, `4:3`, `1:1`, `3:4` and `9:16`.\n\nExisting PixVerse-V5.5 features are kept: native audio (`generate_audio_switch`), multi-clip output (`generate_multi_clip_switch`) and prompt reasoning enhancement (`thinking_type`).\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/request_10"}}}},"summary":"PixVerse V6 - Create video from text","operationId":"create_pixverse_v6_text_to_video"}},"/v1/ai/video-upscaler-topaz/{task-id}":{"get":{"tags":["video-upscaler-topaz"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string","format":"uuid"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Returns the current status and output URL of a specific video upscaler topaz task. The output URL is included only if the task has completed successfully.","summary":"Video Upscaler Topaz - Get task status","operationId":"getAiVideoUpscalerTopazTask"}},"/v1/ai/video/kling-4k-i2v/{task-id}":{"get":{"tags":["video","kling-4k-i2v"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Retrieve the status and result of a specific Kling 4K Image-to-Video task by its task ID.","summary":"Kling 4K I2V - Get task status","operationId":"getAiVideoKling4kI2vTask"}},"/v1/ai/text-to-image/seedream-v5-pro-edit/{task-id}":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Get the status of a specific Seedream 5.0 Pro image editing task","summary":"Seedream 5.0 Pro Edit - Get task status","operationId":"get_seedream_v5_pro_edit_task_status"}},"/v1/ai/text-to-image/seedream-v5-lite/{task-id}":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Get the status of a specific Seedream V5 Lite image generation task","summary":"Seedream V5 Lite - Get task status","operationId":"get_seedream_v5_lite_task_status"}},"/v1/ai/video/runway-act-two":{"get":{"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"RunWay Act Two - List tasks","tags":["video"],"operationId":"get_all_runway_act_two_tasks"},"post":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a character performance video using RunWay Act Two model. Transfer facial expressions and body movements from a reference video to a character image or video.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/runway-act-two-request"}}}},"summary":"RunWay Act Two Character Performance","operationId":"create_video_runway_act_two"}},"/v1/ai/text-to-image/seedream-v5-lite":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of all Seedream V5 Lite tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Seedream V5 Lite - List tasks","description":"Get the status of all Seedream V5 Lite image generation tasks","operationId":"get_all_seedream_v5_lite_tasks"},"post":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The request has succeeded and the Seedream V5 Lite process has started.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate high-quality images from text descriptions using ByteDance's Seedream V5 Lite model.\n\n**Key Features:**\n- Improved detail and composition over previous versions\n- Up to 4MP resolution support\n- Various aspect ratios available\n- Optional seed for reproducibility\n\n**Best for:**\n- High-quality image generation\n- Detailed scenes and compositions\n- Cinematic and artistic imagery\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ttisdv5l-request-content"},"examples":{"required-params":{"$ref":"#/components/examples/request-seedream-v5-lite-required-params"},"all-params":{"$ref":"#/components/examples/request-seedream-v5-lite-all-params"}}}}},"summary":"Seedream V5 Lite - Create image from text","operationId":"create_image_from_text_seedream_v5_lite"}},"/v1/ai/reference-to-video/happy-horse-1-1":{"get":{"tags":["reference-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Happy Horse 1.1 R2V - List tasks","description":"Retrieve the list of all Happy Horse 1.1 reference-to-video tasks for the authenticated user.","operationId":"get_all_happy_horse_1_1_r2v_tasks"},"post":{"tags":["reference-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a high-quality AI video guided by 1 to 9 reference images that define characters, objects or scenes using Happy Horse 1.1, Alibaba's reference-to-video model.\n\n**How to use references:**\n- Provide 1 to 9 reference images via `image_urls`\n- Reference each image in the prompt by its 1-based positional index (`character1`, `character2`, ...)\n- The order of `image_urls` matches the character index in the prompt\n\n**Key features:**\n- 720P and 1080P resolution support\n- 9 aspect ratio options\n- Duration range: 3-15 seconds\n- Optional bottom-right \"Happy Horse\" watermark\n- Prompt up to 5000 characters\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/r2v-request_2"}}}},"summary":"Happy Horse 1.1 - Create video from reference images","operationId":"create_video_happy_horse_1_1_r2v"}},"/v1/ai/voiceover/elevenlabs-turbo-v2-5/{task-id}":{"get":{"tags":["voiceover"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string","format":"uuid"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Get the status of one voiceover task","summary":"Voiceover - Get task status","operationId":"get_voiceover_task_status"}},"/v1/ai/image-relight/{task-id}":{"get":{"tags":["image-relight"],"description":"Get the status of the relight task","summary":"Relight - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/ai/loras/characters":{"post":{"tags":["loras"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The request has succeeded and the character is processing","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"LoRAs training for custom characters","description":"Create you own custom character using LoRAs training\n\nFor now you can check the status of the training calling `v1/ai/loras`. We are working on it\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/loras-character-request"},"examples":{"characters-request":{"$ref":"#/components/examples/request-loras-characters"}}}}}}},"/v1/ai/text-to-image/seedream-v5-lite-edit/{task-id}":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Get the status of a specific Seedream V5 Lite image editing task","summary":"Seedream V5 Lite Edit - Get task status","operationId":"get_seedream_v5_lite_edit_task_status"}},"/v1/ai/loras/styles":{"post":{"tags":["loras"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The request has succeeded and the style is processing","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Mystic LoRA Styles - Train custom style","description":"Create you own custom style using LoRAs training\n\nFor now you can check the status of the training calling `v1/ai/loras`. We are working on it\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/loras-style-request"},"examples":{"characters-request":{"$ref":"#/components/examples/request-loras-styles"}}}}}}},"/v1/ai/text-to-image/seedream-v5-pro-edit":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of all Seedream 5.0 Pro edit tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Seedream 5.0 Pro Edit - List tasks","description":"Get the status of all Seedream 5.0 Pro image editing tasks","operationId":"get_all_seedream_v5_pro_edit_tasks"},"post":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The request has succeeded and the Seedream 5.0 Pro edit process has started.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Edit images using ByteDance's Seedream 5.0 Pro model with text guidance.\n\n**Key Features:**\n- Preserves subject details, lighting, and color tone\n- Supports up to 10 reference images\n- Enhanced editing consistency\n- Selectable resolution tiers (1.5K, 2K)\n\n**Best for:**\n- Image-to-image editing\n- Style transfer with consistency\n- Multi-image reference editing\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ttisdv5p-edit-request-content"},"examples":{"required-params":{"$ref":"#/components/examples/request-seedream-v5-pro-edit-required-params"},"all-params":{"$ref":"#/components/examples/request-seedream-v5-pro-edit-all-params"}}}}},"summary":"Seedream 5.0 Pro - Edit image","operationId":"create_image_edit_seedream_v5_pro"}},"/v1/ai/image-to-video/kling-v3-turbo-1080p":{"post":{"tags":["video","kling-v3-turbo-i2v-1080p","background_tasks"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/task-detail-200-default-response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate AI video from a first-frame image using Kling 3.0 Turbo at 1080p resolution, a fast image-to-video model from the Kling 3.0 family.\n\n**Features:**\n- **Image-to-video**: Animate a static image into a dynamic video\n- **Optional prompt**: Guide the motion and animation style with text\n- **Resolution**: Fixed 1080p output\n- **Duration**: 3-15 seconds\n\n**How it works:**\n1. Submit an image (URL or Base64) to use as the first frame, with an optional prompt\n2. Receive a task ID to track progress\n3. Poll the status endpoint or use a `webhook_url` to get notified when the task completes\n4. Download the generated video from the result URL (valid for 30 minutes)\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/kling-v3-turbo-i2v-request"}}}},"summary":"Kling 3.0 Turbo I2V 1080p - Generate video","operationId":"postAiImageToVideoKlingV3Turbo1080p"}},"/v1/ai/text-to-image/recraft-v4/{task-id}":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Get the status of a specific Recraft V4 image generation task","summary":"Get the status of a Recraft V4 task","operationId":"get_recraft_v4_task_status"}},"/v1/ai/video/kling-v3-omni-std":{"post":{"tags":["video","kling-v3-omni-std","background_tasks"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/task-detail-200-default-response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate AI video using Kling 3 Omni Standard with advanced multi-modal capabilities.\n\n**Features:**\n- **Text-to-video**: Generate videos from text prompts\n- **Image-to-video**: Use start and/or end frame images to guide generation\n- **Multi-shot**: Create videos with up to 6 shots (max 15s total)\n- **Element control**: Include reference images for consistent character/style\n\n**Duration:** 3-15 seconds\n**Quality:** Standard mode offers faster generation at slightly lower quality.\n\n**Note:** For video-to-video generation using a reference video, use the `/ai/reference-to-video/kling-v3-omni-std` endpoint instead.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/kling-v3-omni-request"}}}},"summary":"Kling 3 Omni Standard - Generate video from text or image","operationId":"postAiVideoKlingV3OmniStd"}},"/v1/ai/text-to-video/kling-v3-turbo-1080p":{"post":{"tags":["video","kling-v3-turbo-t2v-1080p","background_tasks"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/task-detail-200-default-response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate AI video from a text prompt using Kling 3.0 Turbo at 1080p resolution, a fast text-to-video model from the Kling 3.0 family.\n\n**Features:**\n- **Text-to-video**: Generate videos from detailed text prompts\n- **Resolution**: Fixed 1080p output\n- **Aspect ratio**: Landscape (16:9), portrait (9:16), or square (1:1)\n- **Duration**: 3-15 seconds\n\n**How it works:**\n1. Submit a text prompt describing your desired video\n2. Receive a task ID to track progress\n3. Poll the status endpoint or use a `webhook_url` to get notified when the task completes\n4. Download the generated video from the result URL (valid for 30 minutes)\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/kling-v3-turbo-t2v-request"}}}},"summary":"Kling 3.0 Turbo T2V 1080p - Generate video","operationId":"postAiTextToVideoKlingV3Turbo1080p"}},"/v1/ai/text-to-video/kling-v3-turbo/{task-id}":{"get":{"tags":["video","kling-v3-turbo-t2v"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Retrieve the status and result of a specific Kling 3.0 Turbo T2V task by its task ID, regardless of the resolution it was created at.","summary":"Kling 3.0 Turbo T2V - Get task status","operationId":"getAiTextToVideoKlingV3TurboTask"}},"/v1/ai/text-to-image/runway":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of all RunWay tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Get the status of all RunWay text-to-image tasks","description":"Get the status of all RunWay text-to-image generation tasks","operationId":"get_all_runway_text_to_image_tasks"},"post":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The request has succeeded and the RunWay process has started.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate high-quality images from text descriptions using RunWay's Gen4 Image model.\n\n**Key Features:**\n- Photorealistic and artistic image generation\n- Multiple aspect ratios supported\n- Reference image support with @tag syntax\n- High-resolution output\n\n**Best for:**\n- Photorealistic images\n- Artistic and creative visuals\n- Marketing and promotional content\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ttirunway-request-content"}}}},"summary":"Create image from text - RunWay","operationId":"create_image_from_text_runway"}},"/v1/ai/image-to-video/kling-v3-turbo-720p":{"post":{"tags":["video","kling-v3-turbo-i2v-720p","background_tasks"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/task-detail-200-default-response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate AI video from a first-frame image using Kling 3.0 Turbo at 720p resolution, a fast image-to-video model from the Kling 3.0 family.\n\n**Features:**\n- **Image-to-video**: Animate a static image into a dynamic video\n- **Optional prompt**: Guide the motion and animation style with text\n- **Resolution**: Fixed 720p output\n- **Duration**: 3-15 seconds\n\n**How it works:**\n1. Submit an image (URL or Base64) to use as the first frame, with an optional prompt\n2. Receive a task ID to track progress\n3. Poll the status endpoint or use a `webhook_url` to get notified when the task completes\n4. Download the generated video from the result URL (valid for 30 minutes)\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/kling-v3-turbo-i2v-request"}}}},"summary":"Kling 3.0 Turbo I2V 720p - Generate video","operationId":"postAiImageToVideoKlingV3Turbo720p"}},"/v1/ai/text-to-image/seedream-v5-pro":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of all Seedream 5.0 Pro tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Seedream 5.0 Pro - List tasks","description":"Get the status of all Seedream 5.0 Pro image generation tasks","operationId":"get_all_seedream_v5_pro_tasks"},"post":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The request has succeeded and the Seedream 5.0 Pro process has started.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate high-quality images from text descriptions using ByteDance's Seedream 5.0 Pro model.\n\n**Key Features:**\n- Flagship image quality with high-fidelity detail\n- Strong prompt adherence and superior composition\n- Selectable resolution tiers (1.5K, 2K)\n- Various aspect ratios available\n- Optional seed for reproducibility\n\n**Best for:**\n- Professional and large-format imagery\n- Detailed scenes and complex compositions\n- Cinematic and artistic visuals\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ttisdv5p-request-content"},"examples":{"required-params":{"$ref":"#/components/examples/request-seedream-v5-pro-required-params"},"all-params":{"$ref":"#/components/examples/request-seedream-v5-pro-all-params"}}}}},"summary":"Seedream 5.0 Pro - Create image from text","operationId":"create_image_from_text_seedream_v5_pro"}},"/v1/ai/video/kling-v3-omni":{"get":{"tags":["video","kling-v3-omni"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The list of Kling 3 Omni tasks is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Kling 3 Omni - List tasks","description":"Retrieve the list of all Kling 3 Omni video generation tasks for the authenticated user.","operationId":"getAiVideoKlingV3OmniTasks"}},"/v1/ai/mystic/{task-id}":{"get":{"tags":["mystic"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-mystic-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Get the status of the Mystic task","summary":"Mystic - Get task status","operationId":"get_mystic_task_status"}},"/v1/ai/voiceover/elevenlabs-v4/{task-id}":{"get":{"tags":["voiceover"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string","format":"uuid"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Get the status of one ElevenLabs v4 voiceover task","summary":"Voiceover ElevenLabs v4 - Get task status","operationId":"get_voiceover_elevenlabs_v4_task_status"}},"/v1/ai/text-to-image/flux-2-klein":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Successfully retrieved all Flux 2 Klein tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Flux 2 Klein - List tasks","description":"Retrieve the status of all FLUX.2 [klein] text-to-image generation tasks for the authenticated user.","operationId":"get_all_flux_2_klein_tasks"},"post":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_image_from_text_flux_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate images with sub-second speed using FLUX.2 [klein], the fastest model in the FLUX.2 family by Black Forest Labs.\n\n**Key Features:**\n- Sub-second generation time\n- Up to 4 reference images for style/subject transfer\n- 10 preset aspect ratios with 1k or 2k resolution options\n- Adjustable safety tolerance (0-5)\n- Multiple output formats (PNG/JPEG)\n\n**Use Cases:**\n- Real-time applications requiring fast generation\n- Style transfer with reference images\n- Rapid prototyping and iteration\n- High-volume image generation\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ttif2k-request-content"},"examples":{"required-params":{"$ref":"#/components/examples/request-flux-2-klein-required-params"},"all-params":{"$ref":"#/components/examples/request-flux-2-klein-all-params"}}}}},"summary":"Flux 2 Klein - Create image from text","operationId":"create_image_flux_2_klein"}},"/v1/ai/text-to-image/recraft-v4-pro/{task-id}":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Get the status of a specific Recraft V4 Pro image generation task","summary":"Get the status of a Recraft V4 Pro task","operationId":"get_recraft_v4_pro_task_status"}},"/v1/ai/video/kling-v2-6-motion-control-std":{"post":{"tags":["video","kling-v2-6-motion-control-std","background_tasks"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/task-detail-200-default-response"}}}},"400":{"$ref":"#/components/responses/400-bad-request"},"500":{"$ref":"#/components/responses/500-internal-server-error"}},"description":"Transfer motion from a reference video to a character image using Kling 2.6 Standard. The model preserves the character's appearance while applying motion patterns from the reference video.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/motion-control-request"}}}},"summary":"Kling 2.6 Standard - Motion control video","operationId":"postAiVideoKlingV26MotionControlStd"}},"/v1/ai/image-to-video/kling-v3-turbo/{task-id}":{"get":{"tags":["video","kling-v3-turbo-i2v"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Retrieve the status and result of a specific Kling 3.0 Turbo I2V task by its task ID, regardless of the resolution it was created at.","summary":"Kling 3.0 Turbo I2V - Get task status","operationId":"getAiImageToVideoKlingV3TurboTask"}},"/v1/ai/video/kling-v3-pro":{"post":{"tags":["video","kling-v3-pro","background_tasks"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/task-detail-200-default-response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate AI video using Kling 3 Pro with text-to-video or image-to-video capabilities.\n\n**Features:**\n- **Text-to-video**: Generate videos from text prompts\n- **Image-to-video**: Use start and/or end frame images to guide generation\n- **Multi-shot**: Create videos with up to 6 shots (max 15s total)\n- **Element control**: Include reference images for consistent character/style\n\n**Duration:** 3-15 seconds\n**Quality:** Pro mode offers highest quality output with longer processing time.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/kling-v3-request"}}}},"summary":"Kling 3 Pro - Generate video","operationId":"postAiVideoKlingV3Pro"}},"/v1/ai/image-to-video/kling-v3-turbo":{"get":{"tags":["video","kling-v3-turbo-i2v"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The list of tasks is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Kling 3.0 Turbo I2V - List tasks","description":"Retrieve the list of all Kling 3.0 Turbo I2V tasks for the authenticated user, across all resolutions.","operationId":"getAiImageToVideoKlingV3TurboTasks"}},"/v1/ai/image-to-video/kling-v2-6-pro":{"post":{"tags":["image-to-video","kling-v2-6-pro","background_tasks"],"operationId":"postAiImageToVideoKlingV26Pro","responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Kling 2.6 Pro - Create video from text or image","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/postAiImageToVideoKlingV26Pro_request"}}}}}},"/v1/ai/text-to-video/kling-v3-turbo":{"get":{"tags":["video","kling-v3-turbo-t2v"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The list of tasks is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Kling 3.0 Turbo T2V - List tasks","description":"Retrieve the list of all Kling 3.0 Turbo T2V tasks for the authenticated user, across all resolutions.","operationId":"getAiTextToVideoKlingV3TurboTasks"}},"/v1/ai/video/kling-advanced-custom-elements/{task-id}":{"get":{"operationId":"getAiVideoKlingAdvancedCustomElementsTask","tags":["video","advanced-custom-elements"],"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"deprecated":true,"description":"**Deprecated.** This endpoint is deprecated. You can pass reference images directly in the `elements` array\nof the Kling V3 video generation endpoints (`/ai/video/kling-v3-pro`, `/ai/video/kling-v3-std`)\nwithout needing to pre-create elements.\n\nRetrieve the status and result of a specific Advanced Custom Elements creation task by its task ID.\n","summary":"Advanced Custom Elements - Get task status","responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/ai/text-to-image/recraft-v4-1/{task-id}":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Get the status of a specific Recraft V4.1 image generation task","summary":"Get the status of a Recraft V4.1 task","operationId":"get_recraft_v4_1_task_status"}},"/v1/ai/image-to-video/kling-v2-6":{"get":{"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Kling 2.6 Pro - List tasks","tags":["image-to-video","kling-v2-6"],"operationId":"getAiImageToVideoKlingV26Tasks"}},"/v1/ai/lip-sync/latent-sync":{"get":{"tags":["lip-sync"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of all Latent-Sync lip-sync tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Latent Sync - List tasks","description":"Get the status of all Latent-Sync lip-sync tasks","operationId":"get_all_latent_sync_tasks"},"post":{"tags":["lip-sync"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate lip-synced video by synchronizing a video with an audio file using AI Latent-Sync technology","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/request"},"examples":{"all-params":{"$ref":"#/components/examples/request-latent-sync-all-params"},"required-params":{"$ref":"#/components/examples/request-latent-sync-required-params"}}}}},"summary":"Latent Sync - Lip-sync video generation","operationId":"create_latent_sync_lip_sync"}},"/v1/ai/video/kling-v3":{"get":{"tags":["video","kling-v3"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The list of Kling 3 tasks is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Kling 3 - List tasks","description":"Retrieve the list of all Kling 3 video generation tasks for the authenticated user.","operationId":"getAiVideoKlingV3Tasks"}},"/v1/sound-effects":{"get":{"tags":["Sound Effects"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedSfxListResponse"}}}},"400":{"$ref":"#/components/responses/400-bad-request"},"500":{"$ref":"#/components/responses/500-internal-server-error"}},"parameters":[{"name":"q","schema":{"type":"string"},"example":"thunder","in":"query","description":"Full-text search query for sound effect titles, tags, and categories","required":false},{"name":"category","schema":{"type":"string","enum":["ambience","forest","city-ambience","room-tones","rain-and-storm","beach-and-ocean","wind","foley","weapons-and-warfare","footsteps","explosions-and-crashes","kicks-and-punches","clothing","debris","human-sounds","genre","glitch-and-noise","cartoon-voices-and-sounds","sci-fi-sounds","ghosts-and-horror-transitions","gaming-and-fantasy","interface-and-alerts","user-interface","musical","drum-and-percussion-loops","vocal-phrases","one-shots","melodic-loops","realistic","wildlife","machines-and-tools","household-objects","cars-and-airplanes","water","electronic-devices","pets-and-farm-animals","transitions","epic-transitions","cinematic-impacts","whooshes","risers","intros-and-outros"]},"example":"ambience","in":"query","description":"Filter by category slug. Use a parent category to include all its subcategories","required":false},{"in":"query","schema":{"default":false,"type":"boolean"},"required":false,"description":"Include premium sound effects in search results. When false, only free sound effects are returned","name":"include-premium"},{"in":"query","schema":{"type":"string","enum":["relevance","popularity","-popularity","download_count","-download_count","created_at","-created_at","duration","-duration","title","-title"]},"required":false,"description":"Sort order for results. Prefix with \"-\" for descending. Defaults to \"relevance\" when a search query (q) is provided, otherwise defaults to \"-popularity\".","name":"order_by"},{"in":"query","schema":{"default":10,"minimum":1,"type":"integer","maximum":1000},"required":false,"description":"Number of results to return per page","name":"limit"},{"in":"query","schema":{"default":0,"type":"integer","minimum":0},"required":false,"description":"Number of results to skip for pagination","name":"offset"}],"description":"Search the Magnific Sound Effects catalog. Filter by category, duration range, premium status, and creation date. Returns paginated results sorted by popularity by default.","summary":"Search and filter sound effects","operationId":"search_sound_effects"}},"/v1/ai/image-to-video/minimax-hailuo-02-768p/{task-id}":{"get":{"tags":["image-to-video"],"description":"Get the status of the MiniMax Hailuo-02 768p task","summary":"MiniMax Hailuo 02 768p - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/ai/text-to-image/flux-2-turbo":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Successfully retrieved all Flux 2 Turbo tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Flux 2 Turbo - List tasks","description":"Retrieve the status of all Flux 2 Turbo text-to-image generation tasks for the authenticated user.","operationId":"get_all_flux_2_turbo_tasks"},"post":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_image_from_text_flux_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Create high-quality images quickly using FLUX.2 [turbo], the speed-optimized version of Flux 2.\n\n**Key Features:**\n- Fast generation (optimized for speed)\n- Lower cost than Pro version\n- Adjustable guidance scale for prompt adherence\n- Custom image dimensions (512-2048px)\n- Safety checker for content filtering\n- Multiple output formats (PNG/JPEG)\n\n**Use Cases:**\n- Rapid prototyping and iteration\n- Content exploration\n- High-volume generation\n- Testing prompts and concepts\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ttif2t-request-content"},"examples":{"required-params":{"$ref":"#/components/examples/request-flux-2-turbo-required-params"},"all-params":{"$ref":"#/components/examples/request-flux-2-turbo-all-params"}}}}},"summary":"Flux 2 Turbo - Create image from text","operationId":"create_image_flux_2_turbo"}},"/v1/ai/image-to-video/runway-4-5/{task-id}":{"get":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Retrieve the status and result of a specific RunWay Gen 4.5 image-to-video task by its task ID.","summary":"RunWay Gen 4.5 I2V - Get task status","operationId":"get_runway_45_i2v_task"}},"/v1/ai/skin-enhancer/creative":{"post":{"tags":["skin-enhancer"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Skin Enhancer Creative - Enhance skin","description":"Enhance skin in images using AI with the Creative mode. This mode provides more artistic and stylized enhancements.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/creative-request"}}}}}},"/v1/ai/text-to-image/gpt-image-2/{task-id}":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Get the status of a specific GPT Image 2 image generation task","summary":"Get the status of a GPT Image 2 task","operationId":"get_gpt_image_2_task_status"}},"/v1/ai/text-to-video/happy-horse-1-1":{"get":{"tags":["text-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Happy Horse 1.1 T2V - List tasks","description":"Retrieve the list of all Happy Horse 1.1 text-to-video tasks for the authenticated user.","operationId":"get_all_happy_horse_1_1_t2v_tasks"},"post":{"tags":["text-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a high-quality AI video from a text prompt using Happy Horse 1.1, Alibaba's text-to-video model. Supports 9 configurable aspect ratios (16:9, 9:16, 1:1, 4:3, 3:4, 21:9, 9:21, 5:4, 4:5), resolutions (720P, 1080P), and duration from 3 to 15 seconds.\n\n**Key features:**\n- 720P and 1080P resolution support\n- 9 aspect ratio options\n- Duration: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, or 15 seconds\n- Prompt up to 2500 characters\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/t2v-request_2"}}}},"summary":"Happy Horse 1.1 - Create video from text","operationId":"create_video_happy_horse_1_1_t2v"}},"/v1/ai/loras":{"get":{"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_available_loras_list_200_response"},"examples":{"success":{"$ref":"#/components/examples/200-loras"}}}}},"503":{"$ref":"#/components/responses/503-service-unavailable"},"500":{"$ref":"#/components/responses/500-internal-server-error"}},"tags":["loras"],"operationId":"get_available_loras_list"}},"/v1/ai/skin-enhancer/faithful":{"post":{"tags":["skin-enhancer"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Skin Enhancer Faithful - Enhance skin","description":"Enhance skin in images using AI with the Faithful mode. This mode preserves the original appearance while improving skin quality.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/faithful-request"}}}}}},"/v1/ai/text-to-image/flux-dev":{"get":{"summary":"Flux Dev - List tasks","description":"Get the status of the flux-dev task","tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of all flux-dev tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}},"post":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of the flux-dev task","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_image_from_text_flux_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Convert descriptive text input into images using AI. This endpoint accepts a variety of parameters to customize the generated images.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ttifd-request-content"}}}},"summary":"Flux Dev - Create image from text","operationId":"create_image_from_text_flux"}},"/v1/ai/video/runway-act-two/{task-id}":{"get":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"RunWay Act Two - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"operationId":"get_runway_act_two_task"}},"/v1/ai/skin-enhancer/flexible":{"post":{"tags":["skin-enhancer"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Skin Enhancer Flexible - Enhance skin","description":"Enhance skin in images using AI with the Flexible mode. This mode allows you to choose the optimization target for the enhancement.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/flexible-request"}}}}}},"/v1/ai/image-to-video/happy-horse-1":{"get":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Happy Horse 1.0 I2V - List tasks","description":"Retrieve the list of all Happy Horse 1.0 image-to-video tasks for the authenticated user.","operationId":"get_all_happy_horse_1_i2v_tasks"},"post":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Animate a single image into a high-quality AI video using Happy Horse 1.0, Alibaba's image-to-video model. The image is used as the first frame and an optional text prompt guides motion and style.\n\n**Key features:**\n- 720P and 1080P resolution support\n- Duration: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, or 15 seconds\n- Optional prompt up to 2500 characters\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/i2v-request_1"}}}},"summary":"Happy Horse 1.0 - Create video from image","operationId":"create_video_happy_horse_1_i2v"}},"/v1/ai/image-to-video/ltx-2-fast":{"get":{"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"LTX Video 2.0 Fast I2V - List tasks","tags":["image-to-video"],"operationId":"get_all_ltx_2_fast_i2v_tasks"},"post":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a video from an image using the LTX Video 2.0 Fast model.\n\n**Features:**\n- Fast video generation with resolutions up to 4K (2160p)\n- Extended duration options: 6-20 seconds in 2-second increments\n- Uses the provided image as the first frame\n- Optional synchronized audio generation\n- **Note:** Durations longer than 10 seconds require 25 FPS and 1080p resolution\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ltx-2-fast-i2v-request"}}}},"summary":"LTX Video 2.0 Fast - Create video from image","operationId":"create_video_ltx_2_fast_i2v"}},"/v1/ai/text-to-image/gpt-image-2-edit/{task-id}":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Get the status of a specific GPT Image 2 image editing task","summary":"Get the status of a GPT Image 2 Edit task","operationId":"get_gpt_image_2_edit_task_status"}},"/v1/ai/text-to-video/veo-3-1/{task-id}":{"get":{"tags":["text-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Get Veo 3.1 T2V task by ID","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"operationId":"get_veo_31_t2v_task"}},"/v1/ai/video/minimax-h3-max-480p":{"get":{"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"MiniMax H3 Max 480p - List tasks","tags":["video"],"operationId":"get_all_minimax_h3_max_480p_tasks"},"post":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate 480p video with MiniMax H3 Max, the optimised H3 build. Supports text-to-video and image-to-video with an optional first and last frame. For reference-guided generation use `/ai/video/minimax-h3-max-r2v-480p`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/minimax-h3-max-request"}}}},"summary":"MiniMax H3 Max 480p - Create video","operationId":"create_video_minimax_h3_max_480p"}},"/v1/ai/text-to-image/flux-kontext-max":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Successfully retrieved all Flux Kontext Max tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Flux Kontext Max - List tasks","description":"Retrieve the status of all Flux Kontext Max text-to-image and image editing tasks for the authenticated user.","operationId":"get_all_flux_kontext_max_tasks"},"post":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_image_from_text_flux_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate and edit images using FLUX Kontext Max, the highest-quality tier of Black Forest Labs' Kontext family.\n\nKontext Max delivers maximum prompt adherence and detail for context-aware image editing. Provide an input image\nto guide the transformation, or generate from text alone. Ideal for high-fidelity edits, style changes, and\nprofessional image manipulation where output quality is the priority.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ttifkm-request-content"},"examples":{"required-params":{"$ref":"#/components/examples/request-flux-kontext-max-required-params"},"all-params":{"$ref":"#/components/examples/request-flux-kontext-max-all-params"}}}}},"summary":"Flux Kontext Max - Edit image from text","operationId":"create_image_from_text_flux_kontext_max"}},"/v1/ai/video-upscaler":{"get":{"tags":["video-upscaler"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Video Upscaler - List tasks","description":"Returns a list of all video upscaler tasks. Each task includes its ID, current status, and output URL if completed.","operationId":"getAiVideoUpscalerTasks"},"post":{"tags":["video-upscaler"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Upscales a video while enhancing visual quality and resolution.\nSupports various output resolutions (720p, 1k, 2k, 4k) with optional creativity, sharpening, and grain controls.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/request-content_4"}}}},"summary":"Video Upscaler - Upscale video","operationId":"postAiVideoUpscaler"}},"/v1/ai/image-to-video/wan-v2-6-1080p":{"get":{"summary":"WAN 2.6 I2V 1080p - List tasks","description":"Get the list of WAN 2.6 Image-to-Video 1080p tasks","tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The list of tasks is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}},"post":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_image_from_text_flux_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a 1080p video from image using the WAN 2.6 model.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/i2v-wan-v26-1080p-request-content"}}}},"summary":"WAN 2.6 1080p - Create video from image","operationId":"create_video_wan_v26_i2v_1080p"}},"/v1/ai/reference-to-video/happy-horse-1":{"get":{"tags":["reference-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Happy Horse 1.0 R2V - List tasks","description":"Retrieve the list of all Happy Horse 1.0 reference-to-video tasks for the authenticated user.","operationId":"get_all_happy_horse_1_r2v_tasks"},"post":{"tags":["reference-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a high-quality AI video guided by 1 to 9 reference images that define characters, objects or scenes using Happy Horse 1.0, Alibaba's reference-to-video model.\n\n**How to use references:**\n- Provide 1 to 9 reference images via `image_urls`\n- Reference each image in the prompt by its 1-based positional index (`character1`, `character2`, ...)\n- The order of `image_urls` matches the character index in the prompt\n\n**Key features:**\n- 720P and 1080P resolution support\n- 5 aspect ratio options\n- Duration range: 3-15 seconds\n- Optional bottom-right \"Happy Horse\" watermark\n- Prompt up to 5000 characters\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/r2v-request_1"}}}},"summary":"Happy Horse 1.0 - Create video from reference images","operationId":"create_video_happy_horse_1_r2v"}},"/v1/ai/text-to-video/ltx-2-fast":{"get":{"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"LTX Video 2.0 Fast T2V - List tasks","tags":["text-to-video"],"operationId":"get_all_ltx_2_fast_t2v_tasks"},"post":{"tags":["text-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a video from text prompt using the LTX Video 2.0 Fast model.\n\n**Features:**\n- Fast video generation with resolutions up to 4K (2160p)\n- Extended duration options: 6-20 seconds in 2-second increments\n- Optional synchronized audio generation\n- **Note:** Durations longer than 10 seconds require 25 FPS and 1080p resolution\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ltx-2-fast-t2v-request"}}}},"summary":"LTX Video 2.0 Fast - Create video from text","operationId":"create_video_ltx_2_fast_t2v"}},"/v1/ai/text-to-video/veo-3-1-fast/{task-id}":{"get":{"tags":["text-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Get Veo 3.1 T2V Fast task by ID","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"operationId":"get_veo_31_t2v_fast_task"}},"/v1/ai/text-to-image/ideogram-4-5":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of all Ideogram 4.5 tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Get the status of all Ideogram 4.5 tasks","description":"Get the status of all Ideogram 4.5 image generation tasks","operationId":"get_all_ideogram_4_5_tasks"},"post":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The request has succeeded and the Ideogram 4.5 process has started.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate or edit images with Ideogram 4.5.\n\n**Key Features:**\n- Text-to-image and image editing in the same endpoint: send up to 5\n  images; the first one is edited and the rest guide the edit\n- Accurate text rendering for posters, logos and typography\n- 13 aspect ratios at about 4 megapixels, plus `auto` to follow the\n  input image\n\n**Best for:**\n- Designs with legible text, from scratch or from an existing image\n- Instruction-based edits of an image guided by references\n\n**Credits:** the price is set by `quality` (`very_low`, `low`, `medium` or\n`high`). The other parameters do not affect it. `very_low` is only\navailable when images are sent.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/tti-ideogram-4-5-request"}}}},"summary":"Create image from text - Ideogram 4.5","operationId":"create_image_from_text_ideogram_4_5"}},"/v1/ai/text-to-image/gpt-image-2-5/{task-id}":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Get the status of a specific GPT Image 2.5 image generation task","summary":"Get the status of a GPT Image 2.5 task","operationId":"get_gpt_image_2_5_task_status"}},"/v1/ai/text-to-image/seedream-v4-5-edit":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of all Seedream 4.5 edit tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Seedream 4.5 Edit - List tasks","description":"Get the status of all Seedream 4.5 image editing tasks","operationId":"get_all_seedream_v4_5_edit_tasks"},"post":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The request has succeeded and the Seedream 4.5 edit process has started.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Edit images using ByteDance's Seedream 4.5 model with text guidance.\n\n**Key Features:**\n- Preserves subject details, lighting, and color tone\n- Supports up to 5 reference images\n- Enhanced editing consistency\n- Up to 4MP output resolution\n\n**Best for:**\n- Image-to-image editing\n- Style transfer with consistency\n- Multi-image reference editing\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ttisdv45-edit-request-content"}}}},"summary":"Seedream 4.5 - Edit image","operationId":"create_image_edit_seedream_v4_5"}},"/v1/ai/reference-to-video/wan-2-7":{"get":{"tags":["reference-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"WAN 2.7 R2V - List tasks","description":"Retrieve the list of all WAN 2.7 reference-to-video tasks for the authenticated user.","operationId":"get_all_wan_27_r2v_tasks"},"post":{"tags":["reference-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a video featuring characters from reference images or videos using WAN 2.7. Maintains visual identity of referenced characters across the generated video.\n\n**How to use references:**\n- Provide character images via `image_urls` and/or character videos via `video_urls`\n- Combined total of image and video references must not exceed 5\n- Reference characters in the prompt as \"Image 1\", \"Image 2\", \"Video 1\", etc.\n- Optionally include `reference_voice` per character for voice-guided generation\n\n**Key features:**\n- 720P and 1080P resolution support\n- 5 aspect ratio options (or use `start_image_url` to set aspect ratio from an image)\n- Duration range: 2-10 seconds\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/r2v-request"}}}},"summary":"WAN 2.7 - Create video from reference characters","operationId":"create_video_wan_27_r2v"}},"/v1/ai/lip-sync/veed-fabric-1-0":{"get":{"tags":["lip-sync"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - List of Veed Fabric 1.0 tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Veed Fabric 1.0 - List tasks","description":"Retrieve all Veed Fabric 1.0 lip-sync tasks for the authenticated user.","operationId":"get_all_veed_fabric_1_0_tasks"},"post":{"tags":["lip-sync"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a realistic talking video by combining a static portrait image with an audio file using Veed Fabric 1.0.\nThe model produces a lip-synced video (MP4) where the person in the image speaks naturally in sync with the provided audio.\nIdeal for creating talking head videos from a single photo and voice recording.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/request_1"},"examples":{"all-params":{"$ref":"#/components/examples/request-veed-fabric-1-0-all-params"},"required-params":{"$ref":"#/components/examples/request-veed-fabric-1-0-required-params"}}}}},"summary":"Veed Fabric 1.0 - Generate talking video","operationId":"create_veed_fabric_1_0_lip_sync"}},"/v1/ai/video/minimax-h3-max-768p":{"get":{"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"MiniMax H3 Max 768p - List tasks","tags":["video"],"operationId":"get_all_minimax_h3_max_768p_tasks"},"post":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate 768p video with MiniMax H3 Max, the optimised H3 build. Supports text-to-video and image-to-video with an optional first and last frame. For reference-guided generation use `/ai/video/minimax-h3-max-r2v-768p`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/minimax-h3-max-request"}}}},"summary":"MiniMax H3 Max 768p - Create video","operationId":"create_video_minimax_h3_max_768p"}},"/v1/ai/text-to-image/flux-kontext-pro":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Successfully retrieved all Flux Kontext Pro tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Flux Kontext Pro - List tasks","description":"Retrieve the status of all Flux Kontext Pro text-to-image generation tasks for the authenticated user.","operationId":"get_all_flux_kontext_pro_tasks"},"post":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_image_from_text_flux_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate images using FLUX Kontext Pro, an advanced text-to-image model with optional image input support.\n\nThis model excels at understanding context and generating high-quality images from text descriptions.\nOptionally, you can provide an input image to guide the generation process.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ttifkp-request-content"}}}},"summary":"Flux Kontext Pro - Create image from text","operationId":"create_image_from_text_flux_kontext_pro"}},"/v1/ai/text-to-image/qwen-image-3":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of all Qwen Image 3.0 tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Get the status of all Qwen Image 3.0 tasks","description":"Get the status of all Qwen Image 3.0 tasks","operationId":"get_all_qwen_image_3_tasks"},"post":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The request has succeeded and the Qwen Image 3.0 process has started.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate an image with Qwen Image 3.0 from a text prompt, or edit\nup to 3 input images following the prompt.\n\n**Output:** one image per request, delivered as a URL in the `generated`\narray of the task result.\n\n**Credits:** a flat price per image. The parameters do not affect it.\n\nThe request is processed asynchronously: the endpoint returns a `task_id`\nimmediately. Retrieve the result by polling\n`GET /v1/ai/text-to-image/qwen-image-3/{task-id}` or by providing an optional `webhook_url`.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/tti-qwen-image-3-request"}}}},"summary":"Generate or edit an image with Qwen Image 3.0","operationId":"create_qwen_image_3"}},"/v1/ai/ideogram-image-edit/{task-id}":{"get":{"tags":["ideogram-image-edit"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Get the status of a specific Ideogram Image Edit task","summary":"Ideogram Image Edit - Get task status","operationId":"get_ideogram_image_edit_task_status"}},"/v1/ai/text-to-image/qwen-image-3-pro/{task-id}":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Get the status of a specific Qwen Image 3.0 Pro task","summary":"Get the status of one Qwen Image 3.0 Pro task","operationId":"get_qwen_image_3_pro_task_status"}},"/v1/ai/text-to-video/happy-horse-1":{"get":{"tags":["text-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Happy Horse 1.0 T2V - List tasks","description":"Retrieve the list of all Happy Horse 1.0 text-to-video tasks for the authenticated user.","operationId":"get_all_happy_horse_1_t2v_tasks"},"post":{"tags":["text-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a high-quality AI video from a text prompt using Happy Horse 1.0, Alibaba's text-to-video model ranked #1 on the Artificial Analysis Video Arena (April 2026). Supports configurable aspect ratios (16:9, 9:16, 1:1, 4:3, 3:4), resolutions (720P, 1080P), and duration from 3 to 15 seconds.\n\n**Key features:**\n- 720P and 1080P resolution support\n- 5 aspect ratio options\n- Duration: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, or 15 seconds\n- Prompt up to 2500 characters\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/t2v-request_1"}}}},"summary":"Happy Horse 1.0 - Create video from text","operationId":"create_video_happy_horse_1_t2v"}},"/v1/ai/image-to-video/wan-v2-6-720p":{"get":{"summary":"WAN 2.6 I2V 720p - List tasks","description":"Get the list of WAN 2.6 Image-to-Video 720p tasks","tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The list of tasks is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}},"post":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_image_from_text_flux_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a 720p video from image using the WAN 2.6 model.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/i2v-wan-v26-720p-request-content"}}}},"summary":"WAN 2.6 720p - Create video from image","operationId":"create_video_wan_v26_i2v_720p"}},"/v1/creations/recent":{"get":{"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"400":{"$ref":"#/components/responses/400-bad-request"},"200":{"description":"OK Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/getRecentCreations_200_response"}}}},"403":{"$ref":"#/components/responses/403-forbidden"},"500":{"$ref":"#/components/responses/500-internal-server-error"}},"tags":["Creations"],"parameters":[{"name":"per_page","schema":{"type":"integer"},"example":100,"description":"Results per page. It must be greater than 0.","in":"query"},{"name":"page","schema":{"type":"integer"},"example":1,"in":"query","description":"Page number. It must be greater than 0.","required":false},{"name":"tool_name","schema":{"type":"string"},"example":"text-to-image","in":"query","description":"Filter the creations by the tool that produced them.","required":false}],"description":"Returns the most recent files (creations) belonging to the user identified by the API key, enriched with the metadata of the creation that produced each file. Results are paginated and ordered from newest to oldest.\n","operationId":"getRecentCreations","summary":"Get the user's most recent creations","security":[{"magnificApiKey":[]}]}},"/v1/ai/voiceover/elevenlabs-v3/{task-id}":{"get":{"tags":["voiceover"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string","format":"uuid"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Get the status of one ElevenLabs v3 voiceover task","summary":"Voiceover ElevenLabs v3 - Get task status","operationId":"get_voiceover_elevenlabs_v3_task_status"}},"/v1/ai/music-generation/lyria-3/{task-id}":{"get":{"tags":["music-generation"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/task-detail-200-default-response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string","format":"uuid"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Get the status of one Lyria 3 music generation task","summary":"Lyria 3 - Get task status","operationId":"get_lyria_3_task_status"}},"/v1/ai/text-to-image/qwen-image-3-pro":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of all Qwen Image 3.0 Pro tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Get the status of all Qwen Image 3.0 Pro tasks","description":"Get the status of all Qwen Image 3.0 Pro tasks","operationId":"get_all_qwen_image_3_pro_tasks"},"post":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The request has succeeded and the Qwen Image 3.0 Pro process has started.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate an image with Qwen Image 3.0 Pro, the higher quality tier, at 1K or 2K, from a text prompt, or edit\nup to 3 input images following the prompt.\n\n**Output:** one image per request, delivered as a URL in the `generated`\narray of the task result.\n\n**Credits:** `resolution` sets the price (`1k` or `2k`). The other parameters do\nnot affect it.\n\nThe request is processed asynchronously: the endpoint returns a `task_id`\nimmediately. Retrieve the result by polling\n`GET /v1/ai/text-to-image/qwen-image-3-pro/{task-id}` or by providing an optional `webhook_url`.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/tti-qwen-image-3-pro-request"}}}},"summary":"Generate or edit an image with Qwen Image 3.0 Pro","operationId":"create_qwen_image_3_pro"}},"/v1/ai/image-to-video/minimax-hailuo-2-3-768p/{task-id}":{"get":{"tags":["image-to-video"],"description":"Get the status of the MiniMax Hailuo 2.3 768p task","summary":"MiniMax Hailuo 2.3 768p - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/ai/text-to-image/recraft-v4-pro":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of all Recraft V4 Pro tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Get the status of all Recraft V4 Pro tasks","description":"Get the status of all Recraft V4 Pro image generation tasks","operationId":"get_all_recraft_v4_pro_tasks"},"post":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The request has succeeded and the Recraft V4 Pro process has started.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate an image from a text prompt using Recraft V4 Pro.\n\n**Key Features:**\n- The same design and text-rendering strengths as Recraft V4\n- Twice the linear dimensions of V4 — four times the pixels\n- Eleven fixed aspect ratios, from 1536x2688 to 3072x1536\n\n**Best for:**\n- Print-bound or large-format designs\n- Assets that will be cropped or scaled down after generation\n\n**Output:** one image per request, delivered as a URL in the task's\n`generated` array. Exact sizes are listed under `aspect_ratio`.\n\n**Credits:** a flat price per image, higher than Recraft V4.\n\nThe request is processed asynchronously: the endpoint returns a task id\nimmediately. Retrieve the result by polling the task endpoint or by\nproviding an optional `webhook_url`.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ttirecraft-v4-pro-request-content"},"examples":{"required-params":{"$ref":"#/components/examples/request-recraft-v4-pro-required-params"},"all-params":{"$ref":"#/components/examples/request-recraft-v4-pro-all-params"}}}}},"summary":"Create image from text - Recraft V4 Pro","operationId":"create_image_from_text_recraft_v4_pro"}},"/v1/ai/text-to-image/gpt-image-2-5-edit/{task-id}":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Get the status of a specific GPT Image 2.5 image editing task","summary":"Get the status of a GPT Image 2.5 Edit task","operationId":"get_gpt_image_2_5_edit_task_status"}},"/v1/ai/video/minimax-h3-max-r2v-480p":{"get":{"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"MiniMax H3 Max 480p reference-to-video - List tasks","tags":["video"],"operationId":"get_all_minimax_h3_max_r2v_480p_tasks"},"post":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate 480p video with MiniMax H3 Max, guided by reference images, videos and audios. Mention them in the prompt as @Image1, @Video1, @Audio1 and so on. At least one reference image or reference video is required, and all references together must not exceed 12 files.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/minimax-h3-max-r2v-request"}}}},"summary":"MiniMax H3 Max 480p reference-to-video - Create video","operationId":"create_video_minimax_h3_max_r2v_480p"}},"/v1/ai/text-to-video/wan-2-7/{task-id}":{"get":{"tags":["text-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Retrieve the status and result of a specific WAN 2.7 text-to-video task by its ID.","summary":"WAN 2.7 T2V - Get task status","operationId":"get_wan_27_t2v_task"}},"/v1/ai/text-to-image/flux-pro-v1-1":{"get":{"summary":"Flux Pro 1.1 - List tasks","description":"Get the status of the flux-pro 1.1 task","tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of all flux-pro 1.1 tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}},"post":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of the flux-pro 1.1 task","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_image_from_text_flux_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Convert descriptive text input into images using AI. This endpoint accepts a variety of parameters to customize the generated images.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ttifpv11-request-content"}}}},"summary":"Flux Pro 1.1 - Create image from text","operationId":"create_image_from_text_flux_pro_v1_1"}},"/v1/ai/video-upscaler/turbo":{"post":{"tags":["video-upscaler"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Upscales a video using turbo processing with premium quality enhancement applied automatically.\nTurbo mode reduces processing time while maintaining high visual quality.\nSupports various output resolutions (720p, 1k, 2k, 4k) with optional creativity, sharpening, and grain controls.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/request-content_4"}}}},"summary":"Video Upscaler Turbo - Upscale video","operationId":"postAiVideoUpscalerTurbo"}},"/v1/ai/audio-isolation/{task-id}":{"get":{"tags":["audio-isolation"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string","format":"uuid"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Get the status of one audio isolation task","summary":"Audio Isolation - Get task status","operationId":"get_audio_isolation_task_status"}},"/v1/ai/image-to-video/minimax-hailuo-2-3-1080p/{task-id}":{"get":{"tags":["image-to-video"],"description":"Get the status of the MiniMax Hailuo 2.3 1080p task","summary":"MiniMax Hailuo 2.3 1080p - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/ai/sound-effects":{"get":{"tags":["sound-effects"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of all sound-effects tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_sound_effects_tasks_200_response"},"examples":{"success":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Sound Effects - List tasks","description":"Get the status of all sound-effects tasks","operationId":"get_all_sound_effects_tasks"},"post":{"tags":["sound-effects"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Create realistic sound effects from text descriptions using AI.\n\nGenerate high-quality audio sound effects based on your text prompts. Perfect for video production, game development, podcasts, and multimedia projects.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/request_13"},"examples":{"basic":{"summary":"Basic sound effect generation","value":{"text":"A cat meowing","duration_seconds":5}},"advanced":{"summary":"Advanced with loop and influence","value":{"duration_seconds":10,"text":"Ocean waves crashing on the beach","loop":true,"prompt_influence":0.7}}}}}},"summary":"Sound Effects - Generate from text","operationId":"create_sound_effects_task"}},"/v1/ai/image-style-transfer":{"get":{"tags":["image-style-transfer"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of all Style Transfer tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Style Transfer - List tasks","description":"Get the status of all Style Transfer tasks","operationId":"get_all_style_transfer_tasks"},"post":{"tags":["image-style-transfer"],"operationId":"apply_style_transfer_to_image","responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The request has succeeded and the Style Transfer process has started.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apply_style_transfer_to_image_200_response"},"examples":{"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Style Transfer - Transform image style","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/style-transfer-request-content"},"examples":{"required-params":{"$ref":"#/components/examples/request-style-transfer-required-params"},"all-params":{"$ref":"#/components/examples/request-style-transfer-all-params"}}}}}}},"/v1/ai/uploads/request-url":{"post":{"tags":["uploads"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Pre-signed upload URLs generated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/upload-response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Request one or more pre-signed URLs to upload your own files (image, video or audio) and reference them in other AI endpoints.\n\nFlow:\n1. Call this endpoint with the `content_type` of each file. You get, per file, an `upload_url` (pre-signed PUT), an opaque `file_id`, and a readable `asset_url`.\n2. PUT the raw file bytes to each `upload_url`, including ALL the returned `headers`. The `upload_url` expires quickly (`expires_in`).\n3. Reference the upload by `file_id` (preferred on AI endpoints) or by `asset_url` (a plain URL usable anywhere a URL is accepted).\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/upload-request-body"}}}},"summary":"Request pre-signed URLs to upload files","operationId":"create_upload_urls"}},"/v1/ai/image-to-video/minimax-live/{task-id}":{"get":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"MiniMax Video 01 Live - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"operationId":"get_minimax_live_i2v_task"}},"/v1/ai/image-to-video/wan-2-7":{"get":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"WAN 2.7 I2V - List tasks","description":"Retrieve the list of all WAN 2.7 image-to-video tasks for the authenticated user.","operationId":"get_all_wan_27_i2v_tasks"},"post":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a video from an image or extend an existing video using WAN 2.7.\n\n**Three generation modes:**\n- **First frame**: Provide `start_image_url` alone to animate from a starting image\n- **First + last frame**: Provide both `start_image_url` and `end_image_url` for controlled start-to-end animation\n- **Video continuation**: Provide `video_url` to extend an existing video, optionally with `end_image_url` as the target ending frame\n\n**Key features:**\n- 720P and 1080P resolution support\n- Optional audio-guided generation\n- Duration range: 2-15 seconds\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/i2v-request"}}}},"summary":"WAN 2.7 - Create video from image","operationId":"create_video_wan_27_i2v"}},"/v1/ai/video/vfx":{"get":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"VFX - List tasks","description":"Retrieve the status of all VFX video effect tasks for the authenticated user.","operationId":"get_all_vfx_tasks"},"post":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Apply professional visual effects and filters to your videos using the VFX API. Transform any video with cinematic effects like film grain, motion blur, VHS retro style, and anamorphic lens distortion.\n\n**Available filters:**\n- `1` Film grain - Adds cinematic grain texture for a classic film look\n- `2` Motion blur - Creates motion blur effect (configurable kernel size and decay)\n- `3` Fish eye - Applies fish eye lens distortion\n- `4` VHS - Retro VHS tape effect with scan lines and color distortion\n- `5` Shake - Camera shake effect for dynamic footage\n- `6` VGA - Low resolution VGA effect for retro aesthetics\n- `7` Bloom - Glowing bloom effect (adjustable contrast)\n- `8` Anamorphic lens - Cinematic anamorphic lens effect with horizontal flares\n\n**Use cases:** Social media content, music videos, film production, advertising, retro-style videos, and creative projects.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/vfx-request"}}}},"summary":"VFX - Apply visual effects to video","operationId":"create_video_vfx"}},"/v1/ai/video-upscaler-topaz":{"get":{"tags":["video-upscaler-topaz"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Video Upscaler Topaz - List tasks","description":"Returns a list of all video upscaler topaz tasks. Each task includes its ID, current status, and output URL if completed.","operationId":"getAiVideoUpscalerTopazTasks"},"post":{"tags":["video-upscaler-topaz"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Upscales a video with Topaz Starlight generative enhancement.\nSupports output resolutions of 720p, 1k, 2k, or 4k, an optional frame-rate change with AI frame interpolation, and noise control.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/request-content_6"}}}},"summary":"Video Upscaler Topaz - Upscale video","operationId":"postAiVideoUpscalerTopaz"}},"/v1/ai/video/seedance-2-mini-720p":{"get":{"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Seedance 2.0 Mini 720p - List tasks","tags":["video"],"operationId":"get_all_seedance_2_mini_720p_tasks"},"post":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate 720p video using Seedance 2.0 Mini, the most affordable and fastest variant of the Seedance 2.0 family. Available in 480p and 720p with durations from 4 to 15 seconds. Supports text-to-video and image-to-video with optional first and last frame images. Also supports reference-to-video: attach up to 9 reference images via `reference_images` and mention them in the prompt with @Image1..@Image9.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/seedance-2-mini-request"}}}},"summary":"Seedance 2.0 Mini 720p - Create video from text or image","operationId":"create_video_seedance_2_mini_720p"}},"/v1/ai/text-to-image":{"post":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The request has succeeded, and the images generated from the text are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_image_from_text_classic_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Convert descriptive text input into images using AI. This endpoint accepts a variety of parameters to customize the generated images.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/request-content"},"examples":{"required-params":{"$ref":"#/components/examples/request-tti-required-params"},"styling-params":{"$ref":"#/components/examples/request-tti-styling-params"},"all-params":{"$ref":"#/components/examples/request-tti-all-params"},"portrait-image-size":{"$ref":"#/components/examples/request-tti-portrait-image-size"}}}}},"summary":"Create image from text - Classic fast","operationId":"create_image_from_text_classic"}},"/v1/ai/image-to-video/wan-2-7/{task-id}":{"get":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Retrieve the status and result of a specific WAN 2.7 image-to-video task by its ID.","summary":"WAN 2.7 I2V - Get task status","operationId":"get_wan_27_i2v_task"}},"/v1/ai/reference-to-video/veo-3-1/{task-id}":{"get":{"tags":["reference-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Retrieve the status and results of a specific reference-to-video generation task.","summary":"Get Veo 3.1 Reference-to-Video task by ID","operationId":"get_veo_31_ref2v_task"}},"/v1/ai/uploads":{"get":{"tags":["uploads"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"200":{"description":"OK - The list of uploaded files.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/upload-list-response"}}}},"503":{"$ref":"#/components/responses/503-service-unavailable"},"500":{"$ref":"#/components/responses/500-internal-server-error"}},"summary":"List your uploaded files","description":"Lists the files you have uploaded, each identified by its opaque `file_id`, with size and expiration metadata plus a freshly-signed readable `asset_url`.","operationId":"get_uploads"}},"/v1/ai/video/kling-v3-motion-control-pro/{task-id}":{"get":{"tags":["video","kling-v3-motion-control-pro"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Retrieve the status and result of a specific Kling 3 Pro Motion Control video generation task by its task ID.","summary":"Kling 3 Pro Motion Control - Get task status","operationId":"getAiVideoKlingV3MotionControlProTask"}},"/v1/ai/text-to-image/qwen-image-3/{task-id}":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Get the status of a specific Qwen Image 3.0 task","summary":"Get the status of one Qwen Image 3.0 task","operationId":"get_qwen_image_3_task_status"}},"/v1/ai/video-edit/happy-horse-1":{"get":{"tags":["video-edit"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Happy Horse 1.0 Video Edit - List tasks","description":"Retrieve the list of all Happy Horse 1.0 video edit tasks for the authenticated user.","operationId":"get_all_happy_horse_1_video_edit_tasks"},"post":{"tags":["video-edit"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Edit an existing video with natural-language instructions using Happy Horse 1.0, Alibaba's AI video editing model, optionally guided by up to 5 reference images.\n\n**Editing modes:**\n- **Instruction-based editing**: Provide `prompt` with editing instructions (e.g., \"change the sky to sunset\")\n- **Reference-image editing**: Provide `prompt` and `image_urls`, then reference images from the prompt using `@Image1`..`@Image5` (1-based, in array order)\n\n**Key features:**\n- 720P and 1080P resolution support\n- Up to 5 reference images\n- Output is capped at 15 seconds\n- Configurable audio handling: `auto` (regenerate when relevant) or `origin` (preserve input audio)\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/video-edit-request_1"}}}},"summary":"Happy Horse 1.0 - Edit video","operationId":"create_video_happy_horse_1_edit"}},"/v1/ai/lip-sync/veed-fabric-1-0-fast":{"get":{"tags":["lip-sync"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - List of Veed Fabric 1.0 Fast tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Veed Fabric 1.0 Fast - List tasks","description":"Retrieve all Veed Fabric 1.0 Fast lip-sync tasks for the authenticated user.","operationId":"get_all_veed_fabric_1_0_fast_tasks"},"post":{"tags":["lip-sync"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a realistic talking video by combining a static portrait image with an audio file using Veed Fabric 1.0 Fast.\nThis is the faster variant of Veed Fabric 1.0, optimized for reduced generation time while maintaining quality lip synchronization.\nIdeal for workflows requiring quick turnaround on talking head video generation.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/request_2"},"examples":{"all-params":{"$ref":"#/components/examples/request-veed-fabric-1-0-fast-all-params"},"required-params":{"$ref":"#/components/examples/request-veed-fabric-1-0-fast-required-params"}}}}},"summary":"Veed Fabric 1.0 Fast - Generate talking video","operationId":"create_veed_fabric_1_0_fast_lip_sync"}},"/v1/ai/image-to-video/wan-v2-2-480p":{"get":{"summary":"WAN 2.2 480p - List tasks","description":"Get the list of WAN 2.2 480p tasks","tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The list of WAN 2.2 480p tasks is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}},"post":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_image_from_text_flux_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a video from image using the WAN 2.2 480p model.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/itvwan-v22-480p-request-content"}}}},"summary":"WAN 2.2 480p - Create video from image","operationId":"create_video_wan_v22_480p"}},"/v1/ai/video/seedance-2-5-pro-720p":{"get":{"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Seedance 2.5 Pro 720p - List tasks","tags":["video"],"operationId":"get_all_seedance_2_5_pro_720p_tasks"},"post":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate 720p video using Seedance 2.5 Pro. Supports text-to-video, image-to-video (first/last frame), and reference-to-video with up to 30 reference images (@Image1..@Image30), 10 reference videos (@Video1..@Video10) and 10 reference audios (@Audio1..@Audio10). Also supports video editing and extension via `task_type`, camera motion, multishot sequences (up to 6 shots) and native audio (sound effects).","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/seedance-2-5-request"}}}},"summary":"Seedance 2.5 Pro 720p - Create video from text or image","operationId":"create_video_seedance_2_5_pro_720p"}},"/v1/ai/video/wan-3-0-prime/{task-id}":{"get":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Get the status of a specific Wan 3.0 Prime task","summary":"Get the status of one Wan 3.0 Prime task","operationId":"get_wan_3_0_prime_task_status"}},"/v1/ai/video/wan-3-0":{"get":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of all Wan 3.0 tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Get the status of all Wan 3.0 tasks","description":"Get the status of all Wan 3.0 tasks","operationId":"get_all_wan_3_0_tasks"},"post":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The request has succeeded and the Wan 3.0 process has started.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a video with Wan 3.0, Alibaba's unified video model. One\nendpoint covers every mode, chosen by the fields you send:\n\n- **Text-to-video**: `prompt` only.\n- **First/last frame**: `start_image_url`, optionally with `end_image_url`\n  (a last frame needs a first frame).\n- **References**: up to 10 `image_urls`, 5 `video_urls` and 5 `audio_urls`\n  for characters, motion, voice or style. Not combinable with keyframes.\n\n**Output:** one MP4 video of 2 to 30 seconds at 480p, 720p or 1080p (the\nshort side is 480, 720 or 1080 px, e.g. 854x480 at 16:9), with native\naudio by default. The finished task carries the video URL in its\n`generated` array.\n\n**Credits:** priced per second by `resolution`. The billed seconds are\n`duration` plus the combined duration of the `video_urls`, capped at 15\nseconds. Images and audios do not change the price.\n\nThe request is processed asynchronously: the endpoint returns a `task_id`\nimmediately. Retrieve the result by polling\n`GET /v1/ai/video/wan-3-0/{task-id}` or by providing an optional `webhook_url`.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/wan-3-0-request"}}}},"summary":"Video generation using Wan 3.0","operationId":"create_wan_3_0"}},"/v1/ai/text-to-image/hyperflux/{task-id}":{"get":{"summary":"HyperFlux - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/ai/music-generation/google-lyria":{"get":{"tags":["music-generation"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of all Google Lyria tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_sound_effects_tasks_200_response"},"examples":{"success":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Google Lyria - List tasks","description":"Get the status of all Google Lyria music generation tasks","operationId":"get_all_google_lyria_tasks"},"post":{"tags":["music-generation"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate original 30-second music tracks from text descriptions using Google Lyria.\n\nCreate high-quality instrumental music by describing the genre, mood, instruments, and tempo you want. Ideal for video production, games, podcasts, and multimedia projects.\n\nEach request produces a single track with a fixed duration of 30 seconds.\n\n**Tips for effective prompts:**\n- Include genre: \"lo-fi hip hop\", \"orchestral\", \"synthwave\", \"acoustic folk\"\n- Describe mood: \"uplifting\", \"melancholic\", \"energetic\", \"relaxed\"\n- Mention instruments: \"piano\", \"strings\", \"electric guitar\", \"808 drums\"\n- Add tempo hints: \"slow tempo\", \"upbeat\", \"driving rhythm\"\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/request_15"},"examples":{"basic":{"summary":"Basic music generation","value":{"prompt":"Uplifting orchestral score with soaring strings and triumphant brass"}},"with_negative_prompt":{"summary":"Guided generation with a negative prompt and seed","value":{"seed":12345,"negative_prompt":"vocals, distortion, harsh percussion","prompt":"Warm lo-fi hip hop beat with vinyl crackle and mellow keys"}}}}}},"summary":"Google Lyria - Generate music from text","operationId":"create_google_lyria_task"}},"/v1/ai/video/kling-4k-t2v/{task-id}":{"get":{"tags":["video","kling-4k-t2v"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Retrieve the status and result of a specific Kling 4K Text-to-Video task by its task ID.","summary":"Kling 4K T2V - Get task status","operationId":"getAiVideoKling4kT2vTask"}},"/v1/ai/reference-to-video/wan-2-7/{task-id}":{"get":{"tags":["reference-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Retrieve the status and result of a specific WAN 2.7 reference-to-video task by its ID.","summary":"WAN 2.7 R2V - Get task status","operationId":"get_wan_27_r2v_task"}},"/v1/ai/video/wan-3-0-prime":{"get":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of all Wan 3.0 Prime tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Get the status of all Wan 3.0 Prime tasks","description":"Get the status of all Wan 3.0 Prime tasks","operationId":"get_all_wan_3_0_prime_tasks"},"post":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The request has succeeded and the Wan 3.0 Prime process has started.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a video with Wan 3.0 Prime, Alibaba's unified video model. One\nendpoint covers every mode, chosen by the fields you send:\n\n- **Text-to-video**: `prompt` only.\n- **First/last frame**: `start_image_url`, optionally with `end_image_url`\n  (a last frame needs a first frame).\n- **References**: up to 10 `image_urls`, 5 `video_urls` and 5 `audio_urls`\n  for characters, motion, voice or style. Not combinable with keyframes.\n\n**Output:** one MP4 video of 2 to 30 seconds at 480p, 720p or 1080p (the\nshort side is 480, 720 or 1080 px, e.g. 854x480 at 16:9), with native\naudio by default. The finished task carries the video URL in its\n`generated` array.\n\nPrime is the same model on Alibaba's priority queue: a generation\nfinishes in about 2 minutes instead of about 14, at a higher price per\nsecond. Same parameters as `wan-3-0`.\n\n**Credits:** priced per second by `resolution`. The billed seconds are\n`duration` plus the combined duration of the `video_urls`, capped at 15\nseconds. Images and audios do not change the price.\n\nThe request is processed asynchronously: the endpoint returns a `task_id`\nimmediately. Retrieve the result by polling\n`GET /v1/ai/video/wan-3-0-prime/{task-id}` or by providing an optional `webhook_url`.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/wan-3-0-request"}}}},"summary":"Video generation using Wan 3.0 Prime","operationId":"create_wan_3_0_prime"}},"/v1/ai/text-to-video/wan-v2-6-720p":{"get":{"summary":"WAN 2.6 T2V 720p - List tasks","description":"Get the list of WAN 2.6 Text-to-Video 720p tasks","tags":["text-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The list of tasks is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}},"post":{"tags":["text-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_image_from_text_flux_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a 720p video from text prompt using the WAN 2.6 model.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/t2v-wan-v26-720p-request-content"}}}},"summary":"WAN 2.6 720p - Create video from text","operationId":"create_video_wan_v26_t2v_720p"}},"/v1/ai/text-to-icon/{task-id}/render/{format}":{"post":{"tags":["Text to icon"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"Success - The request has succeeded and the Text to Icon process has started.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string","format":"uuid"},"required":true,"description":"ID of the task","name":"task-id"},{"in":"path","schema":{"$ref":"#/components/schemas/text-to-icon-format"},"required":true,"description":"The format of the icon","name":"format"}],"description":"Download the generated AI icon in the specified format png or svg.","summary":"AI Icon generation","operationId":"download_text_to_icon_render_format"}},"/v1/resources/{resource-id}/download/{resource-format}":{"get":{"tags":["Resources"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"400":{"$ref":"#/components/responses/400-bad-request"},"404":{"$ref":"#/components/responses/404-not-found"},"429":{"$ref":"#/components/responses/429-too-many-requests"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/download_list"}}}},"403":{"$ref":"#/components/responses/403-forbidden"},"500":{"$ref":"#/components/responses/500-internal-server-error"}},"parameters":[{"name":"resource-id","schema":{"type":"integer"},"example":30955,"in":"path","description":"Photo, video or PSD resource ID","required":true},{"in":"path","schema":{"example":"svg","enum":["psd","ai","eps","atn","fonts","resources","png","jpg","3d-render","svg","mockup"],"type":"string"},"required":true,"description":"Resource format","name":"resource-format"}],"description":"Retrieve a resource by specifying both the resource ID and the format. This endpoint allows for precise downloading of resources in the desired format.","summary":"Get available download formats for resource","operationId":"get_resource_download_formats"}},"/v1/ai/text-to-video/ltx-2-pro/{task-id}":{"get":{"tags":["text-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"LTX Video 2.0 Pro T2V - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"operationId":"get_ltx_2_pro_t2v_task"}},"/v1/ai/image-to-video/ltx-2-pro":{"get":{"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"LTX Video 2.0 Pro I2V - List tasks","tags":["image-to-video"],"operationId":"get_all_ltx_2_pro_i2v_tasks"},"post":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a video from an image using the LTX Video 2.0 Pro model.\n\n**Features:**\n- High-quality video generation with resolutions up to 4K (2160p)\n- Duration options: 6, 8, or 10 seconds\n- Uses the provided image as the first frame\n- Optional synchronized audio generation\n- Reproducible results with seed parameter\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ltx-2-pro-i2v-request"}}}},"summary":"LTX Video 2.0 Pro - Create video from image","operationId":"create_video_ltx_2_pro_i2v"}},"/v1/ai/image-to-video/minimax-hailuo-02-1080p":{"get":{"summary":"MiniMax Hailuo 02 1080p - List tasks","description":"Get the list of MiniMax Hailuo-02 1080p tasks","tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The list of MiniMax Hailuo-02 1080p tasks is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}},"post":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_image_from_text_flux_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a video from text or image using the MiniMax Hailuo-02 1080p model.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_video_minimax_hailuo_02_1080p_request"}}}},"summary":"MiniMax Hailuo 02 1080p - Create video from text or image","operationId":"create_video_minimax_hailuo_02_1080p"}},"/v1/ai/image-to-video/pixverse-v5-5-transition":{"get":{"summary":"PixVerse V5.5 Transition - List tasks","description":"List PixVerse-V5.5 Transition tasks.","tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}},"post":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a video transition using the PixVerse-V5.5 model. Provide a `first_image_url` and an `end_image_url` to animate a seamless transition between the two frames.\n\nPixVerse-V5.5 transition supports native audio (`generate_audio_switch`), camera movement control and prompt reasoning enhancement (`thinking_type`).\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/request_5"}}}},"summary":"PixVerse V5.5 - Video transition","operationId":"create_pixverse_v5_5_transition_video"}},"/v1/ai/image-to-video/minimax-hailuo-2-3-768p-fast/{task-id}":{"get":{"tags":["image-to-video"],"description":"Get the status of the MiniMax Hailuo 2.3 768p Fast task","summary":"MiniMax Hailuo 2.3 768p Fast - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/ai/magnific-one/{task-id}":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Get the status of a specific Magnific One task. When it is\n`COMPLETED`, `generated` holds one image URL in `quality` mode, or 8 or\n16 URLs in `draft` mode.\n","summary":"Get the status of a Magnific One task","operationId":"get_magnific_one_task_status"}},"/v1/ai/video/kling-v3-omni-4k":{"post":{"tags":["video","kling-v3-omni-4k","background_tasks"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/task-detail-200-default-response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate AI video using Kling 3 Omni at 4K resolution, with the same multi-modal capabilities.\n\n**Features:**\n- **Text-to-video**: Generate videos from text prompts\n- **Image-to-video**: Use start and/or end frame images to guide generation\n- **Multi-shot**: Create videos with up to 6 shots (max 15s total)\n- **Element control**: Include reference images for consistent character/style\n\n**Duration:** 3-15 seconds\n**Quality:** 4K is generated natively by the model, it is not an upscale of a lower resolution\noutput. Generation takes longer and is priced differently than Pro and Standard.\n\n**Note:** For video-to-video generation using a reference video, use the `/ai/reference-to-video/kling-v3-omni-pro` endpoint instead.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/kling-v3-omni-request"}}}},"summary":"Kling 3 Omni 4K - Generate 4K video from text or image","operationId":"postAiVideoKlingV3Omni4k"}},"/v1/ai/image-relight":{"get":{"summary":"Relight - List tasks","description":"Get the status of all relight tasks","tags":["image-relight"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of all relight tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}},"post":{"tags":["image-relight"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The request has succeeded and the relight process has started.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Relight - Adjust image lighting","description":"Relight an image using AI. This endpoint accepts a variety of parameters to customize the generated images.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/relight-request"},"examples":{"all-params":{"$ref":"#/components/examples/request-image-relight-all-params"},"required-params":{"$ref":"#/components/examples/request-image-relight-required-params"}}}}}}},"/v1/ai/video/seedance-2-5-pro-1080p":{"get":{"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Seedance 2.5 Pro 1080p - List tasks","tags":["video"],"operationId":"get_all_seedance_2_5_pro_1080p_tasks"},"post":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate 1080p video using Seedance 2.5 Pro. Supports text-to-video, image-to-video (first/last frame), and reference-to-video with up to 30 reference images (@Image1..@Image30), 10 reference videos (@Video1..@Video10) and 10 reference audios (@Audio1..@Audio10). Also supports video editing and extension via `task_type`, camera motion, multishot sequences (up to 6 shots) and native audio (sound effects).","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/seedance-2-5-request"}}}},"summary":"Seedance 2.5 Pro 1080p - Create video from text or image","operationId":"create_video_seedance_2_5_pro_1080p"}},"/v1/ai/video/minimax-h3-768p/{task-id}":{"get":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"MiniMax H3 768p - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"operationId":"get_minimax_h3_768p_task"}},"/v1/ai/video-edit/wan-2-7/{task-id}":{"get":{"tags":["video-edit"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Retrieve the status and result of a specific WAN 2.7 video edit task by its ID.","summary":"WAN 2.7 Video Edit - Get task status","operationId":"get_wan_27_video_edit_task"}},"/v1/ai/video/kling-v3-omni-pro":{"post":{"tags":["video","kling-v3-omni-pro","background_tasks"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/task-detail-200-default-response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate AI video using Kling 3 Omni Pro with advanced multi-modal capabilities.\n\n**Features:**\n- **Text-to-video**: Generate videos from text prompts\n- **Image-to-video**: Use start and/or end frame images to guide generation\n- **Multi-shot**: Create videos with up to 6 shots (max 15s total)\n- **Element control**: Include reference images for consistent character/style\n\n**Duration:** 3-15 seconds\n**Quality:** Pro mode offers highest quality output.\n\n**Note:** For video-to-video generation using a reference video, use the `/ai/reference-to-video/kling-v3-omni-pro` endpoint instead.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/kling-v3-omni-request"}}}},"summary":"Kling 3 Omni Pro - Generate video from text or image","operationId":"postAiVideoKlingV3OmniPro"}},"/v1/ai/mystic":{"get":{"summary":"Mystic - List tasks","description":"Get the status of all Mystic tasks","tags":["mystic"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of all Mystic tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}},"post":{"tags":["mystic"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The request has succeeded and the Mystic process has started.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Convert descriptive text input into images using AI. This endpoint accepts a variety of parameters to customize the generated images.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/mystic-request"}}}},"summary":"Mystic - Create image from text","operationId":"create_image_mystic"}},"/v1/ai/music-generation/lyria-3":{"get":{"tags":["music-generation"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of all Lyria 3 tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_sound_effects_tasks_200_response"},"examples":{"success":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Lyria 3 - List tasks","description":"Get the status of all Lyria 3 music generation tasks","operationId":"get_all_lyria_3_tasks"},"post":{"tags":["music-generation"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate original music tracks from text descriptions using Lyria 3, with optional image references to guide mood and style.\n\nDescribe the genre, mood, instruments, and tempo you want, and optionally attach reference images that inform the atmosphere of the composition. Ideal for video production, games, podcasts, and multimedia projects.\n\n**Tips for effective prompts:**\n- Include genre: \"cinematic\", \"jazz\", \"electronic\", \"ambient\"\n- Describe mood: \"dramatic\", \"playful\", \"tense\", \"peaceful\"\n- Mention instruments: \"grand piano\", \"saxophone\", \"synth pads\", \"percussion\"\n- Add tempo hints: \"andante\", \"fast-paced\", \"steady groove\"\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/request_16"},"examples":{"pro_with_reference":{"summary":"Pro model with a reference image","value":{"model":"pro","reference_images":[{"image":"https://example.com/mood-reference.jpg","mime_type":"image/jpeg"}],"prompt":"Dramatic orchestral cue with rising strings and deep percussion"}},"basic":{"summary":"Basic music generation","value":{"prompt":"Cinematic ambient track with warm synth pads, soft piano, and a gentle build"}}}}}},"summary":"Lyria 3 - Generate music from text","operationId":"create_lyria_3_task"}},"/v1/ai/text-to-video/veo-3-1":{"get":{"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Get all Veo 3.1 T2V tasks","tags":["text-to-video"],"operationId":"get_all_veo_31_t2v_tasks"},"post":{"tags":["text-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a video from text prompt using Google Veo 3.1 model. Supports multiple resolutions (720p, 1080p, 4K) and optional audio generation.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/t2v-request_4"}}}},"summary":"Create video from text - Veo 3.1","operationId":"create_video_veo_31_t2v"}},"/v1/ai/video/seedance-1-5-pro-720p":{"get":{"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Seedance 1.5 Pro 720p - List tasks","tags":["video"],"operationId":"get_all_seedance_1_5_pro_720p_tasks"},"post":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate 720p video with synchronized audio using Seedance 1.5 Pro. Supports text-to-video and image-to-video with lip-sync, dialogue, foley, and music generation.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/seedance-1-5-pro-request"}}}},"summary":"Seedance 1.5 Pro 720p - Create video from text or image","operationId":"create_video_seedance_1_5_pro_720p"}},"/v1/ai/image-to-video/minimax-hailuo-02-1080p/{task-id}":{"get":{"tags":["image-to-video"],"description":"Get the status of the MiniMax Hailuo-02 1080p task","summary":"MiniMax Hailuo 02 1080p - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/ai/image-to-video/minimax-hailuo-2-3-1080p-fast/{task-id}":{"get":{"tags":["image-to-video"],"description":"Get the status of the MiniMax Hailuo 2.3 1080p Fast task","summary":"MiniMax Hailuo 2.3 1080p Fast - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/ai/image-to-video/wan-2-5-i2v-1080p":{"get":{"summary":"WAN 2.5 I2V 1080p - List tasks","description":"Get the list of WAN 2.5 Image-to-Video 1080p tasks","tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The list of tasks is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}},"post":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_image_from_text_flux_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a 1080p video from image using the WAN 2.5 model.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/i2v-wan-25-1080p-request-content"}}}},"summary":"WAN 2.5 1080p - Create video from image","operationId":"create_video_wan_25_i2v_1080p"}},"/v1/ai/text-to-video/veo-3-1-fast":{"get":{"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Get all Veo 3.1 T2V Fast tasks","tags":["text-to-video"],"operationId":"get_all_veo_31_t2v_fast_tasks"},"post":{"tags":["text-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a video from text prompt using Google Veo 3.1 Fast model. Faster generation at a lower cost.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/t2v-request_4"}}}},"summary":"Create video from text - Veo 3.1 Fast","operationId":"create_video_veo_31_t2v_fast"}},"/v1/ai/voiceover/elevenlabs-turbo-v2-5":{"get":{"tags":["voiceover"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of all voiceover tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_voiceover_tasks_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Voiceover - List tasks","description":"Get the status of all voiceover tasks","operationId":"get_all_voiceover_tasks"},"post":{"tags":["voiceover"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - task created":{"$ref":"#/components/examples/200-task-created"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate natural-sounding speech from text using ElevenLabs AI voices.\n\nCreate professional voiceovers for videos, podcasts, presentations, and more.\nSupports multiple languages, voice customization, and high-quality audio output.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/request_17"},"examples":{"basic":{"summary":"Basic voiceover generation","value":{"text":"Welcome to Magnific. Create amazing designs with AI-powered tools.","voice_id":"21m00Tcm4TlvDq8ikWAM"}},"with_settings":{"summary":"Voiceover with custom voice settings","value":{"stability":0.6,"similarity_boost":0.3,"voice_id":"21m00Tcm4TlvDq8ikWAM","speed":1.1,"use_speaker_boost":true,"text":"Hello! This is a professional voiceover for your video project."}}}}}},"summary":"Voiceover - Generate speech from text","operationId":"create_voiceover_task"}},"/v1/ai/text-to-image/gpt-image-2-5-edit":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of all GPT Image 2.5 Edit tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Get the status of all GPT Image 2.5 Edit tasks","description":"Get the status of all GPT Image 2.5 image editing tasks","operationId":"get_all_gpt_image_2_5_edit_tasks"},"post":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The request has succeeded and the GPT Image 2.5 Edit process has started.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Edit or recompose one or more input images from a text prompt using\nOpenAI's GPT Image 2.5 model.\n\n**Key Features:**\n- Accepts 1-16 input images, used together as the visual context\n- Restyle a single image, or compose a new one from several\n- Same output controls as text-to-image (resolution, aspect ratio, format, compression, quality)\n\n**Best for:**\n- Product and scene variations from an existing shot\n- Combining a subject, a background and a style reference in one call\n- Adding or correcting text on an existing image\n\n**Output:** one edited image per `num_images` (up to 10), delivered as\nCDN URLs in the task's `generated` array. The input images are never\nmodified.\n\n**Credits:** editing sends your images to the model and their input\ntokens dominate the cost, so it is priced differently from generation:\nflat units per output image by `quality` (`low` x1, `medium` x4,\n`high` x6), with `resolution` not affecting the price.\n\nThe request is processed asynchronously: the endpoint returns a task id\nimmediately. Retrieve the result by polling the task endpoint or by\nproviding an optional `webhook_url`.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ttigi25-edit-request-content"},"examples":{"required-params":{"$ref":"#/components/examples/request-gpt-image-2-5-edit-required-params"},"all-params":{"$ref":"#/components/examples/request-gpt-image-2-5-edit-all-params"}}}}},"summary":"Edit images from text - GPT Image 2","operationId":"edit_image_from_text_gpt_image_2_5"}},"/v1/ai/video/seedance-2-5-pro-480p":{"get":{"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Seedance 2.5 Pro 480p - List tasks","tags":["video"],"operationId":"get_all_seedance_2_5_pro_480p_tasks"},"post":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate 480p video using Seedance 2.5 Pro. Supports text-to-video, image-to-video (first/last frame), and reference-to-video with up to 30 reference images (@Image1..@Image30), 10 reference videos (@Video1..@Video10) and 10 reference audios (@Audio1..@Audio10). Also supports video editing and extension via `task_type`, camera motion, multishot sequences (up to 6 shots) and native audio (sound effects).","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/seedance-2-5-request"}}}},"summary":"Seedance 2.5 Pro 480p - Create video from text or image","operationId":"create_video_seedance_2_5_pro_480p"}},"/v1/ai/video/seedance-1-5-pro-480p":{"get":{"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Seedance 1.5 Pro 480p - List tasks","tags":["video"],"operationId":"get_all_seedance_1_5_pro_480p_tasks"},"post":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate 480p video with synchronized audio using Seedance 1.5 Pro. Supports text-to-video and image-to-video with lip-sync, dialogue, foley, and music generation.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/seedance-1-5-pro-request"}}}},"summary":"Seedance 1.5 Pro 480p - Create video from text or image","operationId":"create_video_seedance_1_5_pro_480p"}},"/v1/ai/text-to-video/ltx-2-pro":{"get":{"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"LTX Video 2.0 Pro T2V - List tasks","tags":["text-to-video"],"operationId":"get_all_ltx_2_pro_t2v_tasks"},"post":{"tags":["text-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a video from text prompt using the LTX Video 2.0 Pro model.\n\n**Features:**\n- High-quality video generation with resolutions up to 4K (2160p)\n- Duration options: 6, 8, or 10 seconds\n- Optional synchronized audio generation\n- Reproducible results with seed parameter\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ltx-2-pro-t2v-request"}}}},"summary":"LTX Video 2.0 Pro - Create video from text","operationId":"create_video_ltx_2_pro_t2v"}},"/v1/ai/video/seedance-2-5-pro-480p/{task-id}":{"get":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Seedance 2.5 Pro 480p - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"operationId":"get_seedance_2_5_pro_480p_task"}},"/v1/ai/text-to-image/z-image/{task-id}":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Get the status of a specific Z-Image image generation task","summary":"Get the status of a Z-Image task","operationId":"get_z_image_task_status"}},"/v1/resources":{"get":{"tags":["Resources"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"404":{"$ref":"#/components/responses/404-not-found"},"200":{"description":"Ok Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/search_resources_200_response"},"examples":{"example":{"$ref":"#/components/examples/200-b2b-full-list-pagination"}}}}},"403":{"$ref":"#/components/responses/403-forbidden"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"name":"Accept-Language","schema":{"type":"string"},"example":"en-US","in":"header","description":"Specifies the search query language using the ISO 639-1 (2-letter\nlanguage code) and the ISO 3166-1 (2-letter country code) for language variants.\nThe API will use \"en-US\" as a default language for processing if a code is not\nprovided, or does not exist.\n","required":false},{"name":"page","schema":{"type":"integer"},"example":1,"in":"query","description":"Page number. It must be greater than 0 and less than or equal to 100.","required":false},{"name":"limit","schema":{"type":"integer"},"example":100,"in":"query","description":"Limit results per page. It must be greater than 0.","required":false},{"name":"order","schema":{"default":"relevance","enum":["relevance","recent"],"type":"string"},"example":"recent","in":"query","description":"Specifies the order in which search results are returned. The available options allow you to prioritize results based on different criteria:\n - `relevance`: Prioritizes results that are most relevant to the search query.\n - `recent`: Sorts results by the most recent updates.\n","required":false},{"name":"term","schema":{"type":"string"},"example":"nature","in":"query","description":"Search term. If only term comes, it is searched for term, if only slug comes, it is searched for slug and if both come, it is searched for slug","required":false},{"in":"query","schema":{"$ref":"#/components/schemas/search_resources_filters_parameter"},"name":"filters","description":"Advanced filtering options for resources","explode":true,"style":"deepObject"}],"description":"Retrieve a list of resources based on various filter criteria such as orientation, content type, license, and more.","summary":"Search and filter resources with advanced options","operationId":"search_resources"}},"/v1/resources/{resource-id}":{"get":{"tags":["Resources"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"404":{"$ref":"#/components/responses/404-not-found"},"200":{"description":"OK Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_resource_detail_by_id_200_response"},"examples":{"detail_vector":{"$ref":"#/components/examples/200-detail-vector-b2b"},"detail_ai":{"$ref":"#/components/examples/200-detail-ai-b2b"},"detail_psd":{"$ref":"#/components/examples/200-detail-psd-b2b"},"detail_photo":{"$ref":"#/components/examples/200-detail-photo-b2b"}}}}},"400":{"$ref":"#/components/responses/400-bad-request"},"500":{"$ref":"#/components/responses/500-internal-server-error"}},"parameters":[{"name":"resource-id","schema":{"type":"string"},"example":30955,"in":"path","description":"Photo, video or PSD resource ID","required":true},{"name":"Accept-Language","schema":{"type":"string"},"example":"en-US","in":"header","description":"Specifies the search query language using the ISO 639-1 (2-letter\nlanguage code) and the ISO 3166-1 (2-letter country code) for language variants.\nThe API will use \"en-US\" as a default language for processing if a code is not\nprovided, or does not exist.\n","required":false}],"description":"Retrieve the detailed information of a specific resource by its ID. This endpoint supports multiple resource types including PSD, vector, photo, and AI-generated content.","summary":"Get detailed resource information by ID","operationId":"get_resource_detail_by_id"}},"/v1/icons":{"get":{"tags":["Icons"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"404":{"$ref":"#/components/responses/404-not-found"},"200":{"description":"OK Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/search_icons_200_response"}}}},"400":{"$ref":"#/components/responses/400-bad-request"},"500":{"$ref":"#/components/responses/500-internal-server-error"}},"parameters":[{"name":"Accept-Language","schema":{"type":"string"},"example":"en-US","in":"header","description":"Specifies the search query language using the ISO 639-1 (2-letter\nlanguage code) and the ISO 3166-1 (2-letter country code) for language variants.\nThe API will use \"en-US\" as a default language for processing if a code is not\nprovided, or does not exist.\n","required":false},{"name":"term","schema":{"type":"string"},"example":"nature","in":"query","description":"Search term. If only term comes, it is searched for term, if only slug comes, it is searched for slug and if both come, it is searched for slug","required":false},{"name":"slug","schema":{"type":"string"},"example":"dog","in":"query","description":"Search by slug","required":false},{"name":"page","schema":{"type":"integer"},"example":1,"in":"query","description":"Page number. It must be greater than 0.","required":false},{"name":"per_page","schema":{"type":"integer"},"example":100,"description":"Results per page. It must be greater than 0.","in":"query"},{"name":"family-id","schema":{"minimum":1,"type":"integer"},"example":30955,"in":"query","description":"Icon family id.","required":false},{"name":"order","schema":{"default":"relevance","enum":["relevance","recent"],"type":"string"},"example":"relevance","in":"query","description":"Define order of results.\n- Note: If the term or slug parameter is used, the order will be the similarity of the search.\n","required":false},{"name":"thumbnail_size","schema":{"type":"string"},"example":"128, 512","in":"query","description":"Size of the thumbnail. \nIf the size is not specified, the API will return 128 as a default size.\n","required":false},{"in":"query","schema":{"$ref":"#/components/schemas/search_icons_filters_parameter"},"name":"filters","description":"Filter parameters for icons","explode":true,"style":"deepObject"}],"description":"Get a list of icons based on the provided parameters and ordering criteria.","summary":"Search and filter icons by specified order","operationId":"search_icons"}},"/v1/icons/{id}":{"get":{"tags":["Icons"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"404":{"$ref":"#/components/responses/404-not-found"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_icon_detail_by_id_200_response"},"examples":{"example-0":{"$ref":"#/components/examples/200-icon-detail"}}}}},"400":{"$ref":"#/components/responses/400-bad-request"},"500":{"$ref":"#/components/responses/500-internal-server-error"}},"parameters":[{"name":"Accept-Language","schema":{"type":"string"},"example":"en-US","in":"header","description":"Specifies the search query language using the ISO 639-1 (2-letter\nlanguage code) and the ISO 3166-1 (2-letter country code) for language variants.\nThe API will use \"en-US\" as a default language for processing if a code is not\nprovided, or does not exist.\n","required":false},{"name":"id","schema":{"type":"integer"},"example":30955,"in":"path","description":"Icon resource ID","required":true}],"description":"Get detailed information about a specific icon identified by its unique ID.","summary":"Get detailed icon information by ID","operationId":"get_icon_detail_by_id"}},"/v1/videos":{"get":{"summary":"Search and filter videos by specified order","parameters":[{"name":"Accept-Language","schema":{"type":"string"},"example":"en-US","in":"header","description":"Specifies the search query language using the ISO 639-1 (2-letter\nlanguage code) and the ISO 3166-1 (2-letter country code) for language variants.\nThe API will use \"en-US\" as a default language for processing if a code is not\nprovided, or does not exist.\n","required":false},{"name":"term","schema":{"type":"string"},"example":"nature","in":"query","description":"Search term. This filter is required whenever the author filter parameter is not in the request. In case you use it with some of these params, response will be error 400, Bad request. This is a temporary causality.","required":true},{"name":"page","schema":{"type":"integer"},"example":1,"in":"query","description":"Page number. It must be greater than 0.","required":false},{"in":"query","schema":{"default":"relevance","enum":["relevance","recent","random"],"type":"string"},"required":false,"description":"Define order of results.\n","name":"order"},{"in":"query","schema":{"$ref":"#/components/schemas/_v1_videos_get_filters_parameter"},"name":"filters","description":"Advanced filtering options for video","explode":true,"style":"deepObject"}],"tags":["Videos"],"responses":{"400":{"$ref":"#/components/responses/400-bad-request"},"200":{"headers":{"Content-Type":{"schema":{"example":"application/json","type":"string"}}},"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/_v1_videos_get_200_response"},"examples":{"all_elements_with_pagination":{"$ref":"#/components/examples/200-b2b-videos-full-list-pagination"}}}}},"404":{"$ref":"#/components/responses/404-not-found-for-search"},"500":{"$ref":"#/components/responses/500-internal-server-error"}}}},"/v1/ai/video/seedance-1-5-pro-480p/{task-id}":{"get":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Seedance 1.5 Pro 480p - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"operationId":"get_seedance_1_5_pro_480p_task"}},"/v1/ai/video/omni-human-1-5":{"get":{"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"OmniHuman 1.5 - List tasks","tags":["video"],"operationId":"get_all_omni_human_1_5_tasks"},"post":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate animated video of a human figure driven by audio using OmniHuman 1.5 model (ByteDance). Supports natural head movements, facial expressions, and body motion synchronized to audio input.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/omni-human-1-5-request"}}}},"summary":"OmniHuman 1.5 - Create human animation","operationId":"create_video_omni_human_1_5"}},"/v1/ai/voiceover/elevenlabs-v3":{"get":{"tags":["voiceover"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of all ElevenLabs v3 voiceover tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_voiceover_tasks_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Voiceover ElevenLabs v3 - List tasks","description":"Get the status of all ElevenLabs v3 voiceover tasks","operationId":"get_all_voiceover_elevenlabs_v3_tasks"},"post":{"tags":["voiceover"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - task created":{"$ref":"#/components/examples/200-task-created"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate expressive, natural-sounding speech from text with the ElevenLabs v3 model.\n\nDirect the performance with inline audio tags in square brackets, such as `[excited]`,\n`[whispers]`, `[laughs]` or `[pause 1s]`: the model performs them instead of reading them aloud.\nUp to 5,000 characters per request.\n\n**Credits:** charged per started block of 10 characters of `text`.\n\nThe request is processed asynchronously: the endpoint returns a `task_id`\nimmediately. Retrieve the result by polling\n`GET /v1/ai/voiceover/elevenlabs-v3/{task-id}` or by providing an optional `webhook_url`.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/elevenlabs-v3-request"},"examples":{"basic":{"summary":"Basic voiceover generation","value":{"text":"[excited] Welcome to Magnific! [pause 0.5s] Let's create something amazing.","voice_id":"21m00Tcm4TlvDq8ikWAM"}},"with_settings":{"summary":"Voiceover with custom voice settings","value":{"stability":0,"text":"[whispers] This is the quiet part of the story.","similarity_boost":0.9,"voice_id":"21m00Tcm4TlvDq8ikWAM"}}}}}},"summary":"Voiceover - Generate speech with ElevenLabs v3","operationId":"create_voiceover_elevenlabs_v3_task"}},"/v1/resources/{resource-id}/download":{"get":{"tags":["Resources"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"400":{"$ref":"#/components/responses/400-bad-request"},"404":{"$ref":"#/components/responses/404-not-found"},"429":{"$ref":"#/components/responses/429-too-many-requests"},"200":{"description":"OK Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/download_resource_by_id_200_response"},"examples":{"download_vector_or_psd":{"$ref":"#/components/examples/200-download-vector-or-psd"},"download_photo":{"$ref":"#/components/examples/200-download-photo"},"download_ai":{"$ref":"#/components/examples/200-download-ai-resource"}}}}},"403":{"$ref":"#/components/responses/403-forbidden"},"500":{"$ref":"#/components/responses/500-internal-server-error"}},"parameters":[{"name":"resource-id","schema":{"type":"integer"},"example":30955,"in":"path","description":"Photo, video or PSD resource ID","required":true},{"name":"Accept-Language","schema":{"type":"string"},"example":"en-US","in":"header","description":"Specifies the search query language using the ISO 639-1 (2-letter\nlanguage code) and the ISO 3166-1 (2-letter country code) for language variants.\nThe API will use \"en-US\" as a default language for processing if a code is not\nprovided, or does not exist.\n","required":false},{"name":"image_size","schema":{"$ref":"#/components/schemas/download_resource_by_id_image_size_parameter"},"example":"2000px","in":"query","description":"Resizes the photo to a specified size while maintaining aspect ratio. Accepts a pixel value (100px to 2000px) or \nkeywords small(1000px), medium(1500px), large(2000px), original corresponding to standard website sizes.\nThe size depends on the image orientation, the longest side of the image will be resized to the specified size.\nIf not specified, the highest resolution is provided. Applicable only to photos.\n","required":false}],"description":"Download a specific resource by providing the resource ID. This endpoint supports downloading various types of resources including vectors, PSDs, photos, and AI-generated content.","summary":"Download an resource","operationId":"download_resource_by_id"}},"/v1/ai/video/seedance-2-5-pro-720p/{task-id}":{"get":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Seedance 2.5 Pro 720p - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"operationId":"get_seedance_2_5_pro_720p_task"}},"/v1/music":{"get":{"tags":["Music"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedMusicListResponse"}}}},"400":{"$ref":"#/components/responses/400-bad-request"},"500":{"$ref":"#/components/responses/500-internal-server-error"}},"parameters":[{"name":"q","schema":{"type":"string"},"example":"summer vibes","in":"query","description":"Full-text search query for music titles, artists, and tags","required":false},{"in":"query","explode":false,"schema":{"type":"array","items":{"type":"string","enum":["Acoustic","Afrobeat","Ambient","Blues","Children","Cinematic","Classical","Corporate","Country","Disco","Electronic","Funk","Hip Hop","Jazz","Latin","Lofi","Lounge","Pop","Reggae","RnB","Rock","Soul","Synthwave","World"]}},"required":false,"example":"Electronic,Ambient","name":"genre","description":"Filter by genre. Comma-separated for multiple values","style":"form"},{"in":"query","explode":false,"schema":{"type":"array","items":{"type":"string","enum":["Dark","Dramatic","Elegant","Energetic","Epic","Exciting","Groovy","Happy","Hopeful","Laid Back","Melancholic","Peaceful","Playful","Sad","Sentimental","Soulful","Tension","Upbeat"]}},"required":false,"example":"Happy,Energetic","name":"mood","description":"Filter by mood. Comma-separated for multiple values","style":"form"},{"in":"query","schema":{"default":false,"type":"boolean"},"required":false,"description":"Include premium music in search results. When false, only free music is returned","name":"include-premium"},{"in":"query","schema":{"type":"string","enum":["7d","30d","90d"]},"required":false,"description":"Filter by creation date, relative to current date","name":"time_range"},{"in":"query","schema":{"type":"string","enum":["relevance","popularity","-popularity","created_at","-created_at","title","-title","seconds","-seconds","bpm","-bpm"]},"required":false,"description":"Sort order for results. Prefix with \"-\" for descending. Defaults to \"relevance\" when a search query (q) is provided, otherwise defaults to \"-popularity\".","name":"order_by"},{"in":"query","schema":{"default":10,"minimum":1,"type":"integer","maximum":1000},"required":false,"description":"Number of results to return per page","name":"limit"},{"in":"query","schema":{"default":0,"type":"integer","minimum":0},"required":false,"description":"Number of results to skip for pagination","name":"offset"}],"description":"Search the Magnific Music catalog. Filter by genre, mood, artist, premium status, and creation date range. Returns paginated results sorted by popularity by default.","summary":"Search and filter music","operationId":"search_music"}},"/v1/analytics/audit-logs/events":{"get":{"tags":["Analytics"],"description":"Returns the audit-log events of the caller's enterprise team: who did what,\nto which resource, and how access changed.\n\nAuthenticates via API key (`X-Magnific-API-Key` header). The caller's enterprise\nteam and identity are resolved automatically from the API key.\n\nAvailable exclusively for Enterprise plans with audit logs enabled, and only to team\n**admins/owners**. Rate limit: 500 RPD.\n\nRetention & paging:\n- The audit index retains at most **30 days**; the query window cannot exceed 30\n  days and defaults to the last 30 days when no dates are given.\n- `per_page` is capped at **100**. In page mode, `page * per_page` cannot exceed\n  **10000** (`400` otherwise) — use `cursor` for deep iteration.\n- When `cursor` is provided, `page` is ignored and there is no depth limit. Follow\n  `meta.next_cursor` until it is `null` to walk the whole history.\n\nReading your own audit trail costs no credits.\n","summary":"Search enterprise audit-log events","parameters":[{"in":"query","schema":{"default":1,"type":"integer","minimum":1},"required":false,"description":"Page number (1-based). Ignored when `cursor` is set.","name":"page"},{"in":"query","schema":{"default":20,"minimum":1,"type":"integer","maximum":100},"required":false,"description":"Items per page (max 100).","name":"per_page"},{"in":"query","schema":{"example":"2026-07-16","format":"date","type":"string"},"required":false,"description":"Start of the query window (YYYY-MM-DD). Defaults to 30 days ago. Window max 30 days.","name":"date_from"},{"in":"query","schema":{"example":"2026-07-31","format":"date","type":"string"},"required":false,"description":"End of the query window (YYYY-MM-DD). Defaults to today.","name":"date_to"},{"in":"query","explode":false,"schema":{"type":"array","items":{"minimum":1,"type":"integer"}},"required":false,"example":[10499812],"name":"member_id","description":"Filter by actor user ID(s). Accepts a single value, a comma-separated list\n(`member_id=1,2`) or repeated params (`member_id[]=1&member_id[]=2`).\n","style":"form"},{"in":"query","explode":false,"schema":{"type":"array","items":{"minimum":1,"type":"integer"}},"required":false,"example":[10,20],"name":"group_id","description":"Filter by team group ID(s). Same multi-value syntax as `member_id`.","style":"form"},{"in":"query","explode":false,"schema":{"type":"array","items":{"type":"string"}},"required":false,"example":["a1b2c3d4-1111-4000-8000-000000000001"],"name":"folder_id","description":"Filter by folder reference(s). Same multi-value syntax as `member_id`.","style":"form"},{"in":"query","explode":false,"schema":{"type":"array","items":{"type":"string"}},"required":false,"example":["team.member.role_changed"],"name":"event_type","description":"Filter by event type(s). Same multi-value syntax as `member_id`.","style":"form"},{"name":"request_id","schema":{"type":"string"},"example":"req-7f3a9c1e","in":"query","description":"Exact `request_id` lookup — returns all events emitted by one request.","required":false},{"in":"query","schema":{"type":"string","enum":["api_key","session"]},"required":false,"description":"Only actions done with an API key (`api_key`) or only the rest (`session`).","name":"auth_type"},{"in":"query","explode":false,"schema":{"type":"array","items":{"type":"string"}},"required":false,"example":["11111111-1111-4111-8111-111111111111"],"name":"api_key_id","description":"Only actions done with these API key(s), up to 50, by the identifier listed on the team's API keys. Same multi-value syntax as `member_id`. Events recorded before key identifiers were stored (those whose `auth.api_key_id` is a masked key such as `********dc03`) carry no identifier and are never matched; a masked value is rejected with `400`. Combined with `auth_type=session` the result is empty, since both filters must hold.","style":"form"},{"in":"query","schema":{"type":"string"},"required":false,"description":"Opaque cursor for deep iteration. When set, `page` is ignored and there is no\ndepth limit. Take the value from `meta.next_cursor` of the previous response.\n","name":"cursor"}],"responses":{"503":{"$ref":"#/components/responses/503-service-unavailable"},"400":{"$ref":"#/components/responses/400-bad-request"},"404":{"$ref":"#/components/responses/404-not-found"},"429":{"$ref":"#/components/responses/429-too-many-requests"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/_v1_analytics_audit_logs_events_get_200_response"},"examples":{"success":{"$ref":"#/components/examples/200-analytics-audit-logs-events"}}}}},"403":{"$ref":"#/components/responses/403-forbidden"},"500":{"$ref":"#/components/responses/500-internal-server-error"}}}},"/v1/videos/{id}/options/{option-id}/download":{"get":{"summary":"Download a video by option id.","parameters":[{"name":"Accept-Language","schema":{"type":"string"},"example":"en-US","in":"header","description":"Specifies the search query language using the ISO 639-1 (2-letter\nlanguage code) and the ISO 3166-1 (2-letter country code) for language variants.\nThe API will use \"en-US\" as a default language for processing if a code is not\nprovided, or does not exist.\n","required":false},{"name":"id","schema":{"minimum":1,"type":"integer"},"example":30955,"in":"path","description":"Video id","required":true},{"name":"option-id","schema":{"minimum":1,"type":"integer"},"example":12345,"in":"path","description":"Video option id","required":true}],"tags":["Videos"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"400":{"$ref":"#/components/responses/400-bad-request"},"404":{"$ref":"#/components/responses/404-not-found"},"429":{"$ref":"#/components/responses/429-too-many-requests"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/_v1_videos__id__download_get_200_response"},"examples":{"response_download_200":{"$ref":"#/components/examples/200-b2b-get-download-video-response"}}}}},"403":{"$ref":"#/components/responses/403-forbidden"},"500":{"$ref":"#/components/responses/500-internal-server-error"}}}},"/v1/ai/text-to-image/flux-2-flex":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Successfully retrieved all Flux 2 Flex tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Flux 2 Flex - List tasks","description":"Retrieve the status of all Flux 2 Flex text-to-image generation tasks for the authenticated user.","operationId":"get_all_flux_2_flex_tasks"},"post":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_image_from_text_flux_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Create highly customizable images using FLUX.2 [flex] from Black Forest Labs, a flexible text-to-image model with an extended resolution range.\n\n**Key Features:**\n- Professional quality with fine-grained control\n- Text-to-image generation\n- Image-to-image editing (up to 4 input images)\n- Wide resolution range (256-1920px) for large-format output\n- Adjustable guidance and inference steps\n- Selectable output format (JPEG or PNG)\n- Reproducible results with seed\n\n**Use Cases:**\n- Large-format marketing materials and posters\n- Product photography variations\n- Concept art and illustrations\n- Image editing and enhancement\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ttif2f-request-content"},"examples":{"required-params":{"$ref":"#/components/examples/request-flux-2-flex-required-params"},"all-params":{"$ref":"#/components/examples/request-flux-2-flex-all-params"}}}}},"summary":"Flux 2 Flex - Create image from text","operationId":"create_image_flux_2_flex"}},"/v1/ai/video/kling-4k-t2v":{"get":{"tags":["video","kling-4k-t2v"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The list of Kling 4K T2V tasks is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Kling 4K T2V - List tasks","description":"Retrieve the list of all Kling 4K Text-to-Video tasks for the authenticated user.","operationId":"getAiVideoKling4kT2vTasks"},"post":{"tags":["video","kling-4k-t2v","background_tasks"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/task-detail-200-default-response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate AI video in 4K resolution from a text prompt using Kling 4K Text-to-Video.\n\n**Features:**\n- **Text-to-video**: Generate 4K videos from text prompts\n- **Camera control**: Optionally specify camera movement type and configuration\n\n**Duration:** 3-15 seconds\n**Resolution:** 4K output quality.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/kling-4k-t2v-request"}}}},"summary":"Kling 4K T2V - Generate video from text","operationId":"postAiVideoKling4kT2v"}},"/v1/analytics/team-api-keys":{"get":{"summary":"List team API keys","description":"Returns all API keys belonging to the caller's team with their ID,\ndisplay name, and status. Use the returned `api_key_id` values as filters\nin `POST /v1/analytics/team-credit-usage`.\n\nAuthenticates via API key (`X-Magnific-API-Key` header). The caller's team\nis resolved automatically from the API key.\n","tags":["Analytics"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/_v1_analytics_team_api_keys_get_200_response"},"examples":{"success":{"$ref":"#/components/examples/200-analytics-team-api-keys"}}}}},"403":{"$ref":"#/components/responses/403-forbidden"},"500":{"$ref":"#/components/responses/500-internal-server-error"}}}},"/v1/ai/video/minimax-h3-2k/{task-id}":{"get":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"MiniMax H3 2K - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"operationId":"get_minimax_h3_2k_task"}},"/v1/ai/video/seedance-1-5-pro-720p/{task-id}":{"get":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Seedance 1.5 Pro 720p - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"operationId":"get_seedance_1_5_pro_720p_task"}},"/v1/ai/image-expand/flux-pro/{task-id}":{"get":{"summary":"Get the status of one image expand task","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"tags":["image-expand"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/analytics/team-credit-usage":{"post":{"tags":["Analytics"],"responses":{"400":{"$ref":"#/components/responses/400-bad-request"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/_v1_analytics_team_credit_usage_post_200_response"},"examples":{"example-team-credit-usage":{"$ref":"#/components/examples/200-analytics-team-credit-usage"}}}}},"403":{"$ref":"#/components/responses/403-forbidden"},"500":{"$ref":"#/components/responses/500-internal-server-error"}},"summary":"Get team credit usage over time","description":"Returns credit consumption for the caller's team aggregated into time buckets.\nAuthenticates via API key (`X-Magnific-API-Key` header). The caller's identity\nis resolved automatically from the API key.\n\nResponse always includes per-user breakdown with email and per-project grouping\n(same data as the CSV export). Each row carries both the tool category as a\ndisplay name in `tool` (e.g. \"AI Image Models\") and the specific tool that was\nbilled in `tool_name`.\n\nReconciling usage: many tools share a category, so `tool` alone does not identify\na row. Rows with the same `tool`, user, project and date are distinct consumptions\n— tell them apart by `tool_name` and sum their credits. De-duplicating them\nundercounts real usage.\n\nDate range limits: Enterprise up to 365 days, Business up to 180 days.\nIf no dates are provided, defaults to the last 7 days.\n\nAvailable exclusively for Business and Enterprise plans. Rate limit: 100 RPD.\n\nResponse field mapping (differs from internal endpoints):\n- `tool`: tool category as a display name (e.g. \"AI Image Models\")\n- `tool_name`: the specific tool billed (e.g. \"pikaso-tti-flux-dev\")\n- `user_uses`: number of operations (replaces `count`)\n- `user_credits`: credits consumed (replaces `total_amount`/`amount`)\n- `project_reference`: project UUID (replaces `folder_reference`)\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/_v1_analytics_team_credit_usage_post_request"}}}}}},"/v1/ai/video/seedance-2-5-pro-1080p/{task-id}":{"get":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Seedance 2.5 Pro 1080p - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"operationId":"get_seedance_2_5_pro_1080p_task"}},"/v1/ai/video/seedance-1-5-pro-1080p":{"get":{"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Seedance 1.5 Pro 1080p - List tasks","tags":["video"],"operationId":"get_all_seedance_1_5_pro_1080p_tasks"},"post":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate 1080p video with synchronized audio using Seedance 1.5 Pro. Supports text-to-video and image-to-video with lip-sync, dialogue, foley, and music generation.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/seedance-1-5-pro-request"}}}},"summary":"Seedance 1.5 Pro 1080p - Create video from text or image","operationId":"create_video_seedance_1_5_pro_1080p"}},"/v1/ai/voiceover/elevenlabs-v4":{"get":{"tags":["voiceover"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of all ElevenLabs v4 voiceover tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_voiceover_tasks_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Voiceover ElevenLabs v4 - List tasks","description":"Get the status of all ElevenLabs v4 voiceover tasks","operationId":"get_all_voiceover_elevenlabs_v4_tasks"},"post":{"tags":["voiceover"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - task created":{"$ref":"#/components/examples/200-task-created"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate expressive, natural-sounding speech from text with the ElevenLabs v4 model.\n\nDirect the performance with inline audio tags in square brackets, such as `[excited]`,\n`[whispers]`, `[laughs]` or `[pause 1s]`: the model performs them instead of reading them aloud.\nUp to 10,000 characters per request.\n\n**Credits:** charged per started block of 10 characters of `text`.\n\nThe request is processed asynchronously: the endpoint returns a `task_id`\nimmediately. Retrieve the result by polling\n`GET /v1/ai/voiceover/elevenlabs-v4/{task-id}` or by providing an optional `webhook_url`.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/elevenlabs-v4-request"},"examples":{"basic":{"summary":"Basic voiceover generation","value":{"text":"[excited] Welcome to Magnific! [pause 0.5s] Let's create something amazing.","voice_id":"21m00Tcm4TlvDq8ikWAM"}},"with_settings":{"summary":"Voiceover with custom voice settings","value":{"stability":0,"text":"[whispers] This is the quiet part of the story.","similarity_boost":0.9,"voice_id":"21m00Tcm4TlvDq8ikWAM"}}}}}},"summary":"Voiceover - Generate speech with ElevenLabs v4","operationId":"create_voiceover_elevenlabs_v4_task"}},"/v1/analytics/team-groups":{"get":{"summary":"List team groups","description":"Returns all groups within the caller's team with their ID, name,\nparent group and member count. Subgroups are returned in the same flat\nlist and can be identified by a non-null `parent_group_id`. Use the\nreturned `group_id` values as filters in `POST /v1/analytics/team-credit-usage`.\n\nAuthenticates via API key (`X-Magnific-API-Key` header). The caller's team\nis resolved automatically from the API key.\n","tags":["Analytics"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/_v1_analytics_team_groups_get_200_response"},"examples":{"success":{"$ref":"#/components/examples/200-analytics-team-groups"}}}}},"403":{"$ref":"#/components/responses/403-forbidden"},"500":{"$ref":"#/components/responses/500-internal-server-error"}}}},"/v1/ai/image-expand/ideogram/{task-id}":{"get":{"summary":"Get the status of one image expand ideogram task","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"tags":["image-expand"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/ai/reference-to-video/happy-horse-1/{task-id}":{"get":{"tags":["reference-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Retrieve the status and result of a specific Happy Horse 1.0 reference-to-video task by its ID.","summary":"Happy Horse 1.0 R2V - Get task status","operationId":"get_happy_horse_1_r2v_task"}},"/v1/ai/text-to-video/pixverse-v5-5":{"get":{"summary":"PixVerse V5.5 Text-to-Video - List tasks","description":"List PixVerse-V5.5 text-to-video tasks.","tags":["text-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}},"post":{"tags":["text-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a video from a text prompt using the PixVerse-V5.5 text-to-video model.\n\nCompared to PixVerse-V5, version 5.5 adds:\n- 10-second duration (in addition to 5s and 8s; 10s capped at 720p)\n- Native audio generation via `generate_audio_switch`\n- Multi-clip output with dynamic camera changes via `generate_multi_clip_switch`\n- Prompt reasoning enhancement via `thinking_type`\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/request_9"}}}},"summary":"PixVerse V5.5 - Create video from text","operationId":"create_pixverse_v5_5_text_to_video"}},"/v1/ai/image-to-video/wan-v2-2-720p/{task-id}":{"get":{"tags":["image-to-video"],"description":"Get the status of the WAN 2.2 720p task","summary":"WAN 2.2 720p - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/analytics/team-members":{"get":{"summary":"List team members","description":"Returns all members of the caller's team with their email, role, and status.\n\nAuthenticates via API key (`X-Magnific-API-Key` header). The caller's team\nis resolved automatically from the API key.\n","tags":["Analytics"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/_v1_analytics_team_members_get_200_response"},"examples":{"success":{"$ref":"#/components/examples/200-analytics-team-members"}}}}},"403":{"$ref":"#/components/responses/403-forbidden"},"500":{"$ref":"#/components/responses/500-internal-server-error"}}}},"/v1/ai/video/seedance-1-5-pro-1080p/{task-id}":{"get":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Seedance 1.5 Pro 1080p - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"operationId":"get_seedance_1_5_pro_1080p_task"}},"/v1/ai/image-expand/seedream-v4-5/{task-id}":{"get":{"summary":"Get the status of one image expand seedream v4.5 task","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"tags":["image-expand"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/ai/ideogram-image-edit":{"get":{"tags":["ideogram-image-edit"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Ideogram Image Edit - List tasks","description":"Get the status of all Ideogram Image Edit tasks","operationId":"get_all_ideogram_image_edit_tasks"},"post":{"tags":["ideogram-image-edit"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Edit an image using Ideogram AI's inpainting capabilities. Provide an image and a mask to specify the areas to edit, along with a prompt describing the desired changes.\n\n**Key features:**\n- Inpainting: Edit specific areas of an image using a mask\n- Multiple rendering speeds: TURBO, DEFAULT, or QUALITY\n- MagicPrompt: Automatically enhance your prompt for better results\n- Style customization: Use style codes, style types, and reference images\n- Character reference: Use reference images to maintain character consistency\n\n**Supported formats:** JPEG, WebP, PNG (max 10MB each)\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/request-content_8"}}}},"summary":"Ideogram Image Edit - Edit an image using inpainting","operationId":"create_ideogram_image_edit"}},"/v1/ai/image-to-video/kling-o1-std":{"post":{"tags":["image-to-video","kling-o1-std","background_tasks"],"operationId":"postAiImageToVideoKlingO1Std","responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/task-detail-200-default-response"}}}},"400":{"$ref":"#/components/responses/400-bad-request"},"500":{"$ref":"#/components/responses/500-internal-server-error"}},"summary":"Kling O1 Standard - Create video from image","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/itvko1-image-to-video-request"}}}}}},"/v1/analytics/team-projects":{"get":{"summary":"List team projects","description":"Returns all projects within the caller's team with their\nreference UUID and name. Use the returned `project_reference` values\nin the `project_references` filter of `POST /v1/analytics/team-credit-usage`.\n\nAuthenticates via API key (`X-Magnific-API-Key` header). The caller's team\nis resolved automatically from the API key.\n","tags":["Analytics"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/_v1_analytics_team_projects_get_200_response"},"examples":{"success":{"$ref":"#/components/examples/200-analytics-team-projects"}}}}},"403":{"$ref":"#/components/responses/403-forbidden"},"500":{"$ref":"#/components/responses/500-internal-server-error"}}}},"/v1/ai/image-to-video/pixverse-v5-transition":{"get":{"summary":"PixVerse V5 Transition - List tasks","description":"List PixVerse-V5 Transition tasks.","tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}},"post":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a video transition between two images using the PixVerse-V5 model.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/transition-request"}}}},"summary":"PixVerse V5 - Video transition","operationId":"create_pixverse_v5_transition_video"}},"/v1/ai/video/seedance-2-fast-1080p":{"get":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Seedance 2.0 Fast 1080p - List tasks","deprecated":true,"operationId":"get_all_seedance_2_fast_1080p_tasks"},"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/seedance-2-request"}}}},"tags":["video"],"description":"Generate 1080p video using Seedance 2.0 Fast. Faster generation with slightly reduced quality compared to Pro. Supports text-to-video and image-to-video with optional first and last frame images. Also supports reference-to-video: attach up to 9 reference images via `reference_images` and mention them in the prompt with @Image1..@Image9.","deprecated":true,"operationId":"create_video_seedance_2_fast_1080p","summary":"Seedance 2.0 Fast 1080p - Create video from text or image","responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/ai/gemini-2-5-flash-image-preview/{task-id}":{"get":{"summary":"Gemini 2.5 Flash - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/ai/image-to-video/veo-3-1-fast":{"get":{"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Get all Veo 3.1 I2V Fast tasks","tags":["image-to-video"],"operationId":"get_all_veo_31_i2v_fast_tasks"},"post":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a video from an image using Google Veo 3.1 Fast model. Faster generation at a lower cost.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/i2v-request_4"}}}},"summary":"Create video from image - Veo 3.1 Fast","operationId":"create_video_veo_31_i2v_fast"}},"/v1/ai/magnific-one":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of all Magnific One tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Get the status of all Magnific One tasks","description":"Get the status of all Magnific One image generation tasks","operationId":"get_all_magnific_one_tasks"},"post":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The request has succeeded and the Magnific One process has started.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate images with Magnific One, Magnific's image model with art\ndirection built in: from a prompt, it develops the composition, style,\nlighting and visual treatment before rendering.\n\n**Modes:**\n- `quality` (default): one finished image, with selectable `quality`\n  and `resolution` (up to 4k)\n- `draft`: a contact sheet of quick variations, returned as 8 or 16\n  individual images — explore directions, then render the chosen one\n  in `quality` mode\n\n**Key Features:**\n- Art direction from a short prompt\n- Optional style reference images (up to 10), in both modes\n- 10 aspect ratios, from `21:9` to `9:16`\n\n**Output:** the task's `generated` array holds one image URL in\n`quality` mode, or 8 or 16 URLs (one per individual image) in `draft`\nmode.\n\n**Credits:** a `quality` request is billed once, at the price of its\n`quality` and `resolution`. A `draft` request is billed once for the\nwhole sheet, at the `medium` / `2k` price, never per image. Reference\nimages do not change the price.\n\nThe request is processed asynchronously: the endpoint returns a task id\nimmediately. Retrieve the result by polling the task endpoint or by\nproviding an optional `webhook_url`.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/magnific-one-request-content"},"examples":{"required-params":{"$ref":"#/components/examples/request-magnific-one-required-params"},"all-params":{"$ref":"#/components/examples/request-magnific-one-all-params"},"draft":{"$ref":"#/components/examples/request-magnific-one-draft"}}}}},"summary":"Create image from text - Magnific One","operationId":"create_image_from_text_magnific_one"}},"/v1/ai/video/minimax-h3-max-768p/{task-id}":{"get":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"MiniMax H3 Max 768p - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"operationId":"get_minimax_h3_max_768p_task"}},"/v1/ai/text-to-video/wan-2-5-t2v-720p/{task-id}":{"get":{"tags":["text-to-video"],"description":"Get the status of a WAN 2.5 Text-to-Video 720p task","summary":"WAN 2.5 T2V 720p - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/ai/image-to-prompt":{"get":{"tags":["image-to-prompt"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of all image-to-prompt tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Image to Prompt - List tasks","description":"Get the status of all image-to-prompt tasks","operationId":"get_all_image_to_prompt_tasks"},"post":{"tags":["image-to-prompt"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate descriptive prompts from input images using AI analysis","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/request_11"},"examples":{"url-example":{"$ref":"#/components/examples/request-image-to-prompt-url"},"base64-example":{"$ref":"#/components/examples/request-image-to-prompt-base64"}}}}},"summary":"Image to Prompt - Generate prompt","operationId":"create_image_to_prompt_task"}},"/v1/ai/image-to-video/veo-3-1":{"get":{"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Get all Veo 3.1 I2V tasks","tags":["image-to-video"],"operationId":"get_all_veo_31_i2v_tasks"},"post":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a video from an image using Google Veo 3.1 model. Supports multiple resolutions (720p, 1080p, 4K) and optional audio generation.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/i2v-request_4"}}}},"summary":"Create video from image - Veo 3.1","operationId":"create_video_veo_31_i2v"}},"/v1/ai/image-to-video/wan-2-5-i2v-480p":{"get":{"summary":"WAN 2.5 I2V 480p - List tasks","description":"Get the list of WAN 2.5 Image-to-Video 480p tasks","tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The list of tasks is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}},"post":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_image_from_text_flux_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a 480p video from image using the WAN 2.5 model.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/i2v-wan-25-480p-request-content"}}}},"summary":"WAN 2.5 480p - Create video from image","operationId":"create_video_wan_25_i2v_480p"}},"/v1/cloned-voices":{"get":{"tags":["cloned-voices"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"List of cloned voices","content":{"application/json":{"example":{"data":[{"name":"My Custom Voice","gender":"female","accent_id":null,"example_mp3_url":"https://example.com/sample.mp3","eleven_labs_voice":"pNInz6obpgDQGcFmaJgB","description":"A warm, professional tone","main_languages":[{"identifier":"en","name":"English","id":1}],"is_active":true,"provider":"elevenlabs","is_cloned":true,"last_used_at":"2026-06-01T10:30:00+00:00","status":"completed","deleted_at":null,"preview_image_url":null,"id":42}]},"schema":{"$ref":"#/components/schemas/list_cloned_voices_200_response"}}}},"403":{"$ref":"#/components/responses/403-forbidden"},"500":{"$ref":"#/components/responses/500-internal-server-error"}},"summary":"Cloned Voices - List user's cloned voices","description":"Retrieve all cloned voices belonging to the authenticated user.\n\nReturns completed cloned voices created via the ElevenLabs voice cloning feature.\nEach voice includes metadata such as name, gender, language, provider, and preview audio URL.\n\n**Enterprise only** — this endpoint is available exclusively for Enterprise API key plans.\n","operationId":"list_cloned_voices"},"post":{"tags":["cloned-voices"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"202":{"description":"Cloned voice creation accepted; processing asynchronously","content":{"application/json":{"example":{"data":{"name":"My Custom Voice","id":42,"sqid":"a1b2c3","status":"pending"},"success":true},"schema":{"$ref":"#/components/schemas/create_cloned_voice_202_response"}}}},"400":{"$ref":"#/components/responses/400-bad-request"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"422":{"$ref":"#/components/responses/422-unprocessable-entity"},"429":{"$ref":"#/components/responses/429-too-many-requests"},"403":{"$ref":"#/components/responses/403-forbidden"},"500":{"$ref":"#/components/responses/500-internal-server-error"}},"description":"Create a cloned voice from one or more audio samples, using the ElevenLabs\nvoice cloning feature. It behaves and is billed exactly like the web flow:\nthe same limit of 30 active voices, the same credit consumption and the\nsame lifecycle.\n\nAudio samples are provided as **public https URLs** (1 to 5). Each URL is\ndownloaded server-side; the combined downloaded size must not exceed 200 MB.\n\nCreation is asynchronous: the endpoint returns `202` with the new voice in\n`pending` status. Poll `GET /v1/cloned-voices` until the voice reaches\n`completed`.\n\n**Enterprise only** — this endpoint is available exclusively for Enterprise API key plans.\n","requestBody":{"required":true,"content":{"application/json":{"example":{"name":"My Custom Voice","audios":["https://example.com/sample1.mp3","https://example.com/sample2.mp3"],"description":"A warm, professional tone","remove_background_noise":true},"schema":{"$ref":"#/components/schemas/create_cloned_voice_request"}}}},"summary":"Cloned Voices - Create a cloned voice","operationId":"create_cloned_voice"}},"/v1/ai/image-style-transfer/{task-id}":{"get":{"tags":["image-style-transfer"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Get the status of the Style Transfer task","summary":"Style Transfer - Get task status","operationId":"get_style_transfer_task_status"}},"/v1/ai/text-to-video/runway-4-5/{task-id}":{"get":{"tags":["text-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Retrieve the status and result of a specific RunWay Gen 4.5 text-to-video task by its task ID.","summary":"RunWay Gen 4.5 T2V - Get task status","operationId":"get_runway_45_t2v_task"}},"/v1/ai/skin-enhancer":{"get":{"summary":"Skin Enhancer - List tasks","tags":["skin-enhancer"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/ai/image-to-video/pixverse-v6-transition":{"get":{"summary":"PixVerse V6 Transition - List tasks","description":"List PixVerse-V6 Transition tasks.","tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}},"post":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a video transition using the PixVerse-V6 model. Provide a `first_image_url` and an `end_image_url` to animate a seamless transition between the two frames.\n\nPixVerse-V6 transition supports flexible duration (`1`-`15` seconds), native audio (`generate_audio_switch`), multi-clip output (`generate_multi_clip_switch`), camera movement control and prompt reasoning enhancement (`thinking_type`).\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/request_7"}}}},"summary":"PixVerse V6 - Video transition","operationId":"create_pixverse_v6_transition_video"}},"/v1/ai/text-to-image/ideogram-4/{task-id}":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Get the status of a specific Ideogram 4 image generation task","summary":"Get the status of a Ideogram 4 task","operationId":"get_ideogram_4_task_status"}},"/v1/ai/text-to-video/kling-v3-turbo-720p":{"post":{"tags":["video","kling-v3-turbo-t2v-720p","background_tasks"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/task-detail-200-default-response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate AI video from a text prompt using Kling 3.0 Turbo at 720p resolution, a fast text-to-video model from the Kling 3.0 family.\n\n**Features:**\n- **Text-to-video**: Generate videos from detailed text prompts\n- **Resolution**: Fixed 720p output\n- **Aspect ratio**: Landscape (16:9), portrait (9:16), or square (1:1)\n- **Duration**: 3-15 seconds\n\n**How it works:**\n1. Submit a text prompt describing your desired video\n2. Receive a task ID to track progress\n3. Poll the status endpoint or use a `webhook_url` to get notified when the task completes\n4. Download the generated video from the result URL (valid for 30 minutes)\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/kling-v3-turbo-t2v-request"}}}},"summary":"Kling 3.0 Turbo T2V 720p - Generate video","operationId":"postAiTextToVideoKlingV3Turbo720p"}},"/v1/ai/lip-sync/latent-sync/{task-id}":{"get":{"tags":["lip-sync"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-latent-sync-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Get the status of one Latent-Sync lip-sync task","summary":"Latent Sync - Get task status","operationId":"get_latent_sync_task_status"}},"/v1/ai/video/seedance-2-fast-480p":{"get":{"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Seedance 2.0 Fast 480p - List tasks","tags":["video"],"operationId":"get_all_seedance_2_fast_480p_tasks"},"post":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate 480p video using Seedance 2.0 Fast. Faster generation with slightly reduced quality compared to Pro. Supports text-to-video and image-to-video with optional first and last frame images. Also supports reference-to-video: attach up to 9 reference images via `reference_images` and mention them in the prompt with @Image1..@Image9.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/seedance-2-request"}}}},"summary":"Seedance 2.0 Fast 480p - Create video from text or image","operationId":"create_video_seedance_2_fast_480p"}},"/v1/ai/image-to-video/veo-3-1/{task-id}":{"get":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Get Veo 3.1 I2V task by ID","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"operationId":"get_veo_31_i2v_task"}},"/v1/ai/image-to-video/happy-horse-1/{task-id}":{"get":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Retrieve the status and result of a specific Happy Horse 1.0 image-to-video task by its ID.","summary":"Happy Horse 1.0 I2V - Get task status","operationId":"get_happy_horse_1_i2v_task"}},"/v1/ai/video/seedance-2-pro/{task-id}":{"get":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"404":{"$ref":"#/components/responses/404-not-found"},"500":{"$ref":"#/components/responses/500-internal-server-error"}},"summary":"Seedance 2.0 Pro - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"Unique identifier of the generation task","name":"task-id"}],"operationId":"get_seedance_2_pro_task"}},"/v1/ai/reference-to-video/kling-v3-omni":{"get":{"tags":["reference-to-video","kling-v3-omni-r2v"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The list of Kling 3 Omni reference-to-video tasks is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1},"description":"Page number for pagination (1-indexed)"},{"in":"query","name":"page_size","schema":{"default":20,"minimum":1,"type":"integer","maximum":100},"description":"Number of items per page"}],"description":"Retrieve the list of all Kling 3 Omni reference-to-video tasks (both Pro and Standard) for the authenticated user.","summary":"Kling 3 Omni Reference-to-Video - List tasks","operationId":"getAiReferenceToVideoKlingV3OmniTasks"}},"/v1/ai/text-to-image/nano-banana-pro/{task-id}":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Get the status of a specific Nano Banana Pro image generation task","summary":"Get the status of a Nano Banana Pro task","operationId":"get_nano_banana_pro_task_status"}},"/v1/ai/image-to-video/kling-elements/{task-id}":{"get":{"tags":["image-to-video"],"description":"Get the status of the kling-elements task","summary":"Kling Elements - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/ai/flows/{flow-id}/run":{"post":{"requestBody":{"required":true,"content":{"application/json":{"example":{"inputs":{"image":"car in the forest"},"webhook":"https://www.example.com/webhook"},"schema":{"$ref":"#/components/schemas/run-request"}}}},"tags":["flows"],"parameters":[{"in":"path","schema":{"example":"uqzQLDr2Aw","type":"string"},"required":true,"description":"Short unique identifier (sqid) of the flow to execute. Discover flow identifiers via GET /v1/ai/flows.","name":"flow-id"}],"description":"Triggers the execution of a flow. Provide values for all required inputs\ndefined in the flow's definition (see the GET endpoint).\n\nThe `inputs` object maps each input's `api_key` (recommended) or its `id` (UUID, legacy) to its value:\n\n| Input Type | Accepted Values |\n|------------|----------------|\n| `creation` | Image URL (`https://...`), base64-encoded image string, or existing creation identifier |\n| `text` | Plain text string |\n| `number` | Numeric value |\n| `select` | Value from allowed options |\n\n**This endpoint is asynchronous.** It returns immediately with `status: \"running\"` and a\n`workflow_run_identifier`. Provide a `webhook` URL to receive notifications when the execution\ncompletes. The webhook receives two events: `initialized` (run started) and `finished`/`failed` (run completed).\n\nThe webhook payload for a completed run includes a `result` object containing `images`, `videos`,\nand `audios` arrays with download URLs for the generated assets.\n","operationId":"run_flow","summary":"Flows - Run a flow","responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"202":{"$ref":"#/components/responses/run-202-response"},"404":{"description":"Flow not found."},"400":{"$ref":"#/components/responses/400-bad-request"},"422":{"description":"Validation error on input values."},"503":{"$ref":"#/components/responses/503-service-unavailable"},"500":{"$ref":"#/components/responses/500-internal-server-error"}}}},"/v1/ai/video/kling-advanced-custom-elements":{"get":{"tags":["video","advanced-custom-elements"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The list of Advanced Custom Elements tasks is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"**Deprecated.** This endpoint is deprecated. You can pass reference images directly in the `elements` array\nof the Kling V3 video generation endpoints (`/ai/video/kling-v3-pro`, `/ai/video/kling-v3-std`)\nwithout needing to pre-create elements.\n\nRetrieve the list of all Advanced Custom Elements creation tasks for the authenticated user.\n","deprecated":true,"summary":"Advanced Custom Elements - List tasks","operationId":"getAiVideoKlingAdvancedCustomElementsTasks"},"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/advanced-custom-elements-request"}}}},"tags":["video","advanced-custom-elements","background_tasks"],"description":"**Deprecated.** This endpoint is deprecated. You can pass reference images directly in the `elements` array\nof the Kling V3 video generation endpoints (`/ai/video/kling-v3-pro`, `/ai/video/kling-v3-std`)\nwithout needing to pre-create elements.\n\nCreate reusable custom elements (characters, animals, items, costumes, scenes, effects) from reference images or videos.\nElements can be referenced in Kling video generation tasks for consistent identity across videos.\n\n**Features:**\n- Create elements from multi-angle reference images or a reference video\n- Supports character, animal, item, costume, scene, and effect element types\n- Optionally bind a voice to the element for video generation with speech\n- Elements can be reused across multiple video generation tasks\n\n**Reference types:**\n- `image_refer`: Create element from 1 frontal image + up to 3 additional reference images from different angles\n- `video_refer`: Create element from a single reference video (3-8 seconds, 1080P, mp4/mov)\n","deprecated":true,"operationId":"postAiVideoKlingAdvancedCustomElements","summary":"Advanced Custom Elements - Create element","responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/task-detail-200-default-response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/ai/text-to-icon/preview":{"post":{"tags":["Text to icon"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"Success - The request has succeeded and the Text to Icon process has started.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Create stunning previews icons in different styles and formats (png, svg) from text prompts using our advanced AI models.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/text-to-icon-request-preview"},"examples":{"required-params":{"$ref":"#/components/examples/request-text-to-icon"},"all-params":{"$ref":"#/components/examples/request-text-to-icon-preview-all"}}}}},"summary":"AI Icon generation","operationId":"generate_text_to_icon_preview"}},"/v1/ai/text-to-image/seedream-v5-pro/{task-id}":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Get the status of a specific Seedream 5.0 Pro image generation task","summary":"Seedream 5.0 Pro - Get task status","operationId":"get_seedream_v5_pro_task_status"}},"/v1/ai/video/seedance-2-fast/{task-id}":{"get":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"404":{"$ref":"#/components/responses/404-not-found"},"500":{"$ref":"#/components/responses/500-internal-server-error"}},"summary":"Seedance 2.0 Fast - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"Unique identifier of the generation task","name":"task-id"}],"operationId":"get_seedance_2_fast_task"}},"/v1/ai/image-to-video/veo-3-1-lite":{"get":{"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Get all Veo 3.1 Lite I2V tasks","tags":["image-to-video"],"operationId":"get_all_veo_31_lite_i2v_tasks"},"post":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a video from an image using Google Veo 3.1 Lite. A cost-efficient variant of Veo 3.1 supporting 720p and 1080p resolutions with optional native audio generation.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/i2v-request_5"}}}},"summary":"Create video from image - Veo 3.1 Lite","operationId":"create_video_veo_31_lite_i2v"}},"/v1/ai/text-to-image/flux-2-pro":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Successfully retrieved all Flux 2 Pro tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Flux 2 Pro - List tasks","description":"Retrieve the status of all Flux 2 Pro text-to-image generation tasks for the authenticated user.","operationId":"get_all_flux_2_pro_tasks"},"post":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_image_from_text_flux_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Create professional-grade images using FLUX.2 [pro], the next generation of Black Forest Labs' image models.\n\n**Key Features:**\n- Professional quality without complex tuning\n- Text-to-image generation\n- Image-to-image editing (up to 4 input images)\n- Customizable dimensions (256-1440px)\n- Optional prompt enhancement\n- Reproducible results with seed\n\n**Use Cases:**\n- Marketing materials and advertisements\n- Product photography variations\n- Concept art and illustrations\n- Image editing and enhancement\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ttif2p-request-content"},"examples":{"required-params":{"$ref":"#/components/examples/request-flux-2-pro-required-params"},"all-params":{"$ref":"#/components/examples/request-flux-2-pro-all-params"}}}}},"summary":"Flux 2 Pro - Create image from text","operationId":"create_image_flux_2_pro"}},"/v1/ai/image-to-video/wan-v2-2-480p/{task-id}":{"get":{"tags":["image-to-video"],"description":"Get the status of the WAN 2.2 480p task","summary":"WAN 2.2 480p - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/ai/image-to-video/pixverse-v5-5":{"get":{"summary":"PixVerse V5.5 - List tasks","description":"List PixVerse-V5.5 tasks.","tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}},"post":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a video from an image using the PixVerse-V5.5 model.\n\nCompared to PixVerse-V5, version 5.5 adds:\n- 10-second duration (in addition to 5s and 8s; 10s capped at 720p)\n- Native audio generation via `generate_audio_switch`\n- Multi-clip output with dynamic camera changes via `generate_multi_clip_switch`\n- Prompt reasoning enhancement via `thinking_type`\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/request_4"}}}},"summary":"PixVerse V5.5 - Create video from image","operationId":"create_pixverse_v5_5_video"}},"/v1/ai/video/seedance-2-fast-720p":{"get":{"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Seedance 2.0 Fast 720p - List tasks","tags":["video"],"operationId":"get_all_seedance_2_fast_720p_tasks"},"post":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate 720p video using Seedance 2.0 Fast. Faster generation with slightly reduced quality compared to Pro. Supports text-to-video and image-to-video with optional first and last frame images. Also supports reference-to-video: attach up to 9 reference images via `reference_images` and mention them in the prompt with @Image1..@Image9.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/seedance-2-request"}}}},"summary":"Seedance 2.0 Fast 720p - Create video from text or image","operationId":"create_video_seedance_2_fast_720p"}},"/v1/ai/lip-sync/veed-fabric-1-0/{task-id}":{"get":{"tags":["lip-sync"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-veed-fabric-1-0-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Retrieve a specific Veed Fabric 1.0 lip-sync task by its ID, including generation status and result URL when completed.","summary":"Veed Fabric 1.0 - Get task status","operationId":"get_veed_fabric_1_0_task_status"}},"/v1/videos/{id}/download":{"get":{"summary":"Download a video by ID.","parameters":[{"name":"Accept-Language","schema":{"type":"string"},"example":"en-US","in":"header","description":"Specifies the search query language using the ISO 639-1 (2-letter\nlanguage code) and the ISO 3166-1 (2-letter country code) for language variants.\nThe API will use \"en-US\" as a default language for processing if a code is not\nprovided, or does not exist.\n","required":false},{"name":"id","schema":{"minimum":1,"type":"integer"},"example":30955,"in":"path","description":"Video id","required":true}],"tags":["Videos"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"400":{"$ref":"#/components/responses/400-bad-request"},"404":{"$ref":"#/components/responses/404-not-found"},"429":{"$ref":"#/components/responses/429-too-many-requests"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/_v1_videos__id__download_get_200_response"},"examples":{"response_download_200":{"$ref":"#/components/examples/200-b2b-get-download-video-response"}}}}},"403":{"$ref":"#/components/responses/403-forbidden"},"500":{"$ref":"#/components/responses/500-internal-server-error"}}}},"/v1/ai/image-to-video/wan-2-5-i2v-720p":{"get":{"summary":"WAN 2.5 I2V 720p - List tasks","description":"Get the list of WAN 2.5 Image-to-Video 720p tasks","tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The list of tasks is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}},"post":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_image_from_text_flux_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a 720p video from image using the WAN 2.5 model.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/i2v-wan-25-720p-request-content"}}}},"summary":"WAN 2.5 720p - Create video from image","operationId":"create_video_wan_25_i2v_720p"}},"/v1/ai/text-to-video/wan-2-7":{"get":{"tags":["text-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"WAN 2.7 T2V - List tasks","description":"Retrieve the list of all WAN 2.7 text-to-video tasks for the authenticated user.","operationId":"get_all_wan_27_t2v_tasks"},"post":{"tags":["text-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a video from a text prompt using WAN 2.7. Supports configurable aspect ratios (16:9, 9:16, 1:1, 4:3, 3:4), resolutions (720P, 1080P), optional audio input, and duration from 2 to 15 seconds.\n\n**Key features:**\n- 720P and 1080P resolution support\n- 5 aspect ratio options\n- Optional audio-guided generation\n- Automatic prompt expansion for richer output\n- Duration range: 2-15 seconds\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/t2v-request"}}}},"summary":"WAN 2.7 - Create video from text","operationId":"create_video_wan_27_t2v"}},"/v1/music/{music-id}/download":{"get":{"tags":["Music"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MusicDownloadResponse"}}}},"404":{"$ref":"#/components/responses/404-not-found"},"500":{"$ref":"#/components/responses/500-internal-server-error"}},"parameters":[{"name":"music-id","schema":{"type":"integer"},"example":1,"in":"path","description":"Unique numeric identifier of the music item","required":true}],"description":"Get a direct download URL for a music audio file. Returns the music ID, title, and a CDN-hosted download link.","summary":"Download music","operationId":"download_music"}},"/v1/ai/video/kling-v3-motion-control-pro":{"get":{"tags":["video","kling-v3-motion-control-pro"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The list of Kling 3 Pro Motion Control tasks is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Kling 3 Pro Motion Control - List tasks","description":"Retrieve the list of all Kling 3 Pro Motion Control video generation tasks for the authenticated user.","operationId":"getAiVideoKlingV3MotionControlProTasks"},"post":{"tags":["video","kling-v3-motion-control-pro","background_tasks"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/task-detail-200-default-response"}}}},"400":{"$ref":"#/components/responses/400-bad-request"},"500":{"$ref":"#/components/responses/500-internal-server-error"}},"description":"Transfer motion from a reference video to a character image using Kling 3 Pro. The model preserves the character's appearance while applying motion patterns from the reference video.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/motion-control-request"}}}},"summary":"Kling 3 Pro - Motion control video","operationId":"postAiVideoKlingV3MotionControlPro"}},"/v1/ai/image-to-video/kling-elements-std":{"get":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The list of the kling-elements-std tasks is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Kling Elements Standard - List tasks","description":"Get the list of the kling-elements-std tasks","operationId":"get_all_kling_elements_std_tasks"},"post":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of the kling-elements-std task","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_image_from_text_flux_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a video from an image using the Kling Elements Std model.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/itvke-request-content"},"examples":{"required-params":{"$ref":"#/components/examples/request-itv-kling-elements-std-required-params"},"all-params":{"$ref":"#/components/examples/request-itv-kling-elements-std-all-params"}}}}},"summary":"Kling Elements Standard - Create video from image","operationId":"create_video_from_image_kling_elements_std"}},"/v1/icons/{id}/download":{"get":{"tags":["Icons"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"400":{"$ref":"#/components/responses/400-bad-request"},"404":{"$ref":"#/components/responses/404-not-found"},"429":{"$ref":"#/components/responses/429-too-many-requests"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/data-icon-download"}}}},"403":{"$ref":"#/components/responses/403-forbidden"},"500":{"$ref":"#/components/responses/500-internal-server-error"}},"parameters":[{"name":"Accept-Language","schema":{"type":"string"},"example":"en-US","in":"header","description":"Specifies the search query language using the ISO 639-1 (2-letter\nlanguage code) and the ISO 3166-1 (2-letter country code) for language variants.\nThe API will use \"en-US\" as a default language for processing if a code is not\nprovided, or does not exist.\n","required":false},{"name":"id","schema":{"type":"integer"},"example":30955,"in":"path","description":"Icon resource ID","required":true},{"name":"format","schema":{"type":"string","enum":["svg","png","gif","mp4","aep","json","psd","eps"]},"example":"svg","description":"These are the formats available for download\n- Note: gif, mp4, aep, json, psd and eps are not available for standard and sticker icon types.\n","in":"query"},{"in":"query","name":"png_size","schema":{"default":512,"enum":[512,256,128,64,32,24,16],"type":"integer"},"description":"These are the sizes available for png_url formats.\n- Note: Only apply to format png.\n"}],"description":"Download the specified icon by its unique ID in the requested format and size.","summary":"Download an icon","operationId":"download_icon_by_id"}},"/v1/ai/me/flows":{"get":{"tags":["flows"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"200":{"description":"OK - List of user's flows.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/list_my_flows_200_response"},"examples":{"success":{"$ref":"#/components/examples/200-list-my-flows"}}}}},"503":{"$ref":"#/components/responses/503-service-unavailable"},"500":{"$ref":"#/components/responses/500-internal-server-error"}},"summary":"Flows - List my flows","description":"Returns all flows **owned** by the authenticated user, including drafts and unpublished workflows.\n\nUnlike `GET /v1/ai/flows` which returns only flows published as tools, this endpoint returns\nevery flow the user has created — regardless of whether it has been published as a tool.\n\nEach item includes the flow identifier and name.\n","operationId":"list_my_flows"}},"/v1/ai/text-to-video/veo-3-1-lite":{"get":{"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Get all Veo 3.1 Lite T2V tasks","tags":["text-to-video"],"operationId":"get_all_veo_31_lite_t2v_tasks"},"post":{"tags":["text-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a video from a text prompt using Google Veo 3.1 Lite. A cost-efficient variant of Veo 3.1 supporting 720p and 1080p resolutions with optional native audio generation.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/t2v-request_5"}}}},"summary":"Create video from text - Veo 3.1 Lite","operationId":"create_video_veo_31_lite_t2v"}},"/v1/ai/reference-to-video/kling-v3-omni-std":{"post":{"tags":["reference-to-video","kling-v3-omni-std-r2v","background_tasks"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/task-detail-200-default-response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate AI video using Kling 3 Omni Standard with a reference video for motion and style guidance.\n\n**Video-to-video mode:** This endpoint requires a `video_url` parameter. Reference the video in your prompt using `@Video1`.\n\n**Features:**\n- Use a reference video (3-10s) to guide motion and style\n- Combine with an image for start frame control\n- Faster generation at slightly lower quality\n\n**Use case:** Create videos that follow motion patterns from a reference video while applying your creative prompt.\n\n**Duration:** 3-15 seconds\n**Quality:** Standard mode offers faster generation at slightly lower quality.\n\n**Tip:** For text-to-video or image-to-video without a reference video, use the `/ai/video/kling-v3-omni-std` endpoint instead.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/kling-v3-omni-video-reference-request"}}}},"summary":"Kling 3 Omni Standard - Video-to-video generation","operationId":"postAiReferenceToVideoKlingV3OmniStd"}},"/v1/ai/video/omni-human-1-5/{task-id}":{"get":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"OmniHuman 1.5 - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"operationId":"get_omni_human_1_5_task"}},"/v1/ai/text-to-video/wan-2-5-t2v-1080p":{"get":{"summary":"WAN 2.5 T2V 1080p - List tasks","description":"Get the list of WAN 2.5 Text-to-Video 1080p tasks","tags":["text-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The list of tasks is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}},"post":{"tags":["text-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_image_from_text_flux_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a 1080p video from text prompt using the WAN 2.5 model.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/t2v-wan-25-1080p-request-content"}}}},"summary":"WAN 2.5 1080p - Create video from text","operationId":"create_video_wan_25_t2v_1080p"}},"/v1/ai/image-to-video/kling-o1-pro":{"post":{"tags":["image-to-video","kling-o1-pro","background_tasks"],"operationId":"postAiImageToVideoKlingO1Pro","responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/task-detail-200-default-response"}}}},"400":{"$ref":"#/components/responses/400-bad-request"},"500":{"$ref":"#/components/responses/500-internal-server-error"}},"summary":"Kling O1 Pro - Create video from image","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/itvko1-image-to-video-request"}}}}}},"/v1/ai/text-to-image/hyperflux":{"get":{"summary":"HyperFlux - List tasks","tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}},"post":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"HyperFlux - Create image from text","description":"This endpoint allows you to generate an image using the HyperFlux model, the fastest Flux model available\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/request-content_1"}}}}}},"/v1/ai/image-to-video/pixverse-v5":{"get":{"summary":"PixVerse V5 - List tasks","description":"List PixVerse-V5 tasks filtered by resolution provided in the request body.","tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}},"post":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a video using the PixVerse-V5 model. Resolution is specified in the request body.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/request_3"}}}},"summary":"PixVerse V5 - Create video from image","operationId":"create_pixverse_v5_video"}},"/v1/ai/video/seedance-2-mini/{task-id}":{"get":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"404":{"$ref":"#/components/responses/404-not-found"},"500":{"$ref":"#/components/responses/500-internal-server-error"}},"summary":"Seedance 2.0 Mini - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"Unique identifier of the generation task","name":"task-id"}],"operationId":"get_seedance_2_mini_task"}},"/v1/ai/text-to-image/nano-banana-pro-flash":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of all Nano Banana Pro Flash tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Get the status of all Nano Banana Pro Flash tasks","description":"Get the status of all Nano Banana Pro Flash image generation tasks","operationId":"get_all_nano_banana_pro_flash_tasks"},"post":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The request has succeeded and the Nano Banana Pro Flash process has started.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate images from text descriptions using Google's Nano Banana Pro Flash model (Gemini 3.1 Flash), a faster variant of Nano Banana Pro optimized for quick image generation.\n\n**Key Features:**\n- Fast image generation with Gemini 3.1 Flash\n- Google Search grounding for real-world accuracy\n- Support for reference images for guided generation\n- Multiple aspect ratios and resolutions up to 4K\n\n**Best for:**\n- Rapid image generation with shorter wait times\n- Grounded image generation using Google Search\n- Reference-guided generation\n- Iterative creative workflows where speed matters\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/tti-nano-banana-pro-flash-request"}}}},"summary":"Create image from text - Nano Banana Pro Flash","operationId":"create_image_from_text_nano_banana_pro_flash"}},"/v1/ai/text-to-video/wan-v2-6-1080p/{task-id}":{"get":{"tags":["text-to-video"],"description":"Get the status of a WAN 2.6 Text-to-Video 1080p task","summary":"WAN 2.6 T2V 1080p - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/ai/video/kling-v3-motion-control-std":{"get":{"tags":["video","kling-v3-motion-control-std"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The list of Kling 3 Standard Motion Control tasks is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Kling 3 Standard Motion Control - List tasks","description":"Retrieve the list of all Kling 3 Standard Motion Control video generation tasks for the authenticated user.","operationId":"getAiVideoKlingV3MotionControlStdTasks"},"post":{"tags":["video","kling-v3-motion-control-std","background_tasks"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/task-detail-200-default-response"}}}},"400":{"$ref":"#/components/responses/400-bad-request"},"500":{"$ref":"#/components/responses/500-internal-server-error"}},"description":"Transfer motion from a reference video to a character image using Kling 3 Standard. The model preserves the character's appearance while applying motion patterns from the reference video.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/motion-control-request"}}}},"summary":"Kling 3 Standard - Motion control video","operationId":"postAiVideoKlingV3MotionControlStd"}},"/v1/ai/image-change-camera":{"get":{"tags":["image-change-camera"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Change Camera - List tasks","description":"Retrieve the status of all Change Camera tasks for the authenticated user. Returns a list of tasks with their current status, creation time, and result URLs for completed tasks.","operationId":"get_all_change_camera_tasks"},"post":{"tags":["image-change-camera"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Transform an image by changing the camera angle using AI. Adjust horizontal rotation (0-360 degrees), vertical tilt (-30 to 90 degrees), and zoom level (0-10) to generate a new image as if the camera had been repositioned around the subject.\n\nThis is an asynchronous endpoint. After submitting a request, use the task ID to poll for results or provide a `webhook_url` to receive a notification when processing completes.\n\n**Camera controls:**\n- **Horizontal angle** (`horizontal_angle`): Rotate the viewpoint 0-360 degrees around the subject. `0` = front view, `90` = right side, `180` = back view, `270` = left side.\n- **Vertical angle** (`vertical_angle`): Tilt the camera from -30 (looking up) to 90 (bird's eye view). `0` = eye level.\n- **Zoom** (`zoom`): Adjust from `0` (wide shot, full scene) to `10` (close-up).\n\n**Use cases:** Product photography with multiple angle views, architectural visualization, creative image manipulation, and generating consistent multi-angle views of objects and scenes.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/change-camera-request"},"examples":{"required-params":{"$ref":"#/components/examples/request-change-camera-required-params"},"all-params":{"$ref":"#/components/examples/request-change-camera-all-params"}}}}},"summary":"Change Camera - Transform image perspective","operationId":"create_change_camera_task"}},"/v1/ai/text-to-video/happy-horse-1/{task-id}":{"get":{"tags":["text-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Retrieve the status and result of a specific Happy Horse 1.0 text-to-video task by its ID.","summary":"Happy Horse 1.0 T2V - Get task status","operationId":"get_happy_horse_1_t2v_task"}},"/v1/ai/image-to-video/wan-v2-2-580p/{task-id}":{"get":{"tags":["image-to-video"],"description":"Get the status of the WAN 2.2 580p task","summary":"WAN 2.2 580p - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/ai/reference-to-video/veo-3-1":{"get":{"tags":["reference-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Get all Veo 3.1 Reference-to-Video tasks","description":"Retrieve a list of all reference-to-video generation tasks for Veo 3.1.","operationId":"get_all_veo_31_ref2v_tasks"},"post":{"tags":["reference-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a video with character or object consistency using reference images. Maintains visual identity across scenes for storytelling and multi-scene projects. Supports 720p, 1080p, and 4K resolutions with native audio generation including dialogue and sound effects. Fixed 8-second duration at 24 FPS.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ref2v-request"}}}},"summary":"Create video with reference images - Veo 3.1","operationId":"create_video_veo_31_ref2v"}},"/v1/ai/text-to-image/z-image":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of all Z-Image tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Get the status of all Z-Image tasks","description":"Get the status of all Z-Image image generation tasks","operationId":"get_all_z_image_tasks"},"post":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The request has succeeded and the Z-Image process has started.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate high-quality images from text descriptions using the Z-Image turbo model.\n\n**Key Features:**\n- Superior speed with turbo architecture\n- High-quality image generation\n- Flexible image size configuration\n- Supports LoRA and ControlNet variants\n\n**Best for:**\n- Fast prototyping and iteration\n- High-volume image generation\n- Cost-effective production workloads\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ttizi-request-content"},"examples":{"required-params":{"$ref":"#/components/examples/request-z-image-required-params"},"all-params":{"$ref":"#/components/examples/request-z-image-all-params"}}}}},"summary":"Create image from text - Z-Image","operationId":"create_image_from_text_z_image"}},"/v1/ai/image-to-video/kling-v2-5-720p/{task-id}":{"get":{"tags":["image-to-video"],"description":"Get the status of the kling-v2-5-720p task","summary":"Kling 2.5 720p - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-flux-dev-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/ai/text-to-image/nano-banana-pro-flash/{task-id}":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Get the status of a specific Nano Banana Pro Flash image generation task","summary":"Get the status of a Nano Banana Pro Flash task","operationId":"get_nano_banana_pro_flash_task_status"}},"/v1/ai/text-to-video/wan-2-5-t2v-480p":{"get":{"summary":"WAN 2.5 T2V 480p - List tasks","description":"Get the list of WAN 2.5 Text-to-Video 480p tasks","tags":["text-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The list of tasks is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}},"post":{"tags":["text-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_image_from_text_flux_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a 480p video from text prompt using the WAN 2.5 model.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/t2v-wan-25-480p-request-content"}}}},"summary":"WAN 2.5 480p - Create video from text","operationId":"create_video_wan_25_t2v_480p"}},"/v1/ai/image-to-video/wan-v2-6-720p/{task-id}":{"get":{"tags":["image-to-video"],"description":"Get the status of a WAN 2.6 Image-to-Video 720p task","summary":"WAN 2.6 I2V 720p - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/ai/video/vfx/{task-id}":{"get":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Retrieve the status and results of a specific VFX video effect task by its task ID.","summary":"VFX - Get task status","operationId":"get_vfx_task"}},"/v1/ai/reference-to-video/kling-v3-omni-pro":{"post":{"tags":["reference-to-video","kling-v3-omni-pro-r2v","background_tasks"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/task-detail-200-default-response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate AI video using Kling 3 Omni Pro with a reference video for motion and style guidance.\n\n**Video-to-video mode:** This endpoint requires a `video_url` parameter. Reference the video in your prompt using `@Video1`.\n\n**Features:**\n- Use a reference video (3-10s) to guide motion and style\n- Combine with an image for start frame control\n- High-quality pro output\n\n**Use case:** Create videos that follow motion patterns from a reference video while applying your creative prompt.\n\n**Duration:** 3-15 seconds\n**Quality:** Pro mode offers highest quality output.\n\n**Tip:** For text-to-video or image-to-video without a reference video, use the `/ai/video/kling-v3-omni-pro` endpoint instead.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/kling-v3-omni-video-reference-request"}}}},"summary":"Kling 3 Omni Pro - Video-to-video generation","operationId":"postAiReferenceToVideoKlingV3OmniPro"}},"/v1/ai/image-to-video/minimax-hailuo-02-768p":{"get":{"summary":"MiniMax Hailuo 02 768p - List tasks","description":"Get the list of MiniMax Hailuo-02 768p tasks","tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The list of MiniMax Hailuo-02 768p tasks is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}},"post":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_image_from_text_flux_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a video from text or image using the MiniMax Hailuo-02 768p model.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_video_minimax_hailuo_02_768p_request"}}}},"summary":"MiniMax Hailuo 02 768p - Create video from text or image","operationId":"create_video_minimax_hailuo_02_768p"}},"/v1/ai/image-to-video/pixverse-v6":{"get":{"summary":"PixVerse V6 - List tasks","description":"List PixVerse-V6 tasks.","tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}},"post":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a video from an image using the PixVerse-V6 model.\n\nCompared to PixVerse-V5.5, version 6 adds:\n- Flexible duration: any integer from `1` to `15` seconds (previously fixed to `5`, `8` or `10`).\n- Optional `last_frame_image`: when provided, PixVerse-V6 generates a transition between `image_url` (first frame) and `last_frame_image` (last frame) in the same endpoint — no separate transition endpoint required.\n\nExisting PixVerse-V5.5 features are kept: native audio (`generate_audio_switch`), multi-clip output (`generate_multi_clip_switch`) and prompt reasoning enhancement (`thinking_type`).\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/request_6"}}}},"summary":"PixVerse V6 - Create video from image","operationId":"create_pixverse_v6_video"}},"/v1/ai/video/kling-4k-i2v":{"get":{"tags":["video","kling-4k-i2v"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The list of Kling 4K I2V tasks is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Kling 4K I2V - List tasks","description":"Retrieve the list of all Kling 4K Image-to-Video tasks for the authenticated user.","operationId":"getAiVideoKling4kI2vTasks"},"post":{"tags":["video","kling-4k-i2v","background_tasks"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/task-detail-200-default-response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate AI video in 4K resolution from an image using Kling 4K Image-to-Video.\n\n**Features:**\n- **Image-to-video**: Use a reference image to guide 4K video generation\n- **End frame control**: Optionally specify an end frame image\n- **Motion brush**: Use static and dynamic masks for precise motion control\n\n**Duration:** 3-15 seconds\n**Resolution:** 4K output quality.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/kling-4k-i2v-request"}}}},"summary":"Kling 4K I2V - Generate video from image","operationId":"postAiVideoKling4kI2v"}},"/v1/music/{music-id}":{"get":{"tags":["Music"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MusicDetail"}}}},"404":{"$ref":"#/components/responses/404-not-found"},"500":{"$ref":"#/components/responses/500-internal-server-error"}},"parameters":[{"name":"music-id","schema":{"type":"integer"},"example":1,"in":"path","description":"Unique numeric identifier of the music item","required":true}],"description":"Retrieve full details for a music item including artist biography, genre and mood metadata, popularity score, and download statistics.","summary":"Get detailed music information by ID","operationId":"get_music_detail"}},"/v1/ai/lip-sync/veed-fabric-1-0-fast/{task-id}":{"get":{"tags":["lip-sync"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-veed-fabric-1-0-fast-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Retrieve a specific Veed Fabric 1.0 Fast lip-sync task by its ID, including generation status and result URL when completed.","summary":"Veed Fabric 1.0 Fast - Get task status","operationId":"get_veed_fabric_1_0_fast_task_status"}},"/v1/ai/image-to-video/kling-v2-5-pro/{task-id}":{"get":{"tags":["image-to-video"],"description":"Get the status of the kling-v2-5-pro task","summary":"Kling 2.5 Pro - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-flux-dev-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/ai/image-expand/flux-pro":{"get":{"summary":"Get the status of all image expand tasks","tags":["image-expand"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}},"post":{"tags":["image-expand"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Flux Pro - Expand image","description":"This endpoint allows you to expand an image using the AI Flux Pro model. The image will be expanded based on the provided parameters.\n\n### Input size\n\nThe image you send must be **at least 256 pixels on each side** and **no\nlarger than 20 megapixels** (`width * height <= 20,000,000`). Neither side\nis capped on its own and there is no aspect ratio restriction: a 30000x600\nimage is accepted, while a 255x70500 one is rejected because one of its\nsides is below 256, even though it is only 18 megapixels.\n\nFile size is irrelevant — what counts is the decoded pixel count, so a\nheavily compressed 60 megapixel photo is rejected just the same. An image\noutside these bounds is rejected with an error naming the rule it broke.\n\nSending more than 20 megapixels buys you nothing anyway: the output is\ncapped at roughly 1.6 megapixels regardless of how large the input was, so\nresize before uploading.\n\n### Output size\n\n`left`, `right`, `top` and `bottom` describe the expansion you are asking for,\nbut **this model does not guarantee that exact output size**. The requested\ncanvas is `input_width + left + right` by `input_height + top + bottom`, and\ntwo rules are then applied to it:\n\n1. **Maximum output size of roughly 1.6 megapixels.** If the requested canvas\n   is larger, the whole image is scaled down proportionally until it fits. The\n   aspect ratio is preserved, so there is no single maximum width or height:\n   the cap applies to the total pixel count. A 1200x400 image expanded by 400\n   pixels on each edge asks for a 2000x1200 canvas and comes back as 1632x976.\n2. **Each side is rounded to the nearest multiple of 16.** A requested\n   916x692 comes back as 912x688; a requested 936x712 comes back as 944x720.\n\nBoth rules apply on every request, including small ones, so an output that\nmatches your requested pixels exactly is the exception rather than the rule.\n\nOmitting an edge applies its default (512 left, 512 right, 256 top, 256\nbottom). Sending `0` leaves that edge unexpanded; sending `0` on all four\nedges returns a `400`, since there is nothing to expand.\n\nThat said, **this is the expand endpoint that stays closest to the pixel\nvalues you request**: below the 1.6 megapixel cap, the rounding to 16 is the\nonly deviation. Expanding an 896x672 image by 500 pixels on the top edge\nalone asks for 896x1172 and returns 896x1168. The other two expand endpoints\ndiverge much further:\n`ideogram` always renders at about 1 megapixel and only preserves the aspect\nratio, and `seedream-v4-5` scales any canvas below 3.7 megapixels up. If you\nneed exact output dimensions, resize the result yourself after generation.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/image-expand-request"}}}}}},"/v1/ai/image-to-video/wan-v2-6-1080p/{task-id}":{"get":{"tags":["image-to-video"],"description":"Get the status of a WAN 2.6 Image-to-Video 1080p task","summary":"WAN 2.6 I2V 1080p - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/ai/video/seedance-2-pro-720p":{"get":{"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Seedance 2.0 Pro 720p - List tasks","tags":["video"],"operationId":"get_all_seedance_2_pro_720p_tasks"},"post":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate 720p video using Seedance 2.0 Pro. Supports text-to-video and image-to-video with optional first and last frame images for transition videos. Also supports reference-to-video: attach up to 9 reference images via `reference_images` and mention them in the prompt with @Image1..@Image9.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/seedance-2-request"}}}},"summary":"Seedance 2.0 Pro 720p - Create video from text or image","operationId":"create_video_seedance_2_pro_720p"}},"/v1/ai/image-to-video/pixverse-v5-5/{task-id}":{"get":{"summary":"PixVerse V5.5 - Get task status","parameters":[{"in":"path","schema":{"type":"string","format":"uuid"},"required":true,"description":"ID of the task","name":"task-id"}],"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/ai/image-upscaler":{"get":{"summary":"Upscaler Creative - List tasks","description":"Get the status of all upscaling tasks","tags":["image-upscaler"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of all upscaling tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}},"post":{"tags":["image-upscaler"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The request has succeeded and the upscaling process has started. The result will be notified by a Webhook call","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Upscaler Creative - Upscale image","description":"This asynchronous endpoint enables image upscaling using advanced AI algorithms. Upon submission, it returns a unique `task_id` which can be used to track the progress of the upscaling process. For real-time production use, include the optional `webhook_url` parameter to receive an automated notification once the task has been completed. This allows for seamless integration and efficient task management without the need for continuous polling.\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/image-upscale-request-content"},"examples":{"all-params":{"$ref":"#/components/examples/request-image-upscale-all-params"},"required-params":{"$ref":"#/components/examples/request-image-upscale-required-params"}}}}}}},"/v1/ai/text-to-icon":{"post":{"tags":["Text to icon"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"Success - The request has succeeded and the Text to Icon process has started.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Create stunning icons in different styles and formats (png, svg) from text prompts using our advanced AI models.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/text-to-icon-request"},"examples":{"required-params":{"$ref":"#/components/examples/request-text-to-icon"},"all-params":{"$ref":"#/components/examples/request-text-to-icon-all"}}}}},"summary":"AI Icon generation","operationId":"generate_text_to_icon"}},"/v1/ai/video/kling-v3-std":{"post":{"tags":["video","kling-v3-std","background_tasks"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/task-detail-200-default-response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate AI video using Kling 3 Standard with text-to-video or image-to-video capabilities.\n\n**Features:**\n- **Text-to-video**: Generate videos from text prompts\n- **Image-to-video**: Use start and/or end frame images to guide generation\n- **Multi-shot**: Create videos with up to 6 shots (max 15s total)\n- **Element control**: Include reference images for consistent character/style\n\n**Duration:** 3-15 seconds\n**Quality:** Standard mode offers faster generation at slightly lower quality compared to Pro.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/kling-v3-request"}}}},"summary":"Kling 3 Standard - Generate video","operationId":"postAiVideoKlingV3Std"}},"/v1/ai/text-to-image/nano-banana-2-1/{task-id}":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Get the status of a specific Nano Banana 2.1 image generation task","summary":"Get the status of a Nano Banana 2.1 task","operationId":"get_nano_banana_2_1_task_status"}},"/v1/ai/text-to-video/wan-v2-6-720p/{task-id}":{"get":{"tags":["text-to-video"],"description":"Get the status of a WAN 2.6 Text-to-Video 720p task","summary":"WAN 2.6 T2V 720p - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/ai/image-upscaler-precision":{"get":{"tags":["upscaler-precision"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Upscaler Precision - List tasks","description":"Returns a list of all precision upscaler tasks. Each task includes its ID, current status, and output URL if completed.","operationId":"getAiImageUpscalerPrecisionTasks"},"post":{"tags":["upscaler-precision"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Upscales an image while adding new visual elements or details.\nThis endpoint may modify the original image content based on the prompt and inferred context.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/request-content_2"}}}},"summary":"Upscaler Precision - Upscale image","operationId":"postAiImageUpscalerPrecision"}},"/v1/ai/image-to-video/minimax-hailuo-2-3-1080p":{"get":{"summary":"MiniMax Hailuo 2.3 1080p - List tasks","description":"Get the list of MiniMax Hailuo 2.3 1080p tasks","tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The list of MiniMax Hailuo 2.3 1080p tasks is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}},"post":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_image_from_text_flux_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a video from text or image using the MiniMax Hailuo 2.3 1080p model.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_video_minimax_hailuo_23_1080p_request"}}}},"summary":"MiniMax Hailuo 2.3 1080p - Create video from text or image","operationId":"create_video_minimax_hailuo_23_1080p"}},"/v1/ai/text-to-video/wan-2-5-t2v-480p/{task-id}":{"get":{"tags":["text-to-video"],"description":"Get the status of a WAN 2.5 Text-to-Video 480p task","summary":"WAN 2.5 T2V 480p - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/ai/image-to-video/pixverse-v5-5-transition/{task-id}":{"get":{"summary":"PixVerse V5.5 Transition - Get task status","parameters":[{"in":"path","schema":{"type":"string","format":"uuid"},"required":true,"description":"ID of the task","name":"task-id"}],"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/ai/video/minimax-h3-max-r2v-768p/{task-id}":{"get":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"MiniMax H3 Max 768p reference-to-video - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"operationId":"get_minimax_h3_max_r2v_768p_task"}},"/v1/ai/image-expand/ideogram":{"get":{"summary":"Get the status of all image expand ideogram tasks","tags":["image-expand"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}},"post":{"tags":["image-expand"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Ideogram - Expand image","description":"This endpoint allows you to expand an image using the Ideogram AI model. The image will be expanded based on the provided pixel values for each side.\nIf no prompt is provided, the model will auto-generate one based on the image content.\n\n### Output size\n\n`left`, `right`, `top` and `bottom` define the **aspect ratio** of the result,\nnot its pixel dimensions. The canvas is built as\n`input_width + left + right` by `input_height + top + bottom`, and the model\nthen renders it at **approximately 1 megapixel**, picking the closest match\nfrom its own fixed list of supported resolutions (all multiples of 32). The\npixel values you send are therefore not preserved:\n\n| Requested canvas | Actual output |\n| --- | --- |\n| 896x1172 | 832x1088 |\n| 1396x672 | 1472x704 |\n| 896x896 | 1024x1024 |\n| 4992x4768 | 1024x960 |\n\nAs the last row shows, a very large expansion does not produce a larger image:\nit only changes the shape. If you need specific output dimensions, resize the\nresult yourself after generation.\n\n`left`, `right`, `top` and `bottom` are all required. At least one of them\nmust be greater than `0`, otherwise the request returns a `400`; the other\nthree may be `0`.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/image-expand-ideogram-request"}}}}}},"/v1/ai/image-change-camera/{task-id}":{"get":{"tags":["image-change-camera"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Retrieve the status and result of a specific Change Camera task by its task ID. When the task status is `completed`, the response includes the URL of the generated image with the new camera angle.","summary":"Change Camera - Get task status","operationId":"get_change_camera_task"}},"/v1/ai/image-to-video/runway-gen4-turbo":{"get":{"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"RunWay Gen4 Turbo - List tasks","tags":["image-to-video"],"operationId":"get_all_runway_gen4_turbo_tasks"},"post":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a video from an image using RunWay Gen4 Turbo model.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/runway-gen4-turbo-request"}}}},"summary":"RunWay Gen4 Turbo - Create video from image","operationId":"create_video_runway_gen4_turbo"}},"/v1/ai/image-to-video/minimax-hailuo-2-3-1080p-fast":{"get":{"summary":"MiniMax Hailuo 2.3 1080p Fast - List tasks","description":"Get the list of MiniMax Hailuo 2.3 1080p Fast tasks","tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The list of MiniMax Hailuo 2.3 1080p Fast tasks is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}},"post":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_image_from_text_flux_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a video from text or image using the MiniMax Hailuo 2.3 1080p model with fast prompt optimization.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_video_minimax_hailuo_23_1080p_fast_request"}}}},"summary":"MiniMax Hailuo 2.3 1080p Fast - Create video from text or image","operationId":"create_video_minimax_hailuo_23_1080p_fast"}},"/v1/ai/image-upscaler-precision-v2":{"get":{"tags":["upscaler-precision"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Upscaler Precision V2 - List tasks","description":"Returns a list of all precision upscaler V2 tasks. Each task includes its ID, current status, and output URL if completed.","operationId":"getAiImageUpscalerPrecisionV2Tasks"},"post":{"tags":["upscaler-precision"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Upscales an image while adding new visual elements or details (V2).\nThis endpoint may modify the original image content based on the prompt and inferred context.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/request-content_3"}}}},"summary":"Upscaler Precision V2 - Upscale image","operationId":"postAiImageUpscalerPrecisionV2"}},"/v1/ai/image-to-video/kling-o1/{task-id}":{"get":{"tags":["kling-o1"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-flux-dev-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Kling O1 - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"operationId":"getAiKlingO1Task"}},"/v1/ai/video/seedance-2-pro":{"get":{"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"}},"summary":"Seedance 2.0 Pro - List all tasks","tags":["video"],"operationId":"get_seedance_2_pro_tasks"}},"/v1/ai/image-to-video/pixverse-v6/{task-id}":{"get":{"summary":"PixVerse V6 - Get task status","parameters":[{"in":"path","schema":{"type":"string","format":"uuid"},"required":true,"description":"ID of the task","name":"task-id"}],"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/ai/image-to-video/minimax-live":{"get":{"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"MiniMax Video 01 Live - List tasks","tags":["image-to-video"],"operationId":"get_all_minimax_live_i2v_tasks"},"post":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a video from an image using MiniMax Video-01-Live model (Live Illustrations).\n\n**Features:**\n- Supports camera movements in square brackets: [Truck left], [Pan right], [Push in], [Pull out], [Zoom in], [Tracking shot], [Static shot]\n- Optional prompt optimization for better results\n- Works best with illustrations and artwork\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/minimax-live-i2v-request"}}}},"summary":"MiniMax Video 01 Live - Create video from image","operationId":"create_video_minimax_live_i2v"}},"/v1/ai/text-to-video/veo-3-1-lite/{task-id}":{"get":{"tags":["text-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Get Veo 3.1 Lite T2V task by ID","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"operationId":"get_veo_31_lite_t2v_task"}},"/v1/ai/beta/remove-background":{"post":{"tags":["remove-background"],"responses":{"200":{"description":"Successful background removal.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/remove_image_background_200_response"}}}}},"description":"This endpoint removes the background from an image provided via a URL. The URLs in the response are temporary and valid for **5 minutes** only.\n\n**Supported formats:** JPG, PNG\n\n**File size limit:** up to 20 MB\n\n**Output resolutions:** Preview (up to 0.25 megapixels), Full resolution (up to 25 megapixels)\n","requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/remove_image_background_request"}}}},"summary":"Remove the background of an image","operationId":"remove_image_background"}},"/v1/ai/video-upscaler-precision":{"get":{"tags":["video-upscaler-precision"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Video Upscaler Precision - List tasks","description":"Returns a list of all video upscaler precision tasks. Each task includes its ID, current status, and output URL if completed.","operationId":"getAiVideoUpscalerPrecisionTasks"},"post":{"tags":["video-upscaler-precision"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"headers":{"X-Frames-Billed":{"description":"Number of frames billed (B2B only). Minimum 12 frames, with 1.60x multiplier if fps_boost is enabled.","schema":{"type":"integer"}}},"description":"OK - Task created. The X-Frames-Billed header indicates the number of frames billed for B2B users.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Upscales a video with precision-grade quality enhancement.\nDesigned for frame-accurate upscaling with fine-grained control over sharpening, grain, and output strength.\nSupports output resolutions of 720p, 1k, 2k, or 4k with optional FPS boost.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/request-content_5"}}}},"summary":"Video Upscaler Precision - Upscale video","operationId":"postAiVideoUpscalerPrecision"}},"/v1/ai/image-to-video/veo-3-1-lite/{task-id}":{"get":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Get Veo 3.1 Lite I2V task by ID","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"operationId":"get_veo_31_lite_i2v_task"}},"/v1/ai/video/wan-3-0/{task-id}":{"get":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Get the status of a specific Wan 3.0 task","summary":"Get the status of one Wan 3.0 task","operationId":"get_wan_3_0_task_status"}},"/v1/ai/image-expand/seedream-v4-5":{"get":{"summary":"Get the status of all image expand seedream v4.5 tasks","tags":["image-expand"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}},"post":{"tags":["image-expand"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Seedream V4.5 - Expand image","description":"This endpoint allows you to expand an image using the Seedream V4.5 AI model. The image will be expanded based on the provided pixel values for each side.\nIf no prompt is provided, the model will auto-generate one based on the image content.\n\n### Output size\n\nThe requested canvas is `input_width + left + right` by\n`input_height + top + bottom`, and this model constrains it in two ways:\n\n1. **Each side is rounded up to the next multiple of 16.**\n2. **The canvas must contain between 3,686,400 and 16,777,216 pixels.** A\n   smaller canvas is scaled **up** to reach the lower bound, and a larger one\n   is scaled down to the upper bound. Since the lower bound is close to 3.7\n   megapixels, a small input with a small expansion is upscaled — a 896x672\n   image expanded by 100px on each edge asks for a 1096x872 canvas and comes\n   back at 2160x1728, close to twice the requested dimensions (measured).\n\nIf you need the output to stay close to the pixel values you requested, use\n`POST /v1/ai/image-expand/flux-pro`, which only deviates by the rounding to 16\nwhile the result stays under 1.6 megapixels. For exact dimensions, resize the\nresult yourself after generation.\n\n`left`, `right`, `top` and `bottom` are all required, and at least one of them\nmust be greater than `0`.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/image-expand-seedream-v4-5-request"}}}}}},"/v1/ai/text-to-image/flux-dev/{task-id}":{"get":{"tags":["text-to-image"],"description":"Get the status of the flux-dev task","summary":"Flux Dev - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-flux-dev-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/ai/image-to-video/pixverse-v6-transition/{task-id}":{"get":{"summary":"PixVerse V6 Transition - Get task status","parameters":[{"in":"path","schema":{"type":"string","format":"uuid"},"required":true,"description":"ID of the task","name":"task-id"}],"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/ai/text-to-video/wan-2-5-t2v-1080p/{task-id}":{"get":{"tags":["text-to-video"],"description":"Get the status of a WAN 2.5 Text-to-Video 1080p task","summary":"WAN 2.5 T2V 1080p - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/ai/text-to-image/flux-pro-v1-1/{task-id}":{"get":{"tags":["text-to-image"],"description":"Get the status of the flux-pro 1.1 task","summary":"Flux Pro 1.1 - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/ai/image-to-video/kling-v2-6/{task-id}":{"get":{"tags":["image-to-video","kling-v2-6"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Kling 2.6 Pro - Get task status","parameters":[{"in":"path","schema":{"type":"string","format":"uuid"},"required":true,"description":"ID of the task","name":"task-id"}],"operationId":"getAiImageToVideoKlingV26Task"}},"/v1/ai/video/minimax-h3-max-480p/{task-id}":{"get":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"MiniMax H3 Max 480p - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"operationId":"get_minimax_h3_max_480p_task"}},"/v1/ai/improve-prompt":{"get":{"tags":["improve-prompt"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of all improve-prompt tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Improve Prompt - List tasks","description":"Get the status of all improve-prompt tasks","operationId":"get_all_improve_prompt_tasks"},"post":{"tags":["improve-prompt"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Enhance user prompts for AI image or video generation using advanced AI models.\n- **Image prompts**: Improve a prompt for image generation\n- **Video prompts**: Improve a prompt for video generation\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/request_12"},"examples":{"video-prompt":{"$ref":"#/components/examples/request-improve-prompt-video"},"image-prompt":{"$ref":"#/components/examples/request-improve-prompt-image"},"all-params":{"$ref":"#/components/examples/request-improve-prompt-all-params"}}}}},"summary":"Improve Prompt - Enhance prompt","operationId":"create_improve_prompt_task"}},"/v1/ai/video/minimax-h3-2k":{"get":{"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"MiniMax H3 2K - List tasks","tags":["video"],"operationId":"get_all_minimax_h3_2k_tasks"},"post":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate 2K video with MiniMax H3. Supports text-to-video, image-to-video with an optional first and last frame, and subject reference images (up to 9, mentioned in the prompt as @Image1..@Image9). Keyframes and reference images are mutually exclusive. The response is a task: poll the GET endpoint or supply `webhook_url` to be notified; the finished task carries a time-limited MP4 URL. Reference videos are billed on top of the output duration, capped at 15 seconds.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/minimax-h3-request"}}}},"summary":"MiniMax H3 2K - Create video","operationId":"create_video_minimax_h3_2k"}},"/v1/ai/text-to-image/ideogram-4-5/{task-id}":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Get the status of a specific Ideogram 4.5 image generation task","summary":"Get the status of a Ideogram 4.5 task","operationId":"get_ideogram_4_5_task_status"}},"/v1/ai/text-to-video/wan-2-5-t2v-720p":{"get":{"summary":"WAN 2.5 T2V 720p - List tasks","description":"Get the list of WAN 2.5 Text-to-Video 720p tasks","tags":["text-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The list of tasks is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}},"post":{"tags":["text-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_image_from_text_flux_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a 720p video from text prompt using the WAN 2.5 model.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/t2v-wan-25-720p-request-content"}}}},"summary":"WAN 2.5 720p - Create video from text","operationId":"create_video_wan_25_t2v_720p"}},"/v1/ai/text-to-video/pixverse-v5/{task-id}":{"get":{"summary":"PixVerse V5 Text-to-Video - Get task status","parameters":[{"in":"path","schema":{"type":"string","format":"uuid"},"required":true,"description":"ID of the task","name":"task-id"}],"tags":["text-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/ai/video/minimax-h3-max-r2v-480p/{task-id}":{"get":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"MiniMax H3 Max 480p reference-to-video - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"operationId":"get_minimax_h3_max_r2v_480p_task"}},"/v1/ai/video/minimax-h3-max-r2v-768p":{"get":{"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"MiniMax H3 Max 768p reference-to-video - List tasks","tags":["video"],"operationId":"get_all_minimax_h3_max_r2v_768p_tasks"},"post":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate 768p video with MiniMax H3 Max, guided by reference images, videos and audios. Mention them in the prompt as @Image1, @Video1, @Audio1 and so on. At least one reference image or reference video is required, and all references together must not exceed 12 files.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/minimax-h3-max-r2v-request"}}}},"summary":"MiniMax H3 Max 768p reference-to-video - Create video","operationId":"create_video_minimax_h3_max_r2v_768p"}},"/v1/ai/image-to-video/minimax-hailuo-2-3-768p":{"get":{"summary":"MiniMax Hailuo 2.3 768p - List tasks","description":"Get the list of MiniMax Hailuo 2.3 768p tasks","tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The list of MiniMax Hailuo 2.3 768p tasks is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}},"post":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_image_from_text_flux_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a video from text or image using the MiniMax Hailuo 2.3 768p model.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_video_minimax_hailuo_23_768p_request"}}}},"summary":"MiniMax Hailuo 2.3 768p - Create video from text or image","operationId":"create_video_minimax_hailuo_23_768p"}},"/v1/ai/text-to-image/gpt-image-2-5":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of all GPT Image 2.5 tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Get the status of all GPT Image 2.5 tasks","description":"Get the status of all GPT Image 2.5 image generation tasks","operationId":"get_all_gpt_image_2_5_tasks"},"post":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The request has succeeded and the GPT Image 2.5 process has started.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate images from a text prompt using OpenAI's GPT Image 2.5 model.\n\n**Key Features:**\n- Strong instruction following on long, detailed prompts\n- Reliable text rendering inside the image\n- Explicit resolution tier, aspect ratio, format and compression control\n- Selectable quality tier (`low` / `medium` / `high`)\n\n**Best for:**\n- Marketing and editorial images that must contain legible text\n- Prompts with many precise constraints\n- Cases where transparency or an exact output format is required\n\n**Output:** one image per `num_images` (up to 10), at the size selected\nby `resolution` + `aspect_ratio`, delivered as CDN URLs in the task's\n`generated` array.\n\n**Credits:** the `quality` tier sets the price per image and\n`resolution` multiplies it (`1k` x1, `2k` x2, `4k` x3). Every image in\n`num_images` is billed.\n\nThe request is processed asynchronously: the endpoint returns a task id\nimmediately. Retrieve the result by polling the task endpoint or by\nproviding an optional `webhook_url`.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ttigi25-request-content"},"examples":{"required-params":{"$ref":"#/components/examples/request-gpt-image-2-5-required-params"},"all-params":{"$ref":"#/components/examples/request-gpt-image-2-5-all-params"}}}}},"summary":"Create image from text - GPT Image 2","operationId":"create_image_from_text_gpt_image_2_5"}},"/v1/ai/text-to-image/recraft-v4":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of all Recraft V4 tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Get the status of all Recraft V4 tasks","description":"Get the status of all Recraft V4 image generation tasks","operationId":"get_all_recraft_v4_tasks"},"post":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The request has succeeded and the Recraft V4 process has started.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate an image from a text prompt using Recraft V4.\n\n**Key Features:**\n- Best-in-class rendering of legible text inside the image\n- Design-oriented output: posters, signage, packaging, editorial layouts\n- Eleven fixed aspect ratios, from 768x1344 to 1536x768\n\n**Best for:**\n- Designs whose wording must be readable and correctly spelled\n- Brand and marketing assets with typographic weight\n\n**Output:** one image per request, delivered as a URL in the task's\n`generated` array. Exact sizes are listed under `aspect_ratio`.\n\n**Credits:** a flat price per image. Recraft V4 Pro renders the same\nsizes at twice the linear dimensions for a higher price.\n\nThe request is processed asynchronously: the endpoint returns a task id\nimmediately. Retrieve the result by polling the task endpoint or by\nproviding an optional `webhook_url`.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ttirecraft-v4-request-content"},"examples":{"required-params":{"$ref":"#/components/examples/request-recraft-v4-required-params"},"all-params":{"$ref":"#/components/examples/request-recraft-v4-all-params"}}}}},"summary":"Create image from text - Recraft V4","operationId":"create_image_from_text_recraft_v4"}},"/v1/ai/text-to-image/flux-kontext-pro/{task-id}":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Retrieve the status and results of a specific Flux Kontext Pro text-to-image generation task.","summary":"Flux Kontext Pro - Get task status","operationId":"get_flux_kontext_pro_task"}},"/v1/videos/{id}":{"get":{"summary":"Get detailed video information by ID","parameters":[{"name":"id","schema":{"minimum":1,"type":"integer"},"example":30955,"in":"path","description":"Video id","required":true},{"name":"Accept-Language","schema":{"type":"string"},"example":"en-US","in":"header","description":"Specifies the search query language using the ISO 639-1 (2-letter\nlanguage code) and the ISO 3166-1 (2-letter country code) for language variants.\nThe API will use \"en-US\" as a default language for processing if a code is not\nprovided, or does not exist.\n","required":false}],"tags":["Videos"],"responses":{"400":{"$ref":"#/components/responses/400-bad-request"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/_v1_videos__id__get_200_response"},"examples":{"detail":{"$ref":"#/components/examples/200-b2b-get-video-detail"}}}}},"404":{"$ref":"#/components/responses/404-not-found"},"500":{"$ref":"#/components/responses/500-internal-server-error"}}}},"/v1/ai/image-to-video/wan-v2-2-720p":{"get":{"summary":"WAN 2.2 720p - List tasks","description":"Get the list of WAN 2.2 720p tasks","tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The list of WAN 2.2 720p tasks is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}},"post":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_image_from_text_flux_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a video from image using the WAN 2.2 720p model.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/itvwan-v22-720p-request-content"}}}},"summary":"WAN 2.2 720p - Create video from image","operationId":"create_video_wan_v22_720p"}},"/v1/ai/text-to-video/pixverse-v5-5/{task-id}":{"get":{"summary":"PixVerse V5.5 Text-to-Video - Get task status","parameters":[{"in":"path","schema":{"type":"string","format":"uuid"},"required":true,"description":"ID of the task","name":"task-id"}],"tags":["text-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/ai/image-to-video/minimax-hailuo-2-3-768p-fast":{"get":{"summary":"MiniMax Hailuo 2.3 768p Fast - List tasks","description":"Get the list of MiniMax Hailuo 2.3 768p Fast tasks","tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The list of MiniMax Hailuo 2.3 768p Fast tasks is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}},"post":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_image_from_text_flux_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a video from text or image using the MiniMax Hailuo 2.3 768p model with fast prompt optimization.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_video_minimax_hailuo_23_768p_fast_request"}}}},"summary":"MiniMax Hailuo 2.3 768p Fast - Create video from text or image","operationId":"create_video_minimax_hailuo_23_768p_fast"}},"/v1/ai/text-to-image/recraft-v4-1":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of all Recraft V4.1 tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Get the status of all Recraft V4.1 tasks","description":"Get the status of all Recraft V4.1 image generation tasks","operationId":"get_all_recraft_v4_1_tasks"},"post":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The request has succeeded and the Recraft V4.1 process has started.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate an image from a text prompt using Recraft V4.1, the latest\nRecraft generation.\n\n**Key Features:**\n- Improved text rendering and design over V4\n- `tier` selects price and output size: `mid` matches V4, `pro` matches V4 Pro\n- `variant` selects how literally the model follows the prompt:\n  `standard` applies its own art direction, `utility` renders neutrally\n\n**Best for:**\n- `standard`: finished design pieces\n- `utility`: diagrams, wireframes, UI mockups and any asset that must\n  follow the prompt exactly\n\n**Output:** one image per request, delivered as a URL in the task's\n`generated` array. Exact sizes are listed under `aspect_ratio`.\n\n**Credits:** `tier: mid` is billed as Recraft V4 and `tier: pro` as\nRecraft V4 Pro. `variant` does not affect the price.\n\nThe request is processed asynchronously: the endpoint returns a task id\nimmediately. Retrieve the result by polling the task endpoint or by\nproviding an optional `webhook_url`.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ttirecraft-v41-request-content"},"examples":{"required-params":{"$ref":"#/components/examples/request-recraft-v4-1-required-params"},"all-params":{"$ref":"#/components/examples/request-recraft-v4-1-all-params"}}}}},"summary":"Create image from text - Recraft V4.1","operationId":"create_image_from_text_recraft_v4_1"}},"/v1/ai/video/seedance-2-fast":{"get":{"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"}},"summary":"Seedance 2.0 Fast - List all tasks","tags":["video"],"operationId":"get_seedance_2_fast_tasks"}},"/v1/ai/image-to-video/kling-elements-pro":{"get":{"summary":"Kling Elements Pro - List tasks","description":"Get the list of the kling-elements-pro tasks","tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The list of the kling-elements-pro tasks is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}},"post":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of the kling-elements-pro task","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_image_from_text_flux_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a video from an image using the Kling Elements Pro model.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/itvke-request-content"},"examples":{"required-params":{"$ref":"#/components/examples/request-itv-kling-elements-pro-required-params"},"all-params":{"$ref":"#/components/examples/request-itv-kling-elements-pro-all-params"}}}}},"summary":"Kling Elements Pro - Create video from image","operationId":"create_video_from_image_kling_elements_pro"}},"/v1/cloned-voices/{voice_id}":{"delete":{"tags":["cloned-voices"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"404":{"$ref":"#/components/responses/404-not-found"},"200":{"description":"Cloned voice deleted","content":{"application/json":{"example":{"success":true},"schema":{"$ref":"#/components/schemas/delete_cloned_voice_200_response"}}}},"403":{"$ref":"#/components/responses/403-forbidden"},"500":{"$ref":"#/components/responses/500-internal-server-error"}},"parameters":[{"in":"path","schema":{"example":"pNInz6obpgDQGcFmaJgB","type":"string"},"required":true,"description":"Provider voice id (the `eleven_labs_voice` from the list endpoint)","name":"voice_id"}],"description":"Delete a cloned voice belonging to the authenticated user. The voice is\nremoved at the provider (ElevenLabs) first and then soft-deleted.\n\n`{voice_id}` is the **provider voice id** — the `eleven_labs_voice` value\nreturned by `GET /v1/cloned-voices`, not the internal numeric `id`. A voice\nthat does not exist or does not belong to the caller returns `404`.\n\n**Enterprise only** — this endpoint is available exclusively for Enterprise API key plans.\n","summary":"Cloned Voices - Delete a cloned voice","operationId":"delete_cloned_voice"}},"/v1/ai/text-to-video/ltx-2-fast/{task-id}":{"get":{"tags":["text-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"LTX Video 2.0 Fast T2V - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"operationId":"get_ltx_2_fast_t2v_task"}},"/v1/ai/music-generation/google-lyria/{task-id}":{"get":{"tags":["music-generation"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/task-detail-200-default-response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string","format":"uuid"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Get the status of one Google Lyria music generation task","summary":"Google Lyria - Get task status","operationId":"get_google_lyria_task_status"}},"/v1/ai/text-to-image/gpt-image-2-edit":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of all GPT Image 2 Edit tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Get the status of all GPT Image 2 Edit tasks","description":"Get the status of all GPT Image 2 image editing tasks","operationId":"get_all_gpt_image_2_edit_tasks"},"post":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The request has succeeded and the GPT Image 2 Edit process has started.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Edit or recompose one or more input images from a text prompt using\nOpenAI's GPT Image 2 model.\n\n**Key Features:**\n- Accepts 1-16 input images, used together as the visual context\n- Restyle a single image, or compose a new one from several\n- Same output controls as text-to-image (resolution, aspect ratio, format, compression, quality)\n\n**Best for:**\n- Product and scene variations from an existing shot\n- Combining a subject, a background and a style reference in one call\n- Adding or correcting text on an existing image\n\n**Output:** one edited image per `num_images` (up to 10), delivered as\nCDN URLs in the task's `generated` array. The input images are never\nmodified.\n\n**Credits:** editing sends your images to the model and their input\ntokens dominate the cost, so it is priced differently from generation:\nflat units per output image by `quality` (`low` x1, `medium` x4,\n`high` x6), with `resolution` not affecting the price.\n\nThe request is processed asynchronously: the endpoint returns a task id\nimmediately. Retrieve the result by polling the task endpoint or by\nproviding an optional `webhook_url`.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ttigi2-edit-request-content"},"examples":{"required-params":{"$ref":"#/components/examples/request-gpt-image-2-edit-required-params"},"all-params":{"$ref":"#/components/examples/request-gpt-image-2-edit-all-params"}}}}},"summary":"Edit images from text - GPT Image 2","operationId":"edit_image_from_text_gpt_image_2"}},"/v1/ai/text-to-video/pixverse-v6/{task-id}":{"get":{"summary":"PixVerse V6 Text-to-Video - Get task status","parameters":[{"in":"path","schema":{"type":"string","format":"uuid"},"required":true,"description":"ID of the task","name":"task-id"}],"tags":["text-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/ai/text-to-video/wan-v2-6-1080p":{"get":{"summary":"WAN 2.6 T2V 1080p - List tasks","description":"Get the list of WAN 2.6 Text-to-Video 1080p tasks","tags":["text-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The list of tasks is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}},"post":{"tags":["text-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_image_from_text_flux_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a 1080p video from text prompt using the WAN 2.6 model.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/t2v-wan-v26-1080p-request-content"}}}},"summary":"WAN 2.6 1080p - Create video from text","operationId":"create_video_wan_v26_t2v_1080p"}},"/v1/ai/image-to-video/wan-v2-2-580p":{"get":{"summary":"WAN 2.2 580p - List tasks","description":"Get the list of WAN 2.2 580p tasks","tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The list of WAN 2.2 580p tasks is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}},"post":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_image_from_text_flux_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate a video from image using the WAN 2.2 580p model.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/itvwan-v22-580p-request-content"}}}},"summary":"WAN 2.2 580p - Create video from image","operationId":"create_video_wan_v22_580p"}},"/v1/ai/video/seedance-2-mini-480p":{"get":{"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Seedance 2.0 Mini 480p - List tasks","tags":["video"],"operationId":"get_all_seedance_2_mini_480p_tasks"},"post":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate 480p video using Seedance 2.0 Mini, the most affordable and fastest variant of the Seedance 2.0 family. Available in 480p and 720p with durations from 4 to 15 seconds. Supports text-to-video and image-to-video with optional first and last frame images. Also supports reference-to-video: attach up to 9 reference images via `reference_images` and mention them in the prompt with @Image1..@Image9.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/seedance-2-mini-request"}}}},"summary":"Seedance 2.0 Mini 480p - Create video from text or image","operationId":"create_video_seedance_2_mini_480p"}},"/v1/ai/sound-effects/{task-id}":{"get":{"tags":["sound-effects"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string","format":"uuid"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Get the status of one sound-effects task","summary":"Sound Effects - Get task status","operationId":"get_sound_effects_task_status"}},"/v1/ai/text-to-image/flux-kontext-max/{task-id}":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Retrieve the status and results of a specific Flux Kontext Max generation task.","summary":"Flux Kontext Max - Get task status","operationId":"get_flux_kontext_max_task"}},"/v1/ai/video-edit/happy-horse-1/{task-id}":{"get":{"tags":["video-edit"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Retrieve the status and result of a specific Happy Horse 1.0 video edit task by its ID.","summary":"Happy Horse 1.0 Video Edit - Get task status","operationId":"get_happy_horse_1_video_edit_task"}},"/v1/ai/image-to-video/veo-3-1-fast/{task-id}":{"get":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Get Veo 3.1 I2V Fast task by ID","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"operationId":"get_veo_31_i2v_fast_task"}},"/v1/ai/image-to-video/wan-2-5-i2v-480p/{task-id}":{"get":{"tags":["image-to-video"],"description":"Get the status of a WAN 2.5 Image-to-Video 480p task","summary":"WAN 2.5 I2V 480p - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - completed task":{"$ref":"#/components/examples/200-task-completed"},"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}}}},"/v1/sound-effects/{sfx-id}":{"get":{"tags":["Sound Effects"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SfxDetail"}}}},"404":{"$ref":"#/components/responses/404-not-found"},"500":{"$ref":"#/components/responses/500-internal-server-error"}},"parameters":[{"name":"sfx-id","schema":{"type":"integer"},"example":1,"in":"path","description":"Unique numeric identifier of the sound effect","required":true}],"description":"Retrieve full details for a sound effect including category hierarchy, tags, duration, popularity, and download statistics.","summary":"Get detailed sound effect information by ID","operationId":"get_sound_effect_detail"}},"/v1/ai/image-to-video/runway-gen4-turbo/{task-id}":{"get":{"tags":["image-to-video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"RunWay Gen4 Turbo - Get task status","parameters":[{"in":"path","schema":{"type":"string"},"required":true,"description":"ID of the task","name":"task-id"}],"operationId":"get_runway_gen4_turbo_task"}},"/v1/ai/image-to-prompt/{task-id}":{"get":{"tags":["image-to-prompt"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The task exists and the status is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_image_to_prompt_task_status_200_response"}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"parameters":[{"in":"path","schema":{"type":"string","format":"uuid"},"required":true,"description":"ID of the task","name":"task-id"}],"description":"Get the status of one image-to-prompt task","summary":"Image to Prompt - Get task status","operationId":"get_image_to_prompt_task_status"}},"/v1/ai/flows/{flow-id}":{"get":{"tags":["flows"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"404":{"description":"Flow not found."},"200":{"$ref":"#/components/responses/detail-200-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"}},"parameters":[{"in":"path","schema":{"example":"uqzQLDr2Aw","type":"string"},"required":true,"description":"Short unique identifier (sqid) of the flow. Discover flow identifiers via GET /v1/ai/flows.","name":"flow-id"}],"description":"Returns the full definition of a flow, including its dynamic inputs and cost.\n\n**Inputs** define what values the caller must provide when running the flow:\n- `creation` type: accepts an image/media URL, base64-encoded data, or an existing creation identifier\n- `text` type: accepts a plain text string (prompt, label, etc.)\n- `number` type: accepts a numeric value\n- `select` type: accepts a value from predefined options\n\nUse each input's `api_key` field (recommended, human-friendly node name) as the identifier when calling the run endpoint.\nThe UUID-based `id` field is still accepted for backward compatibility.\nThe `tool_metadata.total_cost` field indicates the credit cost per execution.\n","summary":"Flows - Get flow definition","operationId":"get_flow"}},"/v1/ai/text-to-image/gpt-image-2":{"get":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - Get the status of all GPT Image 2 tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_all_style_transfer_tasks_200_response"},"examples":{"success - return all tasks":{"$ref":"#/components/examples/200-tasks-list"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"Get the status of all GPT Image 2 tasks","description":"Get the status of all GPT Image 2 image generation tasks","operationId":"get_all_gpt_image_2_tasks"},"post":{"tags":["text-to-image"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"description":"OK - The request has succeeded and the GPT Image 2 process has started.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/get_style_transfer_task_status_200_response"},"examples":{"success - in progress task":{"$ref":"#/components/examples/200-task-in-progress"}}}}},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate images from a text prompt using OpenAI's GPT Image 2 model.\n\n**Key Features:**\n- Strong instruction following on long, detailed prompts\n- Reliable text rendering inside the image\n- Explicit resolution tier, aspect ratio, format and compression control\n- Selectable quality tier (`low` / `medium` / `high`)\n\n**Best for:**\n- Marketing and editorial images that must contain legible text\n- Prompts with many precise constraints\n- Cases where transparency or an exact output format is required\n\n**Output:** one image per `num_images` (up to 10), at the size selected\nby `resolution` + `aspect_ratio`, delivered as CDN URLs in the task's\n`generated` array.\n\n**Credits:** the `quality` tier sets the price per image and\n`resolution` multiplies it (`1k` x1, `2k` x2, `4k` x3). Every image in\n`num_images` is billed.\n\nThe request is processed asynchronously: the endpoint returns a task id\nimmediately. Retrieve the result by polling the task endpoint or by\nproviding an optional `webhook_url`.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ttigi2-request-content"},"examples":{"required-params":{"$ref":"#/components/examples/request-gpt-image-2-required-params"},"all-params":{"$ref":"#/components/examples/request-gpt-image-2-all-params"}}}}},"summary":"Create image from text - GPT Image 2","operationId":"create_image_from_text_gpt_image_2"}},"/v1/ai/flows/runs/{run-id}":{"get":{"tags":["flows"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"404":{"$ref":"#/components/responses/404-not-found"},"200":{"$ref":"#/components/responses/run-detail-200-response"},"403":{"$ref":"#/components/responses/403-forbidden"},"500":{"$ref":"#/components/responses/500-internal-server-error"}},"parameters":[{"in":"path","schema":{"example":"omps2OH829","type":"string"},"required":true,"description":"Unique identifier (SQID) of the flow run. This is the\n`workflow_run_identifier` value returned by the `POST /v1/ai/flows/{flow-id}/run` endpoint.\n","name":"run-id"}],"description":"Retrieve the current status and results of a flow execution run.\n\nUse this endpoint to **poll** the status of a run after calling the\n`POST /v1/ai/flows/{flow-id}/run` endpoint. The `run_id` path parameter\ncorresponds to the `workflow_run_identifier` returned in the run response.\n\n**Polling strategy:**\n- Wait 2-3 seconds after starting the run before the first poll\n- Poll every 3-5 seconds\n- When `status` is `completed`, the `result` field contains download URLs\n- When `status` is `failed`, the `error_message` field describes the failure\n\n**Asset URLs** in the `result` field are temporary and valid for **12 hours**.\n\n**Statuses:**\n| Status | Description |\n|--------|-------------|\n| `pending` | Run is queued but has not started yet |\n| `running` | Flow is executing |\n| `completed` | Finished successfully, `result` is available |\n| `completed_with_errors` | Execution finished but some nodes failed |\n| `failed` | Execution failed, see `error_message` |\n| `cancelled` | Execution was cancelled |\n","summary":"Flows - Get run status","operationId":"get_flow_run"}},"/v1/ai/video/minimax-h3-768p":{"get":{"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-list-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"summary":"MiniMax H3 768p - List tasks","tags":["video"],"operationId":"get_all_minimax_h3_768p_tasks"},"post":{"tags":["video"],"responses":{"401":{"$ref":"#/components/responses/401-unauthorized"},"503":{"$ref":"#/components/responses/503-service-unavailable"},"200":{"$ref":"#/components/responses/task-detail-200-default-response"},"500":{"$ref":"#/components/responses/500-internal-server-error"},"400":{"$ref":"#/components/responses/400-bad-request"}},"description":"Generate 768p video with MiniMax H3. Supports text-to-video, image-to-video with an optional first and last frame, and subject reference images (up to 9, mentioned in the prompt as @Image1..@Image9). Keyframes and reference images are mutually exclusive. The response is a task: poll the GET endpoint or supply `webhook_url` to be notified; the finished task carries a time-limited MP4 URL. Reference videos are billed on top of the output duration, capped at 15 seconds.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/minimax-h3-request"}}}},"summary":"MiniMax H3 768p - Create video","operationId":"create_video_minimax_h3_768p"}}},"security":[{"magnificApiKey":[]}],"servers":[{"description":"B2B API Production V1","url":"https://api.magnific.com"}],"openapi":"3.0.0"}