# Audio Isolation - List tasks
Source: https://docs.freepik.com/api-reference/audio-isolation/audio-isolation-tasks

get /v1/ai/audio-isolation
Get the status of all audio isolation tasks



# Audio Isolation - Extract sounds from audio/video
Source: https://docs.freepik.com/api-reference/audio-isolation/isolate

post /v1/ai/audio-isolation
Isolate and extract specific sounds from audio or video files using SAM Audio AI technology.
Describe the sound you want to isolate, and the API separates it from background noise.

**Use cases:**
- Extract speech from noisy recordings
- Isolate musical instruments from a mix
- Separate specific sound effects from video audio
- Remove background noise while preserving target sounds

**Input options:**
- Provide either an `audio` URL/base64 or a `video` URL/base64 (mutually exclusive)
- Supported audio formats: WAV, MP3, FLAC, OGG, M4A
- Supported video formats: MP4, MOV, WEBM, AVI
- For video input, use bounding box coordinates (x1, y1, x2, y2) to focus on a specific region

**Output:** WAV audio file containing the isolated sound




# SAM Audio - Audio Isolation API | Freepik API
Source: https://docs.freepik.com/api-reference/audio-isolation/overview

Isolate specific sounds from audio or video with SAM Audio. Extract vocals, speech, instruments, or sound effects using text descriptions. WAV output for production workflows.

<Card title="SAM Audio integration" icon="waveform-lines">
  Powered by SAM Audio technology, this API isolates specific sounds from audio or video files using natural language descriptions.
</Card>

SAM Audio is an AI-powered audio isolation API that extracts specific sounds from audio or video files based on text descriptions. Describe what you want to isolate - vocals, speech, instruments, or sound effects - and receive a clean WAV file containing only that sound. The API supports both audio files (WAV, MP3, FLAC, OGG, M4A) and video files (MP4, MOV, WEBM, AVI) as input.

### Key capabilities

* **Text-guided isolation**: Describe any sound to extract (e.g., "A person speaking", "Piano playing", "Dog barking")
* **Multi-format input**: Accepts audio (WAV, MP3, FLAC, OGG, M4A) or video (MP4, MOV, WEBM, AVI) files
* **Video localization**: Optional bounding box (`x1`, `y1`, `x2`, `y2`) to focus on specific areas in video
* **Quality tuning**: Adjust `reranking_candidates` (1-8) to balance quality vs. latency
* **Event detection**: Enable `predict_spans` for better isolation of non-ambient sounds
* **WAV output**: High-quality WAV audio file with the isolated sound
* **Async processing**: Webhook notifications or polling for task completion

### Use cases

* **Music production**: Extract vocals from songs for remixes or karaoke tracks
* **Podcast editing**: Isolate speech from background noise or music
* **Film post-production**: Separate dialogue from ambient sounds for audio mixing
* **Sound design**: Extract specific sound effects from video recordings
* **Transcription services**: Clean up audio by isolating speech before transcription
* **Instrument isolation**: Separate specific instruments from full band recordings

### Isolate audio with SAM Audio

Submit an audio or video file with a text description of the sound to isolate. The service returns a task ID for async polling or webhook notification.

<div>
  <Columns>
    <Card title="POST /v1/ai/audio-isolation" icon="waveform-lines" href="/api-reference/audio-isolation/isolate">
      Create a new audio isolation task
    </Card>

    <Card title="GET /v1/ai/audio-isolation" icon="list" href="/api-reference/audio-isolation/audio-isolation-tasks">
      List all audio isolation tasks
    </Card>

    <Card title="GET /v1/ai/audio-isolation/{task-id}" icon="magnifying-glass" href="/api-reference/audio-isolation/task-by-id">
      Get task status and results by ID
    </Card>
  </Columns>
</div>

### Parameters

| Parameter              | Type      | Required | Default | Description                                                                           |
| ---------------------- | --------- | -------- | ------- | ------------------------------------------------------------------------------------- |
| `description`          | `string`  | Yes      | -       | Text description of the sound to isolate (e.g., "A person speaking", "Piano playing") |
| `audio`                | `string`  | No\*     | -       | URL or base64-encoded audio file (WAV, MP3, FLAC, OGG, M4A)                           |
| `video`                | `string`  | No\*     | -       | URL or base64-encoded video file (MP4, MOV, WEBM, AVI)                                |
| `x1`                   | `integer` | No       | `0`     | Bounding box left coordinate for video localization (0 = full frame)                  |
| `y1`                   | `integer` | No       | `0`     | Bounding box top coordinate for video localization (0 = full frame)                   |
| `x2`                   | `integer` | No       | `0`     | Bounding box right coordinate for video localization (0 = full frame)                 |
| `y2`                   | `integer` | No       | `0`     | Bounding box bottom coordinate for video localization (0 = full frame)                |
| `sample_fps`           | `integer` | No       | `2`     | Frame sampling rate for video (1-5 FPS)                                               |
| `reranking_candidates` | `integer` | No       | `1`     | Quality vs. latency trade-off (1-8, higher = better quality, slower)                  |
| `predict_spans`        | `boolean` | No       | `false` | Enable for better isolation of non-ambient, event-based sounds                        |
| `webhook_url`          | `string`  | No       | -       | URL for task completion notification                                                  |

\*Either `audio` or `video` must be provided, but not both.

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is SAM Audio and how does it work?">
    SAM Audio is an AI-powered audio isolation API that uses text descriptions to identify and extract specific sounds from audio or video files. You submit a file with a description of the target sound (e.g., "A person speaking"), receive a task ID immediately, then poll for results or receive a webhook notification. The output is a WAV file containing only the isolated sound.
  </Accordion>

  <Accordion title="What audio and video formats does SAM Audio support?">
    For audio input: WAV, MP3, FLAC, OGG, and M4A formats. For video input: MP4, MOV, WEBM, and AVI formats. Files can be provided as URLs or base64-encoded strings.
  </Accordion>

  <Accordion title="How do I write effective sound descriptions?">
    Be specific and descriptive. Good examples: "A person speaking", "Piano playing in the background", "Dog barking loudly", "Acoustic guitar strumming". Avoid vague descriptions like "music" or "noise" - instead specify what type of music or sound you want to isolate.
  </Accordion>

  <Accordion title="What is the reranking_candidates parameter for?">
    The `reranking_candidates` parameter (1-8) controls the quality vs. speed trade-off. Higher values produce better isolation quality but take longer to process. Use `1` for fastest results, `8` for highest quality. Default is `1`.
  </Accordion>

  <Accordion title="When should I enable predict_spans?">
    Enable `predict_spans` when isolating non-ambient, event-based sounds like speech, individual notes, or sound effects. Keep it disabled (default) for continuous ambient sounds like background music or environmental noise.
  </Accordion>

  <Accordion title="How does video localization work with bounding boxes?">
    For video input, you can specify a bounding box (`x1`, `y1`, `x2`, `y2`) to focus on sounds originating from a specific area of the frame. This is useful when you want to isolate audio from a particular person or object in the video. Set all values to `0` (default) to process the full frame.
  </Accordion>

  <Accordion title="What is the output format?">
    SAM Audio outputs a high-quality WAV audio file containing only the isolated sound. This uncompressed format is ideal for further editing or processing in audio production workflows.
  </Accordion>
</AccordionGroup>

## Best practices

* **Description specificity**: Use detailed descriptions for better isolation accuracy
* **Input quality**: Higher quality input audio/video produces better isolation results
* **Quality tuning**: Start with `reranking_candidates=1` for testing, increase for production
* **Event sounds**: Enable `predict_spans` for speech, music notes, or sound effects
* **Video focus**: Use bounding boxes to isolate sounds from specific video regions
* **Production integration**: Use webhooks instead of polling for scalable applications
* **Error handling**: Implement retry logic with exponential backoff for 503 errors

## Related APIs

* **[Sound Effects](/api-reference/sound-effects/post-sound-effects)**: Generate sound effects from text descriptions
* **[Lip Sync](/api-reference/lip-sync/latent-sync/overview)**: Synchronize lip movements with audio
* **[OmniHuman 1.5](/api-reference/video/omni-human-1-5)**: Generate human animations driven by audio


# Audio Isolation - Get task status
Source: https://docs.freepik.com/api-reference/audio-isolation/task-by-id

get /v1/ai/audio-isolation/{task-id}
Get the status of one audio isolation task



# AI Image Classifier - Detection API | Freepik API
Source: https://docs.freepik.com/api-reference/classifier/overview

Detect AI-generated images with the AI Image Classifier API. Get probability scores for authentic vs synthetic content. Instant results for content moderation workflows.

<Card title="AI detection technology" icon="tags">
  Powered by advanced machine learning, this API analyzes images to determine the probability of AI generation with high accuracy.
</Card>

The AI Image Classifier is a detection API that analyzes images to determine whether they were created by artificial intelligence or are authentic photographs. Submit any image and receive a confidence score indicating the probability of AI generation vs. natural origin. The API returns instant results, making it ideal for real-time content moderation and verification workflows.

### Key capabilities

* **Binary classification**: Returns probability scores for both `ai` and `not_ai` categories
* **High accuracy detection**: Advanced ML model trained on diverse AI-generated and authentic images
* **Multiple input formats**: Accepts base64-encoded images, URLs, or binary data
* **Instant response**: Synchronous API with immediate results (no task polling required)
* **Confidence scoring**: Probability values from 0 to 1 for precise threshold-based decisions
* **Format support**: Works with common image formats (JPEG, PNG, WebP, GIF)

### Use cases

* **Content moderation**: Automatically flag potentially AI-generated uploads on user platforms
* **Editorial verification**: Verify image authenticity before publication in news or media
* **Stock image curation**: Filter AI-generated content from authentic photography collections
* **Social media compliance**: Detect synthetic content for platform policy enforcement
* **Academic integrity**: Identify AI-generated images in research or educational submissions
* **Legal and forensic analysis**: Support authenticity verification for evidence documentation

### Classify images with AI Image Classifier

Submit an image to analyze whether it was generated by AI. The API returns probability scores instantly without requiring task polling.

<div>
  <Columns>
    <Card title="POST /v1/ai/classifier/image" icon="tags" href="/api-reference/classifier/post-ai-classifier">
      Analyze an image for AI-generation probability
    </Card>
  </Columns>
</div>

### Parameters

| Parameter | Type     | Required | Default | Description                                                  |
| --------- | -------- | -------- | ------- | ------------------------------------------------------------ |
| `image`   | `string` | Yes      | -       | Image to analyze: base64-encoded string, URL, or binary data |

### Response

The API returns an array of classification results with probability scores:

| Field         | Type     | Description                                            |
| ------------- | -------- | ------------------------------------------------------ |
| `class_name`  | `string` | Classification category: `ai` or `not_ai`              |
| `probability` | `number` | Confidence score from 0 to 1 (higher = more confident) |

**Example response:**

```json theme={null}
{
  "data": [
    {
      "class_name": "not_ai",
      "probability": 0.9489
    },
    {
      "class_name": "ai",
      "probability": 0.0511
    }
  ]
}
```

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is the AI Image Classifier and how does it work?">
    The AI Image Classifier is a detection API that uses machine learning to analyze visual patterns in images that are characteristic of AI generation. It examines features like texture consistency, artifact patterns, and statistical properties to determine whether an image was created by AI tools (like Midjourney, DALL-E, or Stable Diffusion) or is an authentic photograph. The API returns probability scores for both categories.
  </Accordion>

  <Accordion title="What image formats does the classifier support?">
    The classifier accepts common image formats including JPEG, PNG, WebP, and GIF. Images can be provided as base64-encoded strings, direct URLs, or binary data in the request body.
  </Accordion>

  <Accordion title="How should I interpret the probability scores?">
    The API returns two probability scores that sum to approximately 1.0. A `not_ai` probability of 0.95 means the model is 95% confident the image is authentic. For content moderation, you can set thresholds based on your requirements - for example, flag images where `ai` probability exceeds 0.7 for review.
  </Accordion>

  <Accordion title="How accurate is the AI detection?">
    The classifier is trained on a diverse dataset of AI-generated images from various models and authentic photographs. Accuracy depends on the image type and generation method. The probability scores help you make threshold-based decisions appropriate for your use case. For critical applications, consider combining with manual review.
  </Accordion>

  <Accordion title="What are the rate limits for the AI Image Classifier?">
    Rate limits vary by subscription tier. See [Rate Limits](/ratelimits) for current limits and how to handle rate-limited requests.
  </Accordion>

  <Accordion title="How much does the AI Image Classifier cost?">
    See the [Pricing page](/pricing) for current rates and subscription options.
  </Accordion>

  <Accordion title="Does the classifier work on edited or manipulated images?">
    The classifier is optimized for detecting fully AI-generated images. Partially edited images (AI inpainting on real photos, filters, or composites) may produce mixed results. For best accuracy, use on complete images rather than crops or heavily processed versions.
  </Accordion>
</AccordionGroup>

## Best practices

* **Image quality**: Submit high-resolution images when possible for more accurate analysis
* **Threshold tuning**: Set classification thresholds based on your false-positive tolerance
* **Batch processing**: For high-volume workflows, implement request queuing to respect rate limits
* **Human review**: Use API scores to prioritize manual review rather than as sole decision criteria
* **Error handling**: Implement retry logic with exponential backoff for 503 errors
* **Caching**: Cache results for identical images to reduce API calls and costs

## Related APIs

* **[Mystic](/api-reference/mystic/mystic)**: Generate high-quality AI images with Freepik's proprietary model
* **[Image Upscaler](/api-reference/image-upscaler-creative/image-upscaler)**: Enhance image resolution with AI upscaling
* **[Background Remover](/api-reference/remove-background/overview)**: Remove or replace image backgrounds


# Analyzes an image to determine its likelihood of being AI-generated
Source: https://docs.freepik.com/api-reference/classifier/post-ai-classifier

post /v1/ai/classifier/image
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.



# AI Icon Generation - Text-to-Icon API | Freepik API
Source: https://docs.freepik.com/api-reference/icon-generation/overview

Generate custom icons from text prompts with AI. Create PNG or SVG icons in 5 styles: solid, outline, color, flat, and sticker. Production-ready vector output for apps and websites.

<Card title="AI-powered icon generation" icon="icons">
  Generate custom icons from text descriptions using advanced AI models, with support for multiple styles and vector output formats.
</Card>

AI Icon Generation is a text-to-icon API that creates custom icons from natural language prompts. Describe the icon you need, and receive production-ready PNG or SVG files in your chosen style. The API supports 5 distinct visual styles and offers a preview workflow for rapid iteration before final rendering.

### Key capabilities

* **Text-to-icon generation**: Create icons from natural language descriptions (e.g., "A cute cat icon", "Shopping cart with heart")
* **Multiple output formats**: Export as PNG for raster graphics or SVG for scalable vector graphics
* **5 visual styles**: Choose from `solid`, `outline`, `color`, `flat`, or `sticker` styles
* **Preview workflow**: Generate quick previews before committing to final high-quality renders
* **Quality tuning**: Adjust `num_inference_steps` (10-50) and `guidance_scale` (0-10) for fine control
* **Async processing**: Webhook notifications for task completion
* **Vector-ready output**: SVG format for infinite scalability without quality loss

### Use cases

* **Mobile app development**: Generate consistent icon sets for iOS and Android applications
* **Web design**: Create custom icons matching your brand identity and design system
* **UI/UX prototyping**: Rapidly iterate on icon concepts during design exploration
* **Marketing materials**: Generate unique icons for presentations, infographics, and social media
* **Brand identity**: Create distinctive iconography that aligns with brand guidelines
* **E-commerce**: Generate product category icons, feature badges, and navigation elements

### Generate icons with the API

Create icons by submitting a text prompt with your desired style and format. Use the preview endpoint for quick iterations, then render the final output in your preferred format.

<div>
  <Columns>
    <Card title="POST /v1/ai/text-to-icon" icon="icons" href="/api-reference/icon-generation/post-generate-icon">
      Generate a new icon from text prompt
    </Card>

    <Card title="POST /v1/ai/text-to-icon/preview" icon="eye" href="/api-reference/icon-generation/post-preview">
      Generate a quick preview of the icon
    </Card>

    <Card title="POST /v1/ai/text-to-icon/{task-id}/render/{format}" icon="download" href="/api-reference/icon-generation/post-{format}-by-id">
      Download icon in PNG or SVG format
    </Card>
  </Columns>
</div>

### Parameters

| Parameter             | Type      | Required | Default | Description                                                          |
| --------------------- | --------- | -------- | ------- | -------------------------------------------------------------------- |
| `prompt`              | `string`  | Yes      | -       | Text description of the icon to generate (e.g., "A cute cat icon")   |
| `webhook_url`         | `string`  | Yes      | -       | URL for task completion notification                                 |
| `style`               | `string`  | No       | `solid` | Visual style: `solid`, `outline`, `color`, `flat`, or `sticker`      |
| `format`              | `string`  | No       | `png`   | Output format: `png` or `svg`                                        |
| `num_inference_steps` | `integer` | No       | `10`    | Generation quality steps (10-50, higher = better quality, slower)    |
| `guidance_scale`      | `number`  | No       | `7`     | Prompt adherence strength (0-10, higher = stricter prompt following) |

### Style reference

| Style     | Description                        | Best for                         |
| --------- | ---------------------------------- | -------------------------------- |
| `solid`   | Filled shapes with single color    | UI icons, navigation elements    |
| `outline` | Line-based icons with strokes      | Minimalist designs, light themes |
| `color`   | Multi-colored filled icons         | Marketing, illustrations         |
| `flat`    | Simplified shapes with flat colors | Modern app interfaces            |
| `sticker` | Decorative style with playful look | Social media, casual apps        |

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is AI Icon Generation and how does it work?">
    AI Icon Generation is a text-to-icon API that uses advanced AI models to create custom icons from natural language descriptions. You submit a prompt describing the icon you want (e.g., "A shopping cart icon"), choose a style and format, and receive a task ID. Poll for results or receive a webhook notification when the icon is ready. The output is a production-ready PNG or SVG file.
  </Accordion>

  <Accordion title="What output formats does AI Icon Generation support?">
    The API supports two output formats: PNG for raster graphics and SVG for scalable vector graphics. PNG is ideal for immediate use in web and mobile applications, while SVG provides infinite scalability without quality loss, perfect for responsive designs and print materials.
  </Accordion>

  <Accordion title="What are the available icon styles?">
    Five visual styles are available: `solid` (filled shapes), `outline` (line-based), `color` (multi-colored), `flat` (simplified modern), and `sticker` (decorative playful). Each style suits different design contexts - solid and outline work well for UI elements, while color and sticker are better for marketing and casual applications.
  </Accordion>

  <Accordion title="How do I write effective icon prompts?">
    Be specific and descriptive. Good examples: "A cute cat icon", "Shopping cart with a heart", "Lightning bolt in a circle", "Envelope with notification badge". Include the subject and any distinctive features. Avoid overly complex descriptions - icons work best as simple, recognizable symbols.
  </Accordion>

  <Accordion title="What is the difference between preview and generate endpoints?">
    The preview endpoint (`/preview`) generates a quick draft for rapid iteration during the design process. The main generate endpoint (`/v1/ai/text-to-icon`) creates the production-ready icon. Use previews to explore different prompts and styles, then generate the final version once satisfied.
  </Accordion>

  <Accordion title="How do num_inference_steps and guidance_scale affect output?">
    `num_inference_steps` (10-50) controls generation quality - higher values produce more refined icons but take longer. `guidance_scale` (0-10) determines how strictly the AI follows your prompt - higher values create icons more closely matching your description, while lower values allow more creative interpretation.
  </Accordion>

  <Accordion title="What are the rate limits for AI Icon Generation?">
    Rate limits vary by subscription tier. See [Rate Limits](/ratelimits) for current limits and quotas.
  </Accordion>

  <Accordion title="How much does AI Icon Generation cost?">
    See the [Pricing page](/pricing) for current rates and subscription options.
  </Accordion>
</AccordionGroup>

## Best practices

* **Prompt clarity**: Use clear, concise descriptions focusing on the core concept of the icon
* **Style consistency**: Use the same style across icon sets for visual coherence in your application
* **Preview first**: Use the preview endpoint to iterate quickly before generating final renders
* **SVG for scalability**: Choose SVG format when icons will be used at multiple sizes
* **Quality vs. speed**: Start with default `num_inference_steps` (10) for testing, increase for production
* **Guidance tuning**: Use higher `guidance_scale` (8-10) for literal interpretations, lower (4-6) for creative variations
* **Webhook integration**: Use webhooks instead of polling for production applications
* **Error handling**: Implement retry logic with exponential backoff for 503 errors

## Related APIs

* **[Freepik Mystic](/api-reference/mystic/mystic)**: Generate full illustrations and images from text prompts
* **[Image Upscaler](/api-reference/image-upscaler-creative/image-upscaler)**: Enhance icon resolution for high-DPI displays
* **[Background Removal](/api-reference/remove-background/overview)**: Remove backgrounds from existing icons or images


# AI Icon generation
Source: https://docs.freepik.com/api-reference/icon-generation/post-generate-icon

post /v1/ai/text-to-icon
Create stunning icons in different styles and formats (png, svg) from text prompts using our advanced AI models.

## Description

Generate an icon from a text prompt.


# AI Icon preview generation
Source: https://docs.freepik.com/api-reference/icon-generation/post-preview

post /v1/ai/text-to-icon/preview
Create stunning previews icons in different styles and formats (png, svg) from text prompts using our advanced AI models.



# Download an icon preview
Source: https://docs.freepik.com/api-reference/icon-generation/post-{format}-by-id

post /v1/ai/text-to-icon/{task-id}/render/{format}
Download the generated AI icon in the specified format png or svg.



# Download an icon
Source: https://docs.freepik.com/api-reference/icons/download-an-icon

get /v1/icons/{id}/download
Download the specified icon by its unique ID in the requested format and size.

Download the original icon asset. See the [Icons API overview](/api-reference/icons/icons-api) for authentication and usage guidance.


# Search and filter icons by specified order
Source: https://docs.freepik.com/api-reference/icons/get-all-icons-by-order

get /v1/icons
Get a list of icons based on the provided parameters and ordering criteria.

Use the Freepik Icons API to list icons ordered by relevance, popularity, or recency. See the [Icons API overview](/api-reference/icons/icons-api) for authentication and usage guidance.


# Get detailed icon information by ID
Source: https://docs.freepik.com/api-reference/icons/get-one-icon-by-id

get /v1/icons/{id}
Get detailed information about a specific icon identified by its unique ID.

Fetch a specific icon by ID. See the [Icons API overview](/api-reference/icons/icons-api) for authentication and usage guidance.


# Icons API
Source: https://docs.freepik.com/api-reference/icons/icons-api

Search, retrieve, and download icons programmatically with the Freepik Icons API.

The Freepik Icons API lets you find and retrieve icons from our catalog with AI-powered search and download the assets for use in your applications.

### What you can do

* List icons with sorting and filters
* Get a single icon by ID
* Download an icon asset

### Authentication

All requests require an API key via the `x-freepik-api-key` header. See the [Quickstart](/quickstart) and [Authentication](/authentication).

### Endpoints

<div>
  <Columns>
    <Card title="GET /v1/icons" icon="code" href="/api-reference/icons/get-all-icons-by-order">
      List icons with sorting and filters
    </Card>

    <Card title="GET /v1/icons/{id}" icon="code" href="/api-reference/icons/get-one-icon-by-id">
      Retrieve a single icon by ID
    </Card>

    <Card title="GET /v1/icons/{id}/download" icon="code" href="/api-reference/icons/download-an-icon">
      Download an icon asset
    </Card>
  </Columns>
</div>

### Use cases

* Build an icon picker into your design tool or CMS
* AI-powered search by keyword and sort by popularity
* Programmatically download icons during build/deploy

### FAQ

#### Is there a rate limit?

Yes. See [Rate limits](/ratelimits).

#### What license applies to icons?

Refer to the [License agreement](https://www.freepik.com/legal/terms-of-use#api-services).


# Ideogram Image Edit - List tasks
Source: https://docs.freepik.com/api-reference/ideogram-image-edit/get-ideogram-image-edit

get /v1/ai/ideogram-image-edit
Get the status of all Ideogram Image Edit tasks



# Ideogram Image Edit - Get task status
Source: https://docs.freepik.com/api-reference/ideogram-image-edit/get-{task-id}-by-id

get /v1/ai/ideogram-image-edit/{task-id}
Get the status of a specific Ideogram Image Edit task



# Ideogram Inpainting API
Source: https://docs.freepik.com/api-reference/ideogram-image-edit/overview

Edit specific areas of an image using Ideogram AI inpainting. Mask-based editing with multiple rendering speeds, MagicPrompt enhancement, style and character references.

<Card title="Ideogram Inpainting" icon="paintbrush">
  Powered by Ideogram AI, this API edits specific areas of an image using mask-based inpainting with prompt-guided generation.
</Card>

Ideogram Inpainting is an AI-powered image editing API that lets you modify specific regions of an image using a mask and a text prompt. Provide a black-and-white mask where black regions indicate the areas to edit, along with a prompt describing the desired changes. The API supports multiple rendering speeds (TURBO, DEFAULT, QUALITY), automatic prompt enhancement via MagicPrompt, and style/character reference images for consistent results.

### Key capabilities

* **Mask-based editing**: Use a black-and-white mask to precisely define which areas of the image to modify
* **Multiple rendering speeds**: Choose between TURBO (fastest), DEFAULT (balanced), or QUALITY (highest quality)
* **MagicPrompt**: Automatically enhance your prompt for better results (AUTO, ON, or OFF)
* **Style customization**: Apply style codes, style types (AUTO, GENERAL, REALISTIC, DESIGN), and style reference images
* **Character consistency**: Use character reference images to maintain consistent characters across edits
* **Color palette control**: Guide the color palette of generated content
* **Reproducible results**: Optional seed parameter (0-2147483647) for consistent output across requests
* **Flexible input**: Accepts HTTPS URLs or base64-encoded images (max 10MB per image)
* **Async processing**: Webhook notifications or polling for task completion

### Use cases

* **Object replacement**: Replace objects in a scene with AI-generated alternatives
* **Background editing**: Modify or replace backgrounds while preserving subjects
* **Content removal**: Remove unwanted elements from images seamlessly
* **Creative retouching**: Edit specific areas with creative prompts for artistic effects
* **Product photography**: Modify product backgrounds or surroundings for e-commerce
* **Character editing**: Maintain character consistency across multiple edited images

### Edit images with Ideogram Inpainting

Submit an image with a mask and prompt to edit specific regions. The service returns a task ID for async polling or webhook notification.

<div>
  <Columns>
    <Card title="POST /v1/ai/ideogram-image-edit" icon="paintbrush" href="/api-reference/ideogram-image-edit/post-ideogram-image-edit">
      Create a new inpainting task
    </Card>

    <Card title="GET /v1/ai/ideogram-image-edit" icon="list" href="/api-reference/ideogram-image-edit/get-ideogram-image-edit">
      List all inpainting tasks
    </Card>

    <Card title="GET /v1/ai/ideogram-image-edit/{task-id}" icon="magnifying-glass" href="/api-reference/ideogram-image-edit/get-{task-id}-by-id">
      Get task status and results by ID
    </Card>
  </Columns>
</div>

### Parameters

| Parameter                    | Type      | Required | Default   | Description                                                                                                                   |
| ---------------------------- | --------- | -------- | --------- | ----------------------------------------------------------------------------------------------------------------------------- |
| `image`                      | `string`  | Yes      | -         | Image to edit. HTTPS URL or base64-encoded (JPEG, WebP, PNG, max 10MB)                                                        |
| `mask`                       | `string`  | Yes      | -         | Black-and-white mask image (same size as input). Black regions indicate areas to edit. HTTPS URL or base64-encoded (max 10MB) |
| `prompt`                     | `string`  | Yes      | -         | Text describing the desired changes to the image                                                                              |
| `rendering_speed`            | `string`  | No       | `DEFAULT` | Rendering speed: `TURBO`, `DEFAULT`, or `QUALITY`                                                                             |
| `magic_prompt`               | `string`  | No       | -         | MagicPrompt enhancement: `AUTO`, `ON`, or `OFF`                                                                               |
| `style_type`                 | `string`  | No       | -         | Style type: `AUTO`, `GENERAL`, `REALISTIC`, or `DESIGN`                                                                       |
| `style_codes`                | `array`   | No       | -         | List of style codes for image generation                                                                                      |
| `style_reference_images`     | `array`   | No       | -         | Images to use as style references (URLs or base64)                                                                            |
| `character_reference_images` | `array`   | No       | -         | Images for character consistency (URLs or base64)                                                                             |
| `color_palette`              | `object`  | No       | -         | Color palette to guide generated content                                                                                      |
| `seed`                       | `integer` | No       | random    | Seed for reproducibility (0-2147483647)                                                                                       |
| `webhook_url`                | `string`  | No       | -         | URL for task completion notification                                                                                          |

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is Ideogram Inpainting and how does it work?">
    Ideogram Inpainting is an AI-powered image editing API. You provide an image, a black-and-white mask indicating which areas to edit, and a text prompt describing the desired changes. The API generates new content in the masked regions that blends seamlessly with the rest of the image. You receive a task ID immediately, then poll for results or receive a webhook notification.
  </Accordion>

  <Accordion title="How does the mask work?">
    The mask must be the same size as the input image. It should be a black-and-white image where black regions indicate the areas you want to edit. White regions will remain unchanged. Supported formats are JPEG, WebP, and PNG (max 10MB).
  </Accordion>

  <Accordion title="What are the rendering speed options?">
    There are three rendering speeds: **TURBO** is the fastest with lower quality, **DEFAULT** provides balanced speed and quality, and **QUALITY** is slower but produces the highest quality results. The default is DEFAULT.
  </Accordion>

  <Accordion title="What is MagicPrompt?">
    MagicPrompt automatically enhances your text prompt for better generation results. Set it to `AUTO` to let the model decide, `ON` to always use it, or `OFF` to disable it. This can significantly improve output quality with minimal effort.
  </Accordion>

  <Accordion title="Can I maintain character consistency across edits?">
    Yes. Use the `character_reference_images` parameter to provide reference images of the character you want to maintain. Combined with `style_type`, this helps ensure consistent characters across multiple edits.
  </Accordion>

  <Accordion title="What image formats are supported?">
    The API accepts JPEG, WebP, and PNG images up to 10MB each. Both HTTPS URLs and base64-encoded strings are supported for images, masks, and reference images. The output is returned as a downloadable image URL.
  </Accordion>

  <Accordion title="What are the rate limits for Ideogram Inpainting?">
    Rate limits vary by subscription tier. See [Rate Limits](/ratelimits) for current limits.
  </Accordion>

  <Accordion title="How much does Ideogram Inpainting cost?">
    See the [Pricing page](/pricing) for current rates and subscription options.
  </Accordion>
</AccordionGroup>

## Best practices

* **Precise masks**: Create clean, well-defined masks for the best results. Avoid feathered or blurry edges
* **Descriptive prompts**: Be specific about what you want in the edited region (e.g., "red roses in a garden" instead of just "flowers")
* **MagicPrompt for quick results**: Use `magic_prompt: "AUTO"` to let the model enhance your prompt automatically
* **Rendering speed tradeoffs**: Use TURBO for quick previews, DEFAULT for production, and QUALITY for final outputs
* **Style references**: Provide style reference images when you need a specific visual style across edits
* **Seed for consistency**: Use the same seed value when you need reproducible results across multiple API calls
* **Production integration**: Use webhooks instead of polling for scalable applications
* **Error handling**: Implement retry logic with exponential backoff for 503 errors

## Related APIs

* **[Ideogram Image Expand](/api-reference/image-expand/ideogram/overview)**: Expand images beyond their boundaries with Ideogram
* **[Image Upscaler](/api-reference/image-upscaler-creative/post-image-upscaler)**: Enhance image resolution and quality
* **[Remove Background](/api-reference/remove-background/post-beta-remove-background)**: Remove image backgrounds for compositing
* **[Reimagine Flux](/api-reference/text-to-image/reimagine-flux/post-reimagine-flux)**: Reimagine images with Flux


# Ideogram Image Edit - Edit an image using inpainting
Source: https://docs.freepik.com/api-reference/ideogram-image-edit/post-ideogram-image-edit

post /v1/ai/ideogram-image-edit
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.

**Key features:**
- Inpainting: Edit specific areas of an image using a mask
- Multiple rendering speeds: TURBO, DEFAULT, or QUALITY
- MagicPrompt: Automatically enhance your prompt for better results
- Style customization: Use style codes, style types, and reference images
- Character reference: Use reference images to maintain character consistency

**Supported formats:** JPEG, WebP, PNG (max 10MB each)




# Change Camera - Transform image perspective
Source: https://docs.freepik.com/api-reference/image-change-camera/change-camera

post /v1/ai/image-change-camera
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.

This 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.

**Camera controls:**
- **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.
- **Vertical angle** (`vertical_angle`): Tilt the camera from -30 (looking up) to 90 (bird's eye view). `0` = eye level.
- **Zoom** (`zoom`): Adjust from `0` (wide shot, full scene) to `10` (close-up).

**Use cases:** Product photography with multiple angle views, architectural visualization, creative image manipulation, and generating consistent multi-angle views of objects and scenes.




# Change Camera - List tasks
Source: https://docs.freepik.com/api-reference/image-change-camera/change-camera-tasks

get /v1/ai/image-change-camera
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.



# Change Camera API
Source: https://docs.freepik.com/api-reference/image-change-camera/overview

Change camera angle and perspective of any image with the Change Camera API. Adjust horizontal rotation (0-360), vertical tilt (-30 to 90), and zoom (0-10) for multi-angle views.

<Card title="AI camera angle transformation" icon="camera-rotate">
  Transform any image by repositioning the virtual camera with precise control over horizontal rotation, vertical tilt, and zoom level.
</Card>

Change Camera is an image editing API that transforms the camera perspective of any image using AI. Provide an input image and specify 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 physically repositioned around the subject. The API accepts JPG, PNG, and WebP images via publicly accessible HTTPS URLs and outputs in PNG or JPEG format. Processing is asynchronous with support for both polling and webhook notifications.

### Key capabilities

* **360-degree horizontal rotation**: Rotate the viewpoint around the subject from 0 (front) through 90 (right side), 180 (back), 270 (left side), to 360 degrees
* **Vertical tilt control**: Tilt the camera from -30 degrees (looking up) through 0 (eye level) to 90 degrees (bird's eye view)
* **Adjustable zoom**: Control the distance from wide shot (`0`) through standard framing (`5`) to close-up (`10`)
* **Output format options**: Choose between lossless PNG or compressed JPEG output
* **Reproducible results**: Optional seed parameter for consistent output across requests
* **Async processing**: Webhook notifications or polling for task completion

### Camera controls reference

| Control                 | Parameter          | Range     | Default | Key positions                                    |
| ----------------------- | ------------------ | --------- | ------- | ------------------------------------------------ |
| **Horizontal rotation** | `horizontal_angle` | 0-360     | 0       | `0` front, `90` right, `180` back, `270` left    |
| **Vertical tilt**       | `vertical_angle`   | -30 to 90 | 0       | `-30` looking up, `0` eye level, `90` bird's eye |
| **Zoom**                | `zoom`             | 0-10      | 5       | `0` wide shot, `5` medium, `10` close-up         |

### Use cases

* **Product photography**: Generate multiple angle views of a product from a single photo for e-commerce listings
* **Architectural visualization**: View buildings and interiors from different perspectives without reshooting
* **Creative image manipulation**: Explore alternative viewpoints of scenes, portraits, and objects
* **3D asset previewing**: Create multi-angle previews from a single reference image
* **Marketing materials**: Produce varied camera angles for advertising campaigns from one source image
* **Content creation**: Generate consistent multi-angle views of subjects for social media and editorial content

### Transform images with Change Camera

Submit an image URL with camera angle parameters to create a new transformation task. The service returns a task ID for async polling or webhook notification.

<div>
  <Columns>
    <Card title="POST /v1/ai/image-change-camera" icon="camera-rotate" href="/api-reference/image-change-camera/change-camera">
      Create a new camera angle transformation task
    </Card>

    <Card title="GET /v1/ai/image-change-camera" icon="list" href="/api-reference/image-change-camera/change-camera-tasks">
      List all Change Camera tasks
    </Card>

    <Card title="GET /v1/ai/image-change-camera/{task-id}" icon="magnifying-glass" href="/api-reference/image-change-camera/task-by-id">
      Get task status and results by ID
    </Card>
  </Columns>
</div>

### Parameters

| Parameter          | Type      | Required | Default | Description                                                                    |
| ------------------ | --------- | -------- | ------- | ------------------------------------------------------------------------------ |
| `image`            | `string`  | Yes      | -       | Input image URL (publicly accessible HTTPS). Supported formats: JPG, PNG, WebP |
| `horizontal_angle` | `integer` | No       | `0`     | Horizontal rotation: `0` (front) to `360` degrees around the subject           |
| `vertical_angle`   | `integer` | No       | `0`     | Vertical tilt: `-30` (looking up) to `90` (bird's eye view) degrees            |
| `zoom`             | `integer` | No       | `5`     | Zoom level: `0` (wide shot) to `10` (close-up)                                 |
| `output_format`    | `string`  | No       | `png`   | Output format: `png` (lossless) or `jpeg` (compressed)                         |
| `seed`             | `integer` | No       | random  | Seed for reproducibility (minimum: 1)                                          |
| `webhook_url`      | `string`  | No       | -       | URL for task completion notification                                           |

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is the Change Camera API and how does it work?">
    The Change Camera API transforms the camera perspective of any image using AI. You submit an image URL with desired camera angle parameters (horizontal rotation, vertical tilt, and zoom), receive a task ID immediately, then poll for results or receive a webhook notification when processing completes. The AI generates a new image as if the camera had been repositioned around the subject.
  </Accordion>

  <Accordion title="What image formats does the Change Camera API support?">
    The Change Camera API accepts images via publicly accessible HTTPS URLs. Supported input formats are JPG, PNG, and WebP. Output is available in PNG (lossless, default) or JPEG (compressed) format, controlled by the `output_format` parameter.
  </Accordion>

  <Accordion title="How does horizontal rotation work?">
    The `horizontal_angle` parameter rotates the camera around the subject from 0 to 360 degrees. Key positions: `0` is the front view, `90` is the right side, `180` is the back view, `270` is the left side, and `360` returns to the front (equivalent to `0`). The default is `0` (front view).
  </Accordion>

  <Accordion title="How does vertical tilt work?">
    The `vertical_angle` parameter tilts the camera up or down relative to the subject. Values range from `-30` (looking up at the subject from below) through `0` (eye level, default) to `90` (bird's eye view looking straight down). A value of `45` provides a moderate downward angle.
  </Accordion>

  <Accordion title="Can I reproduce the same transformation result?">
    Yes. Use the `seed` parameter with the same value across requests. Combined with identical image URLs and camera parameters, the API produces consistent output. This is useful for fine-tuning angles iteratively.
  </Accordion>

  <Accordion title="What are the rate limits for the Change Camera API?">
    Rate limits vary by subscription tier. See [Rate Limits](/ratelimits) for current limits.
  </Accordion>

  <Accordion title="How much does the Change Camera API cost?">
    See the [Pricing page](/pricing) for current rates and subscription options.
  </Accordion>
</AccordionGroup>

## Best practices

* **Start with defaults**: Begin with default values (`horizontal_angle=0`, `vertical_angle=0`, `zoom=5`) and adjust one parameter at a time to understand the effect
* **Subtle angle changes**: Small adjustments (15-30 degrees horizontal, 10-20 degrees vertical) often produce the most realistic results
* **Input quality**: Use high-resolution, well-lit images for best perspective transformation quality
* **Seed for iteration**: Use the `seed` parameter when fine-tuning angles to isolate the effect of each parameter change
* **Production integration**: Use webhooks instead of polling for scalable applications
* **Error handling**: Implement retry logic with exponential backoff for 503 errors

## Related APIs

* **[Image Upscaler](/api-reference/image-upscaler-precision-v2/overview)**: Enhance image resolution before or after camera angle transformation
* **[Style Transfer](/api-reference/image-style-transfer/image-styletransfer)**: Apply artistic styles to images after changing the perspective
* **[Remove Background](/api-reference/remove-background/overview)**: Remove backgrounds for clean subject isolation before camera transformation


# Change Camera - Get task status
Source: https://docs.freepik.com/api-reference/image-change-camera/task-by-id

get /v1/ai/image-change-camera/{task-id}
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.



# Get the status of all image expand tasks
Source: https://docs.freepik.com/api-reference/image-expand/get-flux-pro

get /v1/ai/image-expand/flux-pro



# Get the status of all image expand seedream v4.5 tasks
Source: https://docs.freepik.com/api-reference/image-expand/get-seedream-v4-5

get /v1/ai/image-expand/seedream-v4-5



# Get the status of one image expand seedream v4.5 task
Source: https://docs.freepik.com/api-reference/image-expand/get-seedream-v4-5-task

get /v1/ai/image-expand/seedream-v4-5/{task-id}



# Get the status of one image expand task
Source: https://docs.freepik.com/api-reference/image-expand/get-{task-id}-by-id

get /v1/ai/image-expand/flux-pro/{task-id}



# Ideogram - Expand image
Source: https://docs.freepik.com/api-reference/image-expand/ideogram/expand-image

post /v1/ai/image-expand/ideogram
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.
If no prompt is provided, the model will auto-generate one based on the image content.




# Get the status of all image expand ideogram tasks
Source: https://docs.freepik.com/api-reference/image-expand/ideogram/ideogram-tasks

get /v1/ai/image-expand/ideogram



# Ideogram Image Expand API
Source: https://docs.freepik.com/api-reference/image-expand/ideogram/overview

Expand images beyond their original boundaries with Ideogram Image Expand. AI-powered outpainting with directional control up to 2048 pixels per side and optional prompt guidance.

<Card title="Ideogram integration" icon="expand">
  Powered by Ideogram AI, this API expands images beyond their original boundaries with intelligent content generation that blends seamlessly with the original.
</Card>

Ideogram Image Expand is an AI-powered outpainting API that extends images beyond their original boundaries using Ideogram's generative model. Specify how many pixels to add on each side (left, right, top, bottom) up to 2048 pixels, and optionally provide a text prompt to guide the generated content. If no prompt is provided, the model auto-generates one based on the image content. The API produces seamless expansions that maintain visual consistency with the original image, making it ideal for adapting images to different aspect ratios or adding creative space around subjects.

### Key capabilities

* **Directional expansion**: Independently control expansion on each edge (left, right, top, bottom) from 0 to 2048 pixels
* **Auto-prompt generation**: Automatically generates a prompt from the image content when no prompt is provided
* **Prompt-guided generation**: Optional text descriptions to guide what appears in expanded areas
* **Seamless blending**: AI-generated content matches the style, lighting, and composition of the original image
* **Reproducible results**: Optional seed parameter (0-2147483647) for consistent output across requests
* **Async processing**: Webhook notifications or polling for task completion

### Use cases

* **Social media adaptation**: Convert landscape images to portrait format (or vice versa) for different platforms
* **Print production**: Add bleed area or extend backgrounds for large-format printing
* **Design workflows**: Create additional canvas space for text overlays, logos, or design elements
* **Photography enhancement**: Extend cropped photos to recover lost composition
* **E-commerce**: Expand product images to fit standardized dimensions
* **Marketing materials**: Adapt hero images to various banner sizes and aspect ratios

### Expand images with Ideogram

Submit an image with expansion parameters to extend it in any direction. The service returns a task ID for async polling or webhook notification.

<div>
  <Columns>
    <Card title="POST /v1/ai/image-expand/ideogram" icon="expand" href="/api-reference/image-expand/ideogram/expand-image">
      Create a new image expansion task
    </Card>

    <Card title="GET /v1/ai/image-expand/ideogram" icon="list" href="/api-reference/image-expand/ideogram/ideogram-tasks">
      List all Ideogram image expansion tasks
    </Card>

    <Card title="GET /v1/ai/image-expand/ideogram/{task-id}" icon="magnifying-glass" href="/api-reference/image-expand/ideogram/task-by-id">
      Get task status and results by ID
    </Card>
  </Columns>
</div>

### Parameters

| Parameter     | Type      | Required | Default        | Description                                                                                                              |
| ------------- | --------- | -------- | -------------- | ------------------------------------------------------------------------------------------------------------------------ |
| `image`       | `string`  | Yes      | -              | Base64-encoded image to expand                                                                                           |
| `left`        | `integer` | Yes      | -              | Pixels to expand on the left side (0-2048)                                                                               |
| `right`       | `integer` | Yes      | -              | Pixels to expand on the right side (0-2048)                                                                              |
| `top`         | `integer` | Yes      | -              | Pixels to expand on the top side (0-2048)                                                                                |
| `bottom`      | `integer` | Yes      | -              | Pixels to expand on the bottom side (0-2048)                                                                             |
| `prompt`      | `string`  | No       | auto-generated | Text prompt describing the desired expanded content. If not provided, the AI auto-generates a prompt based on the image. |
| `seed`        | `integer` | No       | random         | Seed for reproducibility (0-2147483647)                                                                                  |
| `webhook_url` | `string`  | No       | -              | URL for task completion notification                                                                                     |

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is Ideogram Image Expand and how does it work?">
    Ideogram Image Expand is an AI-powered outpainting API that extends images beyond their original boundaries. You submit a base64-encoded image with pixel expansion values for each edge (left, right, top, bottom), receive a task ID immediately, then poll for results or receive a webhook notification when processing completes. The API generates new content that seamlessly blends with the original image.
  </Accordion>

  <Accordion title="How much can I expand an image?">
    You can expand up to 2048 pixels on each edge (left, right, top, bottom) independently. All four directional parameters (left, right, top, bottom) are required. Set any edge to 0 if you do not want to expand in that direction.
  </Accordion>

  <Accordion title="What happens if I do not provide a prompt?">
    If no prompt is provided, the Ideogram model automatically generates a prompt based on the image content. This auto-prompt feature analyzes the existing image and produces contextually appropriate content for the expanded areas.
  </Accordion>

  <Accordion title="What image formats are supported?">
    The API accepts base64-encoded images. Common formats like JPEG, PNG, and WebP can be encoded and submitted. The output is returned as a downloadable image URL.
  </Accordion>

  <Accordion title="Can I reproduce the same expansion result?">
    Yes. Use the `seed` parameter with the same value (0-2147483647) across requests to generate reproducible results. Combined with identical images, expansion values, and prompts, you will get consistent outputs.
  </Accordion>

  <Accordion title="What is the difference between Ideogram Expand and Flux Pro Expand?">
    Both APIs extend images beyond their original boundaries. Ideogram Image Expand features auto-prompt generation when no prompt is provided and requires all four directional parameters. Flux Pro Image Expand uses optional directional parameters with default values of 0. Choose based on your workflow preferences and output quality requirements.
  </Accordion>

  <Accordion title="What are the rate limits for Ideogram Image Expand?">
    Rate limits vary by subscription tier. See [Rate Limits](/ratelimits) for current limits.
  </Accordion>

  <Accordion title="How much does Ideogram Image Expand cost?">
    See the [Pricing page](/pricing) for current rates and subscription options.
  </Accordion>
</AccordionGroup>

## Best practices

* **Balanced expansion**: For best results, avoid extreme asymmetric expansions; gradual extensions maintain better visual coherence
* **Prompt specificity**: Use descriptive prompts when you need specific content in expanded areas (e.g., "sunset sky with orange clouds" instead of just "sky")
* **Auto-prompt for natural results**: Omit the prompt parameter to let the model analyze the image and generate contextually appropriate content
* **Image quality**: Higher resolution input images produce better expansion results
* **Seed for consistency**: Use the same seed value when you need reproducible results across multiple API calls
* **Production integration**: Use webhooks instead of polling for scalable applications
* **Error handling**: Implement retry logic with exponential backoff for 503 errors

## Related APIs

* **[Flux Pro Image Expand](/api-reference/image-expand/overview)**: Alternative image expansion API powered by Flux Pro
* **[Image Upscaler](/api-reference/image-upscaler-creative/post-image-upscaler)**: Enhance image resolution and quality
* **[Remove Background](/api-reference/remove-background/post-beta-remove-background)**: Remove image backgrounds for compositing


# Get the status of one image expand ideogram task
Source: https://docs.freepik.com/api-reference/image-expand/ideogram/task-by-id

get /v1/ai/image-expand/ideogram/{task-id}



# Flux Pro Image Expand - Outpainting API | Freepik API
Source: https://docs.freepik.com/api-reference/image-expand/overview

Expand images beyond their original boundaries with Flux Pro Image Expand. AI-powered outpainting with directional control up to 2048 pixels per side. Perfect for social media, print, and design workflows.

<Card title="Flux Pro integration" icon="expand">
  Powered by Flux Pro, this API expands images beyond their original boundaries using AI-generated content that seamlessly blends with the original.
</Card>

Flux Pro Image Expand is an AI-powered outpainting API that extends images beyond their original boundaries. Specify how many pixels to add on each side (left, right, top, bottom) up to 2048 pixels, and optionally provide a text prompt to guide the generated content. The API produces seamless expansions that maintain visual consistency with the original image, making it ideal for adapting images to different aspect ratios or adding creative space around subjects.

### Key capabilities

* **Directional expansion**: Independently control expansion on each edge (left, right, top, bottom) from 0 to 2048 pixels
* **Prompt-guided generation**: Optional text descriptions to guide what appears in expanded areas
* **Seamless blending**: AI-generated content matches the style, lighting, and composition of the original image
* **Flexible input**: Accept base64-encoded images for easy integration
* **High-resolution output**: Support for substantial canvas extensions while maintaining quality
* **Async processing**: Webhook notifications or polling for task completion

### Use cases

* **Social media adaptation**: Convert landscape images to portrait format (or vice versa) for different platforms
* **Print production**: Add bleed area or extend backgrounds for large-format printing
* **Design workflows**: Create additional canvas space for text overlays, logos, or design elements
* **Photography enhancement**: Extend cropped photos to recover lost composition
* **E-commerce**: Expand product images to fit standardized dimensions
* **Marketing materials**: Adapt hero images to various banner sizes and aspect ratios

### Expand images with Flux Pro

Submit an image with expansion parameters to extend it in any direction. The service returns a task ID for async polling or webhook notification.

<div>
  <Columns>
    <Card title="POST /v1/ai/image-expand/flux-pro" icon="expand" href="/api-reference/image-expand/post-flux-pro">
      Create a new image expansion task
    </Card>

    <Card title="GET /v1/ai/image-expand/flux-pro" icon="list" href="/api-reference/image-expand/get-flux-pro">
      List all image expansion tasks
    </Card>

    <Card title="GET /v1/ai/image-expand/flux-pro/{task-id}" icon="magnifying-glass" href="/api-reference/image-expand/get-{task-id}-by-id">
      Get task status and results by ID
    </Card>
  </Columns>
</div>

### Parameters

| Parameter     | Type      | Required | Default | Description                                                                            |
| ------------- | --------- | -------- | ------- | -------------------------------------------------------------------------------------- |
| `image`       | `string`  | Yes      | -       | Base64-encoded image to expand                                                         |
| `prompt`      | `string`  | No       | -       | Text description to guide the expanded areas (e.g., "sunset sky", "forest background") |
| `left`        | `integer` | No       | `0`     | Pixels to expand on the left edge (0-2048)                                             |
| `right`       | `integer` | No       | `0`     | Pixels to expand on the right edge (0-2048)                                            |
| `top`         | `integer` | No       | `0`     | Pixels to expand on the top edge (0-2048)                                              |
| `bottom`      | `integer` | No       | `0`     | Pixels to expand on the bottom edge (0-2048)                                           |
| `webhook_url` | `string`  | No       | -       | URL for task completion notification                                                   |

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is Flux Pro Image Expand and how does it work?">
    Flux Pro Image Expand is an AI-powered outpainting API that extends images beyond their original boundaries. You submit a base64-encoded image with expansion values for each edge (left, right, top, bottom), receive a task ID immediately, then poll for results or receive a webhook notification. The API generates new content that seamlessly blends with the original image.
  </Accordion>

  <Accordion title="How much can I expand an image?">
    You can expand up to 2048 pixels on each edge (left, right, top, bottom) independently. Set any edge to 0 if you do not want to expand in that direction. For example, to only extend the width, set `left` and `right` values while keeping `top` and `bottom` at 0.
  </Accordion>

  <Accordion title="What image formats are supported?">
    The API accepts base64-encoded images. Common formats like JPEG, PNG, and WebP can be encoded and submitted. The output is returned as a downloadable image URL.
  </Accordion>

  <Accordion title="How does the prompt parameter work?">
    The optional `prompt` parameter guides what the AI generates in the expanded areas. For example, "blue sky with clouds" will generate sky content, while "brick wall" will generate a wall background. If omitted, the AI infers appropriate content from the existing image context.
  </Accordion>

  <Accordion title="Will the expanded areas match my original image?">
    Yes, Flux Pro analyzes your image's style, lighting, color palette, and composition to generate expansions that blend seamlessly. The AI maintains visual consistency so the final image appears natural and cohesive.
  </Accordion>

  <Accordion title="What are the rate limits for Image Expand?">
    Rate limits vary by subscription tier. See [Rate Limits](/ratelimits) for current limits.
  </Accordion>

  <Accordion title="How much does Image Expand cost?">
    See the [Pricing page](/pricing) for current rates and subscription options.
  </Accordion>
</AccordionGroup>

## Best practices

* **Balanced expansion**: For best results, avoid extreme asymmetric expansions; gradual extensions maintain better visual coherence
* **Prompt specificity**: Use descriptive prompts when you need specific content in expanded areas (e.g., "ocean waves" instead of just "water")
* **Image quality**: Higher resolution input images produce better expansion results
* **Edge content**: Ensure the edges of your original image have enough context for the AI to continue naturally
* **Production integration**: Use webhooks instead of polling for scalable applications
* **Error handling**: Implement retry logic with exponential backoff for 503 errors

## Related APIs

* **[Flux 2 Pro](/api-reference/text-to-image/post-flux-2-pro)**: Generate images from text descriptions
* **[Flux Kontext Pro](/api-reference/text-to-image/flux-kontext-pro/overview)**: Text-to-image with context understanding and image guidance
* **[Image Upscaler](/api-reference/image-upscaler-creative/post-image-upscaler)**: Enhance image resolution and quality
* **[Remove Background](/api-reference/remove-background/post-beta-remove-background)**: Remove image backgrounds for compositing


# Flux Pro - Expand image
Source: https://docs.freepik.com/api-reference/image-expand/post-flux-pro

post /v1/ai/image-expand/flux-pro
This endpoint allows you to expand an image using the AI Flux Pro model. The image will be expanded based on the provided parameters.




# Seedream V4.5 - Expand image
Source: https://docs.freepik.com/api-reference/image-expand/post-seedream-v4-5

post /v1/ai/image-expand/seedream-v4-5
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.
If no prompt is provided, the model will auto-generate one based on the image content.




# Seedream V4.5 Image Expand API
Source: https://docs.freepik.com/api-reference/image-expand/seedream-v4-5-overview

Expand images beyond their original boundaries with Seedream V4.5. AI-powered outpainting with directional control up to 2048 pixels per side, auto-prompt generation, and optional seed for reproducibility.

<Card title="Seedream V4.5 integration" icon="expand">
  Powered by Seedream V4.5, this API expands images beyond their original boundaries with intelligent content generation that blends seamlessly with the original.
</Card>

Seedream V4.5 Image Expand is an AI-powered outpainting API that extends images beyond their original boundaries using the Seedream V4.5 generative model. Specify how many pixels to add on each side (left, right, top, bottom) up to 2048 pixels, and optionally provide a text prompt to guide the generated content. If no prompt is provided, the model auto-generates one based on the image content. The API produces seamless expansions that maintain visual consistency with the original image, making it ideal for adapting images to different aspect ratios or adding creative space around subjects.

### Key capabilities

* **Directional expansion**: Independently control expansion on each edge (left, right, top, bottom) from 0 to 2048 pixels
* **Auto-prompt generation**: Automatically generates a prompt from the image content when no prompt is provided
* **Prompt-guided generation**: Optional text descriptions to guide what appears in expanded areas
* **Seamless blending**: AI-generated content matches the style, lighting, and composition of the original image
* **Reproducible results**: Optional seed parameter (0-2147483647) for consistent output across requests
* **Flexible input**: Accepts HTTPS URLs or base64-encoded images (max 10MB)
* **Async processing**: Webhook notifications or polling for task completion

### Use cases

* **Social media adaptation**: Convert landscape images to portrait format (or vice versa) for different platforms
* **Print production**: Add bleed area or extend backgrounds for large-format printing
* **Design workflows**: Create additional canvas space for text overlays, logos, or design elements
* **Photography enhancement**: Extend cropped photos to recover lost composition
* **E-commerce**: Expand product images to fit standardized dimensions
* **Marketing materials**: Adapt hero images to various banner sizes and aspect ratios

### Expand images with Seedream V4.5

Submit an image with expansion parameters to extend it in any direction. The service returns a task ID for async polling or webhook notification.

<div>
  <Columns>
    <Card title="POST /v1/ai/image-expand/seedream-v4-5" icon="expand" href="/api-reference/image-expand/post-seedream-v4-5">
      Create a new image expansion task
    </Card>

    <Card title="GET /v1/ai/image-expand/seedream-v4-5" icon="list" href="/api-reference/image-expand/get-seedream-v4-5">
      List all Seedream V4.5 image expansion tasks
    </Card>

    <Card title="GET /v1/ai/image-expand/seedream-v4-5/{task-id}" icon="magnifying-glass" href="/api-reference/image-expand/get-seedream-v4-5-task">
      Get task status and results by ID
    </Card>
  </Columns>
</div>

### Parameters

| Parameter     | Type      | Required | Default        | Description                                                                                                              |
| ------------- | --------- | -------- | -------------- | ------------------------------------------------------------------------------------------------------------------------ |
| `image`       | `string`  | Yes      | -              | Image to expand. Accepts an HTTPS URL or a base64-encoded image (max 10MB)                                               |
| `left`        | `integer` | Yes      | -              | Pixels to expand on the left side (0-2048)                                                                               |
| `right`       | `integer` | Yes      | -              | Pixels to expand on the right side (0-2048)                                                                              |
| `top`         | `integer` | Yes      | -              | Pixels to expand on the top side (0-2048)                                                                                |
| `bottom`      | `integer` | Yes      | -              | Pixels to expand on the bottom side (0-2048)                                                                             |
| `prompt`      | `string`  | No       | auto-generated | Text prompt describing the desired expanded content. If not provided, the AI auto-generates a prompt based on the image. |
| `seed`        | `integer` | No       | random         | Seed for reproducibility (0-2147483647)                                                                                  |
| `webhook_url` | `string`  | No       | -              | URL for task completion notification                                                                                     |

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is Seedream V4.5 Image Expand and how does it work?">
    Seedream V4.5 Image Expand is an AI-powered outpainting API that extends images beyond their original boundaries. You submit an image (URL or base64) with pixel expansion values for each edge (left, right, top, bottom), receive a task ID immediately, then poll for results or receive a webhook notification when processing completes. The API generates new content that seamlessly blends with the original image.
  </Accordion>

  <Accordion title="How much can I expand an image?">
    You can expand up to 2048 pixels on each edge (left, right, top, bottom) independently. All four directional parameters (left, right, top, bottom) are required. Set any edge to 0 if you do not want to expand in that direction.
  </Accordion>

  <Accordion title="What happens if I do not provide a prompt?">
    If no prompt is provided, the Seedream V4.5 model automatically generates a prompt based on the image content. This auto-prompt feature analyzes the existing image and produces contextually appropriate content for the expanded areas.
  </Accordion>

  <Accordion title="What image formats are supported?">
    The API accepts HTTPS URLs or base64-encoded images up to 10MB. Common formats like JPEG, PNG, and WebP are supported. The output is returned as a downloadable image URL.
  </Accordion>

  <Accordion title="Can I reproduce the same expansion result?">
    Yes. Use the `seed` parameter with the same value (0-2147483647) across requests to generate reproducible results. Combined with identical images, expansion values, and prompts, you will get consistent outputs.
  </Accordion>

  <Accordion title="What are the rate limits for Seedream V4.5 Image Expand?">
    Rate limits vary by subscription tier. See [Rate Limits](/ratelimits) for current limits.
  </Accordion>

  <Accordion title="How much does Seedream V4.5 Image Expand cost?">
    See the [Pricing page](/pricing) for current rates and subscription options.
  </Accordion>
</AccordionGroup>

## Best practices

* **Balanced expansion**: For best results, avoid extreme asymmetric expansions; gradual extensions maintain better visual coherence
* **Prompt specificity**: Use descriptive prompts when you need specific content in expanded areas (e.g., "sunset sky with orange clouds" instead of just "sky")
* **Auto-prompt for natural results**: Omit the prompt parameter to let the model analyze the image and generate contextually appropriate content
* **Image quality**: Higher resolution input images produce better expansion results
* **Seed for consistency**: Use the same seed value when you need reproducible results across multiple API calls
* **Production integration**: Use webhooks instead of polling for scalable applications
* **Error handling**: Implement retry logic with exponential backoff for 503 errors

## Related APIs

* **[Flux Pro Image Expand](/api-reference/image-expand/overview)**: Alternative image expansion API powered by Flux Pro
* **[Ideogram Image Expand](/api-reference/image-expand/ideogram/overview)**: Alternative image expansion API powered by Ideogram
* **[Image Upscaler](/api-reference/image-upscaler-creative/post-image-upscaler)**: Enhance image resolution and quality
* **[Remove Background](/api-reference/remove-background/post-beta-remove-background)**: Remove image backgrounds for compositing


# Relight - Get task status
Source: https://docs.freepik.com/api-reference/image-relight/get-image-relight

get /v1/ai/image-relight/{task-id}
Get the status of the relight task



# Relight - List tasks
Source: https://docs.freepik.com/api-reference/image-relight/get-image-relight-task

get /v1/ai/image-relight
Get the status of all relight tasks



# Overview
Source: https://docs.freepik.com/api-reference/image-relight/image-relight



<Frame>
  <div>
    <img alt="Original scene" />

    <img alt="Night scene" />

    <img alt="Snowy landscape" />

    <img alt="Hell scene" />
  </div>
</Frame>

<div>
  <Card title="Freepik API uses Magnific.ai technology, now available as a comprehensive API service." icon="circle-exclamation" />
</div>

Image Relight allows you to change the entire lighting of a scene and, optionally, the background using:

1. A prompt
2. A reference image
3. A light map

This tool can simulate different lighting scenarios, enhance details, and create artistic effects. Our API lets you transform your images with custom prompts and fine-tuned parameters for impressive results.

Image Relight uses Magnific.ai technology, now available as a comprehensive API service.

### Use Cases

The Image Relight can be applied to a wide range of image types and industries, including:

* Portraits: Change lighting to enhance facial features
* Product photography: Adjust lighting for better presentation
* Architectural renderings: Simulate different times of day
* Film stills: Create dramatic lighting effects
* Graphic design: Add creative lighting to designs
* Nature photography: Enhance natural light conditions

### Selecting Light Transfer Method

Choose one of these three ways to transfer light in Image Relight:

1. **Prompt** Describe the desired lighting using text. Specify characteristics like color, time of day, type and shape of light.
   Example: "A sunlit forest clearing at golden hour" or "Under the water"

2. **Reference Image** Provide an image to transfer lighting from. Image Relight will replicate the light, colors, and shadows from this reference.

3. **Lightmap** Create custom lighting with your own lightmap image:
   * Black represents absence of light
   * Lighter colors (including white) indicate presence, color, and shape of light sources

<div>
  <Columns>
    <Card title="POST /v1/ai/image-relight" icon="wand-magic-sparkles" href="/api-reference/image-relight/post-image-relight">
      Relight an image using AI
    </Card>

    <Card title="GET /v1/ai/image-relight/{task-id}" icon="code" href="/api-reference/image-relight/get-image-relight">
      Get the status of a relighting task
    </Card>

    <Card title="GET /v1/ai/image-relight" icon="code" href="/api-reference/image-relight/get-image-relight-task">
      Get the status of all relighting tasks
    </Card>
  </Columns>
</div>

### Image Input Best Practices

For maximum quality results, how you send your image matters:

| Action                                     | Quality Impact             |
| ------------------------------------------ | -------------------------- |
| Send URL of original image                 | ✅ Maximum quality          |
| Send base64 of original file read directly | ✅ Maximum quality          |
| Use `canvas.toDataURL('image/jpeg')`       | ❌ \~8% quality loss        |
| Use `canvas.toDataURL('image/jpeg', 0.8)`  | ❌ \~20% quality loss       |
| Resize image before sending                | ❌ Significant quality loss |
| Convert PNG → JPEG before sending          | ❌ Quality loss             |

<Tip>
  **Recommended:** Send the original image via URL whenever possible. This ensures the AI receives the highest quality input, which directly impacts output quality.
</Tip>

### Frequently Asked Questions

<AccordionGroup>
  <Accordion title="Is this the same technology as Magnific.ai?">
    Yes! Magnific.ai is part of Freepik and we are happy to offer the same technology in an API service. If you tried Magnific.ai before, you will get the same technology and its future updates.
  </Accordion>

  <Accordion title="How much does the image relight cost?">
    The cost per image relight is a fixed cost of €0.10 per operation. This ensures that you have complete transparency and control over your usage.
  </Accordion>
</AccordionGroup>


# Relight - Adjust image lighting
Source: https://docs.freepik.com/api-reference/image-relight/post-image-relight

post /v1/ai/image-relight
Relight an image using AI. This endpoint accepts a variety of parameters to customize the generated images.

## Important

Upscaler endpoints are only available for premium API users. You can upgrade your account [here](https://www.freepik.com/developers/dashboard/billing).

## Request


# Style Transfer - List tasks
Source: https://docs.freepik.com/api-reference/image-style-transfer/get-image-style-transfer

get /v1/ai/image-style-transfer
Get the status of all Style Transfer tasks



# Style Transfer - Get task status
Source: https://docs.freepik.com/api-reference/image-style-transfer/get-image-style-transfer-task

get /v1/ai/image-style-transfer/{task-id}
Get the status of the Style Transfer task



# Overview
Source: https://docs.freepik.com/api-reference/image-style-transfer/image-styletransfer



<Frame>
  <div>
    <img alt="Original image" />

    <img alt="Black and white" />

    <img alt="Wild nature" />

    <img alt="Wood and brick" />
  </div>
</Frame>

<div>
  <Card title="Freepik API uses Magnific.ai technology, now available as a comprehensive API service." icon="circle-exclamation" />
</div>

Image Style Transfer is a powerful AI-driven tool that allows you to transform any image by applying various artistic styles. This technology goes beyond simple filters, enabling you to control the amount of style transferred and maintain structural integrity. With our API, you can:

1. Apply predefined artistic styles
2. Use custom images as style references
3. Fine-tune the style transfer process with advanced parameters
4. Transform images while preserving important details
5. Combine style transfer with upscaling for high-resolution results

Whether you're a professional artist, game developer, or just looking to have fun with your photos, Image Style Transfer opens up a world of creative possibilities.

### Use Cases

Image Style Transfer can be applied to various industries and creative projects, some examples are:

* **Video Game Development**: Transform concept art and create stylized game assets
* **Film and VFX**: Create dramatic lighting effects and stylized scenes
* **Interior Design**: Visualize room makeovers with different design styles
* **3D Rendering**: Texturize and light 3D renders using reference images
* **Sketch Transformation**: Convert sketches into detailed, styled artwork

### Key Features

* **Control Over Style Intensity**: Adjust the strength of the style transfer to find the perfect balance between the original image and the new style.
* **Structure Preservation**: Maintain important details and structural elements of the original image while applying new styles.
* **Prompt-Guided Transformations**: Use text prompts to further refine and direct the style transfer process.
* **Multiple Style Engines**: Choose from various AI engines optimized for different types of style transfers.

By leveraging the power of AI, Image Style Transfer enables creators to push the boundaries of visual art and design, saving hours of manual work and opening up new realms of creative possibility.

<div>
  <Columns>
    <Card title="POST /v1/ai/image-style-transfer" icon="code" href="/api-reference/image-style-transfer/post-image-style-transfer">
      API Reference: Image Style Transfer
    </Card>
  </Columns>
</div>

### Image Input Best Practices

For maximum quality results, how you send your image matters:

| Action                                     | Quality Impact             |
| ------------------------------------------ | -------------------------- |
| Send URL of original image                 | ✅ Maximum quality          |
| Send base64 of original file read directly | ✅ Maximum quality          |
| Use `canvas.toDataURL('image/jpeg')`       | ❌ \~8% quality loss        |
| Use `canvas.toDataURL('image/jpeg', 0.8)`  | ❌ \~20% quality loss       |
| Resize image before sending                | ❌ Significant quality loss |
| Convert PNG → JPEG before sending          | ❌ Quality loss             |

<Tip>
  **Recommended:** Send the original image via URL whenever possible. This ensures the AI receives the highest quality input, which directly impacts output quality.
</Tip>

### Frequently Asked Questions

<AccordionGroup>
  <Accordion title="Is this the same technology as Magnific.ai?">
    Yes! Magnific.ai is part of Freepik and we are happy to offer the same technology in an API service. If you tried Magnific.ai before, you will get the same technology and its future updates.
  </Accordion>

  <Accordion title="How much does the image style transfer cost?">
    The cost per image style transfer is a fixed cost of €0.10 per operation. This ensures that you have complete transparency and control over your usage.
  </Accordion>
</AccordionGroup>


# Style Transfer - Transform image style
Source: https://docs.freepik.com/api-reference/image-style-transfer/post-image-style-transfer

post /v1/ai/image-style-transfer



# Image to Prompt - List tasks
Source: https://docs.freepik.com/api-reference/image-to-prompt/get-image-to-prompt

get /v1/ai/image-to-prompt
Get the status of all image-to-prompt tasks



# Image to Prompt - Get task status
Source: https://docs.freepik.com/api-reference/image-to-prompt/get-{task-id}-by-id

get /v1/ai/image-to-prompt/{task-id}
Get the status of one image-to-prompt task



# Image to Prompt - AI Image Analysis API | Freepik API
Source: https://docs.freepik.com/api-reference/image-to-prompt/overview

Generate descriptive prompts from images with Image to Prompt API. Extract detailed text descriptions for AI workflows. Perfect for prompt engineering and image cataloging.

<Card title="AI-powered image analysis" icon="comment-dots">
  Analyze any image and generate detailed text prompts that describe its content, style, and composition.
</Card>

Image to Prompt is an AI-powered API that analyzes images and generates descriptive text prompts. Submit any image and receive a detailed text description suitable for use with AI image generation models. The API extracts visual elements, artistic styles, compositions, and contextual details to create prompts that can reproduce or inspire similar images.

### Key capabilities

* **Automatic image analysis**: AI extracts subjects, objects, colors, lighting, and composition from images
* **Prompt-ready output**: Generated descriptions formatted for direct use with text-to-image models
* **Flexible input**: Accepts images via URL or base64-encoded string
* **Style detection**: Identifies artistic styles, photography techniques, and visual aesthetics
* **Detail extraction**: Captures fine details including textures, materials, and environmental elements
* **Multi-format support**: Works with common image formats (JPEG, PNG, WebP)
* **Async processing**: Webhook notifications or polling for task completion

### Use cases

* **Prompt engineering**: Reverse-engineer prompts from reference images to recreate similar styles
* **Image cataloging**: Generate searchable text descriptions for image libraries
* **AI workflow automation**: Bridge image-to-text pipelines for automated content creation
* **Style transfer preparation**: Extract style descriptions for consistent AI image generation
* **Content moderation**: Generate text descriptions for image review and classification
* **Accessibility**: Create alt-text descriptions for images in web applications

### Generate prompts with Image to Prompt

Submit an image via URL or base64-encoded string. The service returns a task ID for async polling or webhook notification.

<div>
  <Columns>
    <Card title="POST /v1/ai/image-to-prompt" icon="comment-dots" href="/api-reference/image-to-prompt/post-image-to-prompt">
      Create a new image analysis task
    </Card>

    <Card title="GET /v1/ai/image-to-prompt" icon="list" href="/api-reference/image-to-prompt/get-image-to-prompt">
      List all image-to-prompt tasks
    </Card>

    <Card title="GET /v1/ai/image-to-prompt/{task-id}" icon="magnifying-glass" href="/api-reference/image-to-prompt/get-{task-id}-by-id">
      Get task status and results by ID
    </Card>
  </Columns>
</div>

### Parameters

| Parameter     | Type     | Required | Default | Description                                                                                         |
| ------------- | -------- | -------- | ------- | --------------------------------------------------------------------------------------------------- |
| `image`       | `string` | Yes      | -       | Input image for analysis. Accepts URL or base64-encoded string (e.g., `data:image/jpeg;base64,...`) |
| `webhook_url` | `string` | No       | -       | URL for task completion notification                                                                |

### Response

When the task completes successfully, the response includes:

| Field       | Type     | Description                                                     |
| ----------- | -------- | --------------------------------------------------------------- |
| `task_id`   | `string` | Unique identifier for the task (UUID format)                    |
| `status`    | `string` | Task status: `CREATED`, `IN_PROGRESS`, `COMPLETED`, or `FAILED` |
| `generated` | `array`  | Array containing the generated prompt text                      |

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is Image to Prompt and how does it work?">
    Image to Prompt is an AI-powered API that analyzes images and generates text descriptions suitable for AI image generation. You submit an image (via URL or base64), receive a task ID immediately, then poll for results or receive a webhook notification. The output is a detailed text prompt describing the image content, style, and composition.
  </Accordion>

  <Accordion title="What image formats does Image to Prompt support?">
    Image to Prompt accepts common image formats including JPEG, PNG, and WebP. Images can be provided as publicly accessible URLs or as base64-encoded strings with the appropriate data URI prefix (e.g., `data:image/jpeg;base64,...`).
  </Accordion>

  <Accordion title="How detailed are the generated prompts?">
    The generated prompts capture multiple aspects of the image including subjects, objects, colors, lighting, composition, artistic style, and fine details like textures and materials. The descriptions are formatted for direct use with AI image generation models like Flux, Seedream, or Mystic.
  </Accordion>

  <Accordion title="Can I use the generated prompts with other AI image generators?">
    Yes, the prompts generated by Image to Prompt are designed to work with any text-to-image AI model. Use them directly with Freepik API models like [Flux](/api-reference/text-to-image/flux-kontext-pro/overview), [Seedream](/api-reference/text-to-image/seedream-4/overview), or [Mystic](/api-reference/mystic/mystic), or with external image generation services.
  </Accordion>

  <Accordion title="How long does image analysis take?">
    Processing time varies based on image complexity and current system load. Typical analysis completes within a few seconds. For production workflows, use webhooks instead of polling to receive instant notifications when processing completes.
  </Accordion>

  <Accordion title="What are the rate limits for Image to Prompt?">
    Rate limits vary by subscription tier. See [Rate Limits](/ratelimits) for current limits.
  </Accordion>

  <Accordion title="How much does Image to Prompt cost?">
    See the [Pricing page](/pricing) for current rates and subscription options.
  </Accordion>
</AccordionGroup>

## Best practices

* **Image quality**: Higher resolution images with clear subjects produce more detailed and accurate prompts
* **URL accessibility**: Ensure image URLs are publicly accessible without authentication
* **Base64 encoding**: Include the proper data URI prefix when using base64 (e.g., `data:image/jpeg;base64,`)
* **Production integration**: Use webhooks instead of polling for scalable applications
* **Prompt refinement**: Use generated prompts as starting points and refine them for specific use cases
* **Error handling**: Implement retry logic with exponential backoff for 503 errors

## Related APIs

* **[Improve Prompt](/api-reference/improve-prompt/post-improve-prompt)**: Enhance and refine text prompts for better AI generation results
* **[Flux Kontext Pro](/api-reference/text-to-image/flux-kontext-pro/overview)**: Generate images from text prompts with advanced context understanding
* **[Seedream 4](/api-reference/text-to-image/seedream-4/overview)**: High-quality text-to-image generation with detailed prompt support
* **[Mystic](/api-reference/mystic/mystic)**: Freepik's flagship image generation model with style customization


# Image to Prompt - Generate prompt
Source: https://docs.freepik.com/api-reference/image-to-prompt/post-image-to-prompt

post /v1/ai/image-to-prompt
Generate descriptive prompts from input images using AI analysis



# Get all Veo 3.1 I2V tasks
Source: https://docs.freepik.com/api-reference/image-to-video/get-veo-3-1

get /v1/ai/image-to-video/veo-3-1



# Get all Veo 3.1 I2V Fast tasks
Source: https://docs.freepik.com/api-reference/image-to-video/get-veo-3-1-fast

get /v1/ai/image-to-video/veo-3-1-fast



# Get Veo 3.1 I2V Fast task by ID
Source: https://docs.freepik.com/api-reference/image-to-video/get-veo-3-1-fast-task

get /v1/ai/image-to-video/veo-3-1-fast/{task-id}



# Get Veo 3.1 I2V task by ID
Source: https://docs.freepik.com/api-reference/image-to-video/get-veo-3-1-task

get /v1/ai/image-to-video/veo-3-1/{task-id}



# Kling Elements Pro - List tasks
Source: https://docs.freepik.com/api-reference/image-to-video/kling-elements-pro/get-kling-elements-pro

get /v1/ai/image-to-video/kling-elements-pro
Get the list of the kling-elements-pro tasks



# Kling Elements - Get task status
Source: https://docs.freepik.com/api-reference/image-to-video/kling-elements-pro/get-kling-elements-pro-task

get /v1/ai/image-to-video/kling-elements/{task-id}
Get the status of the kling-elements task



# Kling Elements Pro - Create video from image
Source: https://docs.freepik.com/api-reference/image-to-video/kling-elements-pro/post-kling-elements-pro

post /v1/ai/image-to-video/kling-elements-pro
Generate a video from an image using the Kling Elements Pro model.

## Important

The service allows up to 3 concurrent requests per user.


# Kling Elements Standard - List tasks
Source: https://docs.freepik.com/api-reference/image-to-video/kling-elements-std/get-kling-elements-std

get /v1/ai/image-to-video/kling-elements-std
Get the list of the kling-elements-std tasks



# Kling Elements - Get task status
Source: https://docs.freepik.com/api-reference/image-to-video/kling-elements-std/get-kling-elements-std-task

get /v1/ai/image-to-video/kling-elements/{task-id}
Get the status of the kling-elements task



# Kling Elements Standard - Create video from image
Source: https://docs.freepik.com/api-reference/image-to-video/kling-elements-std/post-kling-elements-std

post /v1/ai/image-to-video/kling-elements-std
Generate a video from an image using the Kling Elements Std model.

## Important

The service allows up to 3 concurrent requests per user.


# Kling O1 Pro - Create video from image
Source: https://docs.freepik.com/api-reference/image-to-video/kling-o1-pro

post /v1/ai/image-to-video/kling-o1-pro



# Kling O1 Pro - Create video with reference
Source: https://docs.freepik.com/api-reference/image-to-video/kling-o1-pro-video-reference

post /v1/ai/image-to-video/kling-o1-pro-video-reference



# Kling O1 Standard - Create video from image
Source: https://docs.freepik.com/api-reference/image-to-video/kling-o1-std

post /v1/ai/image-to-video/kling-o1-std



# Kling O1 Standard - Create video with reference
Source: https://docs.freepik.com/api-reference/image-to-video/kling-o1-std-video-reference

post /v1/ai/image-to-video/kling-o1-std-video-reference



# Kling O1 - List tasks
Source: https://docs.freepik.com/api-reference/image-to-video/kling-o1-tasks

get /v1/ai/image-to-video/kling-o1
Get the list of the kling-o1 tasks



# Kling O1 – Image-to-Video API
Source: https://docs.freepik.com/api-reference/image-to-video/kling-o1/overview

Create cinematic videos with first-to-last frame interpolation using Kling O1. Smooth transitions, reference image support, and Pro or Standard quality modes for 5 or 10 second outputs.

<Card title="Kling O1 integration" icon="video">
  Generate smooth video sequences using first frame and last frame interpolation, with optional reference images for character and style consistency.
</Card>

Kling O1 is an image-to-video API that creates cinematic video sequences by interpolating between a first frame and last frame. It delivers smooth transitions with controlled start and end points, suitable for creative professionals and automated workflows. Choose between Pro quality for premium results or Standard for faster, cost-effective generation.

### Key capabilities

* **Frame interpolation**: Generate smooth transitions between first and last frame images
* **Reference image support**: Maintain character and style consistency with up to 7 reference images
* **Dual quality modes**: Pro for professional-grade output, Standard for efficient generation
* **Flexible durations**: 5-second or 10-second video outputs
* **Multiple aspect ratios**: `16:9` (widescreen), `9:16` (vertical), `1:1` (square)
* **Prompt guidance**: Text descriptions up to 2500 characters to guide motion and style
* **Async processing**: Webhook notifications or polling for task completion

### Use cases

* **Film and animation**: Create smooth scene transitions and animated sequences
* **Marketing content**: Generate cinematic product reveals and brand videos
* **Social media**: Produce vertical and square videos optimized for Instagram, TikTok, and YouTube Shorts
* **E-commerce**: Animate static product images with controlled motion
* **Storytelling**: Build narrative sequences with consistent character appearance
* **Motion design**: Create abstract transitions and visual effects

### API endpoints

Generate videos by submitting a request to one of the Kling O1 endpoints. The service returns a task ID for async polling or webhook notification.

<div>
  <Columns>
    <Card title="POST kling-o1-pro" icon="video" href="/api-reference/image-to-video/kling-o1-pro">
      Pro quality video from first/last frame
    </Card>

    <Card title="POST kling-o1-std" icon="video" href="/api-reference/image-to-video/kling-o1-std">
      Standard quality video from first/last frame
    </Card>

    <Card title="POST kling-o1-pro-video-reference" icon="video" href="/api-reference/image-to-video/kling-o1-pro-video-reference">
      Pro quality with reference images
    </Card>

    <Card title="POST kling-o1-std-video-reference" icon="video" href="/api-reference/image-to-video/kling-o1-std-video-reference">
      Standard quality with reference images
    </Card>

    <Card title="GET kling-o1" icon="list" href="/api-reference/image-to-video/kling-o1-tasks">
      List all Kling O1 tasks
    </Card>

    <Card title="GET kling-o1/{task-id}" icon="magnifying-glass" href="/api-reference/kling-o1/task-by-id">
      Get task status by ID
    </Card>
  </Columns>
</div>

### Parameters

#### Image-to-Video (first/last frame)

| Parameter      | Type      | Required | Default | Description                                                     |
| -------------- | --------- | -------- | ------- | --------------------------------------------------------------- |
| `first_frame`  | `string`  | No\*     | -       | Starting image (URL or Base64). Min 300x300px, max 10MB         |
| `last_frame`   | `string`  | No\*     | -       | Ending image (URL or Base64). Same requirements as first\_frame |
| `prompt`       | `string`  | No       | -       | Motion description up to 2500 characters                        |
| `aspect_ratio` | `string`  | No       | `16:9`  | Video ratio: `16:9`, `9:16`, or `1:1`                           |
| `duration`     | `integer` | No       | `5`     | Video length: `5` or `10` seconds                               |
| `webhook_url`  | `string`  | No       | -       | URL for completion notification                                 |

\*At least one frame (first\_frame or last\_frame) is required.

#### Video Reference

| Parameter          | Type      | Required | Default | Description                              |
| ------------------ | --------- | -------- | ------- | ---------------------------------------- |
| `prompt`           | `string`  | Yes      | -       | Video description up to 2500 characters  |
| `reference_images` | `array`   | No       | -       | Up to 7 reference images for consistency |
| `aspect_ratio`     | `string`  | No       | `16:9`  | Video ratio: `16:9`, `9:16`, or `1:1`    |
| `duration`         | `integer` | No       | `5`     | Video length: `5` or `10` seconds        |
| `webhook_url`      | `string`  | No       | -       | URL for completion notification          |

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is Kling O1 and how does it work?">
    Kling O1 is an image-to-video model that generates smooth video sequences through frame interpolation. You provide a first frame, last frame, or both, and the model creates a cinematic transition between them. Optionally, add a text prompt to guide the motion style. Processing is asynchronous: submit a request, receive a task ID, then poll for results or receive a webhook notification.
  </Accordion>

  <Accordion title="What is the difference between Pro and Standard modes?">
    Pro mode generates higher-fidelity videos with better motion quality, detail retention, and temporal consistency. Standard mode offers faster processing at lower cost, suitable for prototyping or high-volume use cases. Both support the same parameters and output formats.
  </Accordion>

  <Accordion title="What image formats does Kling O1 support?">
    Kling O1 accepts JPEG and PNG images via URL (publicly accessible) or Base64 encoding. Requirements: minimum resolution 300x300px, maximum file size 10MB, aspect ratio between 1:2.5 and 2.5:1.
  </Accordion>

  <Accordion title="How do reference images work?">
    The video reference endpoints accept up to 7 reference images that help maintain character and style consistency. Use these when you need the same subject to appear consistently across multiple video generations or shots.
  </Accordion>

  <Accordion title="How long does Kling O1 take to process?">
    Processing time varies based on duration and mode. Typical generation: 30-120 seconds for 5-second videos, longer for 10-second outputs. Pro mode takes longer than Standard. Use webhooks for production workflows instead of polling.
  </Accordion>

  <Accordion title="What are the rate limits for Kling O1?">
    Rate limits depend on your subscription tier. See the [Rate Limits](/ratelimits) page for current limits by plan.
  </Accordion>

  <Accordion title="How much does Kling O1 cost?">
    Pricing varies by mode (Pro vs Standard) and duration. See the [Pricing page](/pricing) for current rates and subscription options.
  </Accordion>
</AccordionGroup>

## Best practices

* **Image quality**: Use high-resolution images (1080p or higher) with clear subjects and balanced lighting for best results
* **Frame similarity**: When using both first and last frames, ensure similar compositions for smoother interpolation
* **Prompt specificity**: Describe the desired motion clearly (camera movement, subject action, mood) rather than just the scene
* **Reference consistency**: For video reference mode, use images with similar lighting and style for better character consistency
* **Production integration**: Implement webhooks instead of polling for scalable applications
* **Error handling**: Implement retry logic with exponential backoff for 503 (service unavailable) responses

## Related APIs

* **[Kling 2.6](/api-reference/image-to-video/kling-v2-6-pro)**: Latest Kling model with motion control capabilities
* **[Kling 2.5 Turbo Pro](/api-reference/image-to-video/kling-v2.5-pro/overview)**: Fast cinematic generation with 5-10 second outputs
* **[Kling 2.1 Pro](/api-reference/image-to-video/kling-v2.1-pro/overview)**: High-fidelity motion with strong temporal consistency
* **[Kling Elements](/api-reference/image-to-video/kling-elements-pro/post-kling-elements-pro)**: Element-based video generation for specific use cases


# Kling 1.6 Pro - List tasks
Source: https://docs.freepik.com/api-reference/image-to-video/kling-pro/get-kling-pro

get /v1/ai/image-to-video/kling-pro
Get the list of the kling-pro tasks



# Kling 1.6 - Get task status
Source: https://docs.freepik.com/api-reference/image-to-video/kling-pro/get-kling-pro-task

get /v1/ai/image-to-video/kling/{task-id}
Get the status of the kling task



# Kling 1.6 Pro - Create video from image
Source: https://docs.freepik.com/api-reference/image-to-video/kling-pro/post-kling-pro

post /v1/ai/image-to-video/kling-pro
Generate a video from an image using the Kling 1.6 Pro model.

## Important

The service allows up to 3 concurrent requests per user.


# Kling 1.6 Pro - List tasks
Source: https://docs.freepik.com/api-reference/image-to-video/kling-std/get-kling-std

get /v1/ai/image-to-video/kling-std
Get the list of the kling-pro tasks



# Kling 1.6 - Get task status
Source: https://docs.freepik.com/api-reference/image-to-video/kling-std/get-kling-std-task

get /v1/ai/image-to-video/kling/{task-id}
Get the status of the kling task



# Kling 1.6 Standard - Create video from image
Source: https://docs.freepik.com/api-reference/image-to-video/kling-std/post-kling-std

post /v1/ai/image-to-video/kling-std
Generate a video from an image using the Kling 1.6 Std model.

## Important

The service allows up to 3 concurrent requests per user.


# Kling 2.6 Pro - Create video from text or image
Source: https://docs.freepik.com/api-reference/image-to-video/kling-v2-6-pro

post /v1/ai/image-to-video/kling-v2-6-pro



# Kling 2.6 Pro - List tasks
Source: https://docs.freepik.com/api-reference/image-to-video/kling-v2-6-pro-tasks

get /v1/ai/image-to-video/kling-v2-6



# Kling 2.6 Pro - Get task status
Source: https://docs.freepik.com/api-reference/image-to-video/kling-v2-6/task-by-id

get /v1/ai/image-to-video/kling-v2-6/{task-id}



# Kling 2.1 Standard - List tasks
Source: https://docs.freepik.com/api-reference/image-to-video/kling-v2.1-master/get-kling-v2-1-master

get /v1/ai/image-to-video/kling-v2-1-master
Get the list of the kling-v2-1-std tasks



# Kling 2.1 Master - Get task status
Source: https://docs.freepik.com/api-reference/image-to-video/kling-v2.1-master/get-kling-v2-1-master-task

get /v1/ai/image-to-video/kling-v2-1-master/{task-id}
Get the status of the kling-v2-1-master task



# Kling 2.1 Master - Create video from image
Source: https://docs.freepik.com/api-reference/image-to-video/kling-v2.1-master/post-kling-v2-1-master

post /v1/ai/image-to-video/kling-v2-1-master
Generate a video from an image using the Kling 2.1 Master model.



# Kling 2.1 Pro - List tasks
Source: https://docs.freepik.com/api-reference/image-to-video/kling-v2.1-pro/get-kling-v2-1-pro

get /v1/ai/image-to-video/kling-v2-1-pro
Get the list of the kling-v2-1-pro tasks



# Kling 2.1 - Get task status
Source: https://docs.freepik.com/api-reference/image-to-video/kling-v2.1-pro/get-kling-v2-1-pro-task

get /v1/ai/image-to-video/kling-v2-1/{task-id}
Get the status of the kling-v2-1 task



# Kling Pro v2.1 – Image‑to‑Video API
Source: https://docs.freepik.com/api-reference/image-to-video/kling-v2.1-pro/overview

Advanced image‑to‑video generation from a single image with higher fidelity, richer motion control, and strong temporal consistency for premium results.

<Frame>
  <video>
    <source type="video/mp4" />

    Your browser does not support the video tag.
  </video>
</Frame>

Kling Pro v2.1 builds on the stability of the Std variant with enhanced fidelity and more expressive motion. It delivers higher detail retention, smoother transitions, and stronger control over subject and camera movement—ideal for premium marketing assets, cinematic previews, and design showcases. Prefer general‑purpose results? See the <a href="/api-reference/image-to-video/kling-v2.1-std/overview">Kling Std v2.1</a> overview.

### Key capabilities

* High‑fidelity motion and detail from a single image
* Strong temporal consistency with minimal flicker
* Improved texture, edges, and lighting continuity
* Better retention of fine details on faces, products, and environments

### Use cases

* Premium product spots: dynamic hero shots with refined motion
* Cinematic promos: richer parallax and lighting transitions
* High-end social posts and ads: crisp detail and smooth movement
* Design/3D previews: bring still renders to life with controlled motion
* Brand storytelling: subtle camera work with consistent identity

### Generate a video with Kling Pro v2.1

Create an image-to-video task using the Kling v2.1 Pro model.

<div>
  <Columns>
    <Card title="POST /v1/ai/image-to-video/kling-v2-1-pro" icon="video" href="/api-reference/image-to-video/kling-v2.1-pro/post-kling-v2-1-pro">
      Generate video from an image
    </Card>

    <Card title="GET /v1/ai/image-to-video/kling-v2-1-pro" icon="list" href="/api-reference/image-to-video/kling-v2.1-pro/get-kling-v2-1-pro">
      List image-to-video tasks
    </Card>

    <Card title="GET /v1/ai/image-to-video/kling-v2-1/{task-id}" icon="magnifying-glass" href="/api-reference/image-to-video/kling-v2.1-pro/get-kling-v2-1-pro-task">
      Check task status
    </Card>
  </Columns>
</div>

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What input works best for Kling Pro v2.1?">
    Use high‑resolution images with clear subjects and balanced lighting. PNG/JPEG are recommended. Avoid heavy compression and noisy inputs to maximize detail retention.
  </Accordion>

  <Accordion title="How long are the generated videos?">
    Duration depends on API parameters. Kling Pro v2.1 is optimized for short clips suitable for premium previews, ads, and social formats.
  </Accordion>

  <Accordion title="Does Kling Pro v2.1 support camera movements or subject motion?">
    Yes. Pro supports expressive motion with strong temporal stability. Complex motion may require careful prompting, masks, or parameter tuning.
  </Accordion>

  <Accordion title="What’s the difference between Kling Std, Pro, and Master?">
    Std focuses on dependable, general‑purpose results. Pro increases fidelity and motion expressiveness. Master targets top‑tier quality and advanced control for cinematic applications.
  </Accordion>
</AccordionGroup>

## Best practices for image‑to‑video (Pro)

* Use clean, well‑lit images at sufficient resolution to capture micro‑detail.
* Keep the main subject clear of clutter; plan composition for parallax.
* Start with subtle motion; iterate to increase complexity and camera movement.
* Protect brand/face detail—avoid occlusions and extreme crops.
* Validate at target aspect ratios/durations and compress for delivery platforms.


# Kling 2.1 Pro - Create video from image
Source: https://docs.freepik.com/api-reference/image-to-video/kling-v2.1-pro/post-kling-v2-1-pro

post /v1/ai/image-to-video/kling-v2-1-pro
Generate a video from an image using the Kling 2.1 Pro model.



# Kling 2.1 Standard - List tasks
Source: https://docs.freepik.com/api-reference/image-to-video/kling-v2.1-std/get-kling-v2-1-std

get /v1/ai/image-to-video/kling-v2-1-std
Get the list of the kling-v2-1-std tasks



# Kling 2.1 - Get task status
Source: https://docs.freepik.com/api-reference/image-to-video/kling-v2.1-std/get-kling-v2-1-std-task

get /v1/ai/image-to-video/kling-v2-1/{task-id}
Get the status of the kling-v2-1 task



# Kling Std v2.1 – Image‑to‑Video API
Source: https://docs.freepik.com/api-reference/image-to-video/kling-v2.1-std/overview

Image‑to‑video generation from a single image with smooth motion and temporal consistency. Ideal for product demos, concept visualizations, and social content.

<Frame>
  <video>
    <source type="video/mp4" />

    Your browser does not support the video tag.
  </video>
</Frame>

Kling Std v2.1 is a robust image-to-video model that generates short, consistent videos from a single image. It focuses on temporal stability, smooth motion, and faithful visual detail, making it a dependable choice for product demos, concept visualizations, and social media content. Need higher fidelity and more expressive motion? Try <a href="/api-reference/image-to-video/kling-v2.1-pro/overview">Kling Pro v2.1</a>.

### Key capabilities

* Smooth, realistic motion generation from one input image
* Strong temporal consistency with minimal flicker
* Natural color and lighting preservation
* Good detail retention on faces, products, and environments

### Use cases

* Product showcases: animate angles or subtle movements from a hero image
* Marketing and social: create short video loops for ads and posts
* Concept visualization: bring static artwork or renders to life
* UI/UX motion previews: generate simple motion studies from mockups
* Educational content: illustrate processes with gentle camera moves

### Generate a video with Kling Std v2.1

Create an image-to-video task using the Kling v2.1 Standard model.

<div>
  <Columns>
    <Card title="POST /v1/ai/image-to-video/kling-v2-1-std" icon="video" href="/api-reference/image-to-video/kling-v2.1-std/post-kling-v2-1-std">
      Generate video from an image
    </Card>

    <Card title="GET /v1/ai/image-to-video/kling-v2-1-std" icon="list" href="/api-reference/image-to-video/kling-v2.1-std/get-kling-v2-1-std">
      List image-to-video tasks
    </Card>

    <Card title="GET /v1/ai/image-to-video/kling-v2-1/{task-id}" icon="magnifying-glass" href="/api-reference/image-to-video/kling-v2.1-std/get-kling-v2-1-std-task">
      Check task status
    </Card>
  </Columns>
</div>

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What input works best for Kling Std v2.1?">
    Use high-resolution images with clear subjects, clean backgrounds, and balanced lighting. JPEG/PNG are recommended. Avoid heavy compression and noisy inputs.
  </Accordion>

  <Accordion title="How long are the generated videos?">
    Video duration depends on model defaults and parameters from the API. Kling Std v2.1 is geared toward short clips ideal for previews and social formats.
  </Accordion>

  <Accordion title="Does Kling Std v2.1 support camera movements or subject motion?">
    Yes. The model can synthesize gentle camera moves and subject motion while maintaining temporal stability. Complex motion may require careful prompting and tuning.
  </Accordion>

  <Accordion title="What’s the difference between Kling Std, Pro, and Master?">
    Std focuses on reliable, general‑purpose quality with good consistency. Pro and Master variants target higher fidelity or more advanced motion control. Choose Std for dependable everyday use cases.
  </Accordion>
</AccordionGroup>

## Best practices for image‑to‑video

* Start with clean, well‑lit images at sufficient resolution.
* Keep subjects centered and avoid busy backgrounds for clearer motion focus.
* Use moderate motion expectations; evaluate results before increasing complexity.
* Ensure branding, faces, and key details are unobstructed for better consistency.
* Validate outputs at target aspect ratios and durations for your platform.


# Kling 2.1 Standard - Create video from image
Source: https://docs.freepik.com/api-reference/image-to-video/kling-v2.1-std/post-kling-v2-1-std

post /v1/ai/image-to-video/kling-v2-1-std
Generate a video from an image using the Kling 2.1 Std model.



# Kling 2.5 Pro - List tasks
Source: https://docs.freepik.com/api-reference/image-to-video/kling-v2.5-pro/get-kling-v2-5-pro

get /v1/ai/image-to-video/kling-v2-5-pro
Get the list of the kling-v2-5-pro tasks



# Kling 2.5 Pro - Get task status
Source: https://docs.freepik.com/api-reference/image-to-video/kling-v2.5-pro/get-{task-id}-by-id

get /v1/ai/image-to-video/kling-v2-5-pro/{task-id}
Get the status of the kling-v2-5-pro task



# Kling 2.5 Turbo Pro – Image‑to‑Video API
Source: https://docs.freepik.com/api-reference/image-to-video/kling-v2.5-pro/overview

Cinematic image‑to‑video from a single image with smoother motion, sharper detail, stable style/color, and faster rendering. 5s and 10s outputs.

<Frame>
  <video>
    <source type="video/webm" />
  </video>
</Frame>

Kling 2.5 Turbo Pro generates cinematic videos from a single image with dramatically improved motion quality, sharper detail, and stable style and color. It offers 5s and 10s outputs, faster rendering than previous versions, and more reliable prompt adherence—ideal for marketing assets, trailers, and high‑end social content.

### Key capabilities

* Smooth, expressive motion and professional camera work
* Sharper, cinematic imagery with improved clarity and texture
* Stable style and color; better subject consistency across frames
* Strong instruction adherence for look, tone, and motion
* Better static preservation and camera perspective response
* Improved subject understanding and finer emotional expression
* Cost‑efficient credit usage compared to earlier versions
* 5s and 10s duration options

### Use cases

* Short films, teasers, and cinematic promos
* YouTube/TikTok/Instagram videos (short‑ and long‑form)
* Product and brand videos with consistent visuals
* Educational explainers and motion studies
* Experimental art and abstract motion

<div>
  <Columns>
    <Card title="POST /v1/ai/image-to-video/kling-v2-5-pro" icon="video" href="/api-reference/image-to-video/kling-v2.5-pro/post-kling-v2-5-pro">
      Generate video from an image
    </Card>

    <Card title="GET /v1/ai/image-to-video/kling-v2-5-pro/{task-id}" icon="magnifying-glass" href="/api-reference/image-to-video/kling-v2.5-pro/get-{task-id}-by-id">
      Check task status
    </Card>

    <Card title="GET /v1/ai/image-to-video/kling-v2-5-pro" icon="list" href="/api-reference/image-to-video/kling-v2.5-pro/get-kling-v2-5-pro">
      List image-to-video tasks
    </Card>
  </Columns>
</div>

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What durations are supported?">
    Pro currently supports 5s and 10s outputs. For higher resolutions beyond defaults, pair the result with an upscaler.
  </Accordion>

  <Accordion title="What input works best for Kling 2.5 Turbo Pro?">
    Use a high‑resolution image with clear subjects and balanced lighting. Avoid heavy compression or clutter that can reduce perceived motion quality.
  </Accordion>

  <Accordion title="Will audio be supported?">
    Audio support is planned in an upcoming upgrade of the model.
  </Accordion>

  <Accordion title="Are outputs production‑ready?">
    Yes. The model targets professional‑grade cinematic quality with stable style/color and reliable prompt adherence.
  </Accordion>
</AccordionGroup>


# Kling 2.5 Pro - Create video from image
Source: https://docs.freepik.com/api-reference/image-to-video/kling-v2.5-pro/post-kling-v2-5-pro

post /v1/ai/image-to-video/kling-v2-5-pro
Generate a video from an image using the Kling 2.5 Pro model.



# Kling 2.0 - List tasks
Source: https://docs.freepik.com/api-reference/image-to-video/kling-v2/get-kling-v2

get /v1/ai/image-to-video/kling-v2
Get the list of the kling-v2 tasks



# Kling 2.0 - Get task status
Source: https://docs.freepik.com/api-reference/image-to-video/kling-v2/get-kling-v2-task

get /v1/ai/image-to-video/kling-v2/{task-id}
Get the status of the kling-v2 task



# Kling 2.0 - Create video from image
Source: https://docs.freepik.com/api-reference/image-to-video/kling-v2/post-kling-v2

post /v1/ai/image-to-video/kling-v2
Create a video from an image using the Kling v2 model

## Important

The service allows up to 3 concurrent requests per user.


# LTX Video 2.0 Fast - Create video from image
Source: https://docs.freepik.com/api-reference/image-to-video/ltx-2-fast

post /v1/ai/image-to-video/ltx-2-fast
Generate a video from an image using the LTX Video 2.0 Fast model.

**Features:**
- Fast video generation with resolutions up to 4K (2160p)
- Extended duration options: 6-20 seconds in 2-second increments
- Uses the provided image as the first frame
- Optional synchronized audio generation
- **Note:** Durations longer than 10 seconds require 25 FPS and 1080p resolution




# LTX Video 2.0 Fast I2V - List tasks
Source: https://docs.freepik.com/api-reference/image-to-video/ltx-2-fast-tasks

get /v1/ai/image-to-video/ltx-2-fast



# LTX Video 2.0 Fast I2V - Get task status
Source: https://docs.freepik.com/api-reference/image-to-video/ltx-2-fast/task-by-id

get /v1/ai/image-to-video/ltx-2-fast/{task-id}



# LTX Video 2.0 Pro - Create video from image
Source: https://docs.freepik.com/api-reference/image-to-video/ltx-2-pro

post /v1/ai/image-to-video/ltx-2-pro
Generate a video from an image using the LTX Video 2.0 Pro model.

**Features:**
- High-quality video generation with resolutions up to 4K (2160p)
- Duration options: 6, 8, or 10 seconds
- Uses the provided image as the first frame
- Optional synchronized audio generation
- Reproducible results with seed parameter




# LTX Video 2.0 Pro I2V - List tasks
Source: https://docs.freepik.com/api-reference/image-to-video/ltx-2-pro-tasks

get /v1/ai/image-to-video/ltx-2-pro



# LTX Video 2.0 Pro I2V - Get task status
Source: https://docs.freepik.com/api-reference/image-to-video/ltx-2-pro/task-by-id

get /v1/ai/image-to-video/ltx-2-pro/{task-id}



# MiniMax Hailuo 02 1080p - List tasks
Source: https://docs.freepik.com/api-reference/image-to-video/minimax-hailuo-02-1080p/get-minimax-hailuo-02-1080p

get /v1/ai/image-to-video/minimax-hailuo-02-1080p
Get the list of MiniMax Hailuo-02 1080p tasks



# MiniMax Hailuo 02 1080p - Get task status
Source: https://docs.freepik.com/api-reference/image-to-video/minimax-hailuo-02-1080p/get-minimax-hailuo-02-1080p-task

get /v1/ai/image-to-video/minimax-hailuo-02-1080p/{task-id}
Get the status of the MiniMax Hailuo-02 1080p task



# MiniMax Hailuo 02 1080p - Create video from text or image
Source: https://docs.freepik.com/api-reference/image-to-video/minimax-hailuo-02-1080p/post-minimax-hailuo-02-1080p

post /v1/ai/image-to-video/minimax-hailuo-02-1080p
Generate a video from text or image using the MiniMax Hailuo-02 1080p model.



# MiniMax Hailuo 02 768p - List tasks
Source: https://docs.freepik.com/api-reference/image-to-video/minimax-hailuo-02-768p/get-minimax-hailuo-02-768p

get /v1/ai/image-to-video/minimax-hailuo-02-768p
Get the list of MiniMax Hailuo-02 768p tasks



# MiniMax Hailuo 02 768p - Get task status
Source: https://docs.freepik.com/api-reference/image-to-video/minimax-hailuo-02-768p/get-minimax-hailuo-02-768p-task

get /v1/ai/image-to-video/minimax-hailuo-02-768p/{task-id}
Get the status of the MiniMax Hailuo-02 768p task



# MiniMax Hailuo 02 768p - Create video from text or image
Source: https://docs.freepik.com/api-reference/image-to-video/minimax-hailuo-02-768p/post-minimax-hailuo-02-768p

post /v1/ai/image-to-video/minimax-hailuo-02-768p
Generate a video from text or image using the MiniMax Hailuo-02 768p model.



# MiniMax Hailuo 2.3 1080p Fast - List tasks
Source: https://docs.freepik.com/api-reference/image-to-video/minimax-hailuo-2-3-1080p-fast/get-minimax-hailuo-2-3-1080p-fast

get /v1/ai/image-to-video/minimax-hailuo-2-3-1080p-fast
Get the list of MiniMax Hailuo 2.3 1080p Fast tasks



# MiniMax Hailuo 2.3 1080p Fast - Get task status
Source: https://docs.freepik.com/api-reference/image-to-video/minimax-hailuo-2-3-1080p-fast/get-minimax-hailuo-2-3-1080p-fast-task

get /v1/ai/image-to-video/minimax-hailuo-2-3-1080p-fast/{task-id}
Get the status of the MiniMax Hailuo 2.3 1080p Fast task



# MiniMax Hailuo 2.3 1080p Fast - Create video from text or image
Source: https://docs.freepik.com/api-reference/image-to-video/minimax-hailuo-2-3-1080p-fast/post-minimax-hailuo-2-3-1080p-fast

post /v1/ai/image-to-video/minimax-hailuo-2-3-1080p-fast
Generate a video from text or image using the MiniMax Hailuo 2.3 1080p model with fast prompt optimization.



# MiniMax Hailuo 2.3 1080p - List tasks
Source: https://docs.freepik.com/api-reference/image-to-video/minimax-hailuo-2-3-1080p/get-minimax-hailuo-2-3-1080p

get /v1/ai/image-to-video/minimax-hailuo-2-3-1080p
Get the list of MiniMax Hailuo 2.3 1080p tasks



# MiniMax Hailuo 2.3 1080p - Get task status
Source: https://docs.freepik.com/api-reference/image-to-video/minimax-hailuo-2-3-1080p/get-minimax-hailuo-2-3-1080p-task

get /v1/ai/image-to-video/minimax-hailuo-2-3-1080p/{task-id}
Get the status of the MiniMax Hailuo 2.3 1080p task



# MiniMax Hailuo 2.3 1080p - Create video from text or image
Source: https://docs.freepik.com/api-reference/image-to-video/minimax-hailuo-2-3-1080p/post-minimax-hailuo-2-3-1080p

post /v1/ai/image-to-video/minimax-hailuo-2-3-1080p
Generate a video from text or image using the MiniMax Hailuo 2.3 1080p model.



# MiniMax Hailuo 2.3 768p Fast - List tasks
Source: https://docs.freepik.com/api-reference/image-to-video/minimax-hailuo-2-3-768p-fast/get-minimax-hailuo-2-3-768p-fast

get /v1/ai/image-to-video/minimax-hailuo-2-3-768p-fast
Get the list of MiniMax Hailuo 2.3 768p Fast tasks



# MiniMax Hailuo 2.3 768p Fast - Get task status
Source: https://docs.freepik.com/api-reference/image-to-video/minimax-hailuo-2-3-768p-fast/get-minimax-hailuo-2-3-768p-fast-task

get /v1/ai/image-to-video/minimax-hailuo-2-3-768p-fast/{task-id}
Get the status of the MiniMax Hailuo 2.3 768p Fast task



# MiniMax Hailuo 2.3 768p Fast - Create video from text or image
Source: https://docs.freepik.com/api-reference/image-to-video/minimax-hailuo-2-3-768p-fast/post-minimax-hailuo-2-3-768p-fast

post /v1/ai/image-to-video/minimax-hailuo-2-3-768p-fast
Generate a video from text or image using the MiniMax Hailuo 2.3 768p model with fast prompt optimization.



# MiniMax Hailuo 2.3 768p - List tasks
Source: https://docs.freepik.com/api-reference/image-to-video/minimax-hailuo-2-3-768p/get-minimax-hailuo-2-3-768p

get /v1/ai/image-to-video/minimax-hailuo-2-3-768p
Get the list of MiniMax Hailuo 2.3 768p tasks



# MiniMax Hailuo 2.3 768p - Get task status
Source: https://docs.freepik.com/api-reference/image-to-video/minimax-hailuo-2-3-768p/get-minimax-hailuo-2-3-768p-task

get /v1/ai/image-to-video/minimax-hailuo-2-3-768p/{task-id}
Get the status of the MiniMax Hailuo 2.3 768p task



# MiniMax Hailuo 2.3 768p - Create video from text or image
Source: https://docs.freepik.com/api-reference/image-to-video/minimax-hailuo-2-3-768p/post-minimax-hailuo-2-3-768p

post /v1/ai/image-to-video/minimax-hailuo-2-3-768p
Generate a video from text or image using the MiniMax Hailuo 2.3 768p model.



# MiniMax Video 01 Live - Create video from image
Source: https://docs.freepik.com/api-reference/image-to-video/minimax-live

post /v1/ai/image-to-video/minimax-live
Generate a video from an image using MiniMax Video-01-Live model (Live Illustrations).

**Features:**
- Supports camera movements in square brackets: [Truck left], [Pan right], [Push in], [Pull out], [Zoom in], [Tracking shot], [Static shot]
- Optional prompt optimization for better results
- Works best with illustrations and artwork




# MiniMax Video 01 Live - List tasks
Source: https://docs.freepik.com/api-reference/image-to-video/minimax-live-tasks

get /v1/ai/image-to-video/minimax-live



# MiniMax Video 01 Live - Get task status
Source: https://docs.freepik.com/api-reference/image-to-video/minimax-live/task-by-id

get /v1/ai/image-to-video/minimax-live/{task-id}



# PixVerse V5 Transition - List tasks
Source: https://docs.freepik.com/api-reference/image-to-video/pixverse-transition/get-pixverse-v5-transition

get /v1/ai/image-to-video/pixverse-v5-transition
List PixVerse-V5 Transition tasks.



# PixVerse V5 Transition - Get task status
Source: https://docs.freepik.com/api-reference/image-to-video/pixverse-transition/get-{task-id}-by-id

get /v1/ai/image-to-video/pixverse-v5-transition/{task-id}



# PixVerse V5 - Video transition
Source: https://docs.freepik.com/api-reference/image-to-video/pixverse-transition/post-pixverse-v5-transition

post /v1/ai/image-to-video/pixverse-v5-transition
Generate a video transition between two images using the PixVerse-V5 model.



# PixVerse V5 - List tasks
Source: https://docs.freepik.com/api-reference/image-to-video/pixverse/get-pixverse-v5

get /v1/ai/image-to-video/pixverse-v5
List PixVerse-V5 tasks filtered by resolution provided in the request body.



# PixVerse V5 - Get task status
Source: https://docs.freepik.com/api-reference/image-to-video/pixverse/get-{task-id}-by-id

get /v1/ai/image-to-video/pixverse-v5/{task-id}



# PixVerse V5 – Image‑to‑Video API
Source: https://docs.freepik.com/api-reference/image-to-video/pixverse/overview

Generate cinematic videos from a single image with smooth, expressive motion, stable style and color, and strong instruction adherence. Faster rendering and multiple output options.

<Frame>
  <video>
    <source type="video/webm" />
  </video>
</Frame>

## Overview

PixVerse V5 generates videos from a single image with cinematic quality and smooth, expressive motion. It improves rendering speed, maintains style and color across frames, and follows instructions reliably—ideal for creative exploration and production pipelines.

### Key capabilities

* Smooth, natural motion from one input image
* Cinematic imagery with sharper details and clarity
* Stable style and color across sequences (subject consistency)
* Strong instruction adherence for look, tone, and motion
* Faster rendering versus prior versions, with multiple output options

### Use cases

* Short films, teasers, and cinematic promos
* YouTube/TikTok/Instagram content (short- and long‑form)
* Product and brand videos with consistent subjects
* Educational explainers and motion studies
* Experimental art and abstract motion

<div>
  <Columns>
    <Card title="POST /v1/ai/image-to-video/pixverse-v5" icon="video" href="/api-reference/image-to-video/pixverse/post-pixverse-v5">
      Generate video from an image
    </Card>

    <Card title="GET /v1/ai/image-to-video/pixverse-v5/{task-id}" icon="magnifying-glass" href="/api-reference/image-to-video/pixverse/get-{task-id}-by-id">
      Check task status
    </Card>

    <Card title="GET /v1/ai/image-to-video/pixverse-v5" icon="list" href="/api-reference/image-to-video/pixverse/get-pixverse-v5">
      List image-to-video tasks
    </Card>
  </Columns>
</div>

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What input works best for PixVerse V5 image‑to‑video?">
    Use a high‑resolution image with clear subjects and balanced lighting. Avoid heavy compression and cluttered backgrounds to maximize motion quality.
  </Accordion>

  <Accordion title="Which resolutions are supported?">
    Common outputs include 360p, 540p, 720p, and 1080p. For extreme resolutions, pair results with an upscaler to reach 4K.
  </Accordion>

  <Accordion title="Does PixVerse V5 maintain style and color across frames?">
    Yes. V5 improves style/color stability and subject consistency for more coherent sequences and narratives.
  </Accordion>
</AccordionGroup>


# PixVerse V5 - Create video from image
Source: https://docs.freepik.com/api-reference/image-to-video/pixverse/post-pixverse-v5

post /v1/ai/image-to-video/pixverse-v5
Generate a video using the PixVerse-V5 model. Resolution is specified in the request body.



# Create video from image - Veo 3.1
Source: https://docs.freepik.com/api-reference/image-to-video/post-veo-3-1

post /v1/ai/image-to-video/veo-3-1
Generate a video from an image using Google Veo 3.1 model. Supports multiple resolutions (720p, 1080p, 4K) and optional audio generation.



# Create video from image - Veo 3.1 Fast
Source: https://docs.freepik.com/api-reference/image-to-video/post-veo-3-1-fast

post /v1/ai/image-to-video/veo-3-1-fast
Generate a video from an image using Google Veo 3.1 Fast model. Faster generation at a lower cost.



# RunWay Gen4 Turbo - Create video from image
Source: https://docs.freepik.com/api-reference/image-to-video/runway-gen4-turbo

post /v1/ai/image-to-video/runway-gen4-turbo
Generate a video from an image using RunWay Gen4 Turbo model.



# RunWay Gen4 Turbo - List tasks
Source: https://docs.freepik.com/api-reference/image-to-video/runway-gen4-turbo-tasks

get /v1/ai/image-to-video/runway-gen4-turbo



# RunWay Gen4 Turbo - Get task status
Source: https://docs.freepik.com/api-reference/image-to-video/runway-gen4-turbo/task-by-id

get /v1/ai/image-to-video/runway-gen4-turbo/{task-id}



# Seedance Lite 1080p - List tasks
Source: https://docs.freepik.com/api-reference/image-to-video/seedance-lite-1080p/get-seedance-lite-1080p

get /v1/ai/image-to-video/seedance-lite-1080p
Get the list of Seedance Lite 1080p tasks



# Seedance Lite 1080p - Get task status
Source: https://docs.freepik.com/api-reference/image-to-video/seedance-lite-1080p/get-seedance-lite-1080p-task

get /v1/ai/image-to-video/seedance-lite-1080p/{task-id}
Get the status of the Seedance Lite 1080p task



# Seedance Lite 1080p - Create video from image
Source: https://docs.freepik.com/api-reference/image-to-video/seedance-lite-1080p/post-seedance-lite-1080p

post /v1/ai/image-to-video/seedance-lite-1080p
Generate a video from image using the Seedance Lite 1080p model.



# Seedance Lite 480p - List tasks
Source: https://docs.freepik.com/api-reference/image-to-video/seedance-lite-480p/get-seedance-lite-480p

get /v1/ai/image-to-video/seedance-lite-480p
Get the list of Seedance Lite 480p tasks



# Seedance Lite 480p - Get task status
Source: https://docs.freepik.com/api-reference/image-to-video/seedance-lite-480p/get-seedance-lite-480p-task

get /v1/ai/image-to-video/seedance-lite-480p/{task-id}
Get the status of the Seedance Lite 480p task



# Seedance Lite 480p - Create video from image
Source: https://docs.freepik.com/api-reference/image-to-video/seedance-lite-480p/post-seedance-lite-480p

post /v1/ai/image-to-video/seedance-lite-480p
Generate a video from image using the Seedance Lite 480p model.



# Seedance Lite 720p - List tasks
Source: https://docs.freepik.com/api-reference/image-to-video/seedance-lite-720p/get-seedance-lite-720p

get /v1/ai/image-to-video/seedance-lite-720p
Get the list of Seedance Lite 720p tasks



# Seedance Lite 720p - Get task status
Source: https://docs.freepik.com/api-reference/image-to-video/seedance-lite-720p/get-seedance-lite-720p-task

get /v1/ai/image-to-video/seedance-lite-720p/{task-id}
Get the status of the Seedance Lite 720p task



# Seedance Lite 720p - Create video from image
Source: https://docs.freepik.com/api-reference/image-to-video/seedance-lite-720p/post-seedance-lite-720p

post /v1/ai/image-to-video/seedance-lite-720p
Generate a video from image using the Seedance Lite 720p model.



# Seedance Pro 1080p - List tasks
Source: https://docs.freepik.com/api-reference/image-to-video/seedance-pro-1080p/get-seedance-pro-1080p

get /v1/ai/image-to-video/seedance-pro-1080p
Get the list of Seedance Pro 1080p tasks



# Seedance Pro 1080p - Get task status
Source: https://docs.freepik.com/api-reference/image-to-video/seedance-pro-1080p/get-seedance-pro-1080p-task

get /v1/ai/image-to-video/seedance-pro-1080p/{task-id}
Get the status of the Seedance Pro 1080p task



# Seedance Pro 1080p - Create video from image
Source: https://docs.freepik.com/api-reference/image-to-video/seedance-pro-1080p/post-seedance-pro-1080p

post /v1/ai/image-to-video/seedance-pro-1080p
Generate a video from image using the Seedance Pro 1080p model.



# Seedance Pro 480p - List tasks
Source: https://docs.freepik.com/api-reference/image-to-video/seedance-pro-480p/get-seedance-pro-480p

get /v1/ai/image-to-video/seedance-pro-480p
Get the list of Seedance Pro 480p tasks



# Seedance Pro 480p - Get task status
Source: https://docs.freepik.com/api-reference/image-to-video/seedance-pro-480p/get-seedance-pro-480p-task

get /v1/ai/image-to-video/seedance-pro-480p/{task-id}
Get the status of the Seedance Pro 480p task



# Seedance Pro 480p - Create video from image
Source: https://docs.freepik.com/api-reference/image-to-video/seedance-pro-480p/post-seedance-pro-480p

post /v1/ai/image-to-video/seedance-pro-480p
Generate a video from image using the Seedance Pro 480p model.



# Seedance Pro 720p - List tasks
Source: https://docs.freepik.com/api-reference/image-to-video/seedance-pro-720p/get-seedance-pro-720p

get /v1/ai/image-to-video/seedance-pro-720p
Get the list of Seedance Pro 720p tasks



# Seedance Pro 720p - Get task status
Source: https://docs.freepik.com/api-reference/image-to-video/seedance-pro-720p/get-seedance-pro-720p-task

get /v1/ai/image-to-video/seedance-pro-720p/{task-id}
Get the status of the Seedance Pro 720p task



# Seedance Pro 720p - Create video from image
Source: https://docs.freepik.com/api-reference/image-to-video/seedance-pro-720p/post-seedance-pro-720p

post /v1/ai/image-to-video/seedance-pro-720p
Generate a video from image using the Seedance Pro 720p model.



# Veo 3.1 – Image-to-Video API | Freepik API
Source: https://docs.freepik.com/api-reference/image-to-video/veo-3-1/overview

Transform images into cinematic videos with Google Veo 3.1. Supports 720p, 1080p, and 4K resolutions with optional audio. Standard and Fast modes available.

<Card title="Google Veo 3.1" icon="google">
  State-of-the-art image-to-video generation powered by Google's Veo 3.1 model with multi-resolution output and optional audio synthesis.
</Card>

Veo 3.1 Image-to-Video transforms static images into dynamic, cinematic videos guided by text prompts. It supports resolutions up to 4K, durations of 4-8 seconds, and optional audio generation. Choose between **Standard** mode for maximum quality or **Fast** mode for quicker generation at lower cost.

### Key capabilities

* **Image animation**: Bring any image to life with natural motion and dynamics
* **Multi-resolution output**: Generate videos in 720p, 1080p, or 4K resolution
* **Audio generation**: Optional synchronized audio for complete multimedia content
* **Flexible durations**: 4, 6, or 8 second video outputs
* **Aspect ratio control**: 16:9 (landscape) or 9:16 (portrait) formats
* **Motion guidance**: Use prompts to direct how the image animates
* **Two generation modes**: Standard (highest quality) and Fast (cost-efficient)
* **Flexible input**: Accept Base64 encoded images or HTTPS URLs

### Use cases

* **Product animation**: Animate product photos for e-commerce and advertising
* **Social media content**: Transform static posts into engaging video content
* **Portrait animation**: Bring photos of people to life with natural movement
* **Art animation**: Animate artwork, illustrations, and digital creations
* **Marketing visuals**: Convert campaign images into dynamic video ads
* **Storytelling**: Create video sequences from storyboard images

### Generate with Veo 3.1 Standard

High-quality video generation with maximum fidelity and detail.

<div>
  <Columns>
    <Card title="POST /v1/ai/image-to-video/veo-3-1" icon="video" href="/api-reference/image-to-video/post-veo-3-1">
      Create a new image-to-video task
    </Card>

    <Card title="GET /v1/ai/image-to-video/veo-3-1" icon="list" href="/api-reference/image-to-video/get-veo-3-1">
      List all Veo 3.1 tasks
    </Card>

    <Card title="GET /v1/ai/image-to-video/veo-3-1/{task-id}" icon="magnifying-glass" href="/api-reference/image-to-video/get-veo-3-1-task">
      Get task status by ID
    </Card>
  </Columns>
</div>

### Generate with Veo 3.1 Fast

Faster generation at reduced cost, ideal for prototyping and high-volume workflows.

<div>
  <Columns>
    <Card title="POST /v1/ai/image-to-video/veo-3-1-fast" icon="bolt" href="/api-reference/image-to-video/post-veo-3-1-fast">
      Create a fast image-to-video task
    </Card>

    <Card title="GET /v1/ai/image-to-video/veo-3-1-fast" icon="list" href="/api-reference/image-to-video/get-veo-3-1-fast">
      List all Veo 3.1 Fast tasks
    </Card>

    <Card title="GET /v1/ai/image-to-video/veo-3-1-fast/{task-id}" icon="magnifying-glass" href="/api-reference/image-to-video/get-veo-3-1-fast-task">
      Get task status by ID
    </Card>
  </Columns>
</div>

### Parameters

| Parameter         | Type      | Required | Description                                                             |
| ----------------- | --------- | -------- | ----------------------------------------------------------------------- |
| `image`           | `string`  | Yes      | Input image as Base64 string or HTTPS URL (must be publicly accessible) |
| `prompt`          | `string`  | Yes      | Text describing the motion and animation (max 20,000 chars)             |
| `negative_prompt` | `string`  | No       | Text describing what to avoid in the video                              |
| `duration`        | `integer` | No       | Video duration: `4`, `6`, or `8` seconds (default: `8`)                 |
| `resolution`      | `string`  | No       | Output resolution: `"720p"`, `"1080p"`, or `"4k"` (default: `"720p"`)   |
| `aspect_ratio`    | `string`  | No       | Video format: `"16:9"` or `"9:16"` (default: `"16:9"`)                  |
| `generate_audio`  | `boolean` | No       | Generate synchronized audio (default: `true`)                           |
| `seed`            | `integer` | No       | Random seed for reproducibility                                         |
| `webhook_url`     | `string`  | No       | URL for task completion notification                                    |

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What image formats are supported?">
    Veo 3.1 accepts images via **HTTPS URLs** (must be publicly accessible) or **Base64 encoded strings**. Common formats like JPEG, PNG, and WebP are supported.
  </Accordion>

  <Accordion title="What is the difference between Standard and Fast modes?">
    **Standard mode** produces the highest quality output with maximum detail and natural motion, ideal for final production content. **Fast mode** generates videos more quickly at a lower cost, perfect for prototyping and high-volume workflows.
  </Accordion>

  <Accordion title="How do prompts affect the animation?">
    The prompt guides how the image animates. Describe the desired motion, such as *"The subject slowly turns their head and smiles"* or *"Camera slowly zooms in while leaves blow in the wind"*. Be specific about movement direction and speed.
  </Accordion>

  <Accordion title="What resolutions are supported?">
    Veo 3.1 supports **720p** (HD), **1080p** (Full HD), and **4K** (Ultra HD). The output resolution is independent of your input image resolution.
  </Accordion>

  <Accordion title="How does audio generation work?">
    When `generate_audio` is enabled (default), Veo 3.1 synthesizes audio that matches the visual content and motion. This includes ambient sounds and effects appropriate to the scene.
  </Accordion>

  <Accordion title="Can I animate portrait images for social media?">
    Yes, set `aspect_ratio` to `"9:16"` to generate vertical videos. For best results, use portrait-oriented source images when creating vertical content.
  </Accordion>
</AccordionGroup>

## Best practices

* **Image quality**: Use high-resolution, well-lit images with clear subjects for best results
* **Motion prompts**: Describe specific movements like "slowly pans left" or "subject walks forward"
* **Negative prompts**: Use to avoid unwanted artifacts like "blurry, distorted, flickering"
* **Resolution matching**: Consider your source image quality when selecting output resolution
* **Audio control**: Disable `generate_audio` if adding custom audio in post-production
* **Webhook integration**: Use webhooks for production workflows to handle async completion
* **Seed for consistency**: Use the same seed to reproduce similar animation results

## Related APIs

* **[Veo 3.1 Text-to-Video](/api-reference/text-to-video/veo-3-1/overview)**: Generate videos from text prompts with Veo 3.1
* **[Veo 3.1 Reference-to-Video](/api-reference/reference-to-video/veo-3-1/overview)**: Generate videos with consistent characters using reference images
* **[Kling 2.6 Pro](/api-reference/image-to-video/kling-v2-6-pro)**: Image-to-video with advanced motion control
* **[Kling O1](/api-reference/image-to-video/kling-o1/overview)**: Alternative image-to-video model
* **[MiniMax Live](/api-reference/image-to-video/minimax-live)**: Fast image-to-video generation


# WAN 2.5 1080p - Create video from image
Source: https://docs.freepik.com/api-reference/image-to-video/wan-2-5-i2v-1080p

post /v1/ai/image-to-video/wan-2-5-i2v-1080p
Generate a 1080p video from image using the WAN 2.5 model.



# WAN 2.5 I2V 1080p - List tasks
Source: https://docs.freepik.com/api-reference/image-to-video/wan-2-5-i2v-1080p-tasks

get /v1/ai/image-to-video/wan-2-5-i2v-1080p
Get the list of WAN 2.5 Image-to-Video 1080p tasks



# WAN 2.5 480p - Create video from image
Source: https://docs.freepik.com/api-reference/image-to-video/wan-2-5-i2v-480p

post /v1/ai/image-to-video/wan-2-5-i2v-480p
Generate a 480p video from image using the WAN 2.5 model.



# WAN 2.5 I2V 480p - List tasks
Source: https://docs.freepik.com/api-reference/image-to-video/wan-2-5-i2v-480p-tasks

get /v1/ai/image-to-video/wan-2-5-i2v-480p
Get the list of WAN 2.5 Image-to-Video 480p tasks



# WAN 2.5 720p - Create video from image
Source: https://docs.freepik.com/api-reference/image-to-video/wan-2-5-i2v-720p

post /v1/ai/image-to-video/wan-2-5-i2v-720p
Generate a 720p video from image using the WAN 2.5 model.



# WAN 2.5 I2V 720p - List tasks
Source: https://docs.freepik.com/api-reference/image-to-video/wan-2-5-i2v-720p-tasks

get /v1/ai/image-to-video/wan-2-5-i2v-720p
Get the list of WAN 2.5 Image-to-Video 720p tasks



# WAN 2.5 I2V 1080p - Get task status
Source: https://docs.freepik.com/api-reference/image-to-video/wan-2-5/task-by-id-1080p

get /v1/ai/image-to-video/wan-2-5-i2v-1080p/{task-id}
Get the status of a WAN 2.5 Image-to-Video 1080p task



# WAN 2.5 I2V 480p - Get task status
Source: https://docs.freepik.com/api-reference/image-to-video/wan-2-5/task-by-id-480p

get /v1/ai/image-to-video/wan-2-5-i2v-480p/{task-id}
Get the status of a WAN 2.5 Image-to-Video 480p task



# WAN 2.5 I2V 720p - Get task status
Source: https://docs.freepik.com/api-reference/image-to-video/wan-2-5/task-by-id-720p

get /v1/ai/image-to-video/wan-2-5-i2v-720p/{task-id}
Get the status of a WAN 2.5 Image-to-Video 720p task



# WAN 2.7 - Create video from image
Source: https://docs.freepik.com/api-reference/image-to-video/wan-2-7/generate

post /v1/ai/image-to-video/wan-2-7
Generate a video from an image or extend an existing video using WAN 2.7.

**Three generation modes:**
- **First frame**: Provide `start_image_url` alone to animate from a starting image
- **First + last frame**: Provide both `start_image_url` and `end_image_url` for controlled start-to-end animation
- **Video continuation**: Provide `video_url` to extend an existing video, optionally with `end_image_url` as the target ending frame

**Key features:**
- 720P and 1080P resolution support
- Optional audio-guided generation
- Duration range: 2-15 seconds




# WAN 2.7 Image To Video API
Source: https://docs.freepik.com/api-reference/image-to-video/wan-2-7/overview

Generate AI videos from images with WAN 2.7. First frame, first+last frame, and video continuation modes. 720P and 1080P resolution, 2-15 second durations, and audio-guided generation.

<Card title="Alibaba WAN 2.7 integration" icon="video">
  WAN 2.7 Image-to-Video supports three generation modes: animate from a first frame, control start-to-end animation, or extend existing videos with optional audio guidance.
</Card>

WAN 2.7 Image-to-Video is an AI video generation API that creates MP4 videos from images or extends existing videos. It supports three distinct generation modes: first-frame animation, first+last frame controlled animation, and video continuation. Output is available at 720P (1280x720) or 1080P (1920x1080) resolution with durations from 2 to 15 seconds. The model also supports optional audio input and automatic prompt expansion.

### Key capabilities

* **Three generation modes**: First frame only, first+last frame, and video continuation
* **Resolution options**: 720P (1280x720) and 1080P (1920x1080) output
* **Flexible durations**: 2 to 15 seconds of video output
* **Audio-guided generation**: Provide a WAV or MP3 audio file (2-30 seconds, max 15MB) to guide video creation
* **Prompt expansion**: AI optimizer expands short prompts into detailed scripts for richer output
* **Video extension**: Continue an existing MP4/MOV video (2-10 seconds, max 100MB) with new content
* **Image constraints**: Supports JPEG, PNG, BMP, WEBP images (240-8000px per side, max 20MB)
* **Async processing**: Webhook notifications or polling for task completion

### Generation modes

| Mode                   | Required inputs                            | Best for                                          |
| ---------------------- | ------------------------------------------ | ------------------------------------------------- |
| **First frame**        | `start_image_url`                          | Animating a still image with AI-generated motion  |
| **First + last frame** | `start_image_url` + `end_image_url`        | Controlled transition between two keyframes       |
| **Video continuation** | `video_url` (optionally + `end_image_url`) | Extending an existing video clip with new content |

### Use cases

* **Product animation**: Bring product images to life with smooth motion and camera movements
* **Marketing videos**: Animate brand imagery into short-form video content
* **Social media content**: Create video posts from static images for TikTok, Instagram, and YouTube
* **Video extension**: Extend short clips into longer narratives using video continuation
* **Storyboarding**: Animate concept art or wireframes to preview motion sequences
* **Creative exploration**: Experiment with first+last frame mode for controlled visual transitions

### API operations

Generate videos by submitting an image or video to the API. The service returns a task ID for async polling or webhook notification.

<div>
  <Columns>
    <Card title="POST /v1/ai/image-to-video/wan-2-7" icon="video" href="/api-reference/image-to-video/wan-2-7/generate">
      Create a new image-to-video generation task
    </Card>

    <Card title="GET /v1/ai/image-to-video/wan-2-7" icon="list" href="/api-reference/image-to-video/wan-2-7/wan-2-7-i2v-tasks">
      List all WAN 2.7 I2V tasks with status
    </Card>

    <Card title="GET /v1/ai/image-to-video/wan-2-7/{task-id}" icon="magnifying-glass" href="/api-reference/image-to-video/wan-2-7/task-by-id">
      Get task status and results by ID
    </Card>
  </Columns>
</div>

### Parameters

| Parameter                           | Type      | Required    | Default   | Description                                                                           |
| ----------------------------------- | --------- | ----------- | --------- | ------------------------------------------------------------------------------------- |
| `prompt`                            | `string`  | No          | -         | Text description to guide video motion and style. Max 5000 characters                 |
| `negative_prompt`                   | `string`  | No          | -         | Elements to avoid (e.g., "blurry, watermark"). Max 500 characters                     |
| `start_image_url`                   | `string`  | Conditional | -         | URL of first-frame image (JPEG/PNG/BMP/WEBP, 240-8000px, max 20MB)                    |
| `end_image_url`                     | `string`  | No          | -         | URL of last-frame image. Use with `start_image_url` or `video_url`                    |
| `video_url`                         | `string`  | Conditional | -         | URL of existing video to extend (MP4/MOV, 2-10s, max 100MB)                           |
| `audio_url`                         | `string`  | No          | -         | URL of audio file (WAV/MP3, 2-30s, max 15MB) to guide generation                      |
| `resolution`                        | `string`  | No          | `"1080P"` | Output resolution: `"720P"` or `"1080P"`                                              |
| `duration`                          | `integer` | No          | `5`       | Video length in seconds: 2 to 15. For video continuation, this is total output length |
| `seed`                              | `integer` | No          | Random    | Seed for reproducibility (0 to 2147483647)                                            |
| `additional_settings.prompt_extend` | `boolean` | No          | `true`    | Enable AI prompt expansion for richer output                                          |
| `webhook_url`                       | `string`  | No          | -         | URL for async status notifications                                                    |

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is WAN 2.7 Image-to-Video and how does it work?">
    WAN 2.7 Image-to-Video is an AI video generation API developed by Alibaba. You submit an image or video URL, receive a task ID immediately, then poll for results or receive a webhook notification when processing completes. The model generates MP4 video at 720P or 1080P resolution in durations from 2 to 15 seconds.
  </Accordion>

  <Accordion title="What are the three generation modes?">
    **First frame**: Provide `start_image_url` alone to animate from a starting image. **First + last frame**: Provide both `start_image_url` and `end_image_url` for controlled start-to-end animation. **Video continuation**: Provide `video_url` to extend an existing video, optionally with `end_image_url` as the target ending frame.
  </Accordion>

  <Accordion title="What image formats are supported?">
    WAN 2.7 accepts JPEG, PNG, BMP, and WEBP images via publicly accessible URLs. Images must be 240-8000 pixels per side with an aspect ratio between 1:8 and 8:1, and a maximum file size of 20MB.
  </Accordion>

  <Accordion title="What video formats are supported for video continuation?">
    Video continuation accepts MP4 and MOV files via publicly accessible URLs. Input videos must be 2-10 seconds long, 240-4096 pixels per side, and under 100MB.
  </Accordion>

  <Accordion title="How does audio-guided generation work?">
    Provide a WAV or MP3 audio file URL via the `audio_url` parameter. The audio must be 2-30 seconds long and under 15MB. WAN 2.7 uses the audio to influence the visual content and motion of the generated video.
  </Accordion>

  <Accordion title="What are the rate limits for WAN 2.7?">
    Rate limits depend on your subscription tier. See the [Rate Limits](/ratelimits) page for current limits by plan.
  </Accordion>

  <Accordion title="How much does WAN 2.7 cost?">
    See the [Pricing page](/pricing) for current rates and subscription options.
  </Accordion>
</AccordionGroup>

## Best practices

* **Image quality**: Use high-resolution images with clear subjects and balanced lighting. Avoid heavily compressed or noisy inputs.
* **First + last frame**: Ensure both images share a similar visual style and subject for smooth transitions.
* **Video continuation**: Input video duration (2-10s) counts toward total output duration. Plan accordingly.
* **Prompt writing**: Even though prompts are optional for I2V, adding motion and camera directions improves results.
* **Negative prompts**: Always include: "blurry, low quality, watermark, text, distortion, extra limbs"
* **Production integration**: Use webhooks for scalable applications instead of polling.
* **Error handling**: Implement retry with exponential backoff for 503 errors during high-demand periods.

## Related APIs

* **[WAN 2.7 Text-to-Video](/api-reference/text-to-video/wan-2-7/overview)**: Generate videos purely from text prompts with WAN 2.7
* **[WAN 2.7 Reference-to-Video](/api-reference/reference-to-video/wan-2-7/overview)**: Generate videos featuring characters from reference images or videos
* **[WAN 2.6 Image-to-Video](/api-reference/wan-v2-6-i2v/overview)**: Previous WAN generation with multi-shot sequences
* **[Kling 2.5 Turbo Pro](/api-reference/image-to-video/kling-v2.5-pro/overview)**: Alternative I2V model with cinematic quality


# WAN 2.7 I2V - Get task status
Source: https://docs.freepik.com/api-reference/image-to-video/wan-2-7/task-by-id

get /v1/ai/image-to-video/wan-2-7/{task-id}
Retrieve the status and result of a specific WAN 2.7 image-to-video task by its ID.



# WAN 2.7 I2V - List tasks
Source: https://docs.freepik.com/api-reference/image-to-video/wan-2-7/wan-2-7-i2v-tasks

get /v1/ai/image-to-video/wan-2-7
Retrieve the list of all WAN 2.7 image-to-video tasks for the authenticated user.



# WAN 2.2 480p - List tasks
Source: https://docs.freepik.com/api-reference/image-to-video/wan-v2-2-480p/get-wan-v2-2-480p

get /v1/ai/image-to-video/wan-v2-2-480p
Get the list of WAN 2.2 480p tasks



# WAN 2.2 480p - Get task status
Source: https://docs.freepik.com/api-reference/image-to-video/wan-v2-2-480p/get-wan-v2-2-480p-task

get /v1/ai/image-to-video/wan-v2-2-480p/{task-id}
Get the status of the WAN 2.2 480p task



# WAN 2.2 480p - Create video from image
Source: https://docs.freepik.com/api-reference/image-to-video/wan-v2-2-480p/post-wan-v2-2-480p

post /v1/ai/image-to-video/wan-v2-2-480p
Generate a video from image using the WAN 2.2 480p model.



# WAN 2.2 580p - List tasks
Source: https://docs.freepik.com/api-reference/image-to-video/wan-v2-2-580p/get-wan-v2-2-580p

get /v1/ai/image-to-video/wan-v2-2-580p
Get the list of WAN 2.2 580p tasks



# WAN 2.2 580p - Get task status
Source: https://docs.freepik.com/api-reference/image-to-video/wan-v2-2-580p/get-wan-v2-2-580p-task

get /v1/ai/image-to-video/wan-v2-2-580p/{task-id}
Get the status of the WAN 2.2 580p task



# WAN 2.2 580p - Create video from image
Source: https://docs.freepik.com/api-reference/image-to-video/wan-v2-2-580p/post-wan-v2-2-580p

post /v1/ai/image-to-video/wan-v2-2-580p
Generate a video from image using the WAN 2.2 580p model.



# WAN 2.2 720p - List tasks
Source: https://docs.freepik.com/api-reference/image-to-video/wan-v2-2-720p/get-wan-v2-2-720p

get /v1/ai/image-to-video/wan-v2-2-720p
Get the list of WAN 2.2 720p tasks



# WAN 2.2 720p - Get task status
Source: https://docs.freepik.com/api-reference/image-to-video/wan-v2-2-720p/get-wan-v2-2-720p-task

get /v1/ai/image-to-video/wan-v2-2-720p/{task-id}
Get the status of the WAN 2.2 720p task



# WAN 2.2 720p - Create video from image
Source: https://docs.freepik.com/api-reference/image-to-video/wan-v2-2-720p/post-wan-v2-2-720p

post /v1/ai/image-to-video/wan-v2-2-720p
Generate a video from image using the WAN 2.2 720p model.



# WAN 2.6 1080p - Create video from image
Source: https://docs.freepik.com/api-reference/image-to-video/wan-v2-6-1080p

post /v1/ai/image-to-video/wan-v2-6-1080p
Generate a 1080p video from image using the WAN 2.6 model.



# WAN 2.6 I2V 1080p - List tasks
Source: https://docs.freepik.com/api-reference/image-to-video/wan-v2-6-1080p-tasks

get /v1/ai/image-to-video/wan-v2-6-1080p
Get the list of WAN 2.6 Image-to-Video 1080p tasks



# WAN 2.6 720p - Create video from image
Source: https://docs.freepik.com/api-reference/image-to-video/wan-v2-6-720p

post /v1/ai/image-to-video/wan-v2-6-720p
Generate a 720p video from image using the WAN 2.6 model.



# WAN 2.6 I2V 720p - List tasks
Source: https://docs.freepik.com/api-reference/image-to-video/wan-v2-6-720p-tasks

get /v1/ai/image-to-video/wan-v2-6-720p
Get the list of WAN 2.6 Image-to-Video 720p tasks



# WAN 2.6 I2V 1080p - Get task status
Source: https://docs.freepik.com/api-reference/image-to-video/wan-v2-6/task-by-id-1080p

get /v1/ai/image-to-video/wan-v2-6-1080p/{task-id}
Get the status of a WAN 2.6 Image-to-Video 1080p task



# WAN 2.6 I2V 720p - Get task status
Source: https://docs.freepik.com/api-reference/image-to-video/wan-v2-6/task-by-id-720p

get /v1/ai/image-to-video/wan-v2-6-720p/{task-id}
Get the status of a WAN 2.6 Image-to-Video 720p task



# Upscaler Creative - Get task status
Source: https://docs.freepik.com/api-reference/image-upscaler-creative/get-image-upscaler

get /v1/ai/image-upscaler/{task-id}
Get the status of the upscaling task



# Upscaler Creative - List tasks
Source: https://docs.freepik.com/api-reference/image-upscaler-creative/get-image-upscaler-task

get /v1/ai/image-upscaler
Get the status of all upscaling tasks



# Magnific Upscaler Creative API
Source: https://docs.freepik.com/api-reference/image-upscaler-creative/image-upscaler

Best AI image upscaler to enlarge pictures without losing quality. Prompt-guided enhancement, stylization, and 2x/4x/8x/16x upscaling.

<Frame>
  <video>
    <source type="video/mp4" />

    Your browser does not support the video tag.
  </video>
</Frame>

<Card title="Freepik API uses Magnific.ai technology, now available as a comprehensive API service." icon="circle-exclamation">
  Creative mode adds or infers new detail guided by your prompt, enabling stylized, higher‑impact upscales.
</Card>

The Magnific Upscaler enhances images to higher resolutions. This powerful tool does more than just increase image size - it also improves quality and adds detail. By leveraging advanced upscaling technology, our API allows you to transform your images with custom prompts and fine-tuned parameters, achieving impressive results. Need faithful upscaling without adding new elements? See <a href="/api-reference/image-upscaler-precision/image-upscaler">Upscaler Precision</a>.

### Key capabilities

* Prompt‑guided enhancement that can introduce or infer new detail
* Stylization options to match aesthetics or art directions
* Controls to balance fidelity vs creativity
* Resolution growth (2x/4x/8x/16x) with quality improvement
* Ideal for concept art, marketing creatives, and visual ideation

### Use Cases

The Magnific Upscaler can be applied to a wide range of image types and industries, including:

* Portraits: Enhance facial details and skin textures
* Illustrations: Sharpen lines and improve color vibrancy
* Video game assets: Upscale textures and character models
* Landscapes: Bring out intricate details in nature scenes
* Science fiction imagery: Enhance futuristic and space-themed visuals
* Fantasy art: Improve magical and mythical elements
* Film stills: Increase resolution for better visual quality
* Graphic design: Upscale logos and marketing materials
* Architectural renderings: Enhance building details and textures, jumping from quick sketches to high quality renders
* Interior design: Improve quality of room layouts and furniture details
* Food photography: Bring out textures and colors in culinary images

### Upscale an Image with Magnific

Create an upscaling task for an image.

<div>
  <Columns>
    <Card title="POST /v1/ai/image-upscaler" icon="code" href="/api-reference/image-upscaler-creative/post-image-upscaler">
      Upscale an image using Magnific
    </Card>
  </Columns>
</div>

## Image Input Best Practices

For maximum quality results, how you send your image matters:

| Action                                     | Quality Impact             |
| ------------------------------------------ | -------------------------- |
| Send URL of original image                 | ✅ Maximum quality          |
| Send base64 of original file read directly | ✅ Maximum quality          |
| Use `canvas.toDataURL('image/jpeg')`       | ❌ \~8% quality loss        |
| Use `canvas.toDataURL('image/jpeg', 0.8)`  | ❌ \~20% quality loss       |
| Resize image before sending                | ❌ Significant quality loss |
| Convert PNG → JPEG before sending          | ❌ Quality loss             |

<Tip>
  **Recommended:** Send the original image via URL whenever possible. This ensures the upscaler receives the highest quality input, which directly impacts output quality.
</Tip>

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="Is this the same technology as Magnific.ai?">
    Yes! Magnific.ai is part of Freepik and we are happy to offer the same technology in an API service. If you tried Magnific.ai before, you will get the same technology and its future updates.
  </Accordion>

  <Accordion title="How much does the Magnific Upscaler cost?">
    The cost per image upscale is based on the output image area in pixels. This depends on two key factors:

    * The dimensions of the input image
    * The upscale factor applied (e.g.: 2x, 4x, 8x, 16x)

    The larger the output image area, the higher the cost per upscale. Our pricing tiers are applied based on the final output size, so you have complete transparency and control over your usage.

    Some examples:

    | Input Size | Output Size | Upscale Factor | Price |
    | ---------- | ----------- | -------------- | ----- |
    | 640x480    | 1280x960    | 2x             | €0.10 |
    | 640x480    | 2560x1920   | 4x             | €0.20 |
    | 640x480    | 5120x3840   | 8x             | €0.50 |
    | 1280x720   | 2560x1440   | 2x             | €0.10 |
    | 1280x720   | 5120x2880   | 4x             | €0.40 |
    | 1920x1080  | 3840x2160   | 2x             | €0.20 |

    The pricing structure ensures that you only pay for the level of upscaling you need.
  </Accordion>

  <Accordion title="How can I enlarge pictures without losing quality?">
    Use <strong>Upscaler Precision</strong> for faithful super‑resolution without hallucinations (best for logos, UI, text, and product photos). Choose <strong>Creative</strong> when you want to add or infer detail and stylize results via prompts.
  </Accordion>
</AccordionGroup>


# Upscaler Creative - Upscale image
Source: https://docs.freepik.com/api-reference/image-upscaler-creative/post-image-upscaler

post /v1/ai/image-upscaler
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.


## Important

For a comprehensive guide on this service, including use cases and detailed functionality, check out our [Image Upscaler Guide](/api-reference/image-upscaler-creative/image-upscaler).

## Request


# Upscaler Precision V2 - List tasks
Source: https://docs.freepik.com/api-reference/image-upscaler-precision-v2/get-image-upscaler-precision-v2

get /v1/ai/image-upscaler-precision-v2
Returns a list of all precision upscaler V2 tasks. Each task includes its ID, current status, and output URL if completed.



# Upscaler Precision V2 - Get task status
Source: https://docs.freepik.com/api-reference/image-upscaler-precision-v2/get-{task-id}-by-id

get /v1/ai/image-upscaler-precision-v2/{task-id}
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.



# Upscaler Precision V2 – AI Image Upscaling API
Source: https://docs.freepik.com/api-reference/image-upscaler-precision-v2/overview

Upscale images with Precision V2. Advanced detail enhancement with sharpen, smart grain, and ultra detail controls. Scale 2x to 16x with photo and illustration flavors.

<Frame>
  <video>
    <source type="video/webm" />

    Your browser does not support the video tag.
  </video>
</Frame>

<Card title="Freepik API uses Magnific.ai technology, now available as a comprehensive API service." icon="arrow-up-right-dots">
  Precision V2 delivers enhanced upscaling with fine-grained controls for sharpness, texture, and detail while preserving image fidelity.
</Card>

Upscaler Precision V2 is an advanced image upscaling API that enhances resolution while intelligently adding details and improving image quality. Building on the original Precision upscaler, V2 introduces granular control over sharpness, grain texture, and ultra-fine detail enhancement. The API supports multiple image types through specialized processing flavors optimized for photos, illustrations, and noisy images. Looking for creative, prompt-guided upscaling? See <a href="/api-reference/image-upscaler-creative/image-upscaler">Upscaler Creative</a>.

### Key capabilities

* **Scale factors 2x to 16x**: Multiply image dimensions from 2x up to 16x (up to 256x total pixels)
* **Sharpen control**: Adjustable sharpening intensity (0-100, default 7) for edge definition and clarity
* **Smart grain**: Intelligent texture enhancement (0-100, default 7) to preserve natural film grain and prevent artificial smoothness
* **Ultra detail**: Fine detail enhancement level (0-100, default 30) for textures, patterns, and micro-details
* **Processing flavors**: Three optimized modes: `sublime` for illustrations, `photo` for photographs, `photo_denoiser` for noisy images
* **Async processing**: Webhook notifications or polling for task completion
* **Flexible input**: Accepts HTTPS URLs or base64-encoded images

### Use cases

* **E-commerce**: Upscale product photos with enhanced sharpness while preserving color accuracy and texture
* **Photography restoration**: Enhance old photos with smart grain to maintain natural film characteristics
* **Print production**: Scale digital images for large-format printing with ultra detail for crisp output
* **Illustration enhancement**: Upscale digital art with the sublime flavor for smooth gradients and vibrant colors
* **Real estate**: Enhance property photos with the photo flavor for realistic detail preservation
* **Archival digitization**: Restore scanned documents and photos with noise reduction via photo\_denoiser

### Upscale images with Precision V2

Create an upscaling task by submitting a request to the API. The service returns a task ID for async polling or webhook notification.

<div>
  <Columns>
    <Card title="POST /v1/ai/image-upscaler-precision-v2" icon="arrow-up-right-dots" href="/api-reference/image-upscaler-precision-v2/post-image-upscaler-precision-v2">
      Create a new image upscaling task
    </Card>

    <Card title="GET /v1/ai/image-upscaler-precision-v2" icon="list" href="/api-reference/image-upscaler-precision-v2/get-image-upscaler-precision-v2">
      List all Precision V2 tasks
    </Card>

    <Card title="GET /v1/ai/image-upscaler-precision-v2/{task-id}" icon="magnifying-glass" href="/api-reference/image-upscaler-precision-v2/get-{task-id}-by-id">
      Get task status and results by ID
    </Card>
  </Columns>
</div>

### Parameters

| Parameter      | Type                  | Required | Default | Description                                                               |
| -------------- | --------------------- | -------- | ------- | ------------------------------------------------------------------------- |
| `image`        | `string`              | Yes      | -       | Source image as HTTPS URL or base64-encoded string                        |
| `scale_factor` | `integer` or `string` | No       | -       | Scaling multiplier: 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, or 16 |
| `sharpen`      | `integer`             | No       | `7`     | Sharpness intensity (0-100). Higher values increase edge definition       |
| `smart_grain`  | `integer`             | No       | `7`     | Grain/texture enhancement (0-100). Preserves natural film grain           |
| `ultra_detail` | `integer`             | No       | `30`    | Fine detail level (0-100). Controls textures and micro-details            |
| `flavor`       | `string`              | No       | -       | Processing mode: `sublime`, `photo`, or `photo_denoiser`                  |
| `webhook_url`  | `string`              | No       | -       | URL for completion notification with task status and output URL           |

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is Upscaler Precision V2 and how does it work?">
    Upscaler Precision V2 is an AI-powered image upscaling API that increases image resolution while intelligently enhancing details. You submit an image via URL or base64, receive a task ID, then poll for results or receive a webhook notification when processing completes. The API adds fine details based on the content type and your parameter settings.
  </Accordion>

  <Accordion title="What is the difference between Precision V2 and Precision V1?">
    Precision V2 introduces granular control parameters that V1 does not have: sharpen (edge definition), smart\_grain (texture preservation), and ultra\_detail (micro-detail enhancement). V2 also supports processing flavors optimized for different image types. Use V2 when you need fine-tuned control over the upscaling output.
  </Accordion>

  <Accordion title="What are the processing flavors and when should I use each?">
    The three flavors are: **sublime** for artistic and illustrated images with smooth gradients and vibrant colors; **photo** for photographic images preserving natural colors and realistic details; **photo\_denoiser** for photos with noise reduction, ideal for low-light or grainy photographs. Choose based on your source image type.
  </Accordion>

  <Accordion title="How do sharpen, smart_grain, and ultra_detail affect results?">
    **Sharpen** (default 7) controls edge clarity and definition. **Smart grain** (default 7) adds natural texture to prevent artificial smoothness. **Ultra detail** (default 30) enhances fine patterns and micro-details. All range from 0-100. Start with defaults and adjust based on your specific image needs.
  </Accordion>

  <Accordion title="What scale factors are supported?">
    Precision V2 supports scale factors from 2 to 16. A scale factor of 2 doubles dimensions (4x total pixels), while 16 increases dimensions 16-fold (256x total pixels). Higher scale factors increase processing time and output file size.
  </Accordion>

  <Accordion title="What are the rate limits for Upscaler Precision V2?">
    Rate limits vary by subscription tier. See the <a href="/ratelimits">Rate Limits</a> page for current limits by plan.
  </Accordion>

  <Accordion title="How much does Upscaler Precision V2 cost?">
    Pricing is based on output image area in pixels, determined by input dimensions and scale factor. See the <a href="/pricing">Pricing</a> page for current rates and subscription options.
  </Accordion>

  <Accordion title="What is the difference between Precision V2 and Upscaler Creative?">
    **Precision V2** focuses on faithful upscaling with controlled detail enhancement, preserving the original content while adding sharpness and texture. **Creative** uses prompts to introduce or infer new visual elements and stylization. Choose Precision V2 when fidelity matters; choose Creative when you want artistic enhancement.
  </Accordion>
</AccordionGroup>

## Best practices

* **Input quality**: Start from the highest-quality source available. Avoid heavily compressed images as artifacts may be amplified
* **Flavor selection**: Use `sublime` for illustrations and digital art, `photo` for natural photographs, `photo_denoiser` for noisy or low-light images
* **Parameter tuning**: Start with default values (sharpen: 7, smart\_grain: 7, ultra\_detail: 30) and adjust incrementally based on results
* **Scale factor**: Begin with 2x-4x for most use cases. Higher factors (8x-16x) work best with high-quality source images
* **Grain for realism**: Increase smart\_grain for photographic images to avoid the "plastic" look common in AI upscaling
* **Production integration**: Use webhooks instead of polling for scalable, event-driven applications
* **Error handling**: Implement retry logic with exponential backoff for 503 errors during high traffic

## Related APIs

* **[Upscaler Creative](/api-reference/image-upscaler-creative/image-upscaler)**: Prompt-guided upscaling with creative detail generation and stylization
* **[Upscaler Precision](/api-reference/image-upscaler-precision/image-upscaler)**: Original precision upscaler without V2's granular controls


# Upscaler Precision V2 - Upscale image
Source: https://docs.freepik.com/api-reference/image-upscaler-precision-v2/post-image-upscaler-precision-v2

post /v1/ai/image-upscaler-precision-v2
Upscales an image while adding new visual elements or details (V2).
This endpoint may modify the original image content based on the prompt and inferred context.




# Upscaler Precision - List tasks
Source: https://docs.freepik.com/api-reference/image-upscaler-precision/get-image-upscaler-precision

get /v1/ai/image-upscaler-precision
Returns a list of all precision upscaler tasks. Each task includes its ID, current status, and output URL if completed.



# Upscaler Precision - Get task status
Source: https://docs.freepik.com/api-reference/image-upscaler-precision/get-{task-id}-by-id

get /v1/ai/image-upscaler-precision/{task-id}
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.



# Upscaler Precision – High‑Fidelity Super‑Resolution (No Hallucinations)
Source: https://docs.freepik.com/api-reference/image-upscaler-precision/image-upscaler

High‑fidelity AI upscaling that preserves original content, small text/UI, and fine details without adding new elements. Ideal for logos, UI, and product photos.

<Frame>
  <video>
    <source type="video/webm" />

    Your browser does not support the video tag.
  </video>
</Frame>

<Card title="Freepik API uses Magnific.ai technology, now available as a comprehensive API service." icon="circle-exclamation">
  Precision mode focuses on faithful super‑resolution without hallucinations—best choice when preserving content is critical.
</Card>

The Freepik Upscaler Precision focuses on faithful, high-fidelity upscaling. It increases resolution while preserving the original content, texture, and structure of the image. Unlike creative upscaling, Precision prioritizes clarity, sharpness, and detail recovery without inventing new elements. Looking for stylized or prompt‑guided enhancement? See <a href="/api-reference/image-upscaler-creative/image-upscaler">Upscaler Creative</a>.

With advanced super-resolution techniques, Upscaler Precision:

* Preserves edges and fine details while minimizing halos
* Reduces noise and compression artifacts
* Maintains color consistency and natural look
* Enhances readability for small text and UI elements

### Use cases (Precision)

Upscaler Precision is ideal when you need quality improvements without altering the content:

* E‑commerce product photos: sharpen edges, remove artifacts, preserve true colors
* Branding and logos: upscale raster logos and icons with crisp lines
* UI assets and screenshots: improve sharpness while keeping pixel-accurate layouts
* Photography restoration and scans: reduce noise and recover fine detail
* Technical diagrams and architectural drawings: preserve thin lines and text
* Social media and web images: upscale for higher-DPI displays without distortion

### Upscale an image with Upscaler Precision

Create a precision upscaling task for an image.

<div>
  <Columns>
    <Card title="POST /v1/ai/image-upscaler-precision" icon="code" href="/api-reference/image-upscaler-precision/post-image-upscaler-precision">
      Upscale an image with Precision mode
    </Card>
  </Columns>
</div>

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="Is this the same technology as Magnific.ai?">
    Yes! Magnific.ai is part of Freepik and we are happy to offer the same technology in an API service. If you tried Magnific.ai before, you will get the same technology and its future updates.
  </Accordion>

  <Accordion title="How much does the Magnific Upscaler cost?">
    The cost per image upscale is based on the output image area in pixels. This depends on two key factors:

    * The dimensions of the input image
    * The upscale factor applied (e.g.: 2x, 4x, 8x, 16x)

    The larger the output image area, the higher the cost per upscale. Our pricing tiers are applied based on the final output size, so you have complete transparency and control over your usage.

    Some examples:

    | Input Size | Output Size | Upscale Factor | Price |
    | ---------- | ----------- | -------------- | ----- |
    | 640x480    | 1280x960    | 2x             | €0.10 |
    | 640x480    | 2560x1920   | 4x             | €0.20 |
    | 640x480    | 5120x3840   | 8x             | €0.50 |
    | 1280x720   | 2560x1440   | 2x             | €0.10 |
    | 1280x720   | 5120x2880   | 4x             | €0.40 |
    | 1920x1080  | 3840x2160   | 2x             | €0.20 |

    The pricing structure ensures that you only pay for the level of upscaling you need.
  </Accordion>

  <Accordion title="What’s the difference between Upscaler Precision and Upscaler Creative?">
    <strong>Precision</strong> preserves the original content and improves clarity, detail, and sharpness without inventing new elements. It is ideal for logos, UI assets, product photos, scans, and technical diagrams.

    <strong>Creative</strong> can introduce or infer new visual details guided by prompts or context. It is better for artistic enhancement, stylization, or imaginative detail addition.
  </Accordion>

  <Accordion title="When should I choose Precision over Creative?">
    Choose <strong>Precision</strong> when fidelity is critical: brand consistency, readable text, pixel-accurate UI, and product authenticity. Choose <strong>Creative</strong> when you want stylistic enhancements or new visual elements.
  </Accordion>

  <Accordion title="What file formats and sizes work best?">
    Prefer PNG for graphics/logos and high-quality JPEG/PNG for photos. Avoid heavily compressed sources. For best results, use inputs large enough to contain the essential detail (e.g., at least 256–512 px on the shortest edge), then upscale 2x–4x.
  </Accordion>

  <Accordion title="Does Precision fix blurry text or small UI elements?">
    Precision improves edge sharpness and micro-contrast, which can make small text and UI icons more legible. Extremely low-resolution or heavily blurred originals may still have limits.
  </Accordion>
</AccordionGroup>

## Best practices for Upscaler Precision

Follow these recommendations to get the best, most faithful results:

* Start from the highest-quality source you have (avoid heavy-compressed inputs).
* Prefer PNG or high-quality JPEG; keep artifacts minimal in the input.
* Choose moderate upscale factors first (2x–4x) to avoid amplifying noise; iterate if needed.
* Disable any creative prompts or stylization when fidelity is critical.
* For logos/UI, use crisp sources with strong contrast; avoid anti-aliased tiny originals.
* When upscaling scans, pre-trim borders and rotate/crop to the correct orientation.
* Compare results at 100% zoom to validate line sharpness and color consistency.

### Image Input Quality

How you send your image directly impacts the output quality:

| Action                                     | Quality Impact             |
| ------------------------------------------ | -------------------------- |
| Send URL of original image                 | ✅ Maximum quality          |
| Send base64 of original file read directly | ✅ Maximum quality          |
| Use `canvas.toDataURL('image/jpeg')`       | ❌ \~8% quality loss        |
| Use `canvas.toDataURL('image/jpeg', 0.8)`  | ❌ \~20% quality loss       |
| Resize image before sending                | ❌ Significant quality loss |
| Convert PNG → JPEG before sending          | ❌ Quality loss             |

<Tip>
  **Recommended:** Send the original image via URL whenever possible. This ensures the upscaler receives the highest quality input.
</Tip>


# Upscaler Precision - Upscale image
Source: https://docs.freepik.com/api-reference/image-upscaler-precision/post-image-upscaler-precision

post /v1/ai/image-upscaler-precision
Upscales an image while adding new visual elements or details.
This endpoint may modify the original image content based on the prompt and inferred context.




# Improve Prompt - List tasks
Source: https://docs.freepik.com/api-reference/improve-prompt/get-improve-prompt

get /v1/ai/improve-prompt
Get the status of all improve-prompt tasks



# Improve Prompt - Get task status
Source: https://docs.freepik.com/api-reference/improve-prompt/get-{task-id}-by-id

get /v1/ai/improve-prompt/{task-id}
Get the status of one improve-prompt task



# Improve Prompt - AI Prompt Enhancement API | Freepik API
Source: https://docs.freepik.com/api-reference/improve-prompt/overview

Enhance text prompts for AI image and video generation. Transform basic descriptions into detailed, optimized prompts with language support. Improve generation results automatically.

<Card title="AI-powered prompt enhancement" icon="pen-fancy">
  Transform simple text descriptions into optimized prompts for AI image and video generation, improving output quality automatically.
</Card>

Improve Prompt is an AI-powered prompt enhancement API that transforms basic text descriptions into detailed, optimized prompts for AI generation. Submit a simple prompt like "a cat" and receive an enhanced version with specific details about lighting, composition, style, and atmosphere. The API supports both image and video generation prompts, with multi-language output capabilities.

### Key capabilities

* **Dual-mode enhancement**: Optimize prompts for either image or video generation with mode-specific improvements
* **Multi-language support**: Output enhanced prompts in any language using ISO 639-1 codes (e.g., `en`, `es`, `fr`, `de`)
* **Creative generation**: Submit an empty prompt to generate creative ideas from scratch
* **Maximum prompt length**: Input prompts up to 2,500 characters for comprehensive enhancement
* **Context-aware improvements**: Adds relevant details for lighting, composition, style, mood, and technical parameters
* **Async processing**: Webhook notifications or polling for task completion

### Use cases

* **Text-to-image workflows**: Enhance prompts before sending to Flux, Mystic, or other image generation APIs
* **Video generation preparation**: Optimize prompts for Kling, WAN, or other video generation models
* **Creative brainstorming**: Generate detailed creative prompts from minimal input or ideas
* **Non-English content creation**: Create prompts in your preferred language for localized projects
* **Batch processing pipelines**: Automate prompt enhancement in production workflows
* **Quality improvement**: Consistently achieve better AI generation results with optimized prompts

### Enhance prompts with Improve Prompt

Submit a text prompt with the target generation type (image or video). The service returns a task ID for async polling or webhook notification.

<div>
  <Columns>
    <Card title="POST /v1/ai/improve-prompt" icon="pen-fancy" href="/api-reference/improve-prompt/post-improve-prompt">
      Create a new prompt enhancement task
    </Card>

    <Card title="GET /v1/ai/improve-prompt" icon="list" href="/api-reference/improve-prompt/get-improve-prompt">
      List all prompt enhancement tasks
    </Card>

    <Card title="GET /v1/ai/improve-prompt/{task-id}" icon="magnifying-glass" href="/api-reference/improve-prompt/get-{task-id}-by-id">
      Get task status and results by ID
    </Card>
  </Columns>
</div>

### Parameters

| Parameter     | Type     | Required | Default | Description                                                                                                             |
| ------------- | -------- | -------- | ------- | ----------------------------------------------------------------------------------------------------------------------- |
| `prompt`      | `string` | Yes      | -       | Text prompt to improve for AI generation. Can be empty to generate a creative prompt. Maximum length: 2,500 characters. |
| `type`        | `string` | Yes      | -       | Type of generation to optimize for: `"image"` or `"video"`                                                              |
| `language`    | `string` | No       | `"en"`  | Language code for the improved prompt (ISO 639-1 format, e.g., `"en"`, `"es"`, `"fr"`)                                  |
| `webhook_url` | `string` | No       | -       | URL for task completion notification                                                                                    |

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is Improve Prompt and how does it work?">
    Improve Prompt is an AI-powered API that enhances basic text descriptions into detailed, optimized prompts for AI image or video generation. You submit a simple prompt (e.g., "a sunset") with the target type (image or video), receive a task ID immediately, then poll for results or receive a webhook notification. The output is an enhanced prompt with added details about composition, lighting, style, and technical parameters.
  </Accordion>

  <Accordion title="What is the difference between image and video prompt types?">
    The `type` parameter determines how the prompt is optimized. For `"image"` prompts, the API adds details about composition, lighting, color palette, and visual style. For `"video"` prompts, it includes motion descriptions, camera movements, temporal flow, and cinematic elements that help video generation models produce better results.
  </Accordion>

  <Accordion title="Can I generate prompts in languages other than English?">
    Yes. Use the `language` parameter with any ISO 639-1 language code (e.g., `"es"` for Spanish, `"fr"` for French, `"de"` for German, `"ja"` for Japanese). The enhanced prompt will be returned in your specified language. Default is English (`"en"`).
  </Accordion>

  <Accordion title="What happens if I submit an empty prompt?">
    When you submit an empty prompt, the API generates a creative prompt from scratch. This is useful for brainstorming or when you want AI-generated creative ideas for image or video generation.
  </Accordion>

  <Accordion title="What is the maximum prompt length?">
    Input prompts can be up to 2,500 characters. This allows you to provide detailed context that the API will further enhance and optimize.
  </Accordion>

  <Accordion title="How long does prompt enhancement take?">
    Prompt enhancement typically completes within 2-5 seconds. For production workflows, use webhooks instead of polling to receive immediate notification when tasks complete.
  </Accordion>

  <Accordion title="What are the rate limits for Improve Prompt?">
    Rate limits vary by subscription tier. See [Rate Limits](/ratelimits) for current limits.
  </Accordion>

  <Accordion title="How much does Improve Prompt cost?">
    See the [Pricing page](/pricing) for current rates and subscription options.
  </Accordion>
</AccordionGroup>

## Best practices

* **Be specific**: Even simple prompts benefit from context - include subject, action, or mood hints
* **Choose the right type**: Use `"image"` for static visuals and `"video"` for motion content
* **Language matching**: Set the language parameter to match your target audience or downstream model preferences
* **Chain with generation**: Pipe enhanced prompts directly to Flux, Mystic, Kling, or other generation APIs
* **Production integration**: Use webhooks instead of polling for scalable applications
* **Error handling**: Implement retry logic with exponential backoff for 503 errors

## Related APIs

* **[Freepik Mystic](/api-reference/mystic/mystic)**: Generate photorealistic images in 1K/2K/4K with LoRA styles
* **[Flux Pro](/api-reference/text-to-image/flux-pro-v1-1/post-flux-pro-v1-1)**: High-quality text-to-image generation with Flux Pro
* **[Kling 2.6 Pro](/api-reference/image-to-video/kling-v2.5-pro/overview)**: Generate videos from images with Kling
* **[Image to Prompt](/api-reference/image-to-prompt/post-image-to-prompt)**: Reverse process - generate prompts from images


# Improve Prompt - Enhance prompt
Source: https://docs.freepik.com/api-reference/improve-prompt/post-improve-prompt

post /v1/ai/improve-prompt
Enhance user prompts for AI image or video generation using advanced AI models.
- **Image prompts**: Improve a prompt for image generation
- **Video prompts**: Improve a prompt for video generation




# Kling O1 - Get task status
Source: https://docs.freepik.com/api-reference/kling-o1/task-by-id

get /v1/ai/image-to-video/kling-o1/{task-id}



# Latent Sync - List tasks
Source: https://docs.freepik.com/api-reference/lip-sync/latent-sync/get-latent-sync

get /v1/ai/lip-sync/latent-sync
Get the status of all Latent-Sync lip-sync tasks



# Latent Sync - Get task status
Source: https://docs.freepik.com/api-reference/lip-sync/latent-sync/get-{task-id}-by-id

get /v1/ai/lip-sync/latent-sync/{task-id}
Get the status of one Latent-Sync lip-sync task



# Latent Sync – Lip Sync API
Source: https://docs.freepik.com/api-reference/lip-sync/latent-sync/overview

Advanced AI-powered lip synchronization technology for realistic facial animation and speech-to-video matching with high-quality, production-ready outputs.

<Card title="Latent Sync integration" icon="microphone-lines">
  Powered by Latent Sync technology, this API provides state-of-the-art lip synchronization capabilities for creating realistic talking avatar videos from audio input.
</Card>

Latent Sync is an advanced AI-powered lip synchronization solution that creates realistic facial animations synchronized with audio input. It generates high-quality talking avatar videos by intelligently matching mouth movements to speech patterns, delivering natural and believable results suitable for production environments.

### Key capabilities

* High-quality lip synchronization with natural facial movements
* Support for multiple languages and accents
* Realistic expression preservation during speech animation
* Production-ready video outputs with consistent quality
* Fast processing times optimized for real-time applications

### Use cases

* Avatar creation for virtual presentations and digital content
* Video dubbing and localization with synchronized lip movements
* Interactive chatbots and virtual assistants with realistic speech
* Educational content with animated instructors or characters
* Marketing videos with personalized spokesperson animations

<div>
  <Columns>
    <Card title="POST /v1/ai/lip-sync/latent-sync" icon="video" href="/api-reference/lip-sync/latent-sync/post-latent-sync">
      Create a Latent Sync lip sync task
    </Card>

    <Card title="GET /v1/ai/lip-sync/latent-sync/{task-id}" icon="code" href="/api-reference/lip-sync/latent-sync/get-{task-id}-by-id">
      Check Latent Sync task status
    </Card>

    <Card title="GET /v1/ai/lip-sync/latent-sync" icon="list" href="/api-reference/lip-sync/latent-sync/get-latent-sync">
      List Latent Sync tasks
    </Card>
  </Columns>
</div>

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What audio formats are supported for lip sync?">
    Latent Sync supports common audio formats including MP3, WAV, and AAC. The API automatically processes the audio to extract speech patterns for optimal lip synchronization.
  </Accordion>

  <Accordion title="How accurate is the lip synchronization?">
    Latent Sync uses advanced AI models trained specifically for speech-to-lip mapping, providing highly accurate synchronization that maintains natural facial expressions and realistic mouth movements.
  </Accordion>

  <Accordion title="Can I use custom avatar images or videos?">
    Yes, you can provide your own base images or videos that will be animated with synchronized lip movements. The system works best with clear, front-facing portraits.
  </Accordion>

  <Accordion title="What languages are supported?">
    Latent Sync supports multiple languages and can handle various accents and speech patterns. The AI model adapts to different linguistic characteristics for optimal results.
  </Accordion>

  <Accordion title="Are the outputs suitable for commercial use?">
    Yes, Latent Sync generates production-quality videos suitable for commercial applications, marketing content, and professional presentations.
  </Accordion>
</AccordionGroup>


# Latent Sync - Lip-sync video generation
Source: https://docs.freepik.com/api-reference/lip-sync/latent-sync/post-latent-sync

post /v1/ai/lip-sync/latent-sync
Generate lip-synced video by synchronizing a video with an audio file using AI Latent-Sync technology



# Veed Fabric 1.0 Fast - Generate talking video
Source: https://docs.freepik.com/api-reference/lip-sync/veed-fabric-1-0-fast/generate

post /v1/ai/lip-sync/veed-fabric-1-0-fast
Generate a realistic talking video by combining a static portrait image with an audio file using Veed Fabric 1.0 Fast.
This is the faster variant of Veed Fabric 1.0, optimized for reduced generation time while maintaining quality lip synchronization.
Ideal for workflows requiring quick turnaround on talking head video generation.




# Veed Fabric 1.0 Fast API
Source: https://docs.freepik.com/api-reference/lip-sync/veed-fabric-1-0-fast/overview

Generate talking videos with faster processing using Veed Fabric 1.0 Fast. Lip-synced MP4 output at 720p or 480p from a portrait image and audio file.

<Card title="Veed Fabric 1.0 Fast integration" icon="microphone-lines">
  Powered by Veed Fabric 1.0 Fast technology, this API generates talking head videos with optimized processing time for faster turnaround.
</Card>

Veed Fabric 1.0 Fast is an AI-powered lip synchronization API optimized for reduced generation time. It creates talking videos from a static portrait image and an audio file, producing an MP4 video with natural lip movements synchronized to the speech. This variant prioritizes faster processing while maintaining quality lip-sync results, making it suitable for workflows that require quick turnaround. Output resolution is configurable at 720p (1280x720) or 480p (854x480).

### Key capabilities

* **Faster processing**: Optimized generation pipeline for reduced turnaround time compared to Veed Fabric 1.0
* **Image + audio input**: Combine a portrait photo with an audio file (MP3, WAV, M4A) to generate a talking video
* **Resolution options**: Output at `720p` (1280x720) for production use or `480p` (854x480) for drafts
* **Natural lip sync**: AI-driven mouth movement generation that matches speech patterns
* **Async processing**: Webhook notifications or polling for task completion

### Use cases

* **Rapid prototyping**: Quickly preview talking head videos before committing to full-quality generation
* **High-volume production**: Process large batches of lip-sync videos with faster turnaround
* **Real-time content**: Create time-sensitive marketing or social media videos
* **A/B testing**: Generate multiple video variants quickly for testing different audio or images
* **Live campaigns**: Produce personalized video responses at scale with minimal latency

### Generate talking video with Veed Fabric 1.0 Fast

Submit a portrait image URL and audio file URL along with the desired resolution. The service returns a task ID for async polling or webhook notification.

<div>
  <Columns>
    <Card title="POST /v1/ai/lip-sync/veed-fabric-1-0-fast" icon="microphone-lines" href="/api-reference/lip-sync/veed-fabric-1-0-fast/generate">
      Create a new fast lip-sync video generation task
    </Card>

    <Card title="GET /v1/ai/lip-sync/veed-fabric-1-0-fast" icon="list" href="/api-reference/lip-sync/veed-fabric-1-0-fast/veed-fabric-1-0-fast-tasks">
      List all Veed Fabric 1.0 Fast tasks
    </Card>

    <Card title="GET /v1/ai/lip-sync/veed-fabric-1-0-fast/{task-id}" icon="magnifying-glass" href="/api-reference/lip-sync/veed-fabric-1-0-fast/task-by-id">
      Get task status and results by ID
    </Card>
  </Columns>
</div>

### Parameters

| Parameter     | Type     | Required | Default | Description                                                                                                         |
| ------------- | -------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------- |
| `image_url`   | `string` | Yes      | -       | URL of the portrait image to animate. Must be publicly accessible. Use a clear, front-facing photo for best results |
| `audio_url`   | `string` | Yes      | -       | URL of the audio file for lip synchronization. Supported formats: MP3, WAV, M4A. Must be publicly accessible        |
| `resolution`  | `string` | Yes      | -       | Output video resolution: `"720p"` (1280x720) or `"480p"` (854x480)                                                  |
| `webhook_url` | `string` | No       | -       | HTTPS URL for task completion notification                                                                          |

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is Veed Fabric 1.0 Fast and how does it work?">
    Veed Fabric 1.0 Fast is an optimized variant of Veed Fabric 1.0 designed for faster lip-sync video generation. You submit an image URL and audio URL via the API, receive a task ID immediately, then poll for results or receive a webhook notification when processing completes. The output is an MP4 video with the person speaking in sync with the provided audio.
  </Accordion>

  <Accordion title="What image formats does Veed Fabric 1.0 Fast accept?">
    Veed Fabric 1.0 Fast accepts common image formats via a publicly accessible URL. For best lip-sync results, use a clear, front-facing portrait photo where the face is fully visible and well-lit.
  </Accordion>

  <Accordion title="What audio formats are supported?">
    Veed Fabric 1.0 Fast supports MP3, WAV, and M4A audio formats. The audio file must be hosted at a publicly accessible URL.
  </Accordion>

  <Accordion title="What output resolutions are available?">
    Two resolutions are available: `720p` (1280x720) for production-quality output and `480p` (854x480) for drafts or faster processing.
  </Accordion>

  <Accordion title="What is the difference between Veed Fabric 1.0 Fast and Veed Fabric 1.0?">
    Veed Fabric 1.0 Fast is optimized for reduced generation time while maintaining quality lip synchronization. Veed Fabric 1.0 prioritizes maximum generation fidelity. Choose Veed Fabric 1.0 Fast when speed and throughput are the priority, or Veed Fabric 1.0 when you need the highest quality output.
  </Accordion>

  <Accordion title="What are the rate limits for Veed Fabric 1.0 Fast?">
    Rate limits vary by subscription tier. See [Rate Limits](/ratelimits) for current limits.
  </Accordion>

  <Accordion title="How much does Veed Fabric 1.0 Fast cost?">
    See the [Pricing page](/pricing) for current rates and subscription options.
  </Accordion>
</AccordionGroup>

## Best practices

* **Image quality**: Use well-lit, front-facing portrait photos with a clearly visible face for the most accurate lip sync
* **Audio clarity**: Clean audio with minimal background noise produces better lip-sync accuracy
* **Resolution choice**: Use `720p` for final production videos and `480p` for quick previews or prototyping
* **Speed vs quality**: Use Veed Fabric 1.0 Fast for high-volume or time-sensitive workflows; switch to Veed Fabric 1.0 for maximum quality
* **Production integration**: Use webhooks instead of polling for scalable applications
* **Error handling**: Implement retry logic with exponential backoff for 503 errors

## Related APIs

* **[Veed Fabric 1.0](/api-reference/lip-sync/veed-fabric-1-0/overview)**: Higher fidelity lip-sync generation for quality-focused workflows
* **[Latent Sync](/api-reference/lip-sync/latent-sync/overview)**: Alternative lip synchronization technology
* **[Voiceover](/api-reference/voiceover/overview)**: Generate speech audio from text to use as lip-sync input
* **[Sound Effects](/api-reference/sound-effects/overview)**: Generate sound effects from text descriptions


# Veed Fabric 1.0 Fast - Get task status
Source: https://docs.freepik.com/api-reference/lip-sync/veed-fabric-1-0-fast/task-by-id

get /v1/ai/lip-sync/veed-fabric-1-0-fast/{task-id}
Retrieve a specific Veed Fabric 1.0 Fast lip-sync task by its ID, including generation status and result URL when completed.



# Veed Fabric 1.0 Fast - List tasks
Source: https://docs.freepik.com/api-reference/lip-sync/veed-fabric-1-0-fast/veed-fabric-1-0-fast-tasks

get /v1/ai/lip-sync/veed-fabric-1-0-fast
Retrieve all Veed Fabric 1.0 Fast lip-sync tasks for the authenticated user.



# Veed Fabric 1.0 - Generate talking video
Source: https://docs.freepik.com/api-reference/lip-sync/veed-fabric-1-0/generate

post /v1/ai/lip-sync/veed-fabric-1-0
Generate a realistic talking video by combining a static portrait image with an audio file using Veed Fabric 1.0.
The model produces a lip-synced video (MP4) where the person in the image speaks naturally in sync with the provided audio.
Ideal for creating talking head videos from a single photo and voice recording.




# Veed Fabric 1.0 API
Source: https://docs.freepik.com/api-reference/lip-sync/veed-fabric-1-0/overview

Generate realistic talking videos from a portrait image and audio file with Veed Fabric 1.0. Lip-synced MP4 output at 720p or 480p resolution for marketing, e-learning, and content creation.

<Card title="Veed Fabric 1.0 integration" icon="microphone-lines">
  Powered by Veed Fabric 1.0 technology, this API generates realistic talking head videos by synchronizing lip movements to audio input.
</Card>

Veed Fabric 1.0 is an AI-powered lip synchronization API that creates realistic talking videos from a static portrait image and an audio file. The model analyzes the speech patterns in the audio and animates the person in the image with natural lip movements, producing an MP4 video where the subject appears to speak in sync with the provided audio. Output resolution is configurable at 720p (1280x720) or 480p (854x480).

### Key capabilities

* **Image + audio input**: Combine a portrait photo with an audio file (MP3, WAV, M4A) to generate a talking video
* **Resolution options**: Output at `720p` (1280x720) for production use or `480p` (854x480) for drafts and faster processing
* **Natural lip sync**: AI-driven mouth movement generation that matches speech patterns accurately
* **MP4 video output**: Generates a downloadable MP4 video file with the animated portrait
* **Async processing**: Webhook notifications or polling for task completion

### Use cases

* **Marketing videos**: Create personalized spokesperson videos from a single photo
* **E-learning**: Animate instructors for training materials and educational content
* **Social media**: Generate talking head content at scale for multiple platforms
* **Customer support**: Build video responses with consistent brand representatives
* **Localization**: Produce dubbed videos with lip-synced speech in different languages

### Generate talking video with Veed Fabric 1.0

Submit a portrait image URL and audio file URL along with the desired resolution. The service returns a task ID for async polling or webhook notification.

<div>
  <Columns>
    <Card title="POST /v1/ai/lip-sync/veed-fabric-1-0" icon="microphone-lines" href="/api-reference/lip-sync/veed-fabric-1-0/generate">
      Create a new lip-sync video generation task
    </Card>

    <Card title="GET /v1/ai/lip-sync/veed-fabric-1-0" icon="list" href="/api-reference/lip-sync/veed-fabric-1-0/veed-fabric-1-0-tasks">
      List all Veed Fabric 1.0 tasks
    </Card>

    <Card title="GET /v1/ai/lip-sync/veed-fabric-1-0/{task-id}" icon="magnifying-glass" href="/api-reference/lip-sync/veed-fabric-1-0/task-by-id">
      Get task status and results by ID
    </Card>
  </Columns>
</div>

### Parameters

| Parameter     | Type     | Required | Default | Description                                                                                                         |
| ------------- | -------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------- |
| `image_url`   | `string` | Yes      | -       | URL of the portrait image to animate. Must be publicly accessible. Use a clear, front-facing photo for best results |
| `audio_url`   | `string` | Yes      | -       | URL of the audio file for lip synchronization. Supported formats: MP3, WAV, M4A. Must be publicly accessible        |
| `resolution`  | `string` | Yes      | -       | Output video resolution: `"720p"` (1280x720) or `"480p"` (854x480)                                                  |
| `webhook_url` | `string` | No       | -       | HTTPS URL for task completion notification                                                                          |

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is Veed Fabric 1.0 and how does it work?">
    Veed Fabric 1.0 is an AI lip-sync API that generates realistic talking videos from a static portrait image and an audio file. You submit an image URL and audio URL via the API, receive a task ID immediately, then poll for results or receive a webhook notification when processing completes. The output is an MP4 video where the person in the image speaks in sync with the provided audio.
  </Accordion>

  <Accordion title="What image formats does Veed Fabric 1.0 accept?">
    Veed Fabric 1.0 accepts common image formats via a publicly accessible URL. For best lip-sync results, use a clear, front-facing portrait photo where the face is fully visible and well-lit.
  </Accordion>

  <Accordion title="What audio formats are supported?">
    Veed Fabric 1.0 supports MP3, WAV, and M4A audio formats. The audio file must be hosted at a publicly accessible URL. The model analyzes speech patterns in the audio to generate matching lip movements.
  </Accordion>

  <Accordion title="What output resolutions are available?">
    Two resolutions are available: `720p` (1280x720) for production-quality output and `480p` (854x480) for drafts or faster processing. The resolution is set via the required `resolution` parameter.
  </Accordion>

  <Accordion title="What is the difference between Veed Fabric 1.0 and Veed Fabric 1.0 Fast?">
    Veed Fabric 1.0 prioritizes generation quality with higher fidelity lip synchronization. Veed Fabric 1.0 Fast is optimized for reduced generation time while maintaining quality lip-sync results. Choose Veed Fabric 1.0 when output quality is the priority, or Veed Fabric 1.0 Fast when speed is more important.
  </Accordion>

  <Accordion title="What are the rate limits for Veed Fabric 1.0?">
    Rate limits vary by subscription tier. See [Rate Limits](/ratelimits) for current limits.
  </Accordion>

  <Accordion title="How much does Veed Fabric 1.0 cost?">
    See the [Pricing page](/pricing) for current rates and subscription options.
  </Accordion>
</AccordionGroup>

## Best practices

* **Image quality**: Use well-lit, front-facing portrait photos with a clearly visible face for the most accurate lip sync
* **Audio clarity**: Clean audio with minimal background noise produces better lip-sync accuracy
* **Resolution choice**: Use `720p` for final production videos and `480p` for quick previews or prototyping
* **Production integration**: Use webhooks instead of polling for scalable applications
* **Error handling**: Implement retry logic with exponential backoff for 503 errors

## Related APIs

* **[Veed Fabric 1.0 Fast](/api-reference/lip-sync/veed-fabric-1-0-fast/overview)**: Faster lip-sync generation with optimized processing time
* **[Latent Sync](/api-reference/lip-sync/latent-sync/overview)**: Alternative lip synchronization technology
* **[Voiceover](/api-reference/voiceover/overview)**: Generate speech audio from text to use as lip-sync input
* **[Sound Effects](/api-reference/sound-effects/overview)**: Generate sound effects from text descriptions


# Veed Fabric 1.0 - Get task status
Source: https://docs.freepik.com/api-reference/lip-sync/veed-fabric-1-0/task-by-id

get /v1/ai/lip-sync/veed-fabric-1-0/{task-id}
Retrieve a specific Veed Fabric 1.0 lip-sync task by its ID, including generation status and result URL when completed.



# Veed Fabric 1.0 - List tasks
Source: https://docs.freepik.com/api-reference/lip-sync/veed-fabric-1-0/veed-fabric-1-0-tasks

get /v1/ai/lip-sync/veed-fabric-1-0
Retrieve all Veed Fabric 1.0 lip-sync tasks for the authenticated user.



# Music Generation - Generate from text
Source: https://docs.freepik.com/api-reference/music-generation/generate

post /v1/ai/music-generation
Generate original music tracks from text descriptions using AI.

Create high-quality music compositions based on your text prompts. Specify genre, mood, instruments, and tempo to get exactly the sound you need. Perfect for video production, game development, podcasts, and multimedia projects.

**Tips for effective prompts:**
- Include genre: "jazz", "electronic", "classical", "rock"
- Describe mood: "upbeat", "melancholic", "energetic", "peaceful"
- Mention instruments: "piano", "guitar", "drums", "synthesizer"
- Add tempo hints: "slow", "fast-paced", "moderate groove"




# Music Generation - List tasks
Source: https://docs.freepik.com/api-reference/music-generation/music-generation-tasks

get /v1/ai/music-generation
Get the status of all music-generation tasks



# ElevenLabs Music API
Source: https://docs.freepik.com/api-reference/music-generation/overview

Generate original music from text with ElevenLabs Music. Create 10-240 second tracks in any genre for videos, games, and ads.

<Card title="ElevenLabs Music integration" icon="music">
  Powered by ElevenLabs technology, this API generates original music tracks from text descriptions.
</Card>

ElevenLabs Music is an AI-powered music generation API that creates original music tracks from text descriptions. Describe the style, mood, instruments, and tempo you want, and receive a high-quality MP3 audio file. The API supports customizable track durations from 10 seconds to 4 minutes, with typical generation times of 30-90 seconds.

### Key capabilities

* **Text-guided generation**: Describe any music style to generate (e.g., "Upbeat jazz with piano and drums", "Cinematic orchestral soundtrack")
* **Customizable duration**: Generate tracks from 10 seconds to 240 seconds (4 minutes)
* **High-quality output**: Professional-grade MP3 audio files suitable for production use
* **Genre flexibility**: Support for any music genre, style, or mood
* **Async processing**: Webhook notifications or polling for task completion

### Use cases

* **Video production**: Create background music for videos and presentations
* **Game development**: Generate custom soundtracks for games and apps
* **Content creation**: Produce unique music for podcasts, streams, and social media
* **Advertising**: Create original jingles and background tracks for ads
* **Film production**: Generate temp tracks or production music for films

### Generate music with ElevenLabs

Submit a text description of the music you want to create along with the desired duration. The service returns a task ID for async polling or webhook notification.

<div>
  <Columns>
    <Card title="POST /v1/ai/music-generation" icon="music" href="/api-reference/music-generation/generate">
      Create a new music generation task
    </Card>

    <Card title="GET /v1/ai/music-generation" icon="list" href="/api-reference/music-generation/music-generation-tasks">
      List all music generation tasks
    </Card>

    <Card title="GET /v1/ai/music-generation/{task-id}" icon="magnifying-glass" href="/api-reference/music-generation/task-by-id">
      Get task status and results by ID
    </Card>
  </Columns>
</div>

### Parameters

| Parameter              | Type      | Required | Default | Description                                                                                            |
| ---------------------- | --------- | -------- | ------- | ------------------------------------------------------------------------------------------------------ |
| `prompt`               | `string`  | Yes      | -       | Text description of the music to generate (e.g., "Upbeat jazz with piano", "Melancholic piano ballad") |
| `music_length_seconds` | `integer` | Yes      | -       | Duration of the generated track in seconds (10-240)                                                    |
| `webhook_url`          | `string`  | No       | -       | HTTPS URL for task completion notification                                                             |

### Prompt tips

For best results, include details about:

* **Genre**: jazz, electronic, classical, rock, ambient, etc.
* **Mood**: upbeat, melancholic, energetic, peaceful, dramatic
* **Instruments**: piano, guitar, drums, synthesizer, strings, etc.
* **Tempo**: slow, moderate, fast-paced, groove

**Example prompts:**

* "A Blues guitar solo with emotional bends and slides"
* "Upbeat electronic dance music with synthesizers and heavy bass"
* "Peaceful ambient piano with gentle strings in the background"
* "Cinematic orchestral piece building to an epic climax"
* "Modern corporate background music with light piano and subtle electronic elements"

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is ElevenLabs Music and how does it work?">
    ElevenLabs Music is an AI-powered text-to-music API. You submit a text description of the music you want (genre, mood, instruments, tempo) along with the desired duration, receive a task ID immediately, then poll for results or receive a webhook notification. The output is a high-quality MP3 audio file.
  </Accordion>

  <Accordion title="What music duration range is supported?">
    You can generate music tracks from 10 seconds (minimum) to 240 seconds / 4 minutes (maximum). The duration is specified in the `music_length_seconds` parameter.
  </Accordion>

  <Accordion title="How do I write effective music prompts?">
    Be specific about genre, mood, instruments, and tempo. Good examples: "Upbeat jazz with piano and brushed drums", "Melancholic acoustic guitar ballad", "Epic orchestral soundtrack with building tension". Avoid vague prompts like just "music" or "song".
  </Accordion>

  <Accordion title="What is the output format?">
    ElevenLabs Music outputs MP3 audio files at professional quality. The generated audio is delivered via a URL that remains accessible for download after task completion.
  </Accordion>

  <Accordion title="How long does generation take?">
    Generation typically takes 30-90 seconds depending on track duration. Shorter tracks (10-30 seconds) usually complete in under a minute, while maximum-length tracks (4 minutes) may take 1-2 minutes. For production workflows, use webhooks for efficient notification.
  </Accordion>

  <Accordion title="What are the rate limits for ElevenLabs Music?">
    Rate limits vary by subscription tier. See [Rate Limits](/ratelimits) for current limits.
  </Accordion>

  <Accordion title="How much does ElevenLabs Music cost?">
    See the [Pricing page](/pricing) for current rates and subscription options.
  </Accordion>
</AccordionGroup>

## Best practices

* **Prompt specificity**: Use detailed descriptions for better generation accuracy
* **Duration planning**: Consider your use case when selecting track length
* **Genre mixing**: Combine styles for unique results (e.g., "jazz-influenced electronic")
* **Production integration**: Use webhooks instead of polling for scalable applications
* **Error handling**: Implement retry logic with exponential backoff for 503 errors

## Related APIs

* **[Sound Effects](/api-reference/sound-effects/post-sound-effects)**: Generate sound effects from text descriptions
* **[Audio Isolation](/api-reference/audio-isolation/overview)**: Isolate specific sounds from audio files
* **[Lip Sync](/api-reference/lip-sync/latent-sync/overview)**: Synchronize lip movements to audio tracks
* **[OmniHuman 1.5](/api-reference/video/omni-human-1-5)**: Generate human animations driven by audio


# Music Generation - Get task status
Source: https://docs.freepik.com/api-reference/music-generation/task-by-id

get /v1/ai/music-generation/{task-id}
Get the status of one music-generation task



# Download music
Source: https://docs.freepik.com/api-reference/music/download-music

get /v1/music/{music-id}/download
Get a direct download URL for a music audio file. Returns the music ID, title, and a CDN-hosted download link.

Get a direct download URL for a music audio file. See the [Music API overview](/api-reference/music/overview) for authentication and usage guidance.


# Get detailed music information by ID
Source: https://docs.freepik.com/api-reference/music/get-music-by-id

get /v1/music/{music-id}
Retrieve full details for a music item including artist biography, genre and mood metadata, popularity score, and download statistics.

Retrieve full details for a music item including artist biography, genre and mood metadata, popularity score, and download statistics. See the [Music API overview](/api-reference/music/overview) for authentication and usage guidance.


# Freepik Music API
Source: https://docs.freepik.com/api-reference/music/overview

Search, filter, and download royalty-free music from the Freepik Music catalog via the Freepik API.

The Freepik Music API gives you programmatic access to the Freepik Music catalog. Search music by keyword, filter by genre and mood, and download audio files for use in your applications.

### What you can do

* Search music with full-text queries across titles and tags
* Filter by genre, mood, premium status, and creation date
* Sort results by relevance, popularity, creation date, duration, or tempo
* Get detailed music metadata including artist biography, download stats, and playlist count
* Download music audio files via CDN-hosted URLs

### Authentication

All requests require an API key via the `x-freepik-api-key` header. See the [Quickstart](/quickstart) and [Authentication](/authentication).

### Endpoints

<div>
  <Columns>
    <Card title="GET /v1/music" icon="code" href="/api-reference/music/search-music">
      Search and filter music
    </Card>

    <Card title="GET /v1/music/{music-id}" icon="code" href="/api-reference/music/get-music-by-id">
      Get detailed music information by ID
    </Card>

    <Card title="GET /v1/music/{music-id}/download" icon="code" href="/api-reference/music/download-music">
      Download a music audio file
    </Card>
  </Columns>
</div>

### Parameters overview

The search endpoint supports the following filters:

| Parameter         | Type      | Description                                                                                                                                                                                                                                 |
| ----------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `q`               | `string`  | Full-text search across titles and tags                                                                                                                                                                                                     |
| `genre`           | `string`  | Filter by genre name, comma-separated (e.g., `"Electronic,Ambient"`)                                                                                                                                                                        |
| `mood`            | `string`  | Filter by mood tag, comma-separated (e.g., `"Happy,Energetic"`)                                                                                                                                                                             |
| `include-premium` | `boolean` | Include premium content (default: `false`)                                                                                                                                                                                                  |
| `time_range`      | `string`  | Filter by creation date: `"7d"`, `"30d"`, or `"90d"`                                                                                                                                                                                        |
| `order_by`        | `string`  | Sort order: `"relevance"`, `"popularity"`, `"-popularity"`, `"created_at"`, `"-created_at"`, `"title"`, `"-title"`, `"seconds"`, `"-seconds"`, `"bpm"`, `"-bpm"`. Defaults to `"relevance"` when `q` is provided, `"-popularity"` otherwise |
| `limit`           | `integer` | Results per page: 1-1000 (default: `10`)                                                                                                                                                                                                    |
| `offset`          | `integer` | Pagination offset (default: `0`)                                                                                                                                                                                                            |

### Use cases

* Build a music browser or audio picker into your app or CMS
* Search music by genre and mood for video or podcast background music
* Programmatically download royalty-free music during content production pipelines
* Create curated playlists filtered by popularity, tempo, or release date

### FAQ

#### Is there a rate limit?

Yes. See [Rate limits](/ratelimits).

#### What license applies to the music?

Refer to the [License agreement](https://www.freepik.com/legal/terms-of-use#api-services).

#### What audio format is the music available in?

Music is delivered as audio files via CDN-hosted download URLs.

#### Can I filter for only free music?

Yes. Set `include-premium` to `false` (the default) to return only free music.


# Search and filter music
Source: https://docs.freepik.com/api-reference/music/search-music

get /v1/music
Search the Freepik Music catalog. Filter by genre, mood, artist, premium status, and creation date range. Returns paginated results sorted by popularity by default.

Use the Freepik Music API to search and filter music by genre, mood, artist, and more. See the [Music API overview](/api-reference/music/overview) for authentication and usage guidance.


# Get loras
Source: https://docs.freepik.com/api-reference/mystic/get-loras

get /v1/ai/loras



# Mystic - List tasks
Source: https://docs.freepik.com/api-reference/mystic/get-mystic

get /v1/ai/mystic
Get the status of all Mystic tasks



# Mystic - Get task status
Source: https://docs.freepik.com/api-reference/mystic/get-mystic-task

get /v1/ai/mystic/{task-id}
Get the status of the Mystic task



# Freepik Mystic API
Source: https://docs.freepik.com/api-reference/mystic/mystic

Photorealistic AI image generator with LoRA styles and characters. Generate production-ready 1K, 2K, and 4K images for marketing, e-commerce, and creative projects.

<Frame>
  <video>
    <source type="video/mp4" />

    Your browser does not support the video tag.
  </video>
</Frame>

<div>
  <Card title="Freepik API's Mystic is a Freepik-exclusive AI image generation tool." icon="circle-exclamation">
    Generate photorealistic images in 1K/2K/4K with LoRA styles and characters.
  </Card>
</div>

Mystic AI image generation is a cutting-edge tool that produces stunningly realistic, high-resolution images. With options for 1K, 2K and 4K resolution, Mystic delivers sharp, detailed visuals that rival professional photography. From intricate facial features to complex textures, every element is rendered with exceptional clarity and precision.

### Stunning 1K, 2K and 4K quality

Enjoy razor-sharp 1K, 2K and 4K resolution with Freepik Mystic. Generate high-definition images with zero effort—no extra steps or upscaling needed. Just describe your vision, and Mystic will create beautifully detailed visuals ready for any project, from web design to large-format printing.

### Effortless creation

Transform your text descriptions into impressive, realistic results with custom parameters. Whether you need faces, hands, or text, everything is pixel-perfect and photo-realistic. Our state-of-the-art AI technology ensures that every generated image meets professional standards without requiring additional editing.

### Versatile applications

Perfect for a wide range of uses, including:

* Marketing materials that demand visual impact
* E-commerce product showcases with lifelike detail
* High-quality illustrations for publications
* Concept art for film and game development
* And much more!

With Mystic AI, you're equipped to create visuals that captivate and convince, all at the click of a button.

<div>
  <Columns>
    <Card title="POST /v1/ai/mystic" icon="wand-magic-sparkles" href="/api-reference/mystic/post-mystic">
      Generate an image using Mystic
    </Card>

    <Card title="GET /v1/ai/mystic/{task-id}" icon="code" href="/api-reference/mystic/get-mystic-task">
      Get the status of a Mystic image generation task
    </Card>

    <Card title="GET /v1/ai/mystic" icon="code" href="/api-reference/mystic/get-mystic">
      Get a list of all Mystic image generation tasks, including their statuses and details.
    </Card>

    <Card title="GET /v1/ai/loras" icon="code" href="/api-reference/mystic/get-loras">
      Returns a curated list of available LoRAs (Low-Rank Adaptation) for Mystic image generation.
    </Card>
  </Columns>
</div>

### Image Reference Best Practices

When using `structure_reference` or `style_reference` images, how you send them matters:

| Action                                     | Quality Impact             |
| ------------------------------------------ | -------------------------- |
| Send URL of original image                 | ✅ Maximum quality          |
| Send base64 of original file read directly | ✅ Maximum quality          |
| Use `canvas.toDataURL('image/jpeg')`       | ❌ \~8% quality loss        |
| Use `canvas.toDataURL('image/jpeg', 0.8)`  | ❌ \~20% quality loss       |
| Resize image before sending                | ❌ Significant quality loss |
| Convert PNG → JPEG before sending          | ❌ Quality loss             |

<Tip>
  **Recommended:** Send reference images via URL whenever possible. Higher quality reference images produce better style and structure transfers.
</Tip>

### Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What resolutions does Freepik Mystic support?">
    Freepik Mystic generates images in three resolution tiers: 1K (1024px), 2K (2048px), and 4K (4096px). Higher resolutions deliver more detail and are ideal for print or large-format displays.
  </Accordion>

  <Accordion title="What are LoRAs and how do I use them with Mystic?">
    LoRAs (Low-Rank Adaptations) are style and character presets that customize Mystic's output. Use the GET /v1/ai/loras endpoint to retrieve available LoRAs, then include the LoRA ID in your generation request to apply specific styles or characters.
  </Accordion>

  <Accordion title="How long does image generation take?">
    Generation time depends on resolution: 1K images typically complete in 10-20 seconds, 2K in 20-40 seconds, and 4K in 40-90 seconds. Use webhooks for efficient notification of task completion.
  </Accordion>

  <Accordion title="What is the output format?">
    Mystic outputs high-quality PNG images. The generated image is delivered via a URL that remains accessible for download after task completion.
  </Accordion>

  <Accordion title="What are the rate limits for Freepik Mystic?">
    Rate limits vary by subscription tier. See [Rate Limits](/ratelimits) for current limits.
  </Accordion>

  <Accordion title="How much does Freepik Mystic cost?">
    See the [Pricing page](/pricing) for current rates and subscription options.
  </Accordion>
</AccordionGroup>


# LoRAs training for custom characters
Source: https://docs.freepik.com/api-reference/mystic/post-loras-characters

post /v1/ai/loras/characters
Create you own custom character using LoRAs training

For now you can check the status of the training calling `v1/ai/loras`. We are working on it




# Mystic LoRA Styles - Train custom style
Source: https://docs.freepik.com/api-reference/mystic/post-loras-styles

post /v1/ai/loras/styles
Create you own custom style using LoRAs training

For now you can check the status of the training calling `v1/ai/loras`. We are working on it




# Mystic - Create image from text
Source: https://docs.freepik.com/api-reference/mystic/post-mystic

post /v1/ai/mystic
Convert descriptive text input into images using AI. This endpoint accepts a variety of parameters to customize the generated images.

## Important

Mystic image generation mode is Freepik's exclusive advanced AI workflow for ultra-realistic, high-resolution images.

Make sure you get your webhook set up on every request in order to retrieve your generations.


# Create video with reference images - Veo 3.1
Source: https://docs.freepik.com/api-reference/reference-to-video/veo-3-1/generate

post /v1/ai/reference-to-video/veo-3-1
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.



# Veo 3.1 Reference-to-Video API | Freepik API
Source: https://docs.freepik.com/api-reference/reference-to-video/veo-3-1/overview

Generate videos with consistent characters and objects using reference images. Maintain visual identity across scenes for storytelling and multi-scene projects with Google Veo 3.1.

<Card title="Google Veo 3.1 Reference-to-Video" icon="google">
  Generate videos with consistent characters and objects using reference images. Perfect for storytelling and multi-scene projects.
</Card>

Reference-to-Video is a specialized video generation mode that maintains **visual identity consistency** across generated content. By providing 1-3 reference images, you can create videos where characters, objects, or subjects maintain their appearance throughout the scene. This is ideal for creating coherent narratives, character-based content, and multi-scene projects where visual consistency is critical.

### Key capabilities

* **Character consistency**: Maintain visual identity of characters across video generation
* **Multi-reference support**: Use 1-3 reference images for subject consistency
* **Multi-resolution output**: Generate videos in 720p, 1080p, or 4K resolution
* **Native audio generation**: Includes dialogue and sound effects synthesis
* **Fixed 8-second duration**: Optimized duration at 24 FPS for cinematic quality
* **Aspect ratio control**: 16:9 (landscape) or 9:16 (portrait) formats
* **Negative prompts**: Specify elements to avoid in generation
* **Long prompts**: Up to 20,000 characters for detailed scene descriptions

### Use cases

* **Storytelling**: Create multi-scene narratives with consistent characters
* **Brand mascots**: Generate videos featuring consistent brand characters
* **Product showcases**: Maintain product appearance across different scenes
* **Character animation**: Bring illustrated or photographed characters to life consistently
* **Social media series**: Create episodic content with recurring characters
* **Advertising campaigns**: Produce multiple ads with consistent spokesperson

### How it differs from Image-to-Video

| Feature  | Image-to-Video               | Reference-to-Video                           |
| -------- | ---------------------------- | -------------------------------------------- |
| Input    | Single image to animate      | 1-3 reference images + prompt                |
| Purpose  | Animate a specific image     | Generate new scenes with consistent subjects |
| Output   | Animation of the input image | New video featuring reference subjects       |
| Duration | 4, 6, or 8 seconds           | Fixed 8 seconds                              |
| Modes    | Standard and Fast            | Single mode                                  |

### Generate with Reference-to-Video

Create videos with consistent characters and objects using reference images.

<div>
  <Columns>
    <Card title="POST /v1/ai/reference-to-video/veo-3-1" icon="video" href="/api-reference/reference-to-video/veo-3-1/generate">
      Create a reference-to-video task
    </Card>

    <Card title="GET /v1/ai/reference-to-video/veo-3-1" icon="list" href="/api-reference/reference-to-video/veo-3-1/veo-3-1-tasks">
      List all reference-to-video tasks
    </Card>

    <Card title="GET /v1/ai/reference-to-video/veo-3-1/{task-id}" icon="magnifying-glass" href="/api-reference/reference-to-video/veo-3-1/task-by-id">
      Get task status by ID
    </Card>
  </Columns>
</div>

### Parameters

| Parameter         | Type      | Required | Description                                                                |
| ----------------- | --------- | -------- | -------------------------------------------------------------------------- |
| `image_urls`      | `array`   | Yes      | Array of 1-3 reference image URLs (HTTPS, publicly accessible)             |
| `prompt`          | `string`  | Yes      | Text describing the video scene with reference subjects (max 20,000 chars) |
| `negative_prompt` | `string`  | No       | Text describing what to avoid in the video                                 |
| `resolution`      | `string`  | No       | Output resolution: `"720p"`, `"1080p"`, or `"4k"` (default: `"720p"`)      |
| `aspect_ratio`    | `string`  | No       | Video format: `"16:9"` or `"9:16"` (default: `"16:9"`)                     |
| `generate_audio`  | `boolean` | No       | Generate audio with dialogue and effects (default: `true`)                 |
| `seed`            | `integer` | No       | Random seed for reproducibility                                            |
| `webhook_url`     | `string`  | No       | URL for task completion notification                                       |

### Example request

```bash theme={null}
curl -X POST "https://api.freepik.com/v1/ai/reference-to-video/veo-3-1" \
  -H "x-freepik-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_urls": [
      "https://example.com/character-front.jpg",
      "https://example.com/character-side.jpg"
    ],
    "prompt": "The character walks through a futuristic city at night, neon lights reflecting on wet streets",
    "negative_prompt": "blurry, low quality, distorted",
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }'
```

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is Reference-to-Video and how is it different from Image-to-Video?">
    **Reference-to-Video** uses reference images to maintain visual consistency of subjects (characters, objects) while generating entirely new video scenes. **Image-to-Video** animates a single input image directly. Use Reference-to-Video when you need to create multiple scenes with the same character or object looking consistent.
  </Accordion>

  <Accordion title="How many reference images should I provide?">
    You can provide 1-3 reference images. Using multiple images from different angles improves consistency. For characters, include front-facing and profile views. For objects, include various angles to help the model understand the complete appearance.
  </Accordion>

  <Accordion title="What makes good reference images?">
    Good reference images are:

    * High resolution and well-lit
    * Show the subject clearly without obstructions
    * Include different angles when using multiple images
    * Have consistent appearance of the subject across images
    * Use HTTPS URLs that are publicly accessible
  </Accordion>

  <Accordion title="Why is the duration fixed at 8 seconds?">
    The 8-second duration at 24 FPS is optimized for reference-to-video generation, providing enough time for meaningful scenes while ensuring high-quality consistency of the reference subjects throughout the video.
  </Accordion>

  <Accordion title="Does Reference-to-Video have a Fast mode?">
    Currently, Reference-to-Video is available in a single mode optimized for quality and consistency. Unlike Text-to-Video and Image-to-Video, there is no Fast variant for Reference-to-Video.
  </Accordion>

  <Accordion title="How does audio generation work with reference subjects?">
    When `generate_audio` is enabled (default), the model generates synchronized audio including dialogue and sound effects appropriate to the scene. If your reference subject is a person and the prompt describes them speaking, the audio will include synthesized dialogue.
  </Accordion>
</AccordionGroup>

## Best practices

* **Multiple reference angles**: Provide 2-3 images showing different angles of your subject for best consistency
* **Clear subjects**: Use reference images where the subject is clearly visible and unobstructed
* **Consistent lighting**: Reference images with similar lighting produce more coherent results
* **Descriptive prompts**: Describe how the reference subject should act in the scene
* **Scene context**: Include environment and action details in your prompt
* **Negative prompts**: Use to avoid quality issues like "blurry, distorted, inconsistent features"
* **Webhook integration**: Use webhooks for production workflows to handle async completion

## Related APIs

* **[Veo 3.1 Text-to-Video](/api-reference/text-to-video/veo-3-1/overview)**: Generate videos from text prompts without reference images
* **[Veo 3.1 Image-to-Video](/api-reference/image-to-video/veo-3-1/overview)**: Animate a single image into video
* **[Kling 2.6 Motion Control](/api-reference/video/kling-v2-6-motion-control-pro)**: Transfer motion from reference videos
* **[RunWay Act Two](/api-reference/video/runway-act-two)**: Character performance with reference video


# Get Veo 3.1 Reference-to-Video task by ID
Source: https://docs.freepik.com/api-reference/reference-to-video/veo-3-1/task-by-id

get /v1/ai/reference-to-video/veo-3-1/{task-id}
Retrieve the status and results of a specific reference-to-video generation task.



# Get all Veo 3.1 Reference-to-Video tasks
Source: https://docs.freepik.com/api-reference/reference-to-video/veo-3-1/veo-3-1-tasks

get /v1/ai/reference-to-video/veo-3-1
Retrieve a list of all reference-to-video generation tasks for Veo 3.1.



# WAN 2.7 - Create video from reference characters
Source: https://docs.freepik.com/api-reference/reference-to-video/wan-2-7/generate

post /v1/ai/reference-to-video/wan-2-7
Generate a video featuring characters from reference images or videos using WAN 2.7. Maintains visual identity of referenced characters across the generated video.

**How to use references:**
- Provide character images via `image_urls` and/or character videos via `video_urls`
- Combined total of image and video references must not exceed 5
- Reference characters in the prompt as "Image 1", "Image 2", "Video 1", etc.
- Optionally include `reference_voice` per character for voice-guided generation

**Key features:**
- 720P and 1080P resolution support
- 5 aspect ratio options (or use `start_image_url` to set aspect ratio from an image)
- Duration range: 2-10 seconds




# WAN 2.7 Reference To Video API
Source: https://docs.freepik.com/api-reference/reference-to-video/wan-2-7/overview

Generate AI videos featuring characters from reference images or videos with WAN 2.7. Up to 5 character references, voice-guided generation, 720P and 1080P resolution, 2-10 second durations.

<Card title="Alibaba WAN 2.7 integration" icon="video">
  WAN 2.7 Reference-to-Video generates videos featuring specific characters from reference images or videos, maintaining visual identity and supporting optional voice references.
</Card>

WAN 2.7 Reference-to-Video is an AI video generation API that creates MP4 videos featuring characters from reference images or videos. You provide up to 5 character references (images and/or videos combined), then describe a scene in the prompt using labels like "Image 1" or "Video 1" to place those characters. The model maintains visual identity of referenced characters across the generated video. Output is available at 720P (1280x720) or 1080P (1920x1080) resolution with durations from 2 to 10 seconds.

### Key capabilities

* **Character references**: Provide up to 5 combined character images and videos for identity preservation
* **Prompt-based character placement**: Reference characters as "Image 1", "Image 2", "Video 1" in the prompt
* **Voice-guided generation**: Optionally include `reference_voice` audio per character for voice-guided output
* **Resolution options**: 720P (1280x720) and 1080P (1920x1080) output
* **5 aspect ratios**: `16:9`, `9:16`, `1:1`, `4:3`, `3:4` (or auto-detect from `start_image_url`)
* **Flexible durations**: 2 to 10 seconds of video output
* **Start frame control**: Optionally provide `start_image_url` to set the first frame and auto-detect aspect ratio
* **Async processing**: Webhook notifications or polling for task completion

### How character references work

1. Provide character images via `image_urls` (JPEG/PNG/BMP/WEBP, 240-8000px, max 20MB each)
2. Provide character videos via `video_urls` (MP4/MOV, max 100MB each)
3. Combined total of images + videos must not exceed 5
4. Reference characters in the prompt using position labels: "Image 1", "Image 2", "Video 1", "Video 2"
5. Optionally add `reference_voice` audio URL per character for voice-guided generation

**Example prompt:**

> "Image 1 and Image 2 are walking together in a park while Video 1 plays guitar in the background."

### Use cases

* **Consistent character videos**: Generate multiple videos with the same character across different scenes
* **Multi-character narratives**: Create scenes with up to 5 characters interacting
* **Branded content**: Maintain consistent mascot or spokesperson identity across video campaigns
* **Voice-synchronized video**: Guide character motion using voice references for natural lip and gesture sync
* **Social media series**: Create episodic content with recurring characters
* **Virtual presenters**: Generate videos of a reference person in different settings

### API operations

Generate videos by submitting character references and a prompt to the API. The service returns a task ID for async polling or webhook notification.

<div>
  <Columns>
    <Card title="POST /v1/ai/reference-to-video/wan-2-7" icon="video" href="/api-reference/reference-to-video/wan-2-7/generate">
      Create a new reference-to-video generation task
    </Card>

    <Card title="GET /v1/ai/reference-to-video/wan-2-7" icon="list" href="/api-reference/reference-to-video/wan-2-7/wan-2-7-r2v-tasks">
      List all WAN 2.7 R2V tasks with status
    </Card>

    <Card title="GET /v1/ai/reference-to-video/wan-2-7/{task-id}" icon="magnifying-glass" href="/api-reference/reference-to-video/wan-2-7/task-by-id">
      Get task status and results by ID
    </Card>
  </Columns>
</div>

### Parameters

| Parameter                           | Type      | Required    | Default   | Description                                                                                |
| ----------------------------------- | --------- | ----------- | --------- | ------------------------------------------------------------------------------------------ |
| `prompt`                            | `string`  | Yes         | -         | Scene description referencing characters as "Image 1", "Video 1", etc. Max 5000 characters |
| `negative_prompt`                   | `string`  | No          | -         | Elements to avoid (e.g., "blurry, watermark"). Max 500 characters                          |
| `image_urls`                        | `array`   | Conditional | -         | Character reference images. Each item has `url` (required) and optional `reference_voice`  |
| `video_urls`                        | `array`   | Conditional | -         | Character reference videos. Each item has `url` (required) and optional `reference_voice`  |
| `start_image_url`                   | `string`  | No          | -         | First-frame image. If provided, overrides `aspect_ratio` with image dimensions             |
| `aspect_ratio`                      | `string`  | No          | `"16:9"`  | Output ratio: `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"`, `"3:4"`                                |
| `resolution`                        | `string`  | No          | `"1080P"` | Output resolution: `"720P"` or `"1080P"`                                                   |
| `duration`                          | `integer` | No          | `5`       | Video length in seconds: 2 to 10                                                           |
| `seed`                              | `integer` | No          | Random    | Seed for reproducibility (0 to 2147483647)                                                 |
| `additional_settings.prompt_extend` | `boolean` | No          | `true`    | Enable AI prompt expansion for richer output                                               |
| `webhook_url`                       | `string`  | No          | -         | URL for async status notifications                                                         |

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is WAN 2.7 Reference-to-Video and how does it work?">
    WAN 2.7 Reference-to-Video is an AI video generation API developed by Alibaba. You provide character reference images or videos along with a text prompt that describes a scene. The model generates a video featuring those characters while preserving their visual identity. You receive a task ID immediately, then poll for results or receive a webhook notification.
  </Accordion>

  <Accordion title="How many character references can I use?">
    You can provide up to 5 combined character references (images + videos). For example: 3 character images and 2 character videos, or 5 images and 0 videos. At least one image or video reference is required.
  </Accordion>

  <Accordion title="How do I reference characters in the prompt?">
    Use position labels based on the order you provide references. Image references are labeled "Image 1", "Image 2", etc. Video references are labeled "Video 1", "Video 2", etc. Example: "Image 1 and Video 1 are having a conversation at a cafe."
  </Accordion>

  <Accordion title="What is voice-guided generation?">
    Each character reference (image or video) can include an optional `reference_voice` URL pointing to an audio file. The model uses this voice to guide character motion and lip movement in the generated video, creating more natural character animation.
  </Accordion>

  <Accordion title="What image and video formats are supported for references?">
    Image references: JPEG, PNG, BMP, WEBP (240-8000px per side, max 20MB). Video references: MP4, MOV (max 100MB). All files must be at publicly accessible URLs.
  </Accordion>

  <Accordion title="What are the rate limits for WAN 2.7 Reference-to-Video?">
    Rate limits depend on your subscription tier. See the [Rate Limits](/ratelimits) page for current limits by plan.
  </Accordion>

  <Accordion title="How much does WAN 2.7 Reference-to-Video cost?">
    See the [Pricing page](/pricing) for current rates and subscription options.
  </Accordion>
</AccordionGroup>

## Best practices

* **Character images**: Use clear, well-lit images with the character prominently visible. Avoid busy backgrounds.
* **Character videos**: Shorter reference videos with clear character visibility produce better identity preservation.
* **Prompt structure**: Explicitly name each character by label ("Image 1 walks left while Image 2 sits down") for predictable placement.
* **Voice references**: Provide clean audio clips with minimal background noise for best voice-guided results.
* **Duration selection**: Reference-to-Video supports 2-10 seconds. Start with shorter durations for iteration.
* **Negative prompts**: Include: "blurry, low quality, watermark, text, distortion, extra limbs"
* **Production integration**: Use webhooks for scalable applications instead of polling.
* **Error handling**: Implement retry with exponential backoff for 503 errors during high-demand periods.

## Related APIs

* **[WAN 2.7 Text-to-Video](/api-reference/text-to-video/wan-2-7/overview)**: Generate videos from text prompts without character references
* **[WAN 2.7 Image-to-Video](/api-reference/image-to-video/wan-2-7/overview)**: Animate images or extend existing videos
* **[Kling 3 Omni](/api-reference/video/kling-v3-omni/overview)**: Alternative video generation model with reference video support


# WAN 2.7 R2V - Get task status
Source: https://docs.freepik.com/api-reference/reference-to-video/wan-2-7/task-by-id

get /v1/ai/reference-to-video/wan-2-7/{task-id}
Retrieve the status and result of a specific WAN 2.7 reference-to-video task by its ID.



# WAN 2.7 R2V - List tasks
Source: https://docs.freepik.com/api-reference/reference-to-video/wan-2-7/wan-2-7-r2v-tasks

get /v1/ai/reference-to-video/wan-2-7
Retrieve the list of all WAN 2.7 reference-to-video tasks for the authenticated user.



# Remove Background - Image Cutout API | Freepik API
Source: https://docs.freepik.com/api-reference/remove-background/overview

Remove image backgrounds with AI. Get transparent PNG up to 25 megapixels. Supports JPG/PNG input up to 20 MB. Instant synchronous results.

<Note>
  This API is currently in **beta**. Features and endpoints may change as we continue to improve the service.
</Note>

<Card title="AI Background Removal" icon="eraser">
  Automatically remove backgrounds from images using AI-powered segmentation. Get clean cutouts with transparent backgrounds in seconds.
</Card>

Remove Background is an AI-powered background removal API that instantly separates subjects from their backgrounds. Upload any JPG or PNG image via URL and receive a transparent PNG with the background removed. The API supports images up to 20 MB and outputs high-resolution results up to 25 megapixels. This is a synchronous API that returns results immediately without polling.

### Key capabilities

* **Instant processing**: Synchronous API returns results immediately without task polling
* **High resolution output**: Full resolution up to 25 megapixels, preview up to 0.25 megapixels
* **Transparent PNG output**: Clean cutouts with alpha channel transparency
* **Multiple output URLs**: Get original, high-resolution, and preview versions in one response
* **Large file support**: Accepts images up to 20 MB in size
* **Format support**: Works with JPG and PNG input images
* **URL-based input**: Submit images via public URL for easy integration
* **Temporary URLs**: Response URLs valid for 5 minutes for secure access

### Use cases

* **E-commerce product photos**: Remove backgrounds for consistent product catalogs and marketplace listings
* **Graphic design workflows**: Create transparent assets for compositions and marketing materials
* **Social media content**: Isolate subjects for custom backgrounds and branded visuals
* **Photo editing apps**: Integrate background removal into mobile and web editing tools
* **Print-on-demand services**: Prepare artwork for merchandise and custom products
* **Real estate photography**: Isolate property elements for virtual staging

### Remove background from images

Submit an image URL to remove its background. The API returns multiple URLs for different resolution outputs.

<div>
  <Columns>
    <Card title="POST /v1/ai/beta/remove-background" icon="eraser" href="/api-reference/remove-background/post-beta-remove-background">
      Remove background from an image
    </Card>
  </Columns>
</div>

### Parameters

| Parameter   | Type     | Required | Default | Description                                                                     |
| ----------- | -------- | -------- | ------- | ------------------------------------------------------------------------------- |
| `image_url` | `string` | Yes      | -       | URL of the image whose background needs to be removed (JPG or PNG, up to 20 MB) |

### Response

| Field             | Type     | Description                                                            |
| ----------------- | -------- | ---------------------------------------------------------------------- |
| `original`        | `string` | URL of the original input image                                        |
| `high_resolution` | `string` | URL of the high-resolution image with background removed (up to 25 MP) |
| `preview`         | `string` | URL of the preview version (up to 0.25 MP)                             |
| `url`             | `string` | Direct download URL for the high-resolution result                     |

<Warning>
  Response URLs are temporary and expire after **5 minutes**. Download or process the images promptly after receiving the response.
</Warning>

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is the Remove Background API and how does it work?">
    The Remove Background API is an AI-powered service that automatically detects and removes backgrounds from images. You submit an image URL, and the API uses advanced segmentation models to separate the subject from the background, returning a transparent PNG. Unlike async APIs, this endpoint processes requests synchronously and returns results immediately.
  </Accordion>

  <Accordion title="What image formats and sizes are supported?">
    The API accepts JPG and PNG images up to 20 MB in file size. Output is always a PNG with transparency. The high-resolution output supports images up to 25 megapixels, while the preview output is limited to 0.25 megapixels.
  </Accordion>

  <Accordion title="How long do the response URLs remain valid?">
    All URLs in the response (original, high\_resolution, preview, url) are temporary and valid for **5 minutes** only. Make sure to download or process the images immediately after receiving the response.
  </Accordion>

  <Accordion title="Is this a synchronous or asynchronous API?">
    The Remove Background API is **synchronous**. Unlike other AI endpoints that return task IDs for polling, this API processes your request and returns the result immediately in the response. No task polling or webhooks are needed.
  </Accordion>

  <Accordion title="What are the rate limits for the Remove Background API?">
    Rate limits depend on your subscription tier. Visit the [Rate Limits](/ratelimits) page for details on request limits and quotas.
  </Accordion>

  <Accordion title="How much does the Remove Background API cost?">
    Pricing varies by subscription plan. Check the [Pricing](/pricing) page for current rates and available plans.
  </Accordion>

  <Accordion title="Why is this API in beta?">
    The beta designation indicates the API is production-ready but may receive updates to improve accuracy, performance, or add new features. We recommend monitoring the changelog for any changes that might affect your integration.
  </Accordion>
</AccordionGroup>

## Best practices

* **Image quality**: Use high-resolution input images for best cutout quality
* **Clear subjects**: Images with well-defined subjects produce cleaner results
* **Contrast**: Higher contrast between subject and background improves accuracy
* **Download promptly**: Save results immediately as URLs expire in 5 minutes
* **Error handling**: Implement retry logic with exponential backoff for 5xx errors
* **URL validation**: Ensure image URLs are publicly accessible before submission

## Related APIs

* **[Image Upscaler](/api-reference/image-upscaler-creative/image-upscaler)**: Enhance image resolution after background removal
* **[Reimagine](/api-reference/text-to-image/reimagine-flux/post-reimagine-flux)**: Transform images with AI-powered style changes
* **[Image Style Transfer](/api-reference/image-style-transfer/image-styletransfer)**: Apply artistic styles to your cutout images


# Remove the background of an image
Source: https://docs.freepik.com/api-reference/remove-background/post-beta-remove-background

post /v1/ai/beta/remove-background
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.

**Supported formats:** JPG, PNG

**File size limit:** up to 20 MB

**Output resolutions:** Preview (up to 0.25 megapixels), Full resolution (up to 25 megapixels)




# Download an resource
Source: https://docs.freepik.com/api-reference/resources/download-a-resource

get /v1/resources/{resource-id}/download
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.



# Get available download formats for resource
Source: https://docs.freepik.com/api-reference/resources/download-resource-by-id-and-format

get /v1/resources/{resource-id}/download/{resource-format}
Retrieve a resource by specifying both the resource ID and the format. This endpoint allows for precise downloading of resources in the desired format.



# Search and filter resources with advanced options
Source: https://docs.freepik.com/api-reference/resources/get-all-resources

get /v1/resources
Retrieve a list of resources based on various filter criteria such as orientation, content type, license, and more.



# Get detailed resource information by ID
Source: https://docs.freepik.com/api-reference/resources/get-the-detail-of-a-resource-psd-vector-or-photo

get /v1/resources/{resource-id}
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.



# Images and templates API
Source: https://docs.freepik.com/api-reference/resources/images-and-templates-api

Search, retrieve, and download images and templates programmatically with the Freepik API.

The Images and templates API lets you discover resources (photos, vectors, PSDs) with AI-powered search and download assets for use in your applications.

### What you can do

* List resources with sorting and filters
* Get a single resource by ID
* Download a resource and specify format

### Authentication

All requests require an API key via the `x-freepik-api-key` header. See the [Quickstart](/quickstart) and [Authentication](/authentication).

### Endpoints

<div>
  <Columns>
    <Card title="GET /v1/resources" icon="code" href="/api-reference/resources/get-all-resources">
      List resources with sorting and filters
    </Card>

    <Card title="GET /v1/resources/{resource-id}" icon="code" href="/api-reference/resources/get-the-detail-of-a-resource-psd-vector-or-photo">
      Retrieve a single resource by ID
    </Card>

    <Card title="GET /v1/resources/{resource-id}/download" icon="code" href="/api-reference/resources/download-a-resource">
      Download a resource
    </Card>

    <Card title="GET /v1/resources/{resource-id}/download/{resource-format}" icon="code" href="/api-reference/resources/download-resource-by-id-and-format">
      Download a resource by ID and format
    </Card>
  </Columns>
</div>

### Use cases

* Build an asset picker for your CMS or design tool
* AI-powered search by keyword and sort by popularity
* Programmatically download assets during build/deploy

### FAQ

#### Is there a rate limit?

Yes. See [Rate limits](/ratelimits).

#### What license applies to resources?

Refer to the [License agreement](https://www.freepik.com/legal/terms-of-use#api-services).


# Stock content API
Source: https://docs.freepik.com/api-reference/resources/stock-content

Search, retrieve, and download Freepik stock content — images, templates, icons, videos, and music — via the Freepik API.

Access Freepik's catalog of images, templates, icons, videos, and music to power your apps and workflows.

### What you can do

* AI-powered search and list stock content
* Retrieve details by ID
* Download assets in supported formats
* Filter by content type and order

### Authentication

All requests require an API key via the `x-freepik-api-key` header. See the [Quickstart](/quickstart) and [Authentication](/authentication).

<div>
  <Columns>
    <Card title="Images and templates API" icon="image" href="/api-reference/resources/images-and-templates-api">
      Photos, vectors, PSDs — list, detail, and download
    </Card>

    <Card title="Icons API" icon="bolt" href="/api-reference/icons/icons-api">
      Browse and download icons
    </Card>

    <Card title="Videos API" icon="film" href="/api-reference/videos/videos-api">
      Discover and download videos
    </Card>

    <Card title="Music API" icon="music" href="/api-reference/music/overview">
      Search and download music
    </Card>
  </Columns>
</div>

### Popular endpoints

<div>
  <Columns>
    <Card title="GET /v1/resources" icon="code" href="/api-reference/resources/get-all-resources">
      List stock resources
    </Card>

    <Card title="GET /v1/icons" icon="code" href="/api-reference/icons/get-all-icons-by-order">
      List icons
    </Card>

    <Card title="GET /v1/videos" icon="code" href="/api-reference/videos/get-all-videos-by-order">
      List videos
    </Card>

    <Card title="GET /v1/music" icon="code" href="/api-reference/music/search-music">
      Search music
    </Card>
  </Columns>
</div>

### FAQ

#### Is there a rate limit?

Yes. See [Rate limits](/ratelimits).

#### What license applies to the content?

Refer to the [License agreement](https://www.freepik.com/legal/terms-of-use#api-services).


# Download a sound effect
Source: https://docs.freepik.com/api-reference/sfx/download-sfx

get /v1/sound-effects/{sfx-id}/download
Get a direct download URL for a sound effect audio file. Returns the sound effect ID, title, and a CDN-hosted download link.

Get a direct download URL for a sound effect audio file. See the [Sound Effects API overview](/api-reference/sfx/overview) for authentication and usage guidance.


# Get detailed sound effect information by ID
Source: https://docs.freepik.com/api-reference/sfx/get-sfx-by-id

get /v1/sound-effects/{sfx-id}
Retrieve full details for a sound effect including category hierarchy, tags, duration, popularity, and download statistics.

Retrieve full details for a sound effect including category hierarchy, tags, duration, popularity, and download statistics. See the [Sound Effects API overview](/api-reference/sfx/overview) for authentication and usage guidance.


# Freepik Sound Effects API
Source: https://docs.freepik.com/api-reference/sfx/overview

Search, filter, and download royalty-free sound effects from the Freepik catalog. Browse 42 categories including ambience, foley, transitions, and more via the Freepik API.

The Freepik Sound Effects API provides programmatic access to a catalog of royalty-free sound effects. Search by keyword, filter by category and premium status, retrieve detailed metadata, and download audio files for use in your projects.

### What you can do

* **Full-text search**: Query sound effects by title, tags, and categories using the `q` parameter
* **Category filtering**: Browse 42 categories organized in a parent-child hierarchy (e.g., `ambience` > `forest`, `foley` > `footsteps`, `transitions` > `whooshes`)
* **Premium filtering**: Control whether results include premium content via `include-premium` (default: free only)
* **Flexible sorting**: Sort by `relevance`, `popularity`, `download_count`, `created_at`, `duration`, or `title` with ascending/descending support
* **Pagination**: Navigate results with `limit` (1-1000, default 10) and `offset` parameters
* **Detailed metadata**: Access title, tags, category hierarchy, duration, popularity score, download count, premium status, and creation date
* **Direct downloads**: Get CDN-hosted download URLs for sound effect audio files

### Authentication

All requests require an API key via the `x-freepik-api-key` header. See the [Quickstart](/quickstart) and [Authentication](/authentication).

### Endpoints

<div>
  <Columns>
    <Card title="GET /v1/sound-effects" icon="magnifying-glass" href="/api-reference/sfx/search-sfx">
      Search and filter sound effects
    </Card>

    <Card title="GET /v1/sound-effects/{sfx-id}" icon="circle-info" href="/api-reference/sfx/get-sfx-by-id">
      Get detailed sound effect information by ID
    </Card>

    <Card title="GET /v1/sound-effects/{sfx-id}/download" icon="download" href="/api-reference/sfx/download-sfx">
      Download a sound effect audio file
    </Card>
  </Columns>
</div>

### Parameters overview

The search endpoint supports the following filters:

| Parameter         | Type      | Description                                                                                                                                                                                                                                                         |
| ----------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `q`               | `string`  | Full-text search across titles, tags, and categories                                                                                                                                                                                                                |
| `category`        | `string`  | Filter by category slug (e.g., `"ambience"`, `"foley"`, `"transitions"`)                                                                                                                                                                                            |
| `include-premium` | `boolean` | Include premium sound effects (default: `false`)                                                                                                                                                                                                                    |
| `order_by`        | `string`  | Sort order: `"relevance"`, `"popularity"`, `"-popularity"`, `"download_count"`, `"-download_count"`, `"created_at"`, `"-created_at"`, `"duration"`, `"-duration"`, `"title"`, `"-title"`. Defaults to `"relevance"` when `q` is provided, `"-popularity"` otherwise |
| `limit`           | `integer` | Results per page: 1-1000 (default: `10`)                                                                                                                                                                                                                            |
| `offset`          | `integer` | Pagination offset (default: `0`)                                                                                                                                                                                                                                    |

### Available categories

Sound effects are organized into 42 categories with a parent-child hierarchy. Use a parent category slug to include all its subcategories.

| Parent Category          | Subcategories                                                                                                                       |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------- |
| **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`                                                  |

### Use cases

* Build a sound effects browser or audio picker into your app or CMS
* Search sound effects by category for video editing and post-production workflows
* Programmatically download royalty-free SFX during content production pipelines
* Create curated sound libraries filtered by popularity, duration, or category
* Add ambient sounds and UI feedback to games and interactive applications

### FAQ

#### Is there a rate limit?

Yes. See [Rate limits](/ratelimits).

#### What license applies to the sound effects?

Refer to the [License agreement](https://www.freepik.com/legal/terms-of-use#api-services).

#### What audio format are the sound effects available in?

Sound effects are delivered as audio files via CDN-hosted download URLs.

#### Can I filter for only free sound effects?

Yes. Set `include-premium` to `false` (the default) to return only free sound effects.

#### How does category filtering work?

Use the `category` parameter with a category slug. Filtering by a parent category (e.g., `ambience`) includes all its subcategories (e.g., `forest`, `city-ambience`, `rain-and-storm`). Each sound effect belongs to one category, and the response includes the full category hierarchy with parent information.

#### How does sorting work?

Use the `order_by` parameter. Prefix a field name with `-` for descending order (e.g., `-popularity` for most popular first). When a search query (`q`) is provided, results default to `"relevance"`. Without a query, results default to `"-popularity"`.

#### What metadata is returned for each sound effect?

Each sound effect includes: `id`, `title`, `tags`, `category` (with parent), `duration` (in seconds), `is_premium`, `popularity` score, `download_count`, `file_url`, and `created_at` timestamp.

## Related APIs

* **[Music API](/api-reference/music/overview)**: Search and download royalty-free music tracks
* **[Music Generation](/api-reference/music-generation/overview)**: Generate original music from text descriptions with AI
* **[ElevenLabs Sound Effects](/api-reference/sound-effects/overview)**: Generate custom sound effects from text with AI


# Search and filter sound effects
Source: https://docs.freepik.com/api-reference/sfx/search-sfx

get /v1/sound-effects
Search the Freepik Sound Effects catalog. Filter by category, duration range, premium status, and creation date. Returns paginated results sorted by popularity by default.

Use the Freepik Sound Effects API to search and filter sound effects by keyword, category, premium status, and more. See the [Sound Effects API overview](/api-reference/sfx/overview) for authentication and usage guidance.


# Skin Enhancer - List tasks
Source: https://docs.freepik.com/api-reference/skin-enhancer/get-skin-enhancer

get /v1/ai/skin-enhancer



# Skin Enhancer - Get task status
Source: https://docs.freepik.com/api-reference/skin-enhancer/get-{task-id}-by-id

get /v1/ai/skin-enhancer/{task-id}



# Skin Enhancer - AI Portrait Enhancement API | Freepik API
Source: https://docs.freepik.com/api-reference/skin-enhancer/overview

Enhance portrait skin quality with AI. Three modes: Creative for artistic effects, Faithful for natural preservation, Flexible for targeted optimization. Professional results for photographers.

<Card title="Magnific AI technology" icon="sparkles">
  Powered by Magnific AI, Skin Enhancer uses advanced neural networks to naturally improve skin texture while preserving facial details and identity.
</Card>

Skin Enhancer is an AI-powered portrait enhancement API that automatically improves skin quality in photographs. It offers three distinct processing modes: Creative for stylized artistic enhancements, Faithful for natural-looking improvements that preserve original appearance, and Flexible for targeted optimization based on specific goals. The API accepts images via URL or base64 encoding and returns high-quality enhanced portraits.

### Key capabilities

* **Three enhancement modes**: Creative (artistic), Faithful (natural), and Flexible (targeted) modes for different use cases
* **Sharpen control**: Adjustable sharpening intensity from 0 to 100 for precise detail enhancement
* **Smart grain**: Intelligent grain application (0-100) to maintain photographic texture and avoid artificial smoothing
* **Skin detail preservation**: Faithful mode includes dedicated skin detail control (0-100) to balance smoothing with texture retention
* **Optimization targets**: Flexible mode offers 5 presets: `enhance_skin`, `improve_lighting`, `enhance_everything`, `transform_to_real`, `no_make_up`
* **Flexible input**: Accepts both base64-encoded images and publicly accessible HTTPS URLs
* **Async processing**: Webhook notifications or polling for task completion

### Use cases

* **Portrait photography**: Enhance skin in professional headshots while maintaining natural appearance
* **E-commerce**: Improve model photos for fashion and beauty product listings
* **Social media content**: Quick skin enhancement for influencer and brand content
* **Wedding photography**: Batch process wedding portraits for consistent skin quality
* **Beauty industry**: Showcase cosmetic results with enhanced before/after comparisons
* **Corporate headshots**: Professional skin enhancement for business profiles and LinkedIn photos

### Choose your enhancement mode

Select the mode that best fits your needs:

| Mode         | Best For                             | Key Feature                                              |
| ------------ | ------------------------------------ | -------------------------------------------------------- |
| **Creative** | Artistic portraits, stylized content | More pronounced artistic enhancement                     |
| **Faithful** | Natural photography, editorial work  | Preserves original appearance with `skin_detail` control |
| **Flexible** | Specific optimization goals          | 5 optimization presets for targeted results              |

### Enhance skin with Skin Enhancer

Submit a portrait image to the appropriate endpoint based on your desired enhancement mode. The service returns a task ID for async polling or webhook notification.

<div>
  <Columns>
    <Card title="POST /v1/ai/skin-enhancer/creative" icon="sparkles" href="/api-reference/skin-enhancer/post-creative">
      Artistic skin enhancement with stylized effects
    </Card>

    <Card title="POST /v1/ai/skin-enhancer/faithful" icon="face-smile" href="/api-reference/skin-enhancer/post-faithful">
      Natural enhancement preserving original appearance
    </Card>

    <Card title="POST /v1/ai/skin-enhancer/flexible" icon="sliders" href="/api-reference/skin-enhancer/post-flexible">
      Targeted enhancement with optimization presets
    </Card>

    <Card title="GET /v1/ai/skin-enhancer" icon="list" href="/api-reference/skin-enhancer/get-skin-enhancer">
      List all skin enhancer tasks
    </Card>

    <Card title="GET /v1/ai/skin-enhancer/{task-id}" icon="magnifying-glass" href="/api-reference/skin-enhancer/get-{task-id}-by-id">
      Get task status and results by ID
    </Card>
  </Columns>
</div>

### Parameters

#### Common parameters (all modes)

| Parameter     | Type      | Required | Default | Description                                               |
| ------------- | --------- | -------- | ------- | --------------------------------------------------------- |
| `image`       | `string`  | Yes      | -       | Input image as base64 or publicly accessible HTTPS URL    |
| `sharpen`     | `integer` | No       | `0`     | Sharpening intensity (0-100)                              |
| `smart_grain` | `integer` | No       | `2`     | Smart grain intensity (0-100) to maintain natural texture |
| `webhook_url` | `string`  | No       | -       | URL for task completion notification                      |

#### Faithful mode additional parameter

| Parameter     | Type      | Required | Default | Description                           |
| ------------- | --------- | -------- | ------- | ------------------------------------- |
| `skin_detail` | `integer` | No       | `80`    | Skin detail enhancement level (0-100) |

#### Flexible mode additional parameter

| Parameter       | Type     | Required | Default        | Description                                                                                                      |
| --------------- | -------- | -------- | -------------- | ---------------------------------------------------------------------------------------------------------------- |
| `optimized_for` | `string` | No       | `enhance_skin` | Optimization target: `enhance_skin`, `improve_lighting`, `enhance_everything`, `transform_to_real`, `no_make_up` |

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is Skin Enhancer and how does it work?">
    Skin Enhancer is an AI-powered portrait enhancement API that uses Magnific AI technology to improve skin quality in photographs. You submit an image via the API, receive a task ID immediately, then poll for results or receive a webhook notification when processing completes. The output is a high-quality enhanced portrait.
  </Accordion>

  <Accordion title="What is the difference between Creative, Faithful, and Flexible modes?">
    **Creative** mode applies more artistic and stylized enhancements for creative projects. **Faithful** mode preserves the original appearance while improving skin quality, ideal for natural photography. **Flexible** mode allows you to select specific optimization targets like lighting improvement or makeup removal.
  </Accordion>

  <Accordion title="What image formats does Skin Enhancer support?">
    Skin Enhancer accepts images as base64-encoded strings or publicly accessible HTTPS URLs. Common formats like JPEG and PNG are supported. For best results, use high-resolution portrait images with clear facial visibility.
  </Accordion>

  <Accordion title="What are the optimization targets in Flexible mode?">
    Flexible mode offers 5 presets: `enhance_skin` (default) focuses on skin quality, `improve_lighting` optimizes facial lighting, `enhance_everything` applies comprehensive enhancement, `transform_to_real` makes images appear more photorealistic, and `no_make_up` reduces visible makeup while enhancing skin.
  </Accordion>

  <Accordion title="How do I control the enhancement intensity?">
    Use `sharpen` (0-100) to control detail enhancement and `smart_grain` (0-100) to maintain natural texture. In Faithful mode, `skin_detail` (0-100) specifically controls how much original skin texture is preserved. Lower values produce smoother results; higher values retain more natural texture.
  </Accordion>

  <Accordion title="What are the rate limits for Skin Enhancer?">
    Rate limits vary by subscription tier. See [Rate Limits](/ratelimits) for current limits and information about your plan.
  </Accordion>

  <Accordion title="How much does Skin Enhancer cost?">
    Pricing varies by subscription tier and usage volume. See the [Pricing page](/pricing) for current rates and subscription options.
  </Accordion>
</AccordionGroup>

## Best practices

* **Image quality**: Use high-resolution images with good lighting for optimal results
* **Mode selection**: Choose Faithful for natural portraits, Creative for artistic projects, Flexible for specific optimization goals
* **Parameter tuning**: Start with default values and adjust `sharpen` and `smart_grain` based on output quality
* **Skin detail balance**: In Faithful mode, use `skin_detail` between 60-90 for natural results; lower values for smoother skin
* **Batch processing**: For multiple images, use webhooks instead of polling for efficient production workflows
* **Error handling**: Implement retry logic with exponential backoff for 503 errors

## Related APIs

* **[Image Upscaler Creative](/api-reference/image-upscaler-creative/image-upscaler)**: Upscale and enhance image resolution with AI
* **[Image Upscaler Precision](/api-reference/image-upscaler-precision/image-upscaler)**: High-fidelity image upscaling
* **[Image Relight](/api-reference/image-relight/image-relight)**: Change lighting conditions in photos
* **[Image Style Transfer](/api-reference/image-style-transfer/image-styletransfer)**: Apply artistic styles to images


# Skin Enhancer Creative - Enhance skin
Source: https://docs.freepik.com/api-reference/skin-enhancer/post-creative

post /v1/ai/skin-enhancer/creative
Enhance skin in images using AI with the Creative mode. This mode provides more artistic and stylized enhancements.




# Skin Enhancer Faithful - Enhance skin
Source: https://docs.freepik.com/api-reference/skin-enhancer/post-faithful

post /v1/ai/skin-enhancer/faithful
Enhance skin in images using AI with the Faithful mode. This mode preserves the original appearance while improving skin quality.




# Skin Enhancer Flexible - Enhance skin
Source: https://docs.freepik.com/api-reference/skin-enhancer/post-flexible

post /v1/ai/skin-enhancer/flexible
Enhance skin in images using AI with the Flexible mode. This mode allows you to choose the optimization target for the enhancement.




# Sound Effects - List tasks
Source: https://docs.freepik.com/api-reference/sound-effects/get-sound-effects

get /v1/ai/sound-effects
Get the status of all sound-effects tasks



# Sound Effects - Get task status
Source: https://docs.freepik.com/api-reference/sound-effects/get-{task-id}-by-id

get /v1/ai/sound-effects/{task-id}
Get the status of one sound-effects task



# ElevenLabs Sound Effects - Text-to-Audio API
Source: https://docs.freepik.com/api-reference/sound-effects/overview

Generate realistic sound effects from text with ElevenLabs Sound Effects. Create 0.5-22 second audio clips with looping support for videos, games, and multimedia.

<Card title="ElevenLabs Sound Effects integration" icon="waveform-lines">
  Powered by ElevenLabs technology, this API generates realistic sound effects from text descriptions.
</Card>

ElevenLabs Sound Effects is an AI-powered text-to-audio API that creates realistic sound effects from natural language descriptions. Describe any sound you need - from animal noises to mechanical sounds, nature ambience to UI feedback - and receive a high-quality audio file. The API supports customizable durations from 0.5 to 22 seconds, seamless looping for continuous playback, and prompt influence control for fine-tuned results.

### Key capabilities

* **Text-guided generation**: Describe any sound effect to generate (e.g., "A cat meowing", "Thunder rolling in the distance", "Keyboard typing")
* **Customizable duration**: Generate audio from 0.5 seconds to 22 seconds
* **Seamless looping**: Enable `loop` for smooth, continuous playback without audible breaks
* **Prompt influence control**: Adjust `prompt_influence` (0-1) to balance creativity vs. prompt adherence
* **High-quality output**: Professional-grade audio files suitable for production use
* **Fast generation**: Typical processing time of 5-15 seconds
* **Async processing**: Webhook notifications or polling for task completion

### Use cases

* **Video production**: Create custom sound effects for films, commercials, and social media videos
* **Game development**: Generate UI sounds, environmental ambience, and character audio
* **Podcast production**: Add sound effects and transitions to audio content
* **App development**: Create notification sounds, button clicks, and interface feedback
* **Animation**: Produce foley sounds and effects for animated content
* **Presentations**: Enhance slideshows and corporate videos with custom audio

### Generate sound effects with ElevenLabs

Submit a text description of the sound effect you want along with the desired duration. The service returns a task ID for async polling or webhook notification.

<div>
  <Columns>
    <Card title="POST /v1/ai/sound-effects" icon="waveform-lines" href="/api-reference/sound-effects/post-sound-effects">
      Create a new sound effect generation task
    </Card>

    <Card title="GET /v1/ai/sound-effects" icon="list" href="/api-reference/sound-effects/get-sound-effects">
      List all sound effects tasks
    </Card>

    <Card title="GET /v1/ai/sound-effects/{task-id}" icon="magnifying-glass" href="/api-reference/sound-effects/get-{task-id}-by-id">
      Get task status and results by ID
    </Card>
  </Columns>
</div>

### Parameters

| Parameter          | Type      | Required | Default | Description                                                            |
| ------------------ | --------- | -------- | ------- | ---------------------------------------------------------------------- |
| `text`             | `string`  | Yes      | -       | Text description of the sound effect to generate (max 2500 characters) |
| `duration_seconds` | `number`  | Yes      | -       | Duration of the generated audio (0.5-22 seconds)                       |
| `loop`             | `boolean` | No       | `false` | Create a sound effect that loops smoothly without audible breaks       |
| `prompt_influence` | `number`  | No       | `0.3`   | Influence of the prompt on generation (0-1, higher = more literal)     |
| `webhook_url`      | `string`  | No       | -       | HTTPS URL for task completion notification                             |

### Prompt tips

For best results, include details about:

* **Sound type**: Specify the exact sound (cat meowing, door creaking, rain falling)
* **Intensity**: Describe loudness or energy (soft, loud, aggressive, gentle)
* **Environment**: Add context (indoor, outdoor, underwater, in a cave)
* **Duration characteristics**: For loops, describe continuous sounds (steady rain, humming motor)

**Example prompts:**

* "A cat meowing softly, indoor setting"
* "Ocean waves crashing on the beach, steady rhythm"
* "Thunder rolling in the distance during a storm"
* "Keyboard typing rapidly on a mechanical keyboard"
* "Glass shattering on a hard floor"
* "A car engine starting and idling"
* "Birds chirping in a forest at dawn"
* "Footsteps on gravel, slow walking pace"

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is ElevenLabs Sound Effects and how does it work?">
    ElevenLabs Sound Effects is an AI-powered text-to-audio API that generates realistic sound effects from natural language descriptions. You submit a text description of the sound you want (e.g., "A cat meowing") along with the duration, receive a task ID immediately, then poll for results or receive a webhook notification. The output is a high-quality audio file ready for use in production.
  </Accordion>

  <Accordion title="What duration range is supported?">
    You can generate sound effects from 0.5 seconds (minimum) to 22 seconds (maximum). The duration is specified as a decimal number in the `duration_seconds` parameter. For longer audio, consider using the loop feature and playing the clip multiple times.
  </Accordion>

  <Accordion title="How does the loop feature work?">
    When `loop` is set to `true`, the API generates audio that seamlessly connects end-to-beginning without audible breaks. This is ideal for continuous sounds like rain, wind, machinery hum, or ambient noise that need to play indefinitely. The loop feature works best with sustained, consistent sounds rather than one-time events.
  </Accordion>

  <Accordion title="What does prompt_influence control?">
    The `prompt_influence` parameter (0-1) controls how closely the generated audio matches your text description. Lower values (0-0.3) allow more creative interpretation, while higher values (0.7-1) produce more literal results. The default of 0.3 balances creativity with prompt adherence.
  </Accordion>

  <Accordion title="How do I write effective sound prompts?">
    Be specific about the sound type, intensity, and environment. Good examples: "A cat meowing softly indoors", "Heavy rain on a metal roof", "Car engine starting then idling". Avoid vague prompts like "noise" or "sound" - instead describe exactly what you want to hear.
  </Accordion>

  <Accordion title="What is the output format?">
    ElevenLabs Sound Effects outputs high-quality audio files suitable for professional production use. The generated audio is delivered via a URL that remains accessible for download after task completion.
  </Accordion>

  <Accordion title="How long does generation take?">
    Generation typically takes 5-15 seconds depending on the requested duration and complexity. Shorter clips (under 5 seconds) usually complete in under 10 seconds. For production workflows, use webhooks for efficient notification instead of polling.
  </Accordion>

  <Accordion title="What are the rate limits for Sound Effects?">
    Rate limits vary by subscription tier. See [Rate Limits](/ratelimits) for current limits.
  </Accordion>

  <Accordion title="How much does Sound Effects cost?">
    See the [Pricing page](/pricing) for current rates and subscription options.
  </Accordion>
</AccordionGroup>

## Best practices

* **Prompt specificity**: Use detailed descriptions with context for better results
* **Loop planning**: Use loop=true for ambient sounds, loop=false for one-shot effects
* **Duration matching**: Match duration to your use case - shorter for UI sounds, longer for ambience
* **Prompt influence tuning**: Start with default (0.3), increase for more literal results
* **Production integration**: Use webhooks instead of polling for scalable applications
* **Error handling**: Implement retry logic with exponential backoff for 503 errors

## Related APIs

* **[Music Generation](/api-reference/music-generation/overview)**: Generate original music tracks from text descriptions
* **[Audio Isolation](/api-reference/audio-isolation/overview)**: Isolate specific sounds from audio or video files
* **[Lip Sync](/api-reference/lip-sync/latent-sync/overview)**: Synchronize lip movements with audio tracks


# Sound Effects - Generate from text
Source: https://docs.freepik.com/api-reference/sound-effects/post-sound-effects

post /v1/ai/sound-effects
Create realistic sound effects from text descriptions using AI.

Generate high-quality audio sound effects based on your text prompts. Perfect for video production, game development, podcasts, and multimedia projects.




# List Tasks
Source: https://docs.freepik.com/api-reference/text-to-image/flux-2-klein/flux-2-klein-tasks

GET /v1/ai/text-to-image/flux-2-klein
Retrieve the status of all FLUX.2 [klein] text-to-image generation tasks for the authenticated user.



# Create Image
Source: https://docs.freepik.com/api-reference/text-to-image/flux-2-klein/generate

POST /v1/ai/text-to-image/flux-2-klein
Generate images with sub-second speed using FLUX.2 [klein], the fastest model in the FLUX.2 family by Black Forest Labs.

**Key Features:**
- Sub-second generation time
- Up to 4 reference images for style/subject transfer
- 10 preset aspect ratios with 1k or 2k resolution options
- Adjustable safety tolerance (0-5)
- Multiple output formats (PNG/JPEG)

**Use Cases:**
- Real-time applications requiring fast generation
- Style transfer with reference images
- Rapid prototyping and iteration
- High-volume image generation




# FLUX.2 Klein - Fast Text-to-Image API | Freepik API
Source: https://docs.freepik.com/api-reference/text-to-image/flux-2-klein/overview

Generate images in sub-second time with FLUX.2 Klein. Up to 4 reference images for style transfer. 256-2048px dimensions, PNG/JPEG output for real-time applications.

<Card title="Black Forest Labs FLUX.2 [klein]" icon="bolt">
  The fastest model in the FLUX.2 family, optimized for sub-second image generation with support for up to 4 reference images.
</Card>

FLUX.2 Klein is a high-speed text-to-image API that generates quality images in sub-second time. Developed by Black Forest Labs, it supports up to 4 reference images for style and subject transfer, making it ideal for real-time applications and high-volume generation workflows. The model produces images in multiple aspect ratios at 1k or 2k resolution in both PNG and JPEG formats.

### Key capabilities

* **Sub-second generation**: Fastest model in the FLUX.2 family for real-time applications
* **Multi-image reference**: Up to 4 reference images (`input_image`, `input_image_2`, `input_image_3`, `input_image_4`) for style/subject transfer
* **Flexible aspect ratios**: 10 preset ratios including square, widescreen, portrait, and social media formats
* **Resolution options**: Choose between 1k (standard) or 2k (high resolution, capped at 2048px)
* **Safety control**: Adjustable tolerance level from 0 (most strict) to 5 (least strict)
* **Output formats**: PNG (lossless) or JPEG (compressed)
* **Async processing**: Webhook notifications or polling for task completion

### Use cases

* **Real-time applications**: Chatbots and interactive tools requiring instant image generation
* **Style transfer**: Apply visual styles from reference images to new generations
* **High-volume workflows**: Generate thousands of images efficiently
* **Rapid prototyping**: Quick iteration on creative concepts and designs
* **E-commerce**: Generate product variations and lifestyle imagery at scale

### Generate images with FLUX.2 Klein

Create images by submitting a request to the API. The service returns a task ID for async polling or webhook notification.

<div>
  <Columns>
    <Card title="POST /v1/ai/text-to-image/flux-2-klein" icon="bolt" href="/api-reference/text-to-image/flux-2-klein/generate">
      Create a new image generation task
    </Card>

    <Card title="GET /v1/ai/text-to-image/flux-2-klein" icon="list" href="/api-reference/text-to-image/flux-2-klein/flux-2-klein-tasks">
      List all FLUX.2 Klein tasks with status
    </Card>

    <Card title="GET /v1/ai/text-to-image/flux-2-klein/{task-id}" icon="magnifying-glass" href="/api-reference/text-to-image/flux-2-klein/task-by-id">
      Get task status and results by ID
    </Card>
  </Columns>
</div>

### Parameters

| Parameter          | Type      | Required | Default      | Description                                           |
| ------------------ | --------- | -------- | ------------ | ----------------------------------------------------- |
| `prompt`           | `string`  | Yes      | -            | Text description of the image to generate             |
| `aspect_ratio`     | `string`  | No       | `square_1_1` | Image aspect ratio (see table below)                  |
| `resolution`       | `string`  | No       | `1k`         | Resolution: `1k` (standard) or `2k` (high resolution) |
| `seed`             | `integer` | No       | random       | Seed for reproducible generation (0-4,294,967,295)    |
| `input_image`      | `string`  | No       | -            | Base64-encoded reference image for style transfer     |
| `input_image_2`    | `string`  | No       | -            | Second reference image                                |
| `input_image_3`    | `string`  | No       | -            | Third reference image                                 |
| `input_image_4`    | `string`  | No       | -            | Fourth reference image                                |
| `safety_tolerance` | `integer` | No       | `2`          | Content moderation: 0 (strict) to 5 (lenient)         |
| `output_format`    | `string`  | No       | -            | Output format: `png` or `jpeg`                        |
| `webhook_url`      | `string`  | No       | -            | URL for completion notification                       |

### Aspect ratios

| Aspect Ratio        | Base Dimensions (1k) |
| ------------------- | -------------------- |
| `square_1_1`        | 1024 × 1024          |
| `widescreen_16_9`   | 1344 × 768           |
| `social_story_9_16` | 768 × 1344           |
| `portrait_2_3`      | 832 × 1216           |
| `traditional_3_4`   | 960 × 1280           |
| `vertical_1_2`      | 704 × 1408           |
| `horizontal_2_1`    | 1408 × 704           |
| `social_post_4_5`   | 896 × 1152           |
| `standard_3_2`      | 1216 × 832           |
| `classic_4_3`       | 1280 × 960           |

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is FLUX.2 Klein and how does it work?">
    FLUX.2 Klein is the fastest model in the FLUX.2 family by Black Forest Labs, optimized for sub-second image generation. You submit a text prompt via the API, optionally include up to 4 reference images, receive a task ID immediately, then poll for results or receive a webhook notification when processing completes.
  </Accordion>

  <Accordion title="How do reference images work in FLUX.2 Klein?">
    You can provide up to 4 Base64-encoded reference images using `input_image`, `input_image_2`, `input_image_3`, and `input_image_4` parameters. The model uses these images to guide style, composition, and subject elements in the generated output while still following your text prompt.
  </Accordion>

  <Accordion title="What image dimensions does FLUX.2 Klein support?">
    FLUX.2 Klein uses preset aspect ratios (square\_1\_1, widescreen\_16\_9, portrait\_2\_3, etc.) combined with resolution settings (1k or 2k). The 2k resolution doubles the base dimensions but caps at 2048px per side.
  </Accordion>

  <Accordion title="How fast is FLUX.2 Klein compared to other Flux models?">
    FLUX.2 Klein is the fastest model in the FLUX.2 family, achieving sub-second generation times. This makes it ideal for real-time applications where speed is critical, though FLUX.2 Pro offers higher quality for less time-sensitive use cases.
  </Accordion>

  <Accordion title="What are the rate limits for FLUX.2 Klein?">
    See [Rate Limits](/ratelimits) for current limits by subscription tier.
  </Accordion>

  <Accordion title="How much does FLUX.2 Klein cost?">
    See [Pricing](/pricing) for detailed rates and free tier credits.
  </Accordion>

  <Accordion title="What is the difference between FLUX.2 Klein and FLUX.2 Pro?">
    FLUX.2 Klein is optimized for speed with sub-second generation, ideal for real-time applications. FLUX.2 Pro offers higher quality output for premium results. Choose FLUX.2 Klein when speed is critical; choose FLUX.2 Pro when quality is the priority.
  </Accordion>
</AccordionGroup>

## Best practices

* **Reference images**: Use high-quality reference images with clear style elements for best transfer results
* **Prompt writing**: Be specific about subjects, scenes, and visual details even when using reference images
* **Aspect ratio selection**: Choose the appropriate preset aspect ratio for your use case
* **Resolution choice**: Use 1k for speed, 2k for higher detail (capped at 2048px)
* **Production integration**: Use webhooks instead of polling for scalable applications
* **Error handling**: Implement retry logic with exponential backoff for 503 errors

## Related APIs

* **[FLUX.2 Pro](/api-reference/text-to-image/post-flux-2-pro)**: Higher quality generation for premium results
* **[FLUX.2 Turbo](/api-reference/text-to-image/post-flux-2-turbo)**: Balance of speed and quality
* **[Flux Kontext Pro](/api-reference/text-to-image/flux-kontext-pro/overview)**: Context-aware generation with image guidance


# Get Task by ID
Source: https://docs.freepik.com/api-reference/text-to-image/flux-2-klein/task-by-id

GET /v1/ai/text-to-image/flux-2-klein/{task-id}
Retrieve the status and results of a specific FLUX.2 [klein] generation task.



# Flux Dev - List tasks
Source: https://docs.freepik.com/api-reference/text-to-image/flux-dev/get-flux-dev

get /v1/ai/text-to-image/flux-dev
Get the status of the flux-dev task



# Flux Dev - Get task status
Source: https://docs.freepik.com/api-reference/text-to-image/flux-dev/get-flux-dev-task

get /v1/ai/text-to-image/flux-dev/{task-id}
Get the status of the flux-dev task



# Flux Dev - Create image from text
Source: https://docs.freepik.com/api-reference/text-to-image/flux-dev/post-flux-dev

post /v1/ai/text-to-image/flux-dev
Convert descriptive text input into images using AI. This endpoint accepts a variety of parameters to customize the generated images.



# Flux Kontext Pro - List tasks
Source: https://docs.freepik.com/api-reference/text-to-image/flux-kontext-pro/get-flux-kontext-pro

get /v1/ai/text-to-image/flux-kontext-pro
Retrieve the status of all Flux Kontext Pro text-to-image generation tasks for the authenticated user.



# Flux Kontext Pro - Get task status
Source: https://docs.freepik.com/api-reference/text-to-image/flux-kontext-pro/get-flux-kontext-pro-task

get /v1/ai/text-to-image/flux-kontext-pro/{task-id}
Retrieve the status and results of a specific Flux Kontext Pro text-to-image generation task.



# Flux Kontext Pro – Text-to-Image API | Freepik API
Source: https://docs.freepik.com/api-reference/text-to-image/flux-kontext-pro/overview

Generate high-quality images from text with Flux Kontext Pro. Advanced context understanding with optional image input support. Multiple aspect ratios and fine-grained generation control.

<Card title="FLUX Kontext Pro integration" icon="wand-magic-sparkles">
  Advanced text-to-image model that excels at understanding context and generating high-quality images with optional image input guidance.
</Card>

Flux Kontext Pro is a state-of-the-art text-to-image model that combines superior context understanding with flexible generation controls. It supports optional image input to guide the generation process, enabling more precise control over the output. The model produces high-quality images across multiple aspect ratios, suitable for professional creative workflows.

### Key capabilities

* **Context-aware generation**: Advanced understanding of complex text descriptions for accurate image synthesis
* **Optional image guidance**: Provide a reference image URL to guide the generation toward desired visual styles
* **Prompt upsampling**: Automatic prompt modification for more creative and detailed outputs
* **Fine-grained control**: Adjustable guidance scale (1-10) and inference steps (1-100) for quality tuning
* **Multiple aspect ratios**: Support for square (1:1), widescreen (16:9), social story (9:16), classic (4:3, 3:4), and standard (3:2)
* **Reproducible results**: Optional seed parameter for consistent generation across requests

### Use cases

* **Marketing and advertising**: Generate product visuals and campaign imagery from descriptions
* **Content creation**: Create unique illustrations and graphics for blogs, social media, and websites
* **Design prototyping**: Quickly visualize concepts before detailed design work
* **E-commerce**: Generate product mockups and lifestyle imagery at scale
* **Creative exploration**: Experiment with visual ideas using text prompts and reference images

### Generate images with Flux Kontext Pro

Create images by submitting a request to the API. The service returns a task ID for async polling or webhook notification.

<div>
  <Columns>
    <Card title="POST /v1/ai/text-to-image/flux-kontext-pro" icon="wand-magic-sparkles" href="/api-reference/text-to-image/flux-kontext-pro/post-flux-kontext-pro">
      Create a new image generation task
    </Card>

    <Card title="GET /v1/ai/text-to-image/flux-kontext-pro" icon="list" href="/api-reference/text-to-image/flux-kontext-pro/get-flux-kontext-pro">
      List all Flux Kontext Pro tasks
    </Card>

    <Card title="GET /v1/ai/text-to-image/flux-kontext-pro/{task-id}" icon="magnifying-glass" href="/api-reference/text-to-image/flux-kontext-pro/get-flux-kontext-pro-task">
      Get task status and results by ID
    </Card>
  </Columns>
</div>

### Parameters

| Parameter           | Type      | Required | Default      | Description                                                                                                                 |
| ------------------- | --------- | -------- | ------------ | --------------------------------------------------------------------------------------------------------------------------- |
| `prompt`            | `string`  | Yes      | -            | Text description of the image to generate                                                                                   |
| `input_image`       | `string`  | No       | -            | URL to a reference image for guided generation                                                                              |
| `prompt_upsampling` | `boolean` | No       | `false`      | Enable automatic prompt modification for creative results                                                                   |
| `seed`              | `integer` | No       | random       | Seed for reproducible generation                                                                                            |
| `guidance`          | `number`  | No       | `3.0`        | Guidance scale (1-10), higher values follow prompt more closely                                                             |
| `steps`             | `integer` | No       | `50`         | Inference steps (1-100), more steps produce higher quality                                                                  |
| `aspect_ratio`      | `string`  | No       | `square_1_1` | Output aspect ratio: `square_1_1`, `classic_4_3`, `traditional_3_4`, `widescreen_16_9`, `social_story_9_16`, `standard_3_2` |

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is Flux Kontext Pro and how does it work?">
    Flux Kontext Pro is an advanced text-to-image AI model that excels at understanding context from text descriptions. You submit a prompt via the API, optionally include a reference image URL, receive a task ID, and then poll for results or receive a webhook notification when the image is ready.
  </Accordion>

  <Accordion title="How does the image input guidance work?">
    When you provide an `input_image` URL, the model uses that image as a reference to guide the generation process. This helps achieve specific visual styles, color palettes, or compositional elements in the output while still following your text prompt.
  </Accordion>

  <Accordion title="What does prompt upsampling do?">
    Prompt upsampling automatically modifies your prompt to add more creative details and variations. Enable it when you want the model to expand on your description for more elaborate and artistic results.
  </Accordion>

  <Accordion title="How do guidance and steps affect the output?">
    The `guidance` parameter (1-10, default 3.0) controls how closely the model follows your prompt. Higher values produce images more faithful to the description. The `steps` parameter (1-100, default 50) controls quality: more steps produce finer details but take longer to process.
  </Accordion>

  <Accordion title="What aspect ratios are available?">
    Flux Kontext Pro supports six aspect ratios: `square_1_1` (default), `classic_4_3`, `traditional_3_4`, `widescreen_16_9`, `social_story_9_16`, and `standard_3_2`. Choose based on your intended use case.
  </Accordion>

  <Accordion title="Can I reproduce the same image?">
    Yes, use the `seed` parameter with the same value across requests to generate reproducible results. Combined with identical prompts and settings, you will get consistent outputs.
  </Accordion>
</AccordionGroup>

## Best practices

* **Prompt writing**: Be specific about subjects, scenes, lighting, atmosphere, and art style for better results
* **Guidance tuning**: Start with the default guidance (3.0) and increase for more literal prompt adherence
* **Image guidance**: Use reference images when you need specific visual styles or want to maintain consistency across generations
* **Production integration**: Use webhooks instead of polling for scalable applications
* **Error handling**: Implement retry logic for 503 errors during high traffic

## Related APIs

* **[Flux 2 Pro](/api-reference/text-to-image/post-flux-2-pro)**: High-quality text-to-image generation without image input support
* **[Flux 2 Turbo](/api-reference/text-to-image/post-flux-2-turbo)**: Faster generation with Flux 2 for time-sensitive workflows
* **[Seedream 4.5](/api-reference/text-to-image/post-seedream-v4-5)**: Alternative text-to-image model with different capabilities


# Flux Kontext Pro - Create image from text
Source: https://docs.freepik.com/api-reference/text-to-image/flux-kontext-pro/post-flux-kontext-pro

post /v1/ai/text-to-image/flux-kontext-pro
Generate images using FLUX Kontext Pro, an advanced text-to-image model with optional image input support.

This model excels at understanding context and generating high-quality images from text descriptions.
Optionally, you can provide an input image to guide the generation process.




# Flux Pro 1.1 - List tasks
Source: https://docs.freepik.com/api-reference/text-to-image/flux-pro-v1-1/get-flux-pro-v1-1

get /v1/ai/text-to-image/flux-pro-v1-1
Get the status of the flux-pro 1.1 task



# Flux Pro 1.1 - Get task status
Source: https://docs.freepik.com/api-reference/text-to-image/flux-pro-v1-1/get-flux-pro-v1-1-detail

get /v1/ai/text-to-image/flux-pro-v1-1/{task-id}
Get the status of the flux-pro 1.1 task



# Flux Pro 1.1 - Create image from text
Source: https://docs.freepik.com/api-reference/text-to-image/flux-pro-v1-1/post-flux-pro-v1-1

post /v1/ai/text-to-image/flux-pro-v1-1
Convert descriptive text input into images using AI. This endpoint accepts a variety of parameters to customize the generated images.



# Flux 2 Pro - List tasks
Source: https://docs.freepik.com/api-reference/text-to-image/get-flux-2-pro

get /v1/ai/text-to-image/flux-2-pro
Retrieve the status of all Flux 2 Pro text-to-image generation tasks for the authenticated user.



# Flux 2 Pro - Get task status
Source: https://docs.freepik.com/api-reference/text-to-image/get-flux-2-pro-task

get /v1/ai/text-to-image/flux-2-pro/{task-id}
Retrieve the status and results of a specific Flux 2 Pro generation task.



# Flux 2 Turbo - List tasks
Source: https://docs.freepik.com/api-reference/text-to-image/get-flux-2-turbo

get /v1/ai/text-to-image/flux-2-turbo
Retrieve the status of all Flux 2 Turbo text-to-image generation tasks for the authenticated user.



# Flux 2 Turbo - Get task status
Source: https://docs.freepik.com/api-reference/text-to-image/get-flux-2-turbo-task

get /v1/ai/text-to-image/flux-2-turbo/{task-id}
Retrieve the status and results of a specific Flux 2 Turbo generation task.



# HyperFlux - List tasks
Source: https://docs.freepik.com/api-reference/text-to-image/get-hyperflux

get /v1/ai/text-to-image/hyperflux



# Create image from text - Classic fast
Source: https://docs.freepik.com/api-reference/text-to-image/get-image-from-text

post /v1/ai/text-to-image
Convert descriptive text input into images using AI. This endpoint accepts a variety of parameters to customize the generated images.



# Get the status of all Nano Banana Pro tasks
Source: https://docs.freepik.com/api-reference/text-to-image/get-nano-banana-pro

get /v1/ai/text-to-image/nano-banana-pro
Get the status of all Nano Banana Pro image generation tasks



# Get the status of a Nano Banana Pro task
Source: https://docs.freepik.com/api-reference/text-to-image/get-nano-banana-pro-task

get /v1/ai/text-to-image/nano-banana-pro/{task-id}
Get the status of a specific Nano Banana Pro image generation task



# Get the status of all RunWay text-to-image tasks
Source: https://docs.freepik.com/api-reference/text-to-image/get-runway

get /v1/ai/text-to-image/runway
Get the status of all RunWay text-to-image generation tasks



# Get RunWay text-to-image task by ID
Source: https://docs.freepik.com/api-reference/text-to-image/get-runway-task

get /v1/ai/text-to-image/runway/{task-id}
Get the status and result of a specific RunWay text-to-image task



# Seedream 4.5 - List tasks
Source: https://docs.freepik.com/api-reference/text-to-image/get-seedream-v4-5

get /v1/ai/text-to-image/seedream-v4-5
Get the status of all Seedream 4.5 image generation tasks



# Seedream 4.5 Edit - List tasks
Source: https://docs.freepik.com/api-reference/text-to-image/get-seedream-v4-5-edit

get /v1/ai/text-to-image/seedream-v4-5-edit
Get the status of all Seedream 4.5 image editing tasks



# Seedream 4.5 Edit - Get task status
Source: https://docs.freepik.com/api-reference/text-to-image/get-seedream-v4-5-edit-task

get /v1/ai/text-to-image/seedream-v4-5-edit/{task-id}
Get the status of a specific Seedream 4.5 image editing task



# Seedream 4.5 - Get task status
Source: https://docs.freepik.com/api-reference/text-to-image/get-seedream-v4-5-task

get /v1/ai/text-to-image/seedream-v4-5/{task-id}
Get the status of a specific Seedream 4.5 image generation task



# Seedream V5 Lite - List tasks
Source: https://docs.freepik.com/api-reference/text-to-image/get-seedream-v5-lite

get /v1/ai/text-to-image/seedream-v5-lite
Get the status of all Seedream V5 Lite image generation tasks



# Seedream V5 Lite Edit - List tasks
Source: https://docs.freepik.com/api-reference/text-to-image/get-seedream-v5-lite-edit

get /v1/ai/text-to-image/seedream-v5-lite-edit
Get the status of all Seedream V5 Lite image editing tasks



# Seedream V5 Lite Edit - Get task status
Source: https://docs.freepik.com/api-reference/text-to-image/get-seedream-v5-lite-edit-task

get /v1/ai/text-to-image/seedream-v5-lite-edit/{task-id}
Get the status of a specific Seedream V5 Lite image editing task



# Seedream V5 Lite - Get task status
Source: https://docs.freepik.com/api-reference/text-to-image/get-seedream-v5-lite-task

get /v1/ai/text-to-image/seedream-v5-lite/{task-id}
Get the status of a specific Seedream V5 Lite image generation task



# Get the status of all Z-Image tasks
Source: https://docs.freepik.com/api-reference/text-to-image/get-z-image

get /v1/ai/text-to-image/z-image
Get the status of all Z-Image image generation tasks



# Get the status of a Z-Image task
Source: https://docs.freepik.com/api-reference/text-to-image/get-z-image-task

get /v1/ai/text-to-image/z-image/{task-id}
Get the status of a specific Z-Image image generation task



# HyperFlux - Get task status
Source: https://docs.freepik.com/api-reference/text-to-image/get-{task-id}-by-id

get /v1/ai/text-to-image/hyperflux/{task-id}



# Create Image
Source: https://docs.freepik.com/api-reference/text-to-image/nano-banana-pro-flash/generate

POST /v1/ai/text-to-image/nano-banana-pro-flash
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.

**Key Features:**
- Fast image generation with Gemini 3.1 Flash
- Google Search grounding for real-world accuracy
- Support for reference images for guided generation
- Multiple aspect ratios and resolutions up to 4K

**Best for:**
- Rapid image generation with shorter wait times
- Grounded image generation using Google Search
- Reference-guided generation
- Iterative creative workflows where speed matters




# List Tasks
Source: https://docs.freepik.com/api-reference/text-to-image/nano-banana-pro-flash/nano-banana-pro-flash-tasks

GET /v1/ai/text-to-image/nano-banana-pro-flash
Get the status of all Nano Banana Pro Flash image generation tasks



# Nano Banana Pro Flash API
Source: https://docs.freepik.com/api-reference/text-to-image/nano-banana-pro-flash/overview

Generate images from text with Nano Banana Pro Flash. Powered by Gemini 3.1 Flash for fast generation with Google Search grounding, reference images, and resolutions up to 4K.

<Card title="Gemini 3.1 Flash integration" icon="bolt">
  The faster variant of Nano Banana Pro, powered by Google's Gemini 3.1 Flash model for rapid image generation with optional web search grounding.
</Card>

Nano Banana Pro Flash (also known as **Nano Banana 2** on fal.ai) is a text-to-image API powered by Google's Gemini 3.1 Flash model. It generates images from natural language prompts with faster processing times than the standard Nano Banana Pro, making it suited for iterative creative workflows and high-volume applications. The model supports Google Search grounding, reference-guided generation with up to 3 images, 10 aspect ratios, and resolutions up to 4K.

### Key capabilities

* **Fast generation**: Powered by Gemini 3.1 Flash for shorter processing times compared to Nano Banana Pro
* **Google Search grounding**: Enable `use_google_search_tool` for images that need real-world accuracy (places, brands, current events)
* **Reference image support**: Up to 3 reference images (PNG, JPEG, WebP) for style and subject guidance
* **Flexible aspect ratios**: 10 ratios including `1:1`, `16:9`, `9:16`, `21:9`, `2:3`, `3:2`, `4:3`, `3:4`, `5:4`, `4:5`
* **Resolution options**: `1K` (fast), `2K` (balanced), `4K` (best quality)
* **Prompt range**: 2 to 3,000 characters for detailed scene descriptions
* **Async processing**: Webhook notifications or polling for task completion

### Use cases

* **Rapid prototyping**: Fast iteration on visual concepts where speed matters more than maximum quality
* **Grounded generation**: Images of real places, products, or events using Google Search for accuracy
* **Reference-guided creation**: Style transfer and subject guidance from existing images
* **Marketing and social media**: Quick generation of campaign visuals in various aspect ratios
* **High-volume pipelines**: Batch generation where throughput is a priority

### Generate images with Nano Banana Pro Flash

Create images by submitting a text prompt to the API. The service returns a task ID for async polling or webhook notification.

<div>
  <Columns>
    <Card title="POST /v1/ai/text-to-image/nano-banana-pro-flash" icon="wand-magic-sparkles" href="/api-reference/text-to-image/nano-banana-pro-flash/generate">
      Create a new image generation task
    </Card>

    <Card title="GET /v1/ai/text-to-image/nano-banana-pro-flash" icon="list" href="/api-reference/text-to-image/nano-banana-pro-flash/nano-banana-pro-flash-tasks">
      List all Nano Banana Pro Flash tasks
    </Card>

    <Card title="GET /v1/ai/text-to-image/nano-banana-pro-flash/{task-id}" icon="magnifying-glass" href="/api-reference/text-to-image/nano-banana-pro-flash/task-by-id">
      Get task status and results by ID
    </Card>
  </Columns>
</div>

### Parameters

| Parameter                | Type      | Required | Default | Description                                                                           |
| ------------------------ | --------- | -------- | ------- | ------------------------------------------------------------------------------------- |
| `prompt`                 | `string`  | Yes      | -       | Text description of the image to generate (2-3,000 characters)                        |
| `reference_images`       | `array`   | No       | -       | Up to 3 reference images with optional `text` and `mime_type` per image               |
| `aspect_ratio`           | `string`  | No       | `1:1`   | Output ratio: `1:1`, `2:3`, `3:2`, `4:3`, `3:4`, `5:4`, `4:5`, `16:9`, `9:16`, `21:9` |
| `resolution`             | `string`  | No       | `1K`    | Quality level: `1K`, `2K`, `4K`                                                       |
| `use_google_search_tool` | `boolean` | No       | `false` | Enable Google Search grounding for real-world accuracy                                |
| `webhook_url`            | `string`  | No       | -       | URL for async status notifications                                                    |

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is Nano Banana Pro Flash and how does it work?">
    Nano Banana Pro Flash is a text-to-image API powered by Google's Gemini 3.1 Flash model. You submit a text prompt (2-3,000 characters) via the API, optionally include up to 3 reference images, and receive a task ID immediately. Poll the task endpoint or configure a webhook to receive the generated image URL when processing completes.
  </Accordion>

  <Accordion title="What does Google Search grounding do?">
    When `use_google_search_tool` is set to `true`, the model uses Google Search to ground its generation with real-world information. This improves accuracy for prompts referencing real places, people, brands, or current events. The response includes `groundingMetadata` with source information when this feature is active.
  </Accordion>

  <Accordion title="What image formats are supported for reference images?">
    Nano Banana Pro Flash accepts PNG, JPEG, and WebP reference images. Each reference image must be a publicly accessible URL. You can include up to 3 reference images, each with optional descriptive text and mime type.
  </Accordion>

  <Accordion title="What resolutions are available?">
    Three resolution levels: `1K` (fastest generation), `2K` (balanced quality and speed), and `4K` (best quality).
  </Accordion>

  <Accordion title="What are the rate limits for Nano Banana Pro Flash?">
    Rate limits depend on your subscription tier. See [Rate Limits](/ratelimits) for current limits.
  </Accordion>

  <Accordion title="How much does Nano Banana Pro Flash cost?">
    See the [Pricing page](/pricing) for current rates and subscription options.
  </Accordion>

  <Accordion title="What is the difference between Nano Banana Pro and Nano Banana Pro Flash?">
    Nano Banana Pro Flash uses Google's Gemini 3.1 Flash model optimized for speed, while Nano Banana Pro uses the standard model for maximum quality. Both share the same parameters, aspect ratios, and resolution options. Choose Flash when generation speed matters; choose Pro when you need the highest quality output. Flash defaults to `1K` resolution while Pro defaults to `2K`.
  </Accordion>
</AccordionGroup>

## Best practices

* **Google Search grounding**: Enable `use_google_search_tool` when your prompt references real-world entities (landmarks, brands, public figures) for more accurate results
* **Reference images**: Use high-quality reference images with clear visual elements for best guided generation
* **Prompt writing**: Be specific about subjects, composition, lighting, and style. The 3,000-character limit allows for detailed scene descriptions
* **Resolution selection**: Use `1K` for fastest iteration, `2K` for balanced workflows, `4K` for final production assets
* **Production integration**: Use webhooks instead of polling for scalable applications
* **Error handling**: Implement retry logic with exponential backoff for 503 errors

## Related APIs

* **[Mystic](/api-reference/mystic/mystic)**: Freepik's proprietary image generation with LoRA style control
* **[Flux Kontext Pro](/api-reference/text-to-image/flux-kontext-pro/overview)**: Context-aware generation with image-guided editing
* **[Seedream 4](/api-reference/text-to-image/seedream-4/overview)**: High-quality text-to-image generation with advanced prompt understanding


# Get Task by ID
Source: https://docs.freepik.com/api-reference/text-to-image/nano-banana-pro-flash/task-by-id

GET /v1/ai/text-to-image/nano-banana-pro-flash/{task-id}
Get the status of a specific Nano Banana Pro Flash image generation task



# Flux 2 Pro - Create image from text
Source: https://docs.freepik.com/api-reference/text-to-image/post-flux-2-pro

post /v1/ai/text-to-image/flux-2-pro
Create professional-grade images using FLUX.2 [pro], the next generation of Black Forest Labs' image models.

**Key Features:**
- Professional quality without complex tuning
- Text-to-image generation
- Image-to-image editing (up to 4 input images)
- Customizable dimensions (256-1440px)
- Optional prompt enhancement
- Reproducible results with seed

**Use Cases:**
- Marketing materials and advertisements
- Product photography variations
- Concept art and illustrations
- Image editing and enhancement




# Flux 2 Turbo - Create image from text
Source: https://docs.freepik.com/api-reference/text-to-image/post-flux-2-turbo

post /v1/ai/text-to-image/flux-2-turbo
Create high-quality images quickly using FLUX.2 [turbo], the speed-optimized version of Flux 2.

**Key Features:**
- Fast generation (optimized for speed)
- Lower cost than Pro version
- Adjustable guidance scale for prompt adherence
- Custom image dimensions (512-2048px)
- Safety checker for content filtering
- Multiple output formats (PNG/JPEG)

**Use Cases:**
- Rapid prototyping and iteration
- Content exploration
- High-volume generation
- Testing prompts and concepts




# HyperFlux - Create image from text
Source: https://docs.freepik.com/api-reference/text-to-image/post-hyperflux

post /v1/ai/text-to-image/hyperflux
This endpoint allows you to generate an image using the HyperFlux model, the fastest Flux model available




# Create image from text - Nano Banana Pro
Source: https://docs.freepik.com/api-reference/text-to-image/post-nano-banana-pro

post /v1/ai/text-to-image/nano-banana-pro
Generate high-quality images from text descriptions using Google's Nano Banana Pro model (Gemini 3).

**Key Features:**
- Advanced image generation with complex compositions
- Support for reference images for guided generation
- Multiple aspect ratios and resolutions
- High-quality output up to 4K resolution

**Best for:**
- High-quality image generation
- Complex scene compositions
- Reference-guided generation
- Professional visual content




# Create image from text - RunWay
Source: https://docs.freepik.com/api-reference/text-to-image/post-runway

post /v1/ai/text-to-image/runway
Generate high-quality images from text descriptions using RunWay's Gen4 Image model.

**Key Features:**
- Photorealistic and artistic image generation
- Multiple aspect ratios supported
- Reference image support with @tag syntax
- High-resolution output

**Best for:**
- Photorealistic images
- Artistic and creative visuals
- Marketing and promotional content




# Seedream 4.5 - Create image from text
Source: https://docs.freepik.com/api-reference/text-to-image/post-seedream-v4-5

post /v1/ai/text-to-image/seedream-v4-5
Generate high-quality images from text descriptions using ByteDance's Seedream 4.5 model.

**Key Features:**
- Superior typography and text rendering
- Excellent poster composition and branded visuals
- Up to 4MP resolution support (4096x4096)
- Enhanced editing consistency

**Best for:**
- Marketing materials with text
- Professional posters and banners
- Branded visual content
- High-resolution image generation




# Seedream 4.5 - Edit image
Source: https://docs.freepik.com/api-reference/text-to-image/post-seedream-v4-5-edit

post /v1/ai/text-to-image/seedream-v4-5-edit
Edit images using ByteDance's Seedream 4.5 model with text guidance.

**Key Features:**
- Preserves subject details, lighting, and color tone
- Supports up to 5 reference images
- Enhanced editing consistency
- Up to 4MP output resolution

**Best for:**
- Image-to-image editing
- Style transfer with consistency
- Multi-image reference editing




# Seedream V5 Lite - Create image from text
Source: https://docs.freepik.com/api-reference/text-to-image/post-seedream-v5-lite

post /v1/ai/text-to-image/seedream-v5-lite
Generate high-quality images from text descriptions using ByteDance's Seedream V5 Lite model.

**Key Features:**
- Improved detail and composition over previous versions
- Up to 4MP resolution support
- Various aspect ratios available
- Optional seed for reproducibility

**Best for:**
- High-quality image generation
- Detailed scenes and compositions
- Cinematic and artistic imagery




# Seedream V5 Lite - Edit image
Source: https://docs.freepik.com/api-reference/text-to-image/post-seedream-v5-lite-edit

post /v1/ai/text-to-image/seedream-v5-lite-edit
Edit images using ByteDance's Seedream V5 Lite model with text guidance.

**Key Features:**
- Preserves subject details, lighting, and color tone
- Supports up to 5 reference images
- Enhanced editing consistency
- Up to 4MP output resolution

**Best for:**
- Image-to-image editing
- Style transfer with consistency
- Multi-image reference editing




# Create image from text - Z-Image
Source: https://docs.freepik.com/api-reference/text-to-image/post-z-image

post /v1/ai/text-to-image/z-image
Generate high-quality images from text descriptions using the Z-Image turbo model.

**Key Features:**
- Superior speed with turbo architecture
- High-quality image generation
- Flexible image size configuration
- Supports LoRA and ControlNet variants

**Best for:**
- Fast prototyping and iteration
- High-volume image generation
- Cost-effective production workloads




# Flux Reimagine - Transform image
Source: https://docs.freepik.com/api-reference/text-to-image/reimagine-flux/post-reimagine-flux

post /v1/ai/beta/text-to-image/reimagine-flux
(Beta, synchronous) Reimagine Flux is a new AI model that allows you to generate images from text prompts.



# Seedream 4 Edit - List tasks
Source: https://docs.freepik.com/api-reference/text-to-image/seedream-4-edit/get-seedream-v4-edit

get /v1/ai/text-to-image/seedream-v4-edit
Get the status of all Seedream v4 edit tasks



# Seedream 4 Edit - Get task status
Source: https://docs.freepik.com/api-reference/text-to-image/seedream-4-edit/get-seedream-v4-edit-detail

get /v1/ai/text-to-image/seedream-v4-edit/{task-id}
Get the status of the Seedream v4 edit task



# Seedream 4 Edit – Image Editing API
Source: https://docs.freepik.com/api-reference/text-to-image/seedream-4-edit/overview

Next‑generation editing with precise instruction following, high‑fidelity feature preservation, and multi‑image input/output for production‑ready results.

<Card title="Seedream 4 Edit is now available" icon="circle-exclamation">
  This page introduces the editing‑focused variant of Seedream 4. Endpoints follow the Seedream naming with an editing suffix for clarity.
</Card>

Seedream 4 Edit brings precise, instruction‑driven image editing. It supports addition, deletion, modification, replacement, and reference operations in a single step, while preserving identity, texture, and style. Multi‑image input/output enables complex compositions and storyboard‑like workflows. Looking for high‑quality text‑to‑image generation? See <a href="/api-reference/text-to-image/seedream-4/overview">Seedream 4</a>.

### Key capabilities

* Precise instruction editing: addition, change, replace, and reference
* High‑degree feature preservation to avoid "AI artifacts"
* Deep intent understanding for better prompt adherence
* Multi‑image input and output for interconnected results
* Ultra‑fast generation and up to 4K outputs

### Use cases

* Commercial/product edits with brand‑safe preservation
* Character/style‑consistent edits across variations and scenes
* Multi‑shot creation for campaigns and storyboards
* Text replacement and layout‑aware modifications

<div>
  <Columns>
    <Card title="POST /v1/ai/text-to-image/seedream-v4-edit" icon="wand-magic-sparkles" href="/api-reference/text-to-image/seedream-4-edit/post-seedream-v4-edit">
      Create a Seedream 4 Edit task
    </Card>

    <Card title="GET /v1/ai/text-to-image/seedream-v4-edit/{task-id}" icon="code" href="/api-reference/text-to-image/seedream-4-edit/get-seedream-v4-edit-detail">
      Check Seedream 4 Edit task status
    </Card>

    <Card title="GET /v1/ai/text-to-image/seedream-v4-edit" icon="list" href="/api-reference/text-to-image/seedream-4-edit/get-seedream-v4-edit">
      List Seedream 4 Edit tasks
    </Card>
  </Columns>
</div>

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="Does Seedream 4 Edit modify identity or preserve it?">
    By default, Seedream 4 Edit prioritizes feature preservation and identity consistency. You can steer larger edits via explicit instructions.
  </Accordion>

  <Accordion title="Can I combine multiple reference images?">
    Yes. The model supports multi‑image input to guide composition, style, and subject relationships across outputs.
  </Accordion>

  <Accordion title="Are outputs suitable for production?">
    Yes. Outputs target production‑ready fidelity. For extreme resolutions, pair with an upscaler.
  </Accordion>
</AccordionGroup>


# Seedream 4 - Edit image
Source: https://docs.freepik.com/api-reference/text-to-image/seedream-4-edit/post-seedream-v4-edit

post /v1/ai/text-to-image/seedream-v4-edit
Convert descriptive text input into images using AI. This endpoint accepts a variety of parameters to customize the generated images.



# Seedream 4 - List tasks
Source: https://docs.freepik.com/api-reference/text-to-image/seedream-4/get-seedream-v4

get /v1/ai/text-to-image/seedream-v4
Get the status of all Seedream v4 tasks



# Seedream 4 - Get task status
Source: https://docs.freepik.com/api-reference/text-to-image/seedream-4/get-seedream-v4-detail

get /v1/ai/text-to-image/seedream-v4/{task-id}
Get the status of the Seedream v4 task



# Seedream 4 - Text To Image API
Source: https://docs.freepik.com/api-reference/text-to-image/seedream-4/overview

Next-generation text-to-image model for high-quality, consistent generations with flexible aspect ratios and production-ready outputs.

<Card title="Seedream 4 is coming soon" icon="circle-exclamation">
  This page outlines the upcoming Seedream 4 model. The API interface and endpoint naming will mirror Seedream 3 with a versioned suffix for clarity.
</Card>

Seedream 4 is a next‑gen text‑to‑image model focused on reliable, production‑ready outputs. It delivers high‑quality imagery from natural language prompts, with strong detail retention, coherent composition, and controllable styles across a range of aspect ratios. Need precise instruction‑driven editing? Try <a href="/api-reference/text-to-image/seedream-4-edit/overview">Seedream 4 Edit</a>.

### Key capabilities

* High‑quality generations with strong subject and style consistency
* Flexible aspect ratios suitable for product, social, and editorial formats
* Robust prompt adherence with natural, balanced color and lighting
* Designed for production workflows and LLM toolchains

### Use cases

* Product and lifestyle imagery for e‑commerce and marketing
* Concept art and visual ideation with consistent styles
* Editorial and social assets tailored to target aspect ratios
* Brand‑aligned visuals with coherent color and composition

<div>
  <Columns>
    <Card title="POST /v1/ai/text-to-image/seedream-v4" icon="wand-magic-sparkles" href="/api-reference/text-to-image/seedream-4/post-seedream-v4">
      Create a Seedream 4 generation task
    </Card>

    <Card title="GET /v1/ai/text-to-image/seedream-v4/{task-id}" icon="code" href="/api-reference/text-to-image/seedream-4/get-seedream-v4-detail">
      Check Seedream 4 task status
    </Card>

    <Card title="GET /v1/ai/text-to-image/seedream-v4" icon="list" href="/api-reference/text-to-image/seedream-4/get-seedream-v4">
      List Seedream 4 tasks
    </Card>
  </Columns>
</div>

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="Will Seedream 4 use the same endpoints as Seedream 3?">
    Yes. Seedream 4 will follow the same endpoint structure as Seedream 3 with a versioned suffix to differentiate models. This ensures easy migration and clear model selection.
  </Accordion>

  <Accordion title="Are outputs suitable for production?">
    Yes. Seedream 4 targets production‑ready image quality and prompt reliability. For extreme resolutions, pair it with an upscaler.
  </Accordion>

  <Accordion title="What aspect ratios are supported?">
    Seedream 4 supports common aspect ratios used across web, social, and print. Exact options will be listed with the final endpoint documentation.
  </Accordion>
</AccordionGroup>


# Seedream 4 - Create image from text
Source: https://docs.freepik.com/api-reference/text-to-image/seedream-4/post-seedream-v4

post /v1/ai/text-to-image/seedream-v4
Convert descriptive text input into images using AI. This endpoint accepts a variety of parameters to customize the generated images.



# Seedream - List tasks
Source: https://docs.freepik.com/api-reference/text-to-image/seedream/get-seedream

get /v1/ai/text-to-image/seedream
Get the status of all Seedream tasks



# Seedream - Get task status
Source: https://docs.freepik.com/api-reference/text-to-image/seedream/get-seedream-task

get /v1/ai/text-to-image/seedream/{task-id}
Get the status of the Seedream task



# Seedream - Create image from text
Source: https://docs.freepik.com/api-reference/text-to-image/seedream/post-seedream

post /v1/ai/text-to-image/seedream
Convert descriptive text input into images using AI. This endpoint accepts a variety of parameters to customize the generated images.



# Get all Veo 3.1 T2V tasks
Source: https://docs.freepik.com/api-reference/text-to-video/get-veo-3-1

get /v1/ai/text-to-video/veo-3-1



# Get all Veo 3.1 T2V Fast tasks
Source: https://docs.freepik.com/api-reference/text-to-video/get-veo-3-1-fast

get /v1/ai/text-to-video/veo-3-1-fast



# Get Veo 3.1 T2V Fast task by ID
Source: https://docs.freepik.com/api-reference/text-to-video/get-veo-3-1-fast-task

get /v1/ai/text-to-video/veo-3-1-fast/{task-id}



# Get Veo 3.1 T2V task by ID
Source: https://docs.freepik.com/api-reference/text-to-video/get-veo-3-1-task

get /v1/ai/text-to-video/veo-3-1/{task-id}



# LTX Video 2.0 Fast - Create video from text
Source: https://docs.freepik.com/api-reference/text-to-video/ltx-2-fast

post /v1/ai/text-to-video/ltx-2-fast
Generate a video from text prompt using the LTX Video 2.0 Fast model.

**Features:**
- Fast video generation with resolutions up to 4K (2160p)
- Extended duration options: 6-20 seconds in 2-second increments
- Optional synchronized audio generation
- **Note:** Durations longer than 10 seconds require 25 FPS and 1080p resolution




# LTX Video 2.0 Fast T2V - List tasks
Source: https://docs.freepik.com/api-reference/text-to-video/ltx-2-fast-tasks

get /v1/ai/text-to-video/ltx-2-fast



# LTX Video 2.0 Fast T2V - Get task status
Source: https://docs.freepik.com/api-reference/text-to-video/ltx-2-fast/task-by-id

get /v1/ai/text-to-video/ltx-2-fast/{task-id}



# LTX Video 2.0 Pro - Create video from text
Source: https://docs.freepik.com/api-reference/text-to-video/ltx-2-pro

post /v1/ai/text-to-video/ltx-2-pro
Generate a video from text prompt using the LTX Video 2.0 Pro model.

**Features:**
- High-quality video generation with resolutions up to 4K (2160p)
- Duration options: 6, 8, or 10 seconds
- Optional synchronized audio generation
- Reproducible results with seed parameter




# LTX Video 2.0 Pro T2V - List tasks
Source: https://docs.freepik.com/api-reference/text-to-video/ltx-2-pro-tasks

get /v1/ai/text-to-video/ltx-2-pro



# LTX Video 2.0 Pro T2V - Get task status
Source: https://docs.freepik.com/api-reference/text-to-video/ltx-2-pro/task-by-id

get /v1/ai/text-to-video/ltx-2-pro/{task-id}



# Create video from text - Veo 3.1
Source: https://docs.freepik.com/api-reference/text-to-video/post-veo-3-1

post /v1/ai/text-to-video/veo-3-1
Generate a video from text prompt using Google Veo 3.1 model. Supports multiple resolutions (720p, 1080p, 4K) and optional audio generation.



# Create video from text - Veo 3.1 Fast
Source: https://docs.freepik.com/api-reference/text-to-video/post-veo-3-1-fast

post /v1/ai/text-to-video/veo-3-1-fast
Generate a video from text prompt using Google Veo 3.1 Fast model. Faster generation at a lower cost.



# Veo 3.1 – Text-to-Video API | Freepik API
Source: https://docs.freepik.com/api-reference/text-to-video/veo-3-1/overview

Generate cinematic videos from text prompts with Google Veo 3.1. Supports 720p, 1080p, and 4K resolutions with optional audio. Standard and Fast modes available.

<Card title="Google Veo 3.1" icon="google">
  State-of-the-art text-to-video generation powered by Google's Veo 3.1 model with multi-resolution output and optional audio synthesis.
</Card>

Veo 3.1 is Google's advanced text-to-video model that transforms text prompts into high-quality cinematic videos. It supports resolutions up to 4K, durations of 4-8 seconds, and optional audio generation for complete multimedia output. Choose between **Standard** mode for maximum quality or **Fast** mode for quicker generation at lower cost.

### Key capabilities

* **Multi-resolution output**: Generate videos in 720p, 1080p, or 4K resolution
* **Audio generation**: Optional synchronized audio for complete multimedia content
* **Flexible durations**: 4, 6, or 8 second video outputs
* **Aspect ratio control**: 16:9 (landscape) or 9:16 (portrait) formats
* **Negative prompts**: Specify elements to avoid in generation
* **Two generation modes**: Standard (highest quality) and Fast (cost-efficient)
* **Long prompts**: Up to 20,000 characters for detailed descriptions
* **Reproducible results**: Seed parameter for consistent outputs

### Use cases

* **Marketing content**: Create promotional videos and product showcases from descriptions
* **Social media**: Generate engaging short-form content for TikTok, Reels, and Shorts
* **Storytelling**: Visualize narratives, concepts, and creative ideas
* **Advertising**: Produce video ads from text briefs
* **Education**: Create visual explanations and demonstrations
* **Prototyping**: Quickly visualize video concepts before production

### Generate with Veo 3.1 Standard

High-quality video generation with maximum fidelity and detail.

<div>
  <Columns>
    <Card title="POST /v1/ai/text-to-video/veo-3-1" icon="video" href="/api-reference/text-to-video/post-veo-3-1">
      Create a new text-to-video task
    </Card>

    <Card title="GET /v1/ai/text-to-video/veo-3-1" icon="list" href="/api-reference/text-to-video/get-veo-3-1">
      List all Veo 3.1 tasks
    </Card>

    <Card title="GET /v1/ai/text-to-video/veo-3-1/{task-id}" icon="magnifying-glass" href="/api-reference/text-to-video/get-veo-3-1-task">
      Get task status by ID
    </Card>
  </Columns>
</div>

### Generate with Veo 3.1 Fast

Faster generation at reduced cost, ideal for prototyping and high-volume workflows.

<div>
  <Columns>
    <Card title="POST /v1/ai/text-to-video/veo-3-1-fast" icon="bolt" href="/api-reference/text-to-video/post-veo-3-1-fast">
      Create a fast text-to-video task
    </Card>

    <Card title="GET /v1/ai/text-to-video/veo-3-1-fast" icon="list" href="/api-reference/text-to-video/get-veo-3-1-fast">
      List all Veo 3.1 Fast tasks
    </Card>

    <Card title="GET /v1/ai/text-to-video/veo-3-1-fast/{task-id}" icon="magnifying-glass" href="/api-reference/text-to-video/get-veo-3-1-fast-task">
      Get task status by ID
    </Card>
  </Columns>
</div>

### Parameters

| Parameter         | Type      | Required | Description                                                           |
| ----------------- | --------- | -------- | --------------------------------------------------------------------- |
| `prompt`          | `string`  | Yes      | Text describing the video to generate (max 20,000 chars)              |
| `negative_prompt` | `string`  | No       | Text describing what to avoid in the video                            |
| `duration`        | `integer` | No       | Video duration: `4`, `6`, or `8` seconds (default: `8`)               |
| `resolution`      | `string`  | No       | Output resolution: `"720p"`, `"1080p"`, or `"4k"` (default: `"720p"`) |
| `aspect_ratio`    | `string`  | No       | Video format: `"16:9"` or `"9:16"` (default: `"16:9"`)                |
| `generate_audio`  | `boolean` | No       | Generate synchronized audio (default: `true`)                         |
| `seed`            | `integer` | No       | Random seed for reproducibility                                       |
| `webhook_url`     | `string`  | No       | URL for task completion notification                                  |

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is the difference between Standard and Fast modes?">
    **Standard mode** produces the highest quality output with maximum detail and fidelity, ideal for final production content. **Fast mode** generates videos more quickly at a lower cost, making it perfect for prototyping, testing prompts, and high-volume workflows where speed matters more than maximum quality.
  </Accordion>

  <Accordion title="What resolutions are supported?">
    Veo 3.1 supports three resolution options: **720p** (HD), **1080p** (Full HD), and **4K** (Ultra HD). Higher resolutions provide more detail but may take longer to generate.
  </Accordion>

  <Accordion title="How does audio generation work?">
    When `generate_audio` is set to `true` (the default), Veo 3.1 synthesizes synchronized audio that matches the visual content. This includes ambient sounds, music, and effects appropriate to the scene described in your prompt.
  </Accordion>

  <Accordion title="How long does generation take?">
    Generation time varies based on resolution, duration, and server load. Fast mode typically completes in less time than Standard mode. Use webhooks for production workflows to avoid polling.
  </Accordion>

  <Accordion title="What makes a good prompt for Veo 3.1?">
    Effective prompts describe the scene, subjects, motion, camera movement, lighting, and atmosphere. Be specific about visual details. Example: *"A serene mountain landscape at sunset with clouds moving slowly across an orange sky, camera slowly panning right"*
  </Accordion>

  <Accordion title="Can I generate portrait videos for social media?">
    Yes, set `aspect_ratio` to `"9:16"` to generate vertical videos optimized for TikTok, Instagram Reels, and YouTube Shorts.
  </Accordion>
</AccordionGroup>

## Best practices

* **Prompt detail**: Provide specific descriptions of scenes, subjects, motion, and atmosphere for best results
* **Negative prompts**: Use `negative_prompt` to exclude unwanted elements like "blurry, low quality, distorted"
* **Resolution selection**: Choose 720p for fast iteration, 1080p for social media, 4K for high-end production
* **Audio control**: Disable `generate_audio` if you plan to add custom audio in post-production
* **Webhook integration**: Use webhooks instead of polling for scalable production applications
* **Seed for consistency**: Use the same seed with identical parameters to reproduce similar results

## Related APIs

* **[Veo 3.1 Image-to-Video](/api-reference/image-to-video/veo-3-1/overview)**: Generate videos from images with Veo 3.1
* **[Veo 3.1 Reference-to-Video](/api-reference/reference-to-video/veo-3-1/overview)**: Generate videos with consistent characters using reference images
* **[Kling 2.6 Pro](/api-reference/image-to-video/kling-v2-6-pro)**: Alternative image-to-video with motion control
* **[WAN 2.6](/api-reference/text-to-video/wan-v2-6-720p)**: Text-to-video at 720p and 1080p resolutions


# WAN 2.5 1080p - Create video from text
Source: https://docs.freepik.com/api-reference/text-to-video/wan-2-5-t2v-1080p

post /v1/ai/text-to-video/wan-2-5-t2v-1080p
Generate a 1080p video from text prompt using the WAN 2.5 model.



# WAN 2.5 T2V 1080p - List tasks
Source: https://docs.freepik.com/api-reference/text-to-video/wan-2-5-t2v-1080p-tasks

get /v1/ai/text-to-video/wan-2-5-t2v-1080p
Get the list of WAN 2.5 Text-to-Video 1080p tasks



# WAN 2.5 480p - Create video from text
Source: https://docs.freepik.com/api-reference/text-to-video/wan-2-5-t2v-480p

post /v1/ai/text-to-video/wan-2-5-t2v-480p
Generate a 480p video from text prompt using the WAN 2.5 model.



# WAN 2.5 T2V 480p - List tasks
Source: https://docs.freepik.com/api-reference/text-to-video/wan-2-5-t2v-480p-tasks

get /v1/ai/text-to-video/wan-2-5-t2v-480p
Get the list of WAN 2.5 Text-to-Video 480p tasks



# WAN 2.5 720p - Create video from text
Source: https://docs.freepik.com/api-reference/text-to-video/wan-2-5-t2v-720p

post /v1/ai/text-to-video/wan-2-5-t2v-720p
Generate a 720p video from text prompt using the WAN 2.5 model.



# WAN 2.5 T2V 720p - List tasks
Source: https://docs.freepik.com/api-reference/text-to-video/wan-2-5-t2v-720p-tasks

get /v1/ai/text-to-video/wan-2-5-t2v-720p
Get the list of WAN 2.5 Text-to-Video 720p tasks



# WAN 2.7 - Create video from text
Source: https://docs.freepik.com/api-reference/text-to-video/wan-2-7/generate

post /v1/ai/text-to-video/wan-2-7
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.

**Key features:**
- 720P and 1080P resolution support
- 5 aspect ratio options
- Optional audio-guided generation
- Automatic prompt expansion for richer output
- Duration range: 2-15 seconds




# WAN 2.7 Text To Video API
Source: https://docs.freepik.com/api-reference/text-to-video/wan-2-7/overview

Generate AI videos from text prompts with WAN 2.7. 720P and 1080P resolution, 5 aspect ratios, 2-15 second durations, audio-guided generation, and prompt expansion for cinematic results.

<Card title="Alibaba WAN 2.7 integration" icon="video">
  WAN 2.7 is Alibaba's latest video generation model, delivering cinematic motion, high visual fidelity, audio-guided generation, and automatic prompt expansion across 5 aspect ratios.
</Card>

WAN 2.7 Text-to-Video is an AI video generation API that creates MP4 videos from text descriptions. It produces smooth, high-fidelity video with cinematic motion at 720P (1280x720) or 1080P (1920x1080) resolution. The model supports durations from 2 to 15 seconds, 5 configurable aspect ratios, optional audio input for sound-guided generation, and automatic prompt expansion for richer output.

### Key capabilities

* **Resolution options**: 720P (1280x720) and 1080P (1920x1080) output
* **5 aspect ratios**: `16:9` landscape, `9:16` portrait, `1:1` square, `4:3` standard, `3:4` standard portrait
* **Flexible durations**: 2 to 15 seconds of video output
* **Audio-guided generation**: Provide a WAV or MP3 audio file (2-30 seconds, max 15MB) to guide video creation
* **Prompt expansion**: AI optimizer expands short prompts into detailed scripts for richer, more cinematic output
* **Negative prompts**: Exclude unwanted elements like watermarks, blur, or distortion (max 500 characters)
* **Reproducible results**: Fixed seed support (0 to 2147483647) for consistent generation
* **Async processing**: Webhook notifications or polling for task completion

### Use cases

* **Marketing videos**: Create product showcases and brand content from text descriptions
* **Social media content**: Generate short-form videos for TikTok, Instagram, and YouTube in portrait or landscape
* **Music visualization**: Use audio-guided generation to create videos synchronized with a soundtrack
* **Concept visualization**: Transform ideas and scripts into motion for rapid prototyping
* **Educational content**: Illustrate concepts with AI-generated video explanations
* **Creative exploration**: Experiment with text prompts and aspect ratios for unique visual content

### API operations

Generate videos by submitting a text prompt to the API. The service returns a task ID for async polling or webhook notification.

<div>
  <Columns>
    <Card title="POST /v1/ai/text-to-video/wan-2-7" icon="video" href="/api-reference/text-to-video/wan-2-7/generate">
      Create a new text-to-video generation task
    </Card>

    <Card title="GET /v1/ai/text-to-video/wan-2-7" icon="list" href="/api-reference/text-to-video/wan-2-7/wan-2-7-t2v-tasks">
      List all WAN 2.7 T2V tasks with status
    </Card>

    <Card title="GET /v1/ai/text-to-video/wan-2-7/{task-id}" icon="magnifying-glass" href="/api-reference/text-to-video/wan-2-7/task-by-id">
      Get task status and results by ID
    </Card>
  </Columns>
</div>

### Parameters

| Parameter                           | Type      | Required | Default   | Description                                                       |
| ----------------------------------- | --------- | -------- | --------- | ----------------------------------------------------------------- |
| `prompt`                            | `string`  | Yes      | -         | Text description of the video to generate. Max 5000 characters    |
| `negative_prompt`                   | `string`  | No       | -         | Elements to avoid (e.g., "blurry, watermark"). Max 500 characters |
| `audio_url`                         | `string`  | No       | -         | URL of audio file (WAV/MP3, 2-30s, max 15MB) to guide generation  |
| `aspect_ratio`                      | `string`  | No       | `"16:9"`  | Output ratio: `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"`, `"3:4"`       |
| `resolution`                        | `string`  | No       | `"1080P"` | Output resolution: `"720P"` or `"1080P"`                          |
| `duration`                          | `integer` | No       | `5`       | Video length in seconds: 2 to 15                                  |
| `seed`                              | `integer` | No       | Random    | Seed for reproducibility (0 to 2147483647)                        |
| `additional_settings.prompt_extend` | `boolean` | No       | `true`    | Enable AI prompt expansion for richer output                      |
| `webhook_url`                       | `string`  | No       | -         | URL for async status notifications                                |

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is WAN 2.7 Text-to-Video and how does it work?">
    WAN 2.7 Text-to-Video is an AI video generation API developed by Alibaba. You submit a text prompt describing your desired video, receive a task ID immediately, then poll for results or receive a webhook notification when processing completes. The model generates MP4 video at 720P or 1080P resolution in durations from 2 to 15 seconds.
  </Accordion>

  <Accordion title="What aspect ratios does WAN 2.7 support?">
    WAN 2.7 supports 5 aspect ratios: `16:9` (landscape widescreen), `9:16` (portrait/mobile), `1:1` (square), `4:3` (standard landscape), and `3:4` (standard portrait). The default is `16:9`.
  </Accordion>

  <Accordion title="How does audio-guided generation work?">
    Provide a WAV or MP3 audio file URL via the `audio_url` parameter. The audio must be 2-30 seconds long and under 15MB. WAN 2.7 uses the audio to guide the visual content and motion of the generated video. If no audio is provided, the model may auto-generate audio.
  </Accordion>

  <Accordion title="What is prompt expansion and when should I use it?">
    Prompt expansion (`additional_settings.prompt_extend`) uses AI to transform short prompts into detailed video scripts before generation. It is enabled by default. Disable it when you need precise control over exactly what the model generates.
  </Accordion>

  <Accordion title="How long does video generation take?">
    Processing time depends on resolution, duration, and server load. Higher resolution (1080P) and longer durations take more time. For production workflows, use webhooks instead of polling for scalable integration.
  </Accordion>

  <Accordion title="What are the rate limits for WAN 2.7?">
    Rate limits depend on your subscription tier. See the [Rate Limits](/ratelimits) page for current limits by plan.
  </Accordion>

  <Accordion title="How much does WAN 2.7 cost?">
    See the [Pricing page](/pricing) for current rates and subscription options.
  </Accordion>

  <Accordion title="What is the difference between WAN 2.7 and WAN 2.6?">
    WAN 2.7 adds audio-guided generation, 5 aspect ratios (vs limited options in 2.6), extended duration range of 2-15 seconds, and higher prompt limits (5000 characters). WAN 2.6 offers multi-shot sequences. Choose WAN 2.7 for the latest capabilities and audio input support.
  </Accordion>
</AccordionGroup>

## Best practices

* **Prompt writing**: Be specific about scenes, camera movements (zoom, pan, tilt), lighting, and atmosphere. Detailed prompts produce better results than vague descriptions.
* **Audio input**: Use clean audio files with clear rhythm or speech for best audio-guided results. Ensure audio duration aligns with your target video duration.
* **Negative prompts**: Always include common artifacts to avoid: "blurry, low quality, watermark, text, distortion, extra limbs"
* **Duration selection**: Start with shorter durations (2-5 seconds) for quick iterations, then increase for final outputs.
* **Prompt expansion**: Leave enabled (default) for short prompts. Disable for precise control over generation.
* **Reproducibility**: Save the `seed` value from successful generations to recreate similar results.
* **Production integration**: Use webhooks for scalable applications instead of polling.
* **Error handling**: Implement retry with exponential backoff for 503 errors during high-demand periods.

## Related APIs

* **[WAN 2.7 Image-to-Video](/api-reference/image-to-video/wan-2-7/overview)**: Animate images or extend existing videos with WAN 2.7
* **[WAN 2.7 Reference-to-Video](/api-reference/reference-to-video/wan-2-7/overview)**: Generate videos featuring characters from reference images or videos
* **[WAN 2.6 Text-to-Video](/api-reference/wan-v2-6-i2v/overview)**: Previous WAN generation with multi-shot sequences
* **[WAN 2.5 Text-to-Video](/api-reference/wan-2-5-t2v/overview)**: WAN 2.5 with 480p, 720p, and 1080p options


# WAN 2.7 T2V - Get task status
Source: https://docs.freepik.com/api-reference/text-to-video/wan-2-7/task-by-id

get /v1/ai/text-to-video/wan-2-7/{task-id}
Retrieve the status and result of a specific WAN 2.7 text-to-video task by its ID.



# WAN 2.7 T2V - List tasks
Source: https://docs.freepik.com/api-reference/text-to-video/wan-2-7/wan-2-7-t2v-tasks

get /v1/ai/text-to-video/wan-2-7
Retrieve the list of all WAN 2.7 text-to-video tasks for the authenticated user.



# WAN 2.6 1080p - Create video from text
Source: https://docs.freepik.com/api-reference/text-to-video/wan-v2-6-1080p

post /v1/ai/text-to-video/wan-v2-6-1080p
Generate a 1080p video from text prompt using the WAN 2.6 model.



# WAN 2.6 T2V 1080p - List tasks
Source: https://docs.freepik.com/api-reference/text-to-video/wan-v2-6-1080p-tasks

get /v1/ai/text-to-video/wan-v2-6-1080p
Get the list of WAN 2.6 Text-to-Video 1080p tasks



# WAN 2.6 720p - Create video from text
Source: https://docs.freepik.com/api-reference/text-to-video/wan-v2-6-720p

post /v1/ai/text-to-video/wan-v2-6-720p
Generate a 720p video from text prompt using the WAN 2.6 model.



# WAN 2.6 T2V 720p - List tasks
Source: https://docs.freepik.com/api-reference/text-to-video/wan-v2-6-720p-tasks

get /v1/ai/text-to-video/wan-v2-6-720p
Get the list of WAN 2.6 Text-to-Video 720p tasks



# Kling 2.6 Pro - Motion control video
Source: https://docs.freepik.com/api-reference/video/kling-v2-6-motion-control-pro

post /v1/ai/video/kling-v2-6-motion-control-pro
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.



# Kling 2.6 Standard - Motion control video
Source: https://docs.freepik.com/api-reference/video/kling-v2-6-motion-control-std

post /v1/ai/video/kling-v2-6-motion-control-std
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.



# Kling 2.6 Pro - Get task status
Source: https://docs.freepik.com/api-reference/video/kling-v2-6-motion-control-task-by-id

get /v1/ai/image-to-video/kling-v2-6/{task-id}



# Kling 2.6 Pro - List tasks
Source: https://docs.freepik.com/api-reference/video/kling-v2-6-motion-control-tasks

get /v1/ai/image-to-video/kling-v2-6



# Kling 3 Pro - Motion control video
Source: https://docs.freepik.com/api-reference/video/kling-v3-motion-control/generate-pro

post /v1/ai/video/kling-v3-motion-control-pro
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.



# Kling 3 Standard - Motion control video
Source: https://docs.freepik.com/api-reference/video/kling-v3-motion-control/generate-std

post /v1/ai/video/kling-v3-motion-control-std
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.



# Kling 3 Motion Control API
Source: https://docs.freepik.com/api-reference/video/kling-v3-motion-control/overview

Transfer motion from reference videos to character images with Kling 3 Motion Control. Preserves character appearance while applying motion patterns from 3-30 second reference videos.

<Card title="Kling 3 Motion Control integration" icon="video">
  Transfer motion patterns from a reference video to a character image, preserving the character's appearance while applying realistic movement.
</Card>

Kling 3 Motion Control is a video generation API that transfers motion from a reference video to a character image. It preserves the character's appearance while applying the motion patterns from the reference video, producing realistic character animation. Available in Pro and Standard tiers, it supports reference videos from 3-30 seconds with optional text prompts for guiding the motion transfer.

### Key capabilities

* **Motion transfer**: Extract motion from a reference video and apply it to a character image
* **Character preservation**: Maintains the character's visual identity, face, and clothing throughout the video
* **Orientation modes**: `video` mode for complex motions (up to 30 seconds output) or `image` mode for camera movements (up to 10 seconds output)
* **Text guidance**: Optional prompt up to 2500 characters to refine the motion transfer
* **CFG scale control**: Adjust prompt adherence from 0 (creative) to 1 (strict), default 0.5
* **Flexible input**: Reference videos from 3-30 seconds in MP4, MOV, WEBM, or M4V format
* **Image support**: Character images in JPG, JPEG, PNG, or WEBP format (min 300x300px, max 10MB)
* **Async processing**: Webhook notifications or polling for task completion

### Pro vs Standard

| Feature  | Kling 3 Motion Control Pro     | Kling 3 Motion Control Standard |
| -------- | ------------------------------ | ------------------------------- |
| Quality  | Higher fidelity, richer detail | Good quality, cost-effective    |
| Speed    | Standard processing            | Faster processing               |
| Best for | Premium content, marketing     | High-volume, testing            |

### Use cases

* **Character animation**: Animate product mascots or brand characters with realistic dance or gesture movements
* **Social media content**: Create engaging short videos by transferring trending motions to custom characters
* **E-commerce**: Showcase apparel on virtual models by transferring real model movements
* **Gaming and entertainment**: Generate character motion previews from reference footage
* **Marketing campaigns**: Produce personalized character videos at scale with consistent branding

### Generate with Kling 3 Motion Control

Create motion control videos by submitting a character image and reference video to the API. The service returns a task ID for async polling or webhook notification.

<div>
  <Columns>
    <Card title="POST Motion Control Pro" icon="video" href="/api-reference/video/kling-v3-motion-control/generate-pro">
      Generate motion control video with Pro quality
    </Card>

    <Card title="POST Motion Control Standard" icon="video" href="/api-reference/video/kling-v3-motion-control/generate-std">
      Generate motion control video with Standard quality
    </Card>

    <Card title="GET Motion Control Pro Tasks" icon="list" href="/api-reference/video/kling-v3-motion-control/pro-tasks">
      List all Motion Control Pro tasks
    </Card>

    <Card title="GET Motion Control Pro Task by ID" icon="magnifying-glass" href="/api-reference/video/kling-v3-motion-control/pro-task-by-id">
      Get Pro task status by ID
    </Card>

    <Card title="GET Motion Control Standard Tasks" icon="list" href="/api-reference/video/kling-v3-motion-control/std-tasks">
      List all Motion Control Standard tasks
    </Card>

    <Card title="GET Motion Control Standard Task by ID" icon="magnifying-glass" href="/api-reference/video/kling-v3-motion-control/std-task-by-id">
      Get Standard task status by ID
    </Card>
  </Columns>
</div>

### Parameters

| Parameter               | Type     | Required | Default | Description                                                                                                   |
| ----------------------- | -------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------- |
| `image_url`             | `string` | Yes      | -       | Character/reference image URL. Min 300x300px, max 10MB. Formats: JPG, JPEG, PNG, WEBP.                        |
| `video_url`             | `string` | Yes      | -       | Reference video URL with the motion to transfer. Duration: 3-30 seconds. Formats: MP4, MOV, WEBM, M4V.        |
| `prompt`                | `string` | No       | -       | Text prompt to guide motion transfer (max 2500 characters)                                                    |
| `character_orientation` | `string` | No       | `video` | Orientation mode: `video` (complex motions, up to 30s output) or `image` (camera movements, up to 10s output) |
| `cfg_scale`             | `number` | No       | `0.5`   | Prompt adherence: 0 (creative) to 1 (strict)                                                                  |
| `webhook_url`           | `string` | No       | -       | URL for task completion notification                                                                          |

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is Kling 3 Motion Control and how does it work?">
    Kling 3 Motion Control is an AI video generation API that transfers motion from a reference video to a character image. You provide a character image and a reference video containing the desired motion. The model extracts the motion patterns and applies them to the character while preserving its visual appearance. Processing is asynchronous: you receive a task ID immediately, then poll for results or receive a webhook notification.
  </Accordion>

  <Accordion title="What is the difference between video and image orientation modes?">
    The `character_orientation` parameter controls how the model interprets spatial information. In `video` mode (default), orientation matches the reference video, which works better for complex motions and supports output up to 30 seconds. In `image` mode, orientation matches the character image, which is better for following camera movements but limits output to 10 seconds maximum.
  </Accordion>

  <Accordion title="What video formats does Kling 3 Motion Control support?">
    Reference videos must be publicly accessible URLs in MP4, MOV, WEBM, or M4V format with a duration between 3 and 30 seconds. Character images support JPG, JPEG, PNG, and WEBP formats with minimum 300x300 pixel resolution and maximum 10MB file size.
  </Accordion>

  <Accordion title="How do I retrieve motion control task results?">
    Motion control tasks have dedicated retrieval endpoints for each tier. Use `GET /v1/ai/video/kling-v3-motion-control-pro` or `GET /v1/ai/video/kling-v3-motion-control-std` to list tasks, and append `/{task-id}` to get a specific task's status and results.
  </Accordion>

  <Accordion title="What is cfg_scale and how should I set it?">
    CFG scale controls how closely the model follows your text prompt during motion transfer. Use 0 for maximum creative freedom, 0.5 (default) for balanced results, or 1 for strict adherence to the prompt. When no prompt is provided, cfg\_scale has minimal effect.
  </Accordion>

  <Accordion title="What is the difference between Pro and Standard tiers?">
    Pro delivers higher fidelity with richer detail, ideal for premium content and marketing videos. Standard offers good quality with faster processing, suitable for high-volume generation and testing. Both tiers share the same parameters and capabilities.
  </Accordion>

  <Accordion title="What are the rate limits for Kling 3 Motion Control?">
    Rate limits vary by subscription tier. See [Rate Limits](/ratelimits) for current limits and quotas.
  </Accordion>

  <Accordion title="How much does Kling 3 Motion Control cost?">
    Pricing varies based on model tier (Pro vs Standard) and output duration. See the [Pricing](/pricing) page for current rates.
  </Accordion>
</AccordionGroup>

## Best practices

* **Character image quality**: Use high-resolution images with clear subjects and good lighting for best character preservation
* **Reference video selection**: Choose reference videos with clear, well-defined motions. Avoid heavily occluded or blurry footage.
* **Orientation mode**: Use `video` mode for dance or full-body motions; use `image` mode when camera movement matters more than body motion
* **Prompt guidance**: Add a text prompt to refine the motion transfer, especially when the reference video has ambiguous movements
* **CFG tuning**: Start with 0.5, decrease for more creative interpretation, increase for strict prompt following
* **Production integration**: Use webhooks instead of polling for scalable applications
* **Error handling**: Implement retry logic with exponential backoff for 503 errors

## Related APIs

* **[Kling 3](/api-reference/video/kling-v3/overview)**: Text-to-video and image-to-video generation with multi-shot support
* **[Kling 3 Omni](/api-reference/video/kling-v3-omni/overview)**: Multi-modal video generation with element consistency and video references
* **[Kling 2.6 Motion Control](/api-reference/video/kling-v2-6-motion-control-pro)**: Previous generation motion control
* **[VFX](/api-reference/video/vfx/overview)**: Apply visual effects to generated videos


# Kling 3 Pro Motion Control - Get task status
Source: https://docs.freepik.com/api-reference/video/kling-v3-motion-control/pro-task-by-id

get /v1/ai/video/kling-v3-motion-control-pro/{task-id}
Retrieve the status and result of a specific Kling 3 Pro Motion Control video generation task by its task ID.



# Kling 3 Pro Motion Control - List tasks
Source: https://docs.freepik.com/api-reference/video/kling-v3-motion-control/pro-tasks

get /v1/ai/video/kling-v3-motion-control-pro
Retrieve the list of all Kling 3 Pro Motion Control video generation tasks for the authenticated user.



# Kling 3 Standard Motion Control - Get task status
Source: https://docs.freepik.com/api-reference/video/kling-v3-motion-control/std-task-by-id

get /v1/ai/video/kling-v3-motion-control-std/{task-id}
Retrieve the status and result of a specific Kling 3 Standard Motion Control video generation task by its task ID.



# Kling 3 Standard Motion Control - List tasks
Source: https://docs.freepik.com/api-reference/video/kling-v3-motion-control/std-tasks

get /v1/ai/video/kling-v3-motion-control-std
Retrieve the list of all Kling 3 Standard Motion Control video generation tasks for the authenticated user.



# Kling 3 Omni Pro - Generate video from text or image
Source: https://docs.freepik.com/api-reference/video/kling-v3-omni/generate-pro

post /v1/ai/video/kling-v3-omni-pro
Generate AI video using Kling 3 Omni Pro with advanced multi-modal capabilities.

**Features:**
- **Text-to-video**: Generate videos from text prompts
- **Image-to-video**: Use start and/or end frame images to guide generation
- **Multi-shot**: Create videos with up to 6 shots (max 15s total)
- **Element control**: Include reference images for consistent character/style

**Duration:** 3-15 seconds
**Quality:** Pro mode offers highest quality output.

**Note:** For video-to-video generation using a reference video, use the `/ai/reference-to-video/kling-v3-omni-pro` endpoint instead.




# Kling 3 Omni Pro - Video-to-video generation
Source: https://docs.freepik.com/api-reference/video/kling-v3-omni/generate-pro-video-reference

post /v1/ai/reference-to-video/kling-v3-omni-pro
Generate AI video using Kling 3 Omni Pro with a reference video for motion and style guidance.

**Video-to-video mode:** This endpoint requires a `video_url` parameter. Reference the video in your prompt using `@Video1`.

**Features:**
- Use a reference video (3-10s) to guide motion and style
- Combine with an image for start frame control
- High-quality pro output

**Use case:** Create videos that follow motion patterns from a reference video while applying your creative prompt.

**Duration:** 3-15 seconds
**Quality:** Pro mode offers highest quality output.

**Tip:** For text-to-video or image-to-video without a reference video, use the `/ai/video/kling-v3-omni-pro` endpoint instead.




# Kling 3 Omni Standard - Generate video from text or image
Source: https://docs.freepik.com/api-reference/video/kling-v3-omni/generate-std

post /v1/ai/video/kling-v3-omni-std
Generate AI video using Kling 3 Omni Standard with advanced multi-modal capabilities.

**Features:**
- **Text-to-video**: Generate videos from text prompts
- **Image-to-video**: Use start and/or end frame images to guide generation
- **Multi-shot**: Create videos with up to 6 shots (max 15s total)
- **Element control**: Include reference images for consistent character/style

**Duration:** 3-15 seconds
**Quality:** Standard mode offers faster generation at slightly lower quality.

**Note:** For video-to-video generation using a reference video, use the `/ai/reference-to-video/kling-v3-omni-std` endpoint instead.




# Kling 3 Omni Standard - Video-to-video generation
Source: https://docs.freepik.com/api-reference/video/kling-v3-omni/generate-std-video-reference

post /v1/ai/reference-to-video/kling-v3-omni-std
Generate AI video using Kling 3 Omni Standard with a reference video for motion and style guidance.

**Video-to-video mode:** This endpoint requires a `video_url` parameter. Reference the video in your prompt using `@Video1`.

**Features:**
- Use a reference video (3-10s) to guide motion and style
- Combine with an image for start frame control
- Faster generation at slightly lower quality

**Use case:** Create videos that follow motion patterns from a reference video while applying your creative prompt.

**Duration:** 3-15 seconds
**Quality:** Standard mode offers faster generation at slightly lower quality.

**Tip:** For text-to-video or image-to-video without a reference video, use the `/ai/video/kling-v3-omni-std` endpoint instead.




# Kling 3 Omni - List tasks
Source: https://docs.freepik.com/api-reference/video/kling-v3-omni/kling-v3-omni-tasks

get /v1/ai/video/kling-v3-omni
Retrieve the list of all Kling 3 Omni video generation tasks for the authenticated user.



# Kling 3 Omni API
Source: https://docs.freepik.com/api-reference/video/kling-v3-omni/overview

Generate AI videos with multi-modal capabilities using Kling 3 Omni. Supports text-to-video, image-to-video, and element consistency with Pro and Standard tiers.

<Card title="Kling 3 Omni integration" icon="video">
  Generate AI videos with multi-modal inputs: text prompts, reference images, and element consistency for characters and objects.
</Card>

Kling 3 Omni is a versatile video generation API that supports multiple input modes: text-to-video, image-to-video, and reference-to-video with elements and images. It offers advanced features like multi-shot mode for scene-by-scene control and element consistency to maintain character/object identity across frames.

<Note>
  **Looking for video-to-video?** Use the dedicated [Reference-to-Video endpoints](#video-to-video-with-reference-video) to generate videos from a reference video using `video_url`.
</Note>

### Key capabilities

* **Text-to-video**: Generate videos from text prompts up to 2500 characters
* **Image-to-video**: Use `image_url` for start frame, `end_image_url` for end frame control
* **Element consistency**: Pre-register characters/objects with `elements` and reference as `@Element1`, `@Element2` in prompts
* **Reference images**: Add style guidance with `image_urls`, reference as `@Image1`, `@Image2` in prompts
* **Multi-shot mode**: Create multi-scene videos with `multi_prompt` for shot-by-shot control
* **Duration control**: Generate videos from 3-15 seconds
* **Audio options**: Generate native audio or use voice IDs for narration
* **Async processing**: Webhook notifications or polling for task completion

### Generation modes

| Mode                   | Parameters                                | Use case                             |
| ---------------------- | ----------------------------------------- | ------------------------------------ |
| **Text-to-video**      | `prompt` (required)                       | Generate video from text description |
| **Image-to-video**     | `image_url` + `prompt`                    | Animate a starting image             |
| **Reference-to-video** | `elements` and/or `image_urls` + `prompt` | Maintain character/style consistency |

### Pro vs Standard

| Feature  | Kling 3 Omni Pro       | Kling 3 Omni Standard        |
| -------- | ---------------------- | ---------------------------- |
| Quality  | Higher fidelity output | Good quality, cost-effective |
| Speed    | Standard processing    | Faster processing            |
| Best for | Premium productions    | Testing, high-volume         |

### Use cases

* **Character animation**: Maintain consistent character identity across video with elements
* **Product visualization**: Animate product images with controlled motion
* **Storyboarding**: Create multi-scene videos with shot-by-shot prompts
* **Style transfer**: Apply visual style from reference images to generated content
* **Marketing content**: Generate promotional videos from brand imagery

### Generate videos with Kling 3 Omni

Create videos by submitting prompts with optional images and elements. The service returns a task ID for async polling or webhook notification.

<div>
  <Columns>
    <Card title="POST /v1/ai/video/kling-v3-omni-pro" icon="video" href="/api-reference/video/kling-v3-omni/generate-pro">
      Generate video with Kling 3 Omni Pro
    </Card>

    <Card title="POST /v1/ai/video/kling-v3-omni-std" icon="video" href="/api-reference/video/kling-v3-omni/generate-std">
      Generate video with Kling 3 Omni Standard
    </Card>

    <Card title="GET /v1/ai/video/kling-v3-omni" icon="list" href="/api-reference/video/kling-v3-omni/kling-v3-omni-tasks">
      List all Kling 3 Omni tasks
    </Card>

    <Card title="GET /v1/ai/video/kling-v3-omni/{task-id}" icon="magnifying-glass" href="/api-reference/video/kling-v3-omni/task-by-id">
      Get task status by ID
    </Card>
  </Columns>
</div>

### Video-to-video with reference video

For video-to-video generation using a reference video, use the dedicated Reference-to-Video endpoints. These endpoints accept `video_url` and let you reference the video in your prompt as `@Video1`.

<div>
  <Columns>
    <Card title="POST reference-to-video Pro" icon="video" href="/api-reference/video/kling-v3-omni/generate-pro-video-reference">
      Generate video from reference video (Pro)
    </Card>

    <Card title="POST reference-to-video Std" icon="video" href="/api-reference/video/kling-v3-omni/generate-std-video-reference">
      Generate video from reference video (Standard)
    </Card>

    <Card title="GET reference-to-video tasks" icon="list" href="/api-reference/video/kling-v3-omni/video-reference-tasks">
      List all reference-to-video tasks
    </Card>

    <Card title="GET reference-to-video task" icon="magnifying-glass" href="/api-reference/video/kling-v3-omni/video-reference-task-by-id">
      Get reference-to-video task by ID
    </Card>
  </Columns>
</div>

### Parameters

| Parameter         | Type      | Required    | Default     | Description                                                       |
| ----------------- | --------- | ----------- | ----------- | ----------------------------------------------------------------- |
| `prompt`          | `string`  | Conditional | -           | Text prompt (max 2500 chars). Required for text-to-video.         |
| `image_url`       | `string`  | No          | -           | Start frame image URL for image-to-video                          |
| `start_image_url` | `string`  | No          | -           | Alternative start frame image                                     |
| `end_image_url`   | `string`  | No          | -           | End frame image URL                                               |
| `image_urls`      | `array`   | No          | -           | Reference images for style. Use `@Image1`, `@Image2` in prompt    |
| `elements`        | `array`   | No          | -           | Character/object elements. Use `@Element1`, `@Element2` in prompt |
| `multi_prompt`    | `array`   | No          | -           | Shot-by-shot prompts for multi-scene videos (max 6 shots)         |
| `shot_type`       | `string`  | No          | `customize` | Multi-shot type (only `customize` supported)                      |
| `aspect_ratio`    | `string`  | No          | `16:9`      | Video ratio: `16:9`, `9:16`, `1:1`                                |
| `duration`        | `integer` | No          | `5`         | Duration in seconds: 3-15                                         |
| `generate_audio`  | `boolean` | No          | -           | Generate native audio for the video                               |
| `voice_ids`       | `array`   | No          | -           | Voice IDs for narration. Use `<<<voice_1>>>` in prompt            |
| `webhook_url`     | `string`  | No          | -           | URL for task completion notification                              |

### Element definition

| Field                  | Type     | Description                                                           |
| ---------------------- | -------- | --------------------------------------------------------------------- |
| `reference_image_urls` | `array`  | Reference image URLs for element. Multiple angles improve consistency |
| `frontal_image_url`    | `string` | Frontal/primary reference image. Best with clear face/front view      |

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is Kling 3 Omni and what can it do?">
    Kling 3 Omni is a multi-modal video generation API that creates videos from text prompts, images, or a combination. It supports element consistency (maintaining character/object identity), reference images for style guidance, and multi-shot mode for scene-by-scene control. Video durations range from 3-15 seconds.
  </Accordion>

  <Accordion title="How do I generate video-to-video content?">
    For video-to-video generation (using a reference video), use the dedicated [Reference-to-Video endpoints](/api-reference/video/kling-v3-omni/generate-pro-video-reference). These endpoints accept a `video_url` parameter and let you reference the video in your prompt as `@Video1`.
  </Accordion>

  <Accordion title="What is the difference between elements and image_urls?">
    `elements` are for maintaining consistent identity of characters or objects across the video - use them for faces, products, or recurring subjects. `image_urls` are for general style/appearance reference. Both can be combined: elements for character consistency, images for style guidance.
  </Accordion>

  <Accordion title="How does multi-shot mode work?">
    Multi-shot mode lets you create videos with multiple scenes, each with its own prompt. Provide an array of prompts via `multi_prompt` (max 6 shots). Each shot must be at least 3 seconds. The total duration is the sum of all shots.
  </Accordion>

  <Accordion title="What image formats does Kling 3 Omni support?">
    Images must be publicly accessible URLs in JPG, JPEG, or PNG format. Requirements: minimum 300x300 pixels, maximum 10MB file size.
  </Accordion>

  <Accordion title="What are the rate limits for Kling 3 Omni?">
    Rate limits vary by subscription tier. See [Rate Limits](/ratelimits) for current limits and quotas.
  </Accordion>

  <Accordion title="How much does Kling 3 Omni cost?">
    Pricing varies based on model tier (Pro vs Standard) and video duration. See the [Pricing](/pricing) page for current rates.
  </Accordion>
</AccordionGroup>

## Best practices

* **Element quality**: Use clear, well-lit reference images for elements. Multiple angles improve consistency.
* **Prompt structure**: Reference elements as `@Element1` and images as `@Image1` in your prompt for best results.
* **Duration planning**: Start with 5-second videos to test, then increase duration for final output.
* **Multi-shot flow**: Plan shot transitions carefully; each shot should have a coherent prompt.
* **Audio options**: Use `generate_audio: true` for ambient sound, or `voice_ids` for narration.
* **Production integration**: Use webhooks instead of polling for scalable applications.

## Related APIs

* **[Kling 3](/api-reference/video/kling-v3/overview)**: Standard Kling 3 without Omni multi-modal features
* **[Kling 2.6 Pro](/api-reference/image-to-video/kling-v2-6-pro)**: Previous generation with motion control
* **[Runway Gen 4.5](/api-reference/video/runway-gen-4-5/overview)**: Alternative video generation model
* **[VFX](/api-reference/video/vfx/overview)**: Apply visual effects to generated videos


# Kling 3 Omni - Get task status
Source: https://docs.freepik.com/api-reference/video/kling-v3-omni/task-by-id

get /v1/ai/video/kling-v3-omni/{task-id}
Retrieve the status and result of a specific Kling 3 Omni video generation task by its task ID.



# Kling 3 Omni Reference-to-Video - Get task status
Source: https://docs.freepik.com/api-reference/video/kling-v3-omni/video-reference-task-by-id

get /v1/ai/reference-to-video/kling-v3-omni/{task-id}
Retrieve the status and result of a specific Kling 3 Omni reference-to-video task (Pro or Standard) by its task ID.



# Kling 3 Omni Reference-to-Video - List tasks
Source: https://docs.freepik.com/api-reference/video/kling-v3-omni/video-reference-tasks

get /v1/ai/reference-to-video/kling-v3-omni
Retrieve the list of all Kling 3 Omni reference-to-video tasks (both Pro and Standard) for the authenticated user.



# Kling 3 Pro - Generate video
Source: https://docs.freepik.com/api-reference/video/kling-v3/generate-pro

post /v1/ai/video/kling-v3-pro
Generate AI video using Kling 3 Pro with text-to-video or image-to-video capabilities.

**Features:**
- **Text-to-video**: Generate videos from text prompts
- **Image-to-video**: Use start and/or end frame images to guide generation
- **Multi-shot**: Create videos with up to 6 shots (max 15s total)
- **Element control**: Include reference images for consistent character/style

**Duration:** 3-15 seconds
**Quality:** Pro mode offers highest quality output with longer processing time.




# Kling 3 Standard - Generate video
Source: https://docs.freepik.com/api-reference/video/kling-v3/generate-std

post /v1/ai/video/kling-v3-std
Generate AI video using Kling 3 Standard with text-to-video or image-to-video capabilities.

**Features:**
- **Text-to-video**: Generate videos from text prompts
- **Image-to-video**: Use start and/or end frame images to guide generation
- **Multi-shot**: Create videos with up to 6 shots (max 15s total)
- **Element control**: Include reference images for consistent character/style

**Duration:** 3-15 seconds
**Quality:** Standard mode offers faster generation at slightly lower quality compared to Pro.




# Kling 3 - List tasks
Source: https://docs.freepik.com/api-reference/video/kling-v3/kling-v3-tasks

get /v1/ai/video/kling-v3
Retrieve the list of all Kling 3 video generation tasks for the authenticated user.



# Kling 3 API
Source: https://docs.freepik.com/api-reference/video/kling-v3/overview

Generate AI videos from text or images with Kling 3. Multi-shot support, first/end frame control, and durations from 3-15 seconds. Pro and Standard tiers for creative video production.

<Card title="Kling 3 integration" icon="video">
  Generate high-quality videos from text prompts or images using Kling's latest V3 model with multi-shot support and advanced frame control.
</Card>

Kling 3 is a dual-mode video generation API that creates professional-grade videos from either text descriptions or source images. It supports multi-shot mode for creating complex narratives with up to 6 scenes, first and end frame image control, and flexible durations from 3 to 15 seconds. Available in Pro and Standard tiers to balance quality and cost.

### Key capabilities

* **Text-to-Video (T2V)**: Generate videos from text prompts up to 2500 characters
* **Image-to-Video (I2V)**: Use first\_frame and/or end\_frame images to control video start and end points
* **Multi-shot mode**: Create videos with up to 6 scenes, each with custom prompts and durations (max 15 seconds total)
* **Flexible durations**: 3-15 seconds with per-shot duration control in multi-shot mode
* **Element consistency**: Pre-registered element IDs for consistent characters/styles across videos
* **CFG scale control**: Adjust prompt adherence from 0 (creative) to 1 (strict), default 0.5
* **Negative prompts**: Exclude unwanted elements, styles, or artifacts
* **Async processing**: Webhook notifications or polling for task completion

### Pro vs Standard

| Feature  | Kling 3 Pro                    | Kling 3 Standard             |
| -------- | ------------------------------ | ---------------------------- |
| Quality  | Higher fidelity, richer detail | Good quality, cost-effective |
| Speed    | Standard processing            | Faster processing            |
| Best for | Premium content, marketing     | High-volume, testing         |

### Use cases

* **Marketing and advertising**: Create multi-scene product narratives with consistent branding
* **Social media content**: Generate vertical videos for TikTok, Instagram Reels, and YouTube Shorts
* **E-commerce**: Animate product images with controlled start and end frames
* **Storyboarding**: Turn scripts into multi-shot video sequences
* **Creative storytelling**: Build narratives with scene-by-scene control

### Generate videos with Kling 3

Create videos by submitting a text prompt (T2V) or images with prompt (I2V) to the API. The service returns a task ID for async polling or webhook notification.

<div>
  <Columns>
    <Card title="POST /v1/ai/video/kling-v3-pro" icon="video" href="/api-reference/video/kling-v3/generate-pro">
      Generate video with Kling 3 Pro
    </Card>

    <Card title="POST /v1/ai/video/kling-v3-std" icon="video" href="/api-reference/video/kling-v3/generate-std">
      Generate video with Kling 3 Standard
    </Card>

    <Card title="GET /v1/ai/video/kling-v3" icon="list" href="/api-reference/video/kling-v3/kling-v3-tasks">
      List all Kling 3 tasks
    </Card>

    <Card title="GET /v1/ai/video/kling-v3/{task-id}" icon="magnifying-glass" href="/api-reference/video/kling-v3/task-by-id">
      Get task status by ID
    </Card>
  </Columns>
</div>

### Parameters

| Parameter         | Type      | Required | Default     | Description                                                                                       |
| ----------------- | --------- | -------- | ----------- | ------------------------------------------------------------------------------------------------- |
| `prompt`          | `string`  | No       | -           | Text prompt describing the video (max 2500 chars). Required for T2V.                              |
| `negative_prompt` | `string`  | No       | -           | Text describing what to avoid (max 2500 chars)                                                    |
| `image_list`      | `array`   | No       | -           | Reference images with `image_url` and `type` (first\_frame/end\_frame)                            |
| `multi_shot`      | `boolean` | No       | `false`     | Enable multi-shot mode for multi-scene videos                                                     |
| `shot_type`       | `string`  | No       | `customize` | Shot segmentation: `customize` (manual per-shot prompts) or `intelligence` (AI auto-segmentation) |
| `multi_prompt`    | `array`   | No       | -           | Shot definitions: `index` (0-5), `prompt`, `duration` per scene                                   |
| `element_list`    | `array`   | No       | -           | Pre-registered element IDs for character/style consistency                                        |
| `aspect_ratio`    | `string`  | No       | `16:9`      | Video ratio: `16:9`, `9:16`, `1:1`                                                                |
| `duration`        | `integer` | No       | `5`         | Duration in seconds: 3-15 (default 5)                                                             |
| `cfg_scale`       | `number`  | No       | `0.5`       | Prompt adherence: 0 (creative) to 1 (strict)                                                      |
| `webhook_url`     | `string`  | No       | -           | URL for task completion notification                                                              |

### Image list item

| Field       | Type     | Description                                                         |
| ----------- | -------- | ------------------------------------------------------------------- |
| `image_url` | `string` | Publicly accessible image URL (300x300 min, 10MB max, JPG/JPEG/PNG) |
| `type`      | `string` | Image role: `first_frame` or `end_frame`                            |

### Multi-prompt item

| Field      | Type      | Description                                |
| ---------- | --------- | ------------------------------------------ |
| `index`    | `integer` | Shot order (0-5)                           |
| `prompt`   | `string`  | Text prompt for this shot (max 2500 chars) |
| `duration` | `number`  | Shot duration in seconds                   |

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is Kling 3 and how does it work?">
    Kling 3 is an AI video generation model that creates videos from text prompts (T2V) or images (I2V). You submit your request via the API, receive a task ID immediately, then poll for results or receive a webhook notification when processing completes. Typical generation takes 30-120 seconds depending on duration and complexity.
  </Accordion>

  <Accordion title="What is multi-shot mode?">
    Multi-shot mode lets you create videos with up to 6 distinct scenes. Each scene can have its own prompt and duration. The total duration across all shots cannot exceed 15 seconds, and each shot must be at least 3 seconds. Enable with `multi_shot: true` and define scenes in `multi_prompt`.
  </Accordion>

  <Accordion title="How do first_frame and end_frame work?">
    Use the `image_list` parameter to provide reference images. Set `type: "first_frame"` to use an image as the video's starting point, or `type: "end_frame"` for the ending point. You can use both to create a transition from one image to another.
  </Accordion>

  <Accordion title="What image formats does Kling 3 support?">
    Kling 3 accepts JPG, JPEG, and PNG images via publicly accessible URLs. Requirements: minimum 300x300 pixels, maximum 10MB file size, aspect ratio between 1:2.5 and 2.5:1.
  </Accordion>

  <Accordion title="What is cfg_scale and how should I set it?">
    CFG scale controls how closely the model follows your prompt. Use 0 for maximum creativity and artistic interpretation, 0.5 (default) for balanced results, or 1 for strict adherence to your prompt with less creative variation.
  </Accordion>

  <Accordion title="What is the difference between Pro and Standard?">
    Pro delivers higher fidelity with richer detail, ideal for premium content and marketing. Standard offers good quality with faster processing, suitable for high-volume generation and testing. Both share the same parameters and capabilities.
  </Accordion>

  <Accordion title="What are the rate limits for Kling 3?">
    Rate limits vary by subscription tier. See [Rate Limits](/ratelimits) for current limits and quotas.
  </Accordion>

  <Accordion title="How much does Kling 3 cost?">
    Pricing varies based on model tier (Pro vs Standard) and video duration. See the [Pricing](/pricing) page for current rates.
  </Accordion>
</AccordionGroup>

## Best practices

* **Prompt clarity**: Write detailed prompts specifying subject, action, camera movement, and atmosphere
* **Start simple**: Begin with single-shot mode before attempting multi-shot sequences
* **Image quality**: For I2V, use high-resolution source images with clear subjects (min 300x300)
* **Duration planning**: For multi-shot, plan scene durations to stay within 15-second total limit
* **Element consistency**: Use pre-registered elements for recurring characters across multiple videos
* **CFG tuning**: Start with 0.5, decrease for more creativity, increase for prompt precision
* **Production integration**: Use webhooks instead of polling for scalable applications
* **Error handling**: Implement retry logic with exponential backoff for 503 errors

## Related APIs

* **[Kling 3 Omni](/api-reference/video/kling-v3-omni/overview)**: Kling 3 with video reference support for motion/style guidance
* **[Kling 2.6 Pro](/api-reference/image-to-video/kling-v2-6-pro)**: Previous generation with motion control capabilities
* **[Kling O1](/api-reference/image-to-video/kling-o1/overview)**: High-performance video generation
* **[Runway Gen 4.5](/api-reference/video/runway-gen-4-5/overview)**: Alternative video generation model


# Kling 3 - Get task status
Source: https://docs.freepik.com/api-reference/video/kling-v3/task-by-id

get /v1/ai/video/kling-v3/{task-id}
Retrieve the status and result of a specific Kling 3 video generation task by its task ID.



# OmniHuman 1.5 - Create human animation
Source: https://docs.freepik.com/api-reference/video/omni-human-1-5

post /v1/ai/video/omni-human-1-5
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.



# OmniHuman 1.5 - List tasks
Source: https://docs.freepik.com/api-reference/video/omni-human-1-5-tasks

get /v1/ai/video/omni-human-1-5



# OmniHuman 1.5 - Get task status
Source: https://docs.freepik.com/api-reference/video/omni-human-1-5/task-by-id

get /v1/ai/video/omni-human-1-5/{task-id}



# RunWay Act Two Character Performance
Source: https://docs.freepik.com/api-reference/video/runway-act-two

post /v1/ai/video/runway-act-two
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.



# RunWay Act Two - List tasks
Source: https://docs.freepik.com/api-reference/video/runway-act-two-tasks

get /v1/ai/video/runway-act-two



# RunWay Act Two - Get task status
Source: https://docs.freepik.com/api-reference/video/runway-act-two/task-by-id

get /v1/ai/video/runway-act-two/{task-id}



# Create video from image - RunWay Gen 4.5
Source: https://docs.freepik.com/api-reference/video/runway-gen-4-5/generate-i2v

post /v1/ai/image-to-video/runway-4-5
Generate high-quality videos from images using RunWay Gen 4.5 model.

**Features:**
- Transform static images into dynamic videos
- Precise motion control via text prompts
- Multiple aspect ratios for different use cases
- Duration options: 5, 8, or 10 seconds
- Reproducible results with seed parameter

**Supported aspect ratios:**
- `1280:720`: Landscape (16:9) - ideal for YouTube, presentations
- `720:1280`: Portrait (9:16) - ideal for TikTok, Instagram Reels
- `1104:832`: Landscape (4:3) - classic format
- `960:960`: Square (1:1) - ideal for Instagram posts
- `832:1104`: Portrait (3:4) - ideal for Pinterest

**Use cases:** Product animations, social media content, marketing videos, and bringing photos to life.




# Create video from text - RunWay Gen 4.5
Source: https://docs.freepik.com/api-reference/video/runway-gen-4-5/generate-t2v

post /v1/ai/text-to-video/runway-4-5
Generate high-quality videos from text descriptions using RunWay Gen 4.5 model.

**Features:**
- State-of-the-art text-to-video generation
- Multiple aspect ratios for different use cases
- Duration options: 5, 8, or 10 seconds
- High visual fidelity and motion quality

**Supported aspect ratios:**
- `1280:720`: Landscape (16:9) - ideal for YouTube, presentations
- `720:1280`: Portrait (9:16) - ideal for TikTok, Instagram Reels
- `1104:832`: Landscape (4:3) - classic format
- `960:960`: Square (1:1) - ideal for Instagram posts
- `832:1104`: Portrait (3:4) - ideal for Pinterest

**Use cases:** Social media content, marketing videos, creative projects, and visual storytelling.




# Runway Gen 4.5 API
Source: https://docs.freepik.com/api-reference/video/runway-gen-4-5/overview

Generate cinematic AI videos from text or images with Runway Gen 4.5. Supports 5, 8, and 10 second durations with multiple aspect ratios. Professional-grade video generation for creative projects.

<Card title="Runway Gen 4.5 integration" icon="video">
  Generate high-quality videos from text prompts or images using Runway's latest Gen 4.5 model with cinematic quality and precise motion control.
</Card>

Runway Gen 4.5 is a dual-mode video generation API that creates professional-grade videos from either text descriptions or source images. It delivers cinematic quality with natural motion, supporting durations of 5, 8, or 10 seconds and multiple aspect ratios including landscape (16:9), portrait (9:16), and square (1:1) formats.

### Key capabilities

* **Text-to-Video (T2V)**: Generate videos from text descriptions up to 2000 characters
* **Image-to-Video (I2V)**: Animate source images with motion guided by text prompts
* **Flexible durations**: 5, 8, or 10 second video generation (default: 5 seconds)
* **Multiple aspect ratios**: `1280:720` (16:9), `720:1280` (9:16), `1104:832` (4:3), `960:960` (1:1), `832:1104` (3:4)
* **Reproducible results**: Seed parameter for consistent video generation with identical inputs
* **Async processing**: Webhook notifications or polling for task completion

### Use cases

* **Marketing and advertising**: Create product showcase videos and promotional content from concepts
* **Social media content**: Generate vertical videos for TikTok, Instagram Reels, and YouTube Shorts
* **E-commerce**: Animate product images to create engaging video presentations
* **Creative storytelling**: Transform storyboards and illustrations into video sequences
* **Music videos**: Generate visual content from artistic concepts and mood descriptions

### Generate videos with Runway Gen 4.5

Create videos by submitting a text prompt (T2V) or image with prompt (I2V) to the API. The service returns a task ID for async polling or webhook notification.

<div>
  <Columns>
    <Card title="POST /v1/ai/text-to-video/runway-4-5" icon="video" href="/api-reference/video/runway-gen-4-5/generate-t2v">
      Create video from text description
    </Card>

    <Card title="POST /v1/ai/image-to-video/runway-4-5" icon="video" href="/api-reference/video/runway-gen-4-5/generate-i2v">
      Create video from source image
    </Card>

    <Card title="GET /v1/ai/text-to-video/runway-4-5" icon="list" href="/api-reference/video/runway-gen-4-5/runway-4-5-t2v-tasks">
      List all text-to-video tasks
    </Card>

    <Card title="GET /v1/ai/image-to-video/runway-4-5" icon="list" href="/api-reference/video/runway-gen-4-5/runway-4-5-i2v-tasks">
      List all image-to-video tasks
    </Card>

    <Card title="GET /v1/ai/text-to-video/runway-4-5/{task-id}" icon="magnifying-glass" href="/api-reference/video/runway-gen-4-5/task-by-id-t2v">
      Get T2V task status by ID
    </Card>

    <Card title="GET /v1/ai/image-to-video/runway-4-5/{task-id}" icon="magnifying-glass" href="/api-reference/video/runway-gen-4-5/task-by-id-i2v">
      Get I2V task status by ID
    </Card>
  </Columns>
</div>

### Text-to-Video Parameters

| Parameter     | Type      | Required | Default    | Description                                                             |
| ------------- | --------- | -------- | ---------- | ----------------------------------------------------------------------- |
| `prompt`      | `string`  | Yes      | -          | Text description of the video to generate. Maximum 2000 characters.     |
| `ratio`       | `string`  | No       | `1280:720` | Aspect ratio: `1280:720`, `720:1280`, `1104:832`, `960:960`, `832:1104` |
| `duration`    | `integer` | No       | `5`        | Video duration in seconds: `5`, `8`, or `10`                            |
| `webhook_url` | `string`  | No       | -          | URL for task completion notification                                    |

### Image-to-Video Parameters

| Parameter     | Type      | Required | Default    | Description                                                             |
| ------------- | --------- | -------- | ---------- | ----------------------------------------------------------------------- |
| `image`       | `string`  | Yes      | -          | Source image URL (HTTPS, publicly accessible) or Base64 encoded image   |
| `prompt`      | `string`  | Yes      | -          | Text description of the desired motion. Maximum 2000 characters.        |
| `ratio`       | `string`  | No       | `1280:720` | Aspect ratio: `1280:720`, `720:1280`, `1104:832`, `960:960`, `832:1104` |
| `duration`    | `integer` | No       | `5`        | Video duration in seconds: `5`, `8`, or `10`                            |
| `seed`        | `integer` | No       | -          | Random seed for reproducible results (0-4294967295)                     |
| `webhook_url` | `string`  | No       | -          | URL for task completion notification                                    |

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is Runway Gen 4.5 and how does it work?">
    Runway Gen 4.5 is an AI video generation model that creates high-quality videos from text prompts (T2V) or source images (I2V). You submit your request via the API, receive a task ID immediately, then poll for results or receive a webhook notification when processing completes. Typical generation takes 30-90 seconds depending on duration.
  </Accordion>

  <Accordion title="What is the difference between Text-to-Video and Image-to-Video?">
    Text-to-Video (T2V) generates videos entirely from text descriptions, creating both the visual content and motion. Image-to-Video (I2V) takes a source image and animates it based on your text prompt, preserving the original image's style and subject while adding motion.
  </Accordion>

  <Accordion title="What image formats does Runway Gen 4.5 I2V support?">
    Runway Gen 4.5 accepts images via publicly accessible HTTPS URLs or Base64 encoded strings. Common formats like JPEG, PNG, and WebP are supported. Ensure your image URL is accessible without authentication.
  </Accordion>

  <Accordion title="How long does video generation take?">
    Processing time depends on the selected duration and current server load. Typical generation takes 30-90 seconds. Longer durations (10 seconds) may take slightly longer. Use webhooks for production workflows to receive notifications instead of polling.
  </Accordion>

  <Accordion title="What are the available aspect ratios?">
    Runway Gen 4.5 supports five aspect ratios: `1280:720` (16:9 landscape), `720:1280` (9:16 portrait), `1104:832` (4:3 landscape), `960:960` (1:1 square), and `832:1104` (3:4 portrait). The default is `1280:720`.
  </Accordion>

  <Accordion title="Can I reproduce the same video?">
    Yes, for Image-to-Video requests. Use the `seed` parameter with a value between 0 and 4294967295. Using the same seed with identical prompt and image will produce the same video. Note: seed is only available for I2V, not T2V.
  </Accordion>

  <Accordion title="What are the rate limits for Runway Gen 4.5?">
    Rate limits vary by subscription tier. See [Rate Limits](/ratelimits) for current limits and quotas.
  </Accordion>

  <Accordion title="How much does Runway Gen 4.5 cost?">
    Pricing varies based on video duration and model tier. See the [Pricing](/pricing) page for current rates and subscription options.
  </Accordion>
</AccordionGroup>

## Best practices

* **Prompt clarity**: Write detailed, descriptive prompts specifying subject, action, lighting, and style for best results
* **Image quality**: For I2V, use high-resolution source images with clear subjects for better animation
* **Aspect ratio matching**: Match the aspect ratio to your target platform (9:16 for TikTok/Reels, 16:9 for YouTube)
* **Duration selection**: Start with 5 seconds for testing, then increase to 8 or 10 for final production
* **Production integration**: Use webhooks instead of polling for scalable applications
* **Error handling**: Implement retry logic with exponential backoff for 503 errors during high traffic

## Related APIs

* **[Runway Gen4 Turbo](/api-reference/image-to-video/runway-gen4-turbo)**: Faster video generation with the Gen4 Turbo model
* **[Runway Act Two](/api-reference/video/runway-act-two)**: Character animation and acting performance videos
* **[Kling 2.6 Pro](/api-reference/image-to-video/kling-v2-6-pro)**: Alternative video generation with advanced motion control
* **[WAN 2.6](/api-reference/wan-v2-6-i2v/overview)**: High-resolution video generation up to 1080p


# RunWay Gen 4.5 I2V - List tasks
Source: https://docs.freepik.com/api-reference/video/runway-gen-4-5/runway-4-5-i2v-tasks

get /v1/ai/image-to-video/runway-4-5
Retrieve the status of all RunWay Gen 4.5 image-to-video generation tasks for the authenticated user.



# RunWay Gen 4.5 T2V - List tasks
Source: https://docs.freepik.com/api-reference/video/runway-gen-4-5/runway-4-5-t2v-tasks

get /v1/ai/text-to-video/runway-4-5
Retrieve the status of all RunWay Gen 4.5 text-to-video generation tasks for the authenticated user.



# RunWay Gen 4.5 I2V - Get task status
Source: https://docs.freepik.com/api-reference/video/runway-gen-4-5/task-by-id-i2v

get /v1/ai/image-to-video/runway-4-5/{task-id}
Retrieve the status and result of a specific RunWay Gen 4.5 image-to-video task by its task ID.



# RunWay Gen 4.5 T2V - Get task status
Source: https://docs.freepik.com/api-reference/video/runway-gen-4-5/task-by-id-t2v

get /v1/ai/text-to-video/runway-4-5/{task-id}
Retrieve the status and result of a specific RunWay Gen 4.5 text-to-video task by its task ID.



# Seedance 1.5 Pro 1080p - List tasks
Source: https://docs.freepik.com/api-reference/video/seedance-1-5-pro-1080p/get-seedance-1-5-pro-1080p

get /v1/ai/video/seedance-1-5-pro-1080p



# Seedance 1.5 Pro 1080p - Get task status
Source: https://docs.freepik.com/api-reference/video/seedance-1-5-pro-1080p/get-seedance-1-5-pro-1080p-task

get /v1/ai/video/seedance-1-5-pro-1080p/{task-id}



# Seedance 1.5 Pro 1080p - Create video from text or image
Source: https://docs.freepik.com/api-reference/video/seedance-1-5-pro-1080p/post-seedance-1-5-pro-1080p

post /v1/ai/video/seedance-1-5-pro-1080p
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.



# Seedance 1.5 Pro 480p - List tasks
Source: https://docs.freepik.com/api-reference/video/seedance-1-5-pro-480p/get-seedance-1-5-pro-480p

get /v1/ai/video/seedance-1-5-pro-480p



# Seedance 1.5 Pro 480p - Get task status
Source: https://docs.freepik.com/api-reference/video/seedance-1-5-pro-480p/get-seedance-1-5-pro-480p-task

get /v1/ai/video/seedance-1-5-pro-480p/{task-id}



# Seedance 1.5 Pro 480p - Create video from text or image
Source: https://docs.freepik.com/api-reference/video/seedance-1-5-pro-480p/post-seedance-1-5-pro-480p

post /v1/ai/video/seedance-1-5-pro-480p
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.



# Seedance 1.5 Pro 720p - List tasks
Source: https://docs.freepik.com/api-reference/video/seedance-1-5-pro-720p/get-seedance-1-5-pro-720p

get /v1/ai/video/seedance-1-5-pro-720p



# Seedance 1.5 Pro 720p - Get task status
Source: https://docs.freepik.com/api-reference/video/seedance-1-5-pro-720p/get-seedance-1-5-pro-720p-task

get /v1/ai/video/seedance-1-5-pro-720p/{task-id}



# Seedance 1.5 Pro 720p - Create video from text or image
Source: https://docs.freepik.com/api-reference/video/seedance-1-5-pro-720p/post-seedance-1-5-pro-720p

post /v1/ai/video/seedance-1-5-pro-720p
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.



# VFX - Apply visual effects to video
Source: https://docs.freepik.com/api-reference/video/vfx/apply-effects

post /v1/ai/video/vfx
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.

**Available filters:**
- `1` Film grain - Adds cinematic grain texture for a classic film look
- `2` Motion blur - Creates motion blur effect (configurable kernel size and decay)
- `3` Fish eye - Applies fish eye lens distortion
- `4` VHS - Retro VHS tape effect with scan lines and color distortion
- `5` Shake - Camera shake effect for dynamic footage
- `6` VGA - Low resolution VGA effect for retro aesthetics
- `7` Bloom - Glowing bloom effect (adjustable contrast)
- `8` Anamorphic lens - Cinematic anamorphic lens effect with horizontal flares

**Use cases:** Social media content, music videos, film production, advertising, retro-style videos, and creative projects.




# VFX – Video Visual Effects API | Freepik API
Source: https://docs.freepik.com/api-reference/video/vfx/overview

Apply cinematic visual effects to videos with VFX API. 8 professional filters including film grain, VHS, bloom, and anamorphic lens. Per-second pricing at $0.017/second.

<Card title="Video Visual Effects processing" icon="wand-magic-sparkles">
  Apply professional cinematic filters and visual effects to your videos with 8 distinct effect types for film, retro, and stylized looks.
</Card>

VFX is a video processing API that applies professional visual effects to any video. It offers 8 cinematic filter types including film grain, motion blur, VHS tape aesthetic, bloom lighting, and anamorphic lens flares. Processing costs \$0.017 per second of video, making it cost-effective for both short clips and longer content.

### Key capabilities

* **8 cinematic filter types**: Film grain, motion blur, fish eye, VHS, camera shake, VGA, bloom, and anamorphic lens
* **Adjustable frame rate**: Output FPS configurable from 1 to 60 frames per second (default: 24 fps)
* **Filter-specific controls**: Fine-tune bloom contrast and motion blur parameters for precise effects
* **Per-second pricing**: \$0.017 per second of video for predictable costs
* **Async processing**: Webhook notifications or polling for task completion

### Available filters

| Filter ID | Name                | Description                                                                  |
| --------- | ------------------- | ---------------------------------------------------------------------------- |
| `1`       | **Film Grain**      | Adds cinematic grain texture for a classic film look                         |
| `2`       | **Motion Blur**     | Creates directional motion blur effect with adjustable kernel size and decay |
| `3`       | **Fish Eye**        | Applies spherical fish eye lens distortion                                   |
| `4`       | **VHS**             | Retro VHS tape aesthetic with scan lines and color bleeding                  |
| `5`       | **Shake**           | Simulates handheld camera shake for dynamic footage                          |
| `6`       | **VGA**             | Low resolution VGA/CRT display look for retro computing aesthetic            |
| `7`       | **Bloom**           | Glowing bloom lighting effect with adjustable contrast                       |
| `8`       | **Anamorphic Lens** | Cinematic anamorphic lens flares for widescreen film look                    |

### Use cases

* **Film and video production**: Add cinematic grain and anamorphic flares to professional footage
* **Social media content**: Create trendy VHS and retro effects for TikTok, Instagram Reels, and YouTube Shorts
* **Music videos**: Apply stylized effects like bloom and motion blur for artistic visuals
* **Advertising campaigns**: Enhance product videos with professional-grade visual effects
* **Gaming content**: Add camera shake and motion blur to gameplay recordings
* **Nostalgic content**: Transform modern footage into retro VHS or VGA aesthetics

### Apply effects with VFX

Submit a video URL and filter type to create a new processing task. The service returns a task ID for async polling or webhook notification.

<div>
  <Columns>
    <Card title="POST /v1/ai/video/vfx" icon="wand-magic-sparkles" href="/api-reference/video/vfx/apply-effects">
      Create a new VFX processing task
    </Card>

    <Card title="GET /v1/ai/video/vfx" icon="list" href="/api-reference/video/vfx/vfx-tasks">
      List all VFX tasks
    </Card>

    <Card title="GET /v1/ai/video/vfx/{task-id}" icon="magnifying-glass" href="/api-reference/video/vfx/task-by-id">
      Get task status and results by ID
    </Card>
  </Columns>
</div>

### Parameters

| Parameter                    | Type      | Required | Default | Description                                                                                                                             |
| ---------------------------- | --------- | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| `video`                      | `string`  | Yes      | -       | URL of the video to process (must be publicly accessible)                                                                               |
| `filter_type`                | `integer` | No       | `1`     | Effect type: `1` (film grain), `2` (motion blur), `3` (fish eye), `4` (VHS), `5` (shake), `6` (VGA), `7` (bloom), `8` (anamorphic lens) |
| `fps`                        | `integer` | No       | `24`    | Output frames per second (1-60)                                                                                                         |
| `bloom_filter_contrast`      | `number`  | No       | -       | Contrast for bloom filter (only for filter\_type `7`)                                                                                   |
| `motion_filter_kernel_size`  | `integer` | No       | -       | Kernel size for motion blur (only for filter\_type `2`)                                                                                 |
| `motion_filter_decay_factor` | `number`  | No       | -       | Decay factor for motion blur (only for filter\_type `2`)                                                                                |
| `webhook_url`                | `string`  | No       | -       | URL for task completion notification                                                                                                    |

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is the VFX API and how does it work?">
    The VFX API applies professional visual effects to videos. You submit a video URL and specify a filter type (1-8), receive a task ID immediately, then poll for results or receive a webhook notification when processing completes. Typical processing time depends on video duration.
  </Accordion>

  <Accordion title="What video formats does the VFX API support?">
    The VFX API accepts videos via publicly accessible URLs. Common formats like MP4, MOV, and WebM are supported. Ensure your video URL is accessible without authentication.
  </Accordion>

  <Accordion title="How much does VFX processing cost?">
    VFX processing costs $0.017 per second of video. For example, a 30-second video costs approximately $0.51, and a 60-second video costs approximately \$1.02.
  </Accordion>

  <Accordion title="What is the difference between the 8 filter types?">
    Each filter creates a distinct visual style: Film grain (1) adds cinematic texture, Motion blur (2) creates directional blur, Fish eye (3) applies lens distortion, VHS (4) creates retro tape aesthetics, Shake (5) simulates handheld camera, VGA (6) creates CRT display look, Bloom (7) adds glow lighting, and Anamorphic lens (8) adds cinematic lens flares.
  </Accordion>

  <Accordion title="Can I customize the bloom and motion blur effects?">
    Yes. For bloom (filter\_type 7), use `bloom_filter_contrast` to adjust the glow intensity. For motion blur (filter\_type 2), use `motion_filter_kernel_size` and `motion_filter_decay_factor` to control blur strength and falloff.
  </Accordion>

  <Accordion title="What frame rates does VFX support?">
    The VFX API supports output frame rates from 1 to 60 fps. The default is 24 fps, which is standard for cinematic content. Use higher values like 30 or 60 fps for smoother motion in fast-paced content.
  </Accordion>

  <Accordion title="How long does VFX processing take?">
    Processing time depends on video duration and complexity. Use webhooks for production workflows to receive notifications when processing completes, rather than polling.
  </Accordion>
</AccordionGroup>

## Best practices

* **Input quality**: Use high-quality source videos for best results; effects amplify existing artifacts
* **Filter selection**: Match the filter to your creative intent; film grain for cinematic, VHS for retro, bloom for dreamy aesthetics
* **Frame rate tuning**: Use 24 fps for cinematic content, 30 fps for web video, 60 fps for gaming content
* **Production integration**: Use webhooks instead of polling for scalable applications
* **Error handling**: Implement retry logic with exponential backoff for 503 errors during high traffic

## Related APIs

* **[Image Upscaler](/api-reference/image-upscaler-precision-v2/post-image-upscaler-precision-v2)**: Enhance image resolution before generating videos to apply VFX effects
* **[Kling 2.6 Pro](/api-reference/image-to-video/kling-v2-6-pro)**: Generate AI videos from images to apply VFX effects to
* **[WAN 2.6](/api-reference/image-to-video/wan-v2-6-720p)**: Create AI videos that can be enhanced with VFX filters


# VFX - Get task status
Source: https://docs.freepik.com/api-reference/video/vfx/task-by-id

get /v1/ai/video/vfx/{task-id}
Retrieve the status and results of a specific VFX video effect task by its task ID.



# VFX - List tasks
Source: https://docs.freepik.com/api-reference/video/vfx/vfx-tasks

get /v1/ai/video/vfx
Retrieve the status of all VFX video effect tasks for the authenticated user.



# Video Upscaler Precision API
Source: https://docs.freepik.com/api-reference/video/video-upscaler-precision/overview

Upscale videos with AI diffusion-based enhancement using Video Upscaler Precision. Output at 1K, 2K, or 4K resolution with sharpening, smart grain, strength, and FPS boost controls.

<Card title="Freepik API uses Magnific.ai technology, now available as a comprehensive API service." icon="arrow-up-right-dots">
  Video Upscaler Precision uses AI diffusion models for high-fidelity video upscaling with fine-grained control over sharpness, grain, and output strength.
</Card>

Video Upscaler Precision is an AI-powered video upscaling API that enhances video resolution using diffusion-based models for faithful, controlled quality improvement. Unlike the standard Video Upscaler, Precision focuses on detail recovery and controlled enhancement without adding AI-generated content -- it upscales what is already in the video. The API supports output resolutions of 1K, 2K (default), and 4K with adjustable sharpening, smart grain, and upscaling strength. For the standard upscaler with creativity controls and Turbo mode, see <a href="/api-reference/video/video-upscaler/overview">Video Upscaler</a>.

### Key capabilities

* **Resolution up to 4K**: Upscale videos to `1k`, `2k` (default), or `4k` output resolution
* **Strength control**: Adjustable upscaling intensity (0-100, default 60) to blend between original and fully upscaled output
* **FPS boost**: Increase video frame rate for smoother motion. When enabled, the strength parameter is ignored and the fully upscaled result is returned
* **Sharpen control**: Adjustable sharpening intensity (0-100, default 0) for edge definition and clarity
* **Smart grain**: Film grain effect (0-100, default 0) to add natural texture and prevent artificial smoothness
* **Async processing**: Webhook notifications or polling for task completion
* **Flexible input**: Accepts HTTPS URLs or base64-encoded video

### Use cases

* **Film restoration**: Upscale archival and classic footage to modern resolutions while preserving the original aesthetic
* **Content repurposing**: Enhance low-resolution social media clips for large-screen display or broadcast delivery
* **Video production**: Upscale B-roll and legacy footage to match project resolution requirements with precise control
* **E-commerce**: Enhance product videos with higher resolution and sharpness for better detail visibility
* **Surveillance review**: Improve clarity of security footage for analysis and evidence review
* **Educational content**: Enhance older training videos and course recordings for modern high-resolution displays

### Upscale videos with Precision

Create a precision upscaling task by submitting a video to the API. The service returns a task ID for async polling or webhook notification.

<div>
  <Columns>
    <Card title="POST /v1/ai/video-upscaler-precision" icon="arrow-up-right-dots" href="/api-reference/video/video-upscaler-precision/upscale-video">
      Create a new precision video upscaling task
    </Card>

    <Card title="GET /v1/ai/video-upscaler-precision" icon="list" href="/api-reference/video/video-upscaler-precision/video-upscaler-precision-tasks">
      List all precision upscaler tasks
    </Card>

    <Card title="GET /v1/ai/video-upscaler-precision/{task-id}" icon="magnifying-glass" href="/api-reference/video/video-upscaler-precision/task-by-id">
      Get task status and results by ID
    </Card>
  </Columns>
</div>

### Parameters

| Parameter     | Type      | Required | Default | Description                                                                                                                                                                                    |
| ------------- | --------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `video`       | `string`  | Yes      | -       | Source video as HTTPS URL or base64-encoded string                                                                                                                                             |
| `resolution`  | `string`  | No       | `"2k"`  | Output resolution: `"1k"`, `"2k"`, or `"4k"`                                                                                                                                                   |
| `fps_boost`   | `boolean` | No       | `false` | Increase frame rate for smoother motion. When enabled, `strength` is ignored and the fully upscaled result is returned                                                                         |
| `sharpen`     | `integer` | No       | `0`     | Sharpening intensity (0-100). Higher values increase edge definition                                                                                                                           |
| `smart_grain` | `integer` | No       | `0`     | Film grain effect (0-100). Adds natural texture to prevent artificial smoothness                                                                                                               |
| `strength`    | `integer` | No       | `60`    | Upscaling intensity (0-100). 0 returns the original video, 100 returns the fully upscaled result. Intermediate values blend original with upscaled output. Ignored when `fps_boost` is enabled |
| `webhook_url` | `string`  | No       | -       | URL for completion notification with task status and output URL                                                                                                                                |

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is Video Upscaler Precision and how does it work?">
    Video Upscaler Precision is an AI-powered video upscaling API that uses diffusion models to increase video resolution with faithful detail recovery. You submit a video via URL or base64, receive a task ID, then poll for results or receive a webhook notification when processing completes. The API processes each frame with controlled enhancement based on your parameter settings.
  </Accordion>

  <Accordion title="What is the difference between Video Upscaler Precision and the standard Video Upscaler?">
    **Video Upscaler Precision** focuses on faithful, controlled upscaling with a `strength` parameter that lets you blend between original and upscaled output. It does not have creativity or flavor controls. The **standard [Video Upscaler](/api-reference/video/video-upscaler/overview)** offers creativity controls (0-100), processing flavors (`vivid`/`natural`), and a separate Turbo endpoint for faster processing. Choose Precision when you want the upscaled video to stay true to the original without AI-generated additions.
  </Accordion>

  <Accordion title="What does the strength parameter do?">
    The strength parameter (0-100, default 60) controls the blend between the original video and the fully upscaled result. A value of 0 returns the original video unchanged. A value of 100 returns the fully upscaled output. Values in between produce a weighted blend. This parameter is ignored when `fps_boost` is enabled, which always returns the fully upscaled result.
  </Accordion>

  <Accordion title="What output resolutions are supported?">
    Video Upscaler Precision supports three output resolutions: `1k`, `2k` (default), and `4k`. Higher resolutions increase processing time. See the <a href="/pricing">Pricing page</a> for details on each resolution tier.
  </Accordion>

  <Accordion title="What are the rate limits for Video Upscaler Precision?">
    Rate limits vary by subscription tier. See the <a href="/ratelimits">Rate Limits</a> page for current limits by plan.
  </Accordion>

  <Accordion title="How much does Video Upscaler Precision cost?">
    Pricing depends on the output resolution you select. See the <a href="/pricing">Pricing page</a> for current rates and subscription options.
  </Accordion>
</AccordionGroup>

## Best practices

* **Input quality**: Start from the highest-quality source video available. Heavily compressed inputs may have artifacts amplified during upscaling
* **Strength tuning**: Start with the default strength of 60. Use lower values (20-40) for subtle enhancement, higher values (80-100) for maximum upscaling effect
* **FPS boost decision**: Enable FPS boost for footage with low frame rates (24fps or below) to create smoother playback. Note that it overrides the strength parameter
* **Smart grain for realism**: Increase smart\_grain for footage that should retain a filmic quality rather than appearing digitally processed
* **Resolution selection**: Choose 2K (default) for most use cases as a good balance of quality and processing time. Use 4K when the target display or delivery format requires it
* **Production integration**: Use webhooks instead of polling for scalable, event-driven applications
* **Error handling**: Implement retry logic with exponential backoff for 503 errors during high traffic

## Related APIs

* **[Video Upscaler](/api-reference/video/video-upscaler/overview)**: Standard video upscaler with creativity controls, processing flavors, and a Turbo endpoint for faster processing
* **[Upscaler Precision V2](/api-reference/image-upscaler-precision-v2/overview)**: High-fidelity image upscaling with granular controls for sharpness, texture, and detail
* **[VFX](/api-reference/video/vfx/overview)**: Apply cinematic visual effects to videos with professional filters


# Video Upscaler Precision - Get task status
Source: https://docs.freepik.com/api-reference/video/video-upscaler-precision/task-by-id

get /v1/ai/video-upscaler-precision/{task-id}
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.



# Video Upscaler Precision - Upscale video
Source: https://docs.freepik.com/api-reference/video/video-upscaler-precision/upscale-video

post /v1/ai/video-upscaler-precision
Upscales a video with precision-grade quality enhancement.
Designed for frame-accurate upscaling with fine-grained control over sharpening, grain, and output strength.
Supports output resolutions of 1k, 2k, or 4k with optional FPS boost.




# Video Upscaler Precision - List tasks
Source: https://docs.freepik.com/api-reference/video/video-upscaler-precision/video-upscaler-precision-tasks

get /v1/ai/video-upscaler-precision
Returns a list of all video upscaler precision tasks. Each task includes its ID, current status, and output URL if completed.



# AI Video Upscaling - Magnific API
Source: https://docs.freepik.com/api-reference/video/video-upscaler/overview

Upscale videos to 1K, 2K, or 4K with the Video Upscaler API. Standard and Turbo endpoints with creativity, FPS boost, sharpening, and smart grain controls.

<Card title="Freepik API uses Magnific.ai technology, now available as a comprehensive API service." icon="arrow-up-right-dots">
  Video Upscaler enhances video resolution up to 4K with AI-powered detail enhancement, FPS boost, and fine-grained controls for sharpness and texture.
</Card>

Video Upscaler is an AI-powered video upscaling API that increases video resolution while intelligently enhancing details and improving visual quality. Built on the same Magnific technology used for image upscaling, this API extends those capabilities to video content with additional controls for frame rate enhancement and processing speed. The API offers two processing modes via separate endpoints: **Standard** for maximum quality and **Turbo** for faster processing with premium quality automatically applied. Both support output resolutions up to 4K with granular control over creativity, sharpness, grain, and processing style.

### Key capabilities

* **Resolution up to 4K**: Upscale videos to 1K, 2K, or 4K output resolution
* **Creativity control**: Adjustable creativity intensity (0-100) to balance fidelity vs enhancement
* **FPS boost**: Increase video frame rate for smoother motion
* **Sharpen control**: Adjustable sharpening intensity (0-100) for edge definition and clarity
* **Smart grain**: Intelligent grain/texture enhancement (0-100) for natural film grain preservation
* **Processing flavors**: Two modes: `vivid` for enhanced colors and detail, `natural` for faithful reproduction
* **Standard and Turbo endpoints**: Standard for maximum quality control, Turbo for faster processing with premium quality built in
* **Frame-based pricing**: Cost calculated per frame, varying by output resolution
* **Async processing**: Webhook notifications or polling for task completion
* **Flexible input**: Accepts HTTPS URLs or base64-encoded video

### Use cases

* **Film restoration**: Upscale classic footage to modern resolutions while preserving the original aesthetic
* **Content repurposing**: Enhance low-resolution social media clips for large-screen display or broadcast
* **Video production**: Upscale B-roll and archival footage to match project resolution requirements
* **E-commerce**: Enhance product videos with higher resolution and sharpness for better customer experience
* **Surveillance**: Improve clarity of security footage for review and analysis
* **Gaming content**: Upscale gameplay recordings and streaming highlights to 4K
* **Educational content**: Enhance older educational videos and training materials for modern displays

### Standard endpoint

Submit a video URL or base64-encoded video to create a new upscaling task. The service returns a task ID for async polling or webhook notification.

<div>
  <Columns>
    <Card title="POST /v1/ai/video-upscaler" icon="arrow-up-right-dots" href="/api-reference/video/video-upscaler/upscale-video">
      Create a new video upscaling task
    </Card>

    <Card title="GET /v1/ai/video-upscaler" icon="list" href="/api-reference/video/video-upscaler/video-upscaler-tasks">
      List all video upscaler tasks
    </Card>

    <Card title="GET /v1/ai/video-upscaler/{task-id}" icon="magnifying-glass" href="/api-reference/video/video-upscaler/task-by-id">
      Get task status and results by ID
    </Card>
  </Columns>
</div>

### Turbo endpoint

Turbo processing with premium quality automatically applied. Faster processing while maintaining high visual quality. Uses the same parameters as the standard endpoint. Turbo tasks appear in the same task list and can be retrieved with the same get-task endpoint as standard tasks.

<div>
  <Columns>
    <Card title="POST /v1/ai/video-upscaler/turbo" icon="bolt" href="/api-reference/video/video-upscaler/upscale-video-turbo">
      Create a turbo video upscaling task
    </Card>
  </Columns>
</div>

### Parameters

Both standard and turbo endpoints accept the same request body:

| Parameter     | Type      | Required | Default | Description                                                                                   |
| ------------- | --------- | -------- | ------- | --------------------------------------------------------------------------------------------- |
| `video`       | `string`  | Yes      | -       | Source video as HTTPS URL or base64-encoded string                                            |
| `creativity`  | `integer` | No       | `0`     | Creativity intensity (0-100). Higher values introduce more AI-generated detail                |
| `resolution`  | `string`  | No       | `2k`    | Output resolution: `1k`, `2k`, or `4k`                                                        |
| `fps_boost`   | `boolean` | No       | `false` | Boost video frame rate for smoother motion                                                    |
| `sharpen`     | `integer` | No       | `0`     | Sharpening intensity (0-100). Higher values increase edge definition                          |
| `smart_grain` | `integer` | No       | `0`     | Grain/texture enhancement (0-100). Adds natural film grain effect                             |
| `flavor`      | `string`  | No       | `vivid` | Processing style: `vivid` for enhanced colors and detail, `natural` for faithful reproduction |
| `webhook_url` | `string`  | No       | -       | URL for completion notification with task status and output URL                               |

### Pricing

Video Upscaler uses frame-based pricing. The cost per frame varies depending on the output resolution selected. Key pricing factors:

* **Number of frames**: Total frame count in the input video determines base cost
* **Output resolution**: 4K costs more per frame than 2K or 1K
* **FPS boost**: Enabling frame rate boost increases the total frame count and cost
* **Endpoint**: Standard and Turbo have different per-frame rates

<Tip>
  **Choosing between Standard and Turbo:** Use the Turbo endpoint (`/v1/ai/video-upscaler/turbo`) for faster processing with premium quality automatically applied. Use the Standard endpoint (`/v1/ai/video-upscaler`) when you need maximum control over processing options. See the [Pricing page](/pricing) for current rates.
</Tip>

### Rate limits

| Tier   | Requests per day |
| ------ | ---------------- |
| Free   | 10               |
| Tier 1 | 125              |

For higher rate limits, [contact our sales team](https://www.freepik.com/api#contact) with details about your use case and expected traffic.

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is Video Upscaler and how does it work?">
    Video Upscaler is an AI-powered video upscaling API that increases video resolution while enhancing details. You submit a video via URL or base64, receive a task ID, then poll for results or receive a webhook notification when processing completes. The API analyzes each frame and applies intelligent upscaling with your chosen parameters.
  </Accordion>

  <Accordion title="What output resolutions are supported?">
    Video Upscaler supports three output resolutions: `1k`, `2k` (default), and `4k`. Choose based on your target display or delivery requirements. Higher resolutions increase processing time and cost per frame.
  </Accordion>

  <Accordion title="What is the difference between Standard and Turbo endpoints?">
    The **Standard** endpoint (`/v1/ai/video-upscaler`) provides full control over upscaling parameters. The **Turbo** endpoint (`/v1/ai/video-upscaler/turbo`) delivers faster processing with premium quality automatically applied. Both accept the same request parameters. Choose Turbo for high-volume workflows or when faster turnaround is needed, and Standard when you want maximum quality control.
  </Accordion>

  <Accordion title="How does frame-based pricing work?">
    Video Upscaler pricing is calculated per frame. The cost per frame varies by output resolution (1K, 2K, or 4K). The total cost equals the number of frames in your video multiplied by the per-frame rate for your chosen resolution. Enabling FPS boost increases the total frame count and therefore the cost. See the [Pricing page](/pricing) for current per-frame rates.
  </Accordion>

  <Accordion title="What is the difference between vivid and natural flavors?">
    **Vivid** enhances colors and adds more detail during upscaling, producing visually striking results. **Natural** preserves the original color palette and characteristics for faithful reproduction. Choose vivid for marketing and creative content, natural for documentary or archival work.
  </Accordion>

  <Accordion title="How does creativity affect the output?">
    The creativity parameter (0-100, default 0) controls how much AI-generated detail is introduced during upscaling. At 0, the upscaler focuses on faithful resolution enhancement. Higher values allow the AI to infer and add new details, similar to the creative image upscaler. Start with low values and increase gradually.
  </Accordion>

  <Accordion title="What does FPS boost do?">
    FPS boost increases the video frame rate for smoother motion. This is especially useful for older footage with low frame rates, creating a more fluid viewing experience on modern displays. Note that FPS boost increases the total frame count, which affects pricing.
  </Accordion>

  <Accordion title="How long does video upscaling take?">
    Processing time depends on video duration, input resolution, output resolution, and selected options. The Turbo endpoint significantly reduces processing time compared to Standard. Use webhooks for production workflows to receive notifications when processing completes, rather than polling.
  </Accordion>

  <Accordion title="What are the rate limits for Video Upscaler?">
    Free tier allows 10 requests per day. Tier 1 allows 125 requests per day. Rate limits apply across both Standard and Turbo endpoints. For higher limits, <a href="https://www.freepik.com/api#contact">contact our sales team</a>.
  </Accordion>
</AccordionGroup>

## Best practices

* **Input quality**: Start from the highest-quality source video available. Avoid heavily compressed inputs as artifacts may be amplified
* **Resolution selection**: Choose the output resolution based on your delivery needs. 2K is a good balance of quality and cost for most use cases
* **Creativity tuning**: Start with creativity at 0 for faithful upscaling. Increase gradually if you want the AI to enhance and infer additional detail
* **Flavor selection**: Use `vivid` for marketing and social media content, `natural` for documentary, archival, or clinical footage
* **Standard vs Turbo**: Use the Turbo endpoint for faster turnaround with premium quality. Use Standard for full quality control
* **Smart grain for realism**: Increase smart\_grain for footage that should retain a filmic quality rather than appearing digitally smooth
* **Production integration**: Use webhooks instead of polling for scalable, event-driven applications
* **Error handling**: Implement retry logic with exponential backoff for 503 errors during high traffic

## Related APIs

* **[Upscaler Creative](/api-reference/image-upscaler-creative/image-upscaler)**: Prompt-guided image upscaling with creative detail generation and stylization
* **[Upscaler Precision V2](/api-reference/image-upscaler-precision-v2/overview)**: High-fidelity image upscaling with granular controls for sharpness, texture, and detail
* **[VFX](/api-reference/video/vfx/overview)**: Apply cinematic visual effects to videos with professional filters


# Video Upscaler - Get task status
Source: https://docs.freepik.com/api-reference/video/video-upscaler/task-by-id

get /v1/ai/video-upscaler/{task-id}
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.



# Video Upscaler - Upscale video
Source: https://docs.freepik.com/api-reference/video/video-upscaler/upscale-video

post /v1/ai/video-upscaler
Upscales a video while enhancing visual quality and resolution.
Supports various output resolutions (1k, 2k, 4k) with optional creativity, sharpening, and grain controls.




# Video Upscaler Turbo - Upscale video
Source: https://docs.freepik.com/api-reference/video/video-upscaler/upscale-video-turbo

post /v1/ai/video-upscaler/turbo
Upscales a video using turbo processing with premium quality enhancement applied automatically.
Turbo mode reduces processing time while maintaining high visual quality.
Supports various output resolutions (1k, 2k, 4k) with optional creativity, sharpening, and grain controls.




# Video Upscaler - List tasks
Source: https://docs.freepik.com/api-reference/video/video-upscaler/video-upscaler-tasks

get /v1/ai/video-upscaler
Returns a list of all video upscaler tasks. Each task includes its ID, current status, and output URL if completed.



# Download a video by option id.
Source: https://docs.freepik.com/api-reference/videos/download-an-option-video

get /v1/videos/{id}/options/{option-id}/download



# Download a video by ID.
Source: https://docs.freepik.com/api-reference/videos/download-an-video

get /v1/videos/{id}/download



# Search and filter videos by specified order
Source: https://docs.freepik.com/api-reference/videos/get-all-videos-by-order

get /v1/videos



# Get detailed video information by ID
Source: https://docs.freepik.com/api-reference/videos/get-one-video-by-id

get /v1/videos/{id}



# Videos API
Source: https://docs.freepik.com/api-reference/videos/videos-api

Search, retrieve, and download videos programmatically with the Freepik Videos API.

The Freepik Videos API lets you discover video resources with AI-powered search and download the assets for use in your applications.

### What you can do

* List videos with sorting and filters
* Get a single video by ID
* Download a video asset

### Authentication

All requests require an API key via the `x-freepik-api-key` header. See the [Quickstart](/quickstart) and [Authentication](/authentication).

### Endpoints

<div>
  <Columns>
    <Card title="GET /v1/videos" icon="code" href="/api-reference/videos/get-all-videos-by-order">
      List videos with sorting and filters
    </Card>

    <Card title="GET /v1/videos/{id}" icon="code" href="/api-reference/videos/get-one-video-by-id">
      Retrieve a single video by ID
    </Card>

    <Card title="GET /v1/videos/{id}/download" icon="code" href="/api-reference/videos/download-an-video">
      Download a video asset
    </Card>
  </Columns>
</div>

### Use cases

* Build a video picker for your CMS
* AI-powered search by keyword and sort by popularity
* Programmatically download videos during build/deploy

### FAQ

#### Is there a rate limit?

Yes. See [Rate limits](/ratelimits).

#### What license applies to videos?

Refer to the [License agreement](https://www.freepik.com/legal/terms-of-use#api-services).


# Voiceover - Generate speech from text
Source: https://docs.freepik.com/api-reference/voiceover/generate

post /v1/ai/voiceover/elevenlabs-turbo-v2-5
Generate natural-sounding speech from text using ElevenLabs AI voices.

Create professional voiceovers for videos, podcasts, presentations, and more.
Supports multiple languages, voice customization, and high-quality audio output.




# ElevenLabs Voiceover - Text-to-Speech API
Source: https://docs.freepik.com/api-reference/voiceover/overview

Generate natural-sounding voiceovers from text with ElevenLabs AI. Professional speech synthesis with voice customization, multi-language support, and high-quality audio output.

<Card title="ElevenLabs integration" icon="microphone-lines">
  Powered by ElevenLabs technology, this API generates natural-sounding speech from text with customizable voice settings and multi-language support.
</Card>

ElevenLabs Voiceover is a text-to-speech API that converts text into natural-sounding audio using AI voice synthesis. Generate professional voiceovers for videos, podcasts, presentations, e-learning content, and accessibility applications. The API supports up to 40,000 characters per request with the Turbo model and delivers high-quality audio output suitable for production use.

### Key capabilities

* **AI model**: `eleven_turbo_v2_5` optimized for fast, high-quality generation (up to 10,000 characters)
* **Voice customization**: Control stability (0-1), similarity boost (0-1), and speech speed (0.7-1.2x)
* **Speaker boost**: Enhanced voice clarity and presence in generated audio
* **Multi-language support**: UTF-8 text including accented letters and non-Latin scripts
* **Maximum text length**: Up to 40,000 characters per request
* **Async processing**: Webhook notifications or polling for task completion

### Use cases

* **Video production**: Create voiceovers for marketing videos, tutorials, and social media content
* **Podcast production**: Generate intro/outro narration or read content aloud
* **E-learning**: Convert educational materials to audio for accessibility and engagement
* **Accessibility**: Provide audio versions of written content for visually impaired users
* **IVR systems**: Generate professional voice prompts for phone systems
* **Audiobook creation**: Convert written content into natural-sounding audio narration

### Generate voiceover with ElevenLabs

Create voiceovers by submitting text to the API with a voice ID. The service returns a task ID for async polling or webhook notification.

<div>
  <Columns>
    <Card title="POST /v1/ai/voiceover" icon="microphone-lines" href="/api-reference/voiceover/generate">
      Create a new voiceover generation task
    </Card>

    <Card title="GET /v1/ai/voiceover" icon="list" href="/api-reference/voiceover/voiceover-tasks">
      List all voiceover tasks with status
    </Card>

    <Card title="GET /v1/ai/voiceover/{task-id}" icon="magnifying-glass" href="/api-reference/voiceover/task-by-id">
      Get task status and results by ID
    </Card>
  </Columns>
</div>

### Parameters

| Parameter           | Type      | Required | Default               | Description                                                           |
| ------------------- | --------- | -------- | --------------------- | --------------------------------------------------------------------- |
| `text`              | `string`  | Yes      | -                     | Text to convert to speech. UTF-8 supported, 1-40,000 characters       |
| `voice_id`          | `string`  | Yes      | -                     | ElevenLabs voice ID from the voice library                            |
| `model`             | `string`  | No       | `"eleven_turbo_v2_5"` | AI model for speech synthesis                                         |
| `stability`         | `number`  | No       | `0.5`                 | Voice consistency: 0.0 (expressive) to 1.0 (stable)                   |
| `similarity_boost`  | `number`  | No       | `0.2`                 | Voice matching: 0.0 (varied) to 1.0 (close match, may have artifacts) |
| `speed`             | `number`  | No       | `1.0`                 | Speech rate: 0.7 (30% slower) to 1.2 (20% faster)                     |
| `use_speaker_boost` | `boolean` | No       | `true`                | Enable enhanced voice clarity and presence                            |
| `webhook_url`       | `string`  | No       | -                     | URL for task completion notification                                  |

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is ElevenLabs Voiceover and how does it work?">
    ElevenLabs Voiceover is a text-to-speech API that converts text into natural-sounding audio using AI voice synthesis. You submit text with a voice ID, receive a task ID immediately, then poll for results or receive a webhook notification when processing completes. The output is a high-quality audio file containing the synthesized speech.
  </Accordion>

  <Accordion title="What model is used for voiceover generation?">
    The `eleven_turbo_v2_5` model is used, optimized for fast, high-quality speech synthesis. It supports up to 10,000 characters per request and is ideal for both real-time applications and production use.
  </Accordion>

  <Accordion title="How do I find voice IDs for ElevenLabs voices?">
    Voice IDs are unique identifiers for each voice in the ElevenLabs voice library. You can find voice IDs in the ElevenLabs Voice Library. A common example voice ID is `21m00Tcm4TlvDq8ikWAM` (Rachel - a calm, professional female voice).
  </Accordion>

  <Accordion title="What do the stability and similarity_boost parameters control?">
    `stability` (0-1) controls voice consistency: lower values produce more expressive, varied speech; higher values produce more consistent, stable output. `similarity_boost` (0-1) controls how closely the output matches the original voice sample: higher values match more closely but may introduce artifacts.
  </Accordion>

  <Accordion title="What languages does ElevenLabs Voiceover support?">
    ElevenLabs Voiceover supports multiple languages through UTF-8 text encoding, including accented letters (e.g., e, n, u) and non-Latin scripts. The specific languages available depend on the voice selected - many voices support multiple languages natively.
  </Accordion>

  <Accordion title="How long does voiceover generation take?">
    Processing time depends on text length and model selection. The `eleven_turbo_v2_5` model is optimized for speed and generates audio faster. For production workflows with longer texts, use webhooks instead of polling to receive completion notifications.
  </Accordion>

  <Accordion title="What are the rate limits for voiceover generation?">
    Rate limits vary by subscription tier. See [Rate Limits](/ratelimits) for current limits by tier. For high-volume production use, consider using webhooks for efficient task management.
  </Accordion>
</AccordionGroup>

## Best practices

* **Voice selection**: Choose a voice appropriate for your content and audience
* **Model**: The `eleven_turbo_v2_5` model provides fast, high-quality results for all use cases
* **Stability tuning**: Start with 0.5, decrease for more expressive reads, increase for more consistent output
* **Speed adjustment**: Use 0.7-0.9 for slower, clearer speech; 1.0-1.2 for faster narration
* **Text preparation**: Use proper punctuation for natural pauses; avoid very long sentences
* **Production integration**: Use webhooks instead of polling for scalable applications
* **Error handling**: Implement retry logic with exponential backoff for 503 errors

## Related APIs

* **[Sound Effects](/api-reference/sound-effects/post-sound-effects)**: Generate sound effects from text descriptions
* **[Audio Isolation](/api-reference/audio-isolation/overview)**: Extract specific sounds from audio or video files
* **[Lip Sync](/api-reference/lip-sync/latent-sync/overview)**: Synchronize lip movements with audio
* **[OmniHuman 1.5](/api-reference/video/omni-human-1-5)**: Generate human animations driven by audio


# Voiceover - Get task status
Source: https://docs.freepik.com/api-reference/voiceover/task-by-id

get /v1/ai/voiceover/elevenlabs-turbo-v2-5/{task-id}
Get the status of one voiceover task



# Voiceover - List tasks
Source: https://docs.freepik.com/api-reference/voiceover/voiceover-tasks

get /v1/ai/voiceover/elevenlabs-turbo-v2-5
Get the status of all voiceover tasks



# WAN 2.5 Text-to-Video API
Source: https://docs.freepik.com/api-reference/wan-2-5-t2v/overview

Generate videos from text prompts with WAN 2.5. Choose from 480p, 720p, or 1080p resolutions with 5 or 10 second durations for creative and marketing content.

<Card title="Alibaba WAN Integration" icon="wand-magic-sparkles">
  WAN 2.5 is developed by Alibaba and delivers high-quality text-to-video generation with multiple resolution options and prompt expansion capabilities.
</Card>

WAN 2.5 Text-to-Video generates videos directly from text descriptions. Describe your scene, characters, motion, and camera movements in a prompt, and the API produces video output at your chosen resolution. Available in 480p, 720p, and 1080p variants with 5 or 10 second durations, suitable for rapid prototyping, social media content, and marketing assets.

### Key capabilities

* **Multiple resolutions**: Choose between 480p, 720p, or 1080p based on quality and speed requirements
* **Flexible duration**: Generate 5-second clips for fast iteration or 10-second videos for more developed action
* **Prompt expansion**: AI-powered prompt optimizer expands simple ideas into detailed video scripts
* **Negative prompts**: Exclude unwanted elements like blur, watermarks, or distortion from output
* **Reproducible results**: Use seed values to regenerate similar videos with identical parameters
* **Async processing**: Webhook notifications or polling for task completion
* **Maximum prompt length**: 800 characters for main prompt, 500 characters for negative prompt

### Resolution comparison

| Resolution | Best for                                                   | Processing speed | Output quality |
| ---------- | ---------------------------------------------------------- | ---------------- | -------------- |
| **480p**   | Rapid prototyping, previews, mobile-first content          | Fastest          | Good           |
| **720p**   | Social media, web content, balanced quality/speed          | Medium           | Better         |
| **1080p**  | Marketing assets, professional content, high-detail scenes | Slower           | Best           |

### Use cases

* **Social media content**: Quick video clips for TikTok, Instagram Reels, and YouTube Shorts
* **Marketing previews**: Rapid concept visualization before full production
* **Product demonstrations**: Animated product showcases from text descriptions
* **Educational content**: Explainer videos and visual learning materials
* **Creative exploration**: Experimental motion and abstract visualizations
* **Storyboarding**: Visual previews for film and video pre-production

### API operations

Generate videos by submitting a text prompt to the appropriate resolution endpoint. The service returns a task ID for async polling or webhook notification.

<div>
  <Columns>
    <Card title="POST /v1/ai/text-to-video/wan-2-5-t2v-480p" icon="video" href="/api-reference/text-to-video/wan-2-5-t2v-480p">
      Generate 480p video from text
    </Card>

    <Card title="GET /v1/ai/text-to-video/wan-2-5-t2v-480p" icon="list" href="/api-reference/text-to-video/wan-2-5-t2v-480p-tasks">
      List 480p tasks
    </Card>

    <Card title="GET /v1/ai/text-to-video/wan-2-5-t2v-480p/{task-id}" icon="magnifying-glass" href="/api-reference/wan-2-5-t2v/task-by-id-480p">
      Get 480p task status
    </Card>
  </Columns>
</div>

<div>
  <Columns>
    <Card title="POST /v1/ai/text-to-video/wan-2-5-t2v-720p" icon="video" href="/api-reference/text-to-video/wan-2-5-t2v-720p">
      Generate 720p video from text
    </Card>

    <Card title="GET /v1/ai/text-to-video/wan-2-5-t2v-720p" icon="list" href="/api-reference/text-to-video/wan-2-5-t2v-720p-tasks">
      List 720p tasks
    </Card>

    <Card title="GET /v1/ai/text-to-video/wan-2-5-t2v-720p/{task-id}" icon="magnifying-glass" href="/api-reference/wan-2-5-t2v/task-by-id-720p">
      Get 720p task status
    </Card>
  </Columns>
</div>

<div>
  <Columns>
    <Card title="POST /v1/ai/text-to-video/wan-2-5-t2v-1080p" icon="video" href="/api-reference/text-to-video/wan-2-5-t2v-1080p">
      Generate 1080p video from text
    </Card>

    <Card title="GET /v1/ai/text-to-video/wan-2-5-t2v-1080p" icon="list" href="/api-reference/text-to-video/wan-2-5-t2v-1080p-tasks">
      List 1080p tasks
    </Card>

    <Card title="GET /v1/ai/text-to-video/wan-2-5-t2v-1080p/{task-id}" icon="magnifying-glass" href="/api-reference/wan-2-5-t2v/task-by-id-1080p">
      Get 1080p task status
    </Card>
  </Columns>
</div>

### Parameters

| Parameter                 | Type      | Required | Default | Description                                                                                                         |
| ------------------------- | --------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------- |
| `prompt`                  | `string`  | Yes      | -       | Main description of the video including scene, characters, motion, camera moves, and style. Maximum 800 characters. |
| `duration`                | `string`  | No       | `"5"`   | Video length: `"5"` seconds (faster) or `"10"` seconds (more action)                                                |
| `negative_prompt`         | `string`  | No       | -       | Elements to avoid in the output (e.g., "blurry, low quality, watermark"). Maximum 500 characters.                   |
| `enable_prompt_expansion` | `boolean` | No       | `true`  | AI optimizer expands shorter prompts into detailed scripts                                                          |
| `seed`                    | `integer` | No       | Random  | Seed for reproducibility (0 to 2147483647). Use same seed with identical parameters for similar results.            |
| `webhook_url`             | `string`  | No       | -       | URL for async completion notifications                                                                              |

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is WAN 2.5 Text-to-Video and how does it work?">
    WAN 2.5 Text-to-Video is an AI video generation API developed by Alibaba. You submit a text prompt describing your desired video, receive a task ID immediately, then poll for results or receive a webhook notification when processing completes. The model interprets your description and generates a video matching the scene, motion, and style you specified.
  </Accordion>

  <Accordion title="Which resolution should I choose: 480p, 720p, or 1080p?">
    Choose based on your use case: 480p is fastest and ideal for rapid prototyping or mobile-first content. 720p balances quality and speed, suitable for most social media and web content. 1080p delivers the highest quality for marketing assets and professional content but takes longer to process.
  </Accordion>

  <Accordion title="How long does WAN 2.5 Text-to-Video take to process?">
    Processing time depends on resolution and duration. 480p processes fastest, followed by 720p, then 1080p. A 5-second clip generates faster than a 10-second clip. For production workflows, use webhooks instead of polling.
  </Accordion>

  <Accordion title="What makes a good text-to-video prompt?">
    Be specific about scenes and visual details. Describe camera movements (zoom, pan, tilt), lighting, atmosphere, and subject actions. Example: "fluffy orange cat on wooden windowsill, looking at snow falling outside, soft warm lighting, slow camera zoom in" produces better results than "cat looking outside."
  </Accordion>

  <Accordion title="What does prompt expansion do?">
    When enabled (default), the AI optimizer expands shorter prompts into detailed video scripts. This is useful when you have a simple idea but want richer video output. Disable it if you want precise control over exactly what the model generates.
  </Accordion>

  <Accordion title="What are the rate limits for WAN 2.5 Text-to-Video?">
    Rate limits vary by subscription tier. See [Rate Limits](/ratelimits) for current limits.
  </Accordion>

  <Accordion title="How much does WAN 2.5 Text-to-Video cost?">
    See the [Pricing page](/pricing) for current rates and subscription options.
  </Accordion>

  <Accordion title="What is the difference between WAN 2.5 and WAN 2.6?">
    WAN 2.5 Text-to-Video offers 480p, 720p, and 1080p resolution options with prompt expansion. WAN 2.6 provides enhanced quality and is available for both text-to-video and image-to-video workflows. Choose WAN 2.5 for more resolution flexibility; choose WAN 2.6 for the latest quality improvements.
  </Accordion>
</AccordionGroup>

## Best practices

* **Prompt writing**: Be specific about scenes, camera movements, lighting, and subject actions. Detailed prompts produce better results than vague descriptions.
* **Resolution selection**: Start with 480p for rapid iteration, then switch to higher resolutions for final output.
* **Duration choice**: Use 5-second clips for quick previews; 10-second clips allow more complex motion and narrative development.
* **Negative prompts**: Include common issues to avoid: "blurry, low quality, watermark, text, distortion, extra limbs."
* **Reproducibility**: Save the seed value if you like a result and want to generate variations with similar characteristics.
* **Production integration**: Use webhooks for scalable applications instead of polling.
* **Error handling**: Implement retry with exponential backoff for 503 errors during high-demand periods.

## Related APIs

* **[WAN 2.6 Text-to-Video](/api-reference/text-to-video/wan-v2-6-720p)**: Latest WAN generation with enhanced quality at 720p and 1080p
* **[WAN 2.5 Image-to-Video](/api-reference/image-to-video/wan-2-5-i2v-480p)**: Generate video from an existing image with WAN 2.5
* **[WAN 2.6 Image-to-Video](/api-reference/image-to-video/wan-v2-6-720p)**: Latest WAN generation for image-to-video at 720p and 1080p
* **[LTX 2 Pro Text-to-Video](/api-reference/text-to-video/ltx-2-pro)**: Alternative text-to-video model with different style characteristics


# WAN 2.5 T2V 1080p - Get task status
Source: https://docs.freepik.com/api-reference/wan-2-5-t2v/task-by-id-1080p

get /v1/ai/text-to-video/wan-2-5-t2v-1080p/{task-id}
Get the status of a WAN 2.5 Text-to-Video 1080p task



# WAN 2.5 T2V 480p - Get task status
Source: https://docs.freepik.com/api-reference/wan-2-5-t2v/task-by-id-480p

get /v1/ai/text-to-video/wan-2-5-t2v-480p/{task-id}
Get the status of a WAN 2.5 Text-to-Video 480p task



# WAN 2.5 T2V 720p - Get task status
Source: https://docs.freepik.com/api-reference/wan-2-5-t2v/task-by-id-720p

get /v1/ai/text-to-video/wan-2-5-t2v-720p/{task-id}
Get the status of a WAN 2.5 Text-to-Video 720p task



# WAN 2.6 Video – Image-to-Video & Text-to-Video API
Source: https://docs.freepik.com/api-reference/wan-v2-6-i2v/overview

Generate high-quality AI videos from images or text with WAN 2.6. 720p and 1080p resolutions, 5-15 second durations, multi-shot sequences, and prompt expansion for cinematic results.

<Card title="Alibaba WAN 2.6 integration" icon="video">
  WAN 2.6 is Alibaba's latest video generation model, delivering smooth motion, high visual fidelity, and advanced features like multi-shot sequences and AI prompt expansion.
</Card>

WAN 2.6 is a versatile AI video generation API that supports both image-to-video (i2v) and text-to-video (t2v) workflows. It generates cinematic videos with smooth motion, strong temporal consistency, and detailed visuals at 720p or 1080p resolution. The model offers durations of 5, 10, or 15 seconds and includes advanced features like prompt expansion and multi-shot composition for richer narratives.

### Key capabilities

* **Dual input modes**: Generate video from an image (i2v) or purely from text (t2v)
* **Resolution options**: 720p (1280x720) and 1080p (1920x1080) in landscape or portrait
* **Flexible durations**: 5, 10, or 15 second video outputs
* **Prompt expansion**: AI optimizer expands short prompts into detailed scripts for richer output
* **Multi-shot sequences**: Break prompts into multiple shots for narrative depth (requires prompt expansion)
* **Negative prompts**: Exclude unwanted elements like watermarks, blur, or distortion
* **Reproducible results**: Fixed seed support for consistent generation
* **Async processing**: Webhook notifications or polling for task completion

### Use cases

* **Marketing videos**: Create product showcases and brand content from images or descriptions
* **Social media content**: Generate short-form videos for TikTok, Instagram, and YouTube
* **Concept visualization**: Transform static designs or ideas into motion
* **Storyboarding**: Use multi-shot mode to prototype narrative sequences
* **Educational content**: Illustrate concepts with AI-generated video explanations
* **Creative exploration**: Experiment with text prompts to generate unique visual content

### Generation modes

| Mode                     | Input              | Best for                                                             |
| ------------------------ | ------------------ | -------------------------------------------------------------------- |
| **Image-to-Video (i2v)** | Image URL + prompt | Animating existing images, product videos, bringing artwork to life  |
| **Text-to-Video (t2v)**  | Text prompt only   | Creating videos from scratch, concept exploration, narrative content |

### Resolution variants

| Variant             | Resolution | Orientation | Use case                        |
| ------------------- | ---------- | ----------- | ------------------------------- |
| **720p Landscape**  | 1280x720   | Horizontal  | Web videos, presentations       |
| **720p Portrait**   | 720x1280   | Vertical    | Social media stories, mobile    |
| **1080p Landscape** | 1920x1080  | Horizontal  | High-quality marketing, YouTube |
| **1080p Portrait**  | 1080x1920  | Vertical    | Premium social content, ads     |

## API Operations

### Image-to-Video (i2v)

Generate videos from an input image with motion guidance via prompts.

<div>
  <Columns>
    <Card title="POST i2v 720p" icon="video" href="/api-reference/image-to-video/wan-v2-6-720p">
      Generate 720p video from image
    </Card>

    <Card title="GET i2v 720p task" icon="magnifying-glass" href="/api-reference/wan-v2-6-i2v/task-by-id-720p">
      Check 720p task status
    </Card>

    <Card title="POST i2v 1080p" icon="video" href="/api-reference/image-to-video/wan-v2-6-1080p">
      Generate 1080p video from image
    </Card>

    <Card title="GET i2v 1080p task" icon="magnifying-glass" href="/api-reference/wan-v2-6-i2v/task-by-id-1080p">
      Check 1080p task status
    </Card>
  </Columns>
</div>

### Text-to-Video (t2v)

Generate videos purely from text descriptions without an input image.

<div>
  <Columns>
    <Card title="POST t2v 720p" icon="video" href="/api-reference/text-to-video/wan-v2-6-720p">
      Generate 720p video from text
    </Card>

    <Card title="GET t2v 720p task" icon="magnifying-glass" href="/api-reference/wan-v2-6-t2v/task-by-id-720p">
      Check 720p task status
    </Card>

    <Card title="POST t2v 1080p" icon="video" href="/api-reference/text-to-video/wan-v2-6-1080p">
      Generate 1080p video from text
    </Card>

    <Card title="GET t2v 1080p task" icon="magnifying-glass" href="/api-reference/wan-v2-6-t2v/task-by-id-1080p">
      Check 1080p task status
    </Card>
  </Columns>
</div>

### Parameters

| Parameter                 | Type      | Required | Default    | Description                                                         |
| ------------------------- | --------- | -------- | ---------- | ------------------------------------------------------------------- |
| `prompt`                  | `string`  | Yes      | -          | Scene description, motion, camera moves, style. Max 2000 characters |
| `image`                   | `string`  | i2v only | -          | URL of the keyframe image to animate (JPEG, PNG, WebP)              |
| `size`                    | `string`  | No       | `1280*720` | Output size: `1280*720`, `720*1280`, `1920*1080`, `1080*1920`       |
| `duration`                | `string`  | No       | `5`        | Video length: `5`, `10`, or `15` seconds                            |
| `negative_prompt`         | `string`  | No       | -          | Elements to avoid (e.g., "blurry, watermark"). Max 1000 characters  |
| `enable_prompt_expansion` | `boolean` | No       | `false`    | Enable AI to expand prompts into detailed scripts                   |
| `shot_type`               | `string`  | No       | `single`   | `single` for continuous shot, `multi` for scene transitions         |
| `seed`                    | `integer` | No       | `-1`       | Random seed for reproducibility (-1 for random)                     |
| `webhook_url`             | `string`  | No       | -          | URL for async status notifications                                  |

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is WAN 2.6 and what can it do?">
    WAN 2.6 is Alibaba's video generation model that creates AI videos from images (i2v) or text prompts (t2v). It produces smooth, cinematic videos up to 15 seconds at 720p or 1080p resolution with features like multi-shot sequences and prompt expansion for richer narratives.
  </Accordion>

  <Accordion title="What is the difference between image-to-video and text-to-video modes?">
    Image-to-video (i2v) animates an existing image you provide, giving you control over the visual starting point. Text-to-video (t2v) generates videos purely from text descriptions, creating visuals entirely from your prompt without an input image.
  </Accordion>

  <Accordion title="What video durations does WAN 2.6 support?">
    WAN 2.6 supports 5, 10, and 15 second durations. Shorter durations (5s) generate faster, while longer durations (15s) allow for more developed scenes and narratives.
  </Accordion>

  <Accordion title="What resolutions are available?">
    WAN 2.6 offers 720p (1280x720) and 1080p (1920x1080) in both landscape and portrait orientations. Use 720p for faster generation and 1080p for higher quality output.
  </Accordion>

  <Accordion title="What is prompt expansion and when should I use it?">
    Prompt expansion uses AI to transform short, simple prompts into detailed scripts before generation. Enable it when you have a basic idea but want richer, more cinematic output. It is required for multi-shot mode.
  </Accordion>

  <Accordion title="What is multi-shot mode?">
    Multi-shot mode (`shot_type: multi`) breaks your prompt into multiple scene transitions, creating a narrative sequence instead of a single continuous shot. It requires `enable_prompt_expansion: true`.
  </Accordion>

  <Accordion title="How long does video generation take?">
    Generation time varies by resolution, duration, and server load. Typical processing ranges from 30 seconds to several minutes. Use webhooks for production workflows instead of polling.
  </Accordion>

  <Accordion title="What are the rate limits for WAN 2.6?">
    Rate limits depend on your subscription tier. See the [Rate Limits](/ratelimits) page for current limits by plan.
  </Accordion>

  <Accordion title="How much does WAN 2.6 cost?">
    Pricing varies by resolution and duration. See the [Pricing](/pricing) page for current rates and credit costs.
  </Accordion>

  <Accordion title="What image formats are supported for i2v?">
    Image-to-video accepts JPEG, PNG, and WebP images via publicly accessible URLs. Use high-quality images with clear subjects for best results.
  </Accordion>
</AccordionGroup>

## Best practices

* **Prompt writing**: Be specific about scenes, camera movements (zoom, pan, tilt), lighting, and atmosphere for better results
* **Image selection (i2v)**: Use high-resolution images with clear subjects and balanced lighting; avoid compressed or noisy inputs
* **Negative prompts**: Always include common artifacts to avoid: "blurry, low quality, watermark, text, distortion"
* **Duration selection**: Start with 5 seconds for quick iterations, then increase to 10-15s for final outputs
* **Prompt expansion**: Enable for short prompts or when you want the AI to add cinematic details
* **Multi-shot planning**: For multi-shot mode, structure your prompt with clear scene descriptions
* **Production integration**: Use webhooks for scalable applications instead of polling
* **Reproducibility**: Save the `seed` value from successful generations to recreate similar results

## Related APIs

* **[WAN 2.5](/api-reference/image-to-video/wan-2-5/task-by-id-720p)**: Previous WAN version with 480p, 720p, and 1080p options
* **[Kling 2.5 Turbo Pro](/api-reference/image-to-video/kling-v2.5-pro/overview)**: Alternative i2v model with cinematic quality
* **[Kling Pro v2.1](/api-reference/image-to-video/kling-v2.1-pro/overview)**: High-fidelity i2v with expressive motion
* **[PixVerse V5](/api-reference/image-to-video/pixverse/overview)**: Fast i2v with style consistency


# WAN 2.6 T2V 1080p - Get task status
Source: https://docs.freepik.com/api-reference/wan-v2-6-t2v/task-by-id-1080p

get /v1/ai/text-to-video/wan-v2-6-1080p/{task-id}
Get the status of a WAN 2.6 Text-to-Video 1080p task



# WAN 2.6 T2V 720p - Get task status
Source: https://docs.freepik.com/api-reference/wan-v2-6-t2v/task-by-id-720p

get /v1/ai/text-to-video/wan-v2-6-720p/{task-id}
Get the status of a WAN 2.6 Text-to-Video 720p task



# Authentication
Source: https://docs.freepik.com/authentication

Learn how to authenticate your requests to the Freepik API

## API Key Authentication

Freepik API uses API keys to authenticate requests. You need to include your API key in the header of every API request to access the Freepik resources.

Currently, private API keys are the only way to authenticate with the Freepik API. This means that only server-to-server calls can be made to the API

All API endpoints are authenticated using API keys and picked up from the specification file.

<div>
  <Columns>
    <Card title="Freepik API" icon="leaf" href="https://storage.googleapis.com/fc-freepik-pro-rev1-eu-api-specs/freepik-api-v1-openapi.yaml">
      Download the OpenAPI specification file
    </Card>
  </Columns>
</div>

## Obtaining an API Key

To get an API key:

1. Sign up for a Freepik account at [freepik.com/api](https://www.freepik.com/api)
2. If you are already registered, visit the API dashboard at [freepik.com/developers/dashboard](https://www.freepik.com/developers/dashboard)
3. Look for the API key section and generate a new API key

<div>
  <Card icon="circle-exclamation" title="Keep your API key secure and do not share it publicly.">
    If you believe your key has been compromised, please contact us and we will generate a new one for you.
  </Card>
</div>

## Using the API Key

Include your API key in the `x-freepik-api-key` header of your HTTP requests:

```bash theme={null}
curl -H "x-freepik-api-key: YOUR_API_KEY" https://api.freepik.com/v1/resources
```

<CodeGroup>
  ```javascript JavaScript theme={null}
  const axios = require('axios');

  const response = await axios.get('https://api.freepik.com/v1/resources', {
    headers: {
      'x-freepik-api-key': 'YOUR_API_KEY'
    }
  });
  ```

  ```python Python theme={null}
  import requests

  headers = {
      'x-freepik-api-key': 'YOUR_API_KEY'
  }

  response = requests.get('https://api.freepik.com/v1/resources', headers=headers)
  ```

  ```ruby Ruby theme={null}
  require 'net/http'
  require 'uri'

  uri = URI.parse('https://api.freepik.com/v1/resources')
  request = Net::HTTP::Get.new(uri)
  request['x-freepik-api-key'] = 'YOUR_API_KEY'

  response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
    http.request(request)
  end
  ```
</CodeGroup>

## Rate limiting

Be aware that API requests are subject to [rate limiting](/ratelimits). The specific limits may vary based on your account type and agreement with Freepik. Always check the API response headers for rate limit information.


# Changelog
Source: https://docs.freepik.com/changelog/2024

This section documents changes to the Freepik API, including all patch updates, bug fixes, new version releases, version deprecations, versions unsets, etc.

<Update label="October 17, 2024">
  ### Mystic AI: Enhanced High-Resolution Image Generation

  We've made significant improvements to our Mystic Image Generation mode, offering advanced text-to-image generation with higher resolution outputs and fine-tuned controls.

  * **POST /v1/ai/mystic**: Enhanced high-resolution image generation with advanced controls

  <Icon icon="book" /> [Go to the docs](/api-reference/mystic/post-mystic)
</Update>

<Update label="October 16, 2024">
  ### Text-to-Image Classic Fast Model: Image Size Parameter Updates

  We've made important changes to the image size parameters for our Text-to-Image Classic Fast model for generating images with AI. These updates provide more precise aspect ratio information and improve clarity for our users.

  * **POST /v1/ai/text-to-image**: Updated with new image size parameters and aspect ratio controls

  <Icon icon="book" /> [Go to the docs](/api-reference/text-to-image)
</Update>

<Update label="September 26, 2024">
  ### Image Relight on Freepik API

  We're excited to announce the launch of our new Image Relight feature on the API! This powerful feature allows you to transform the lighting of your images using advanced AI algorithms.

  * **POST /v1/ai/image-relight**: Transform scene lighting using text prompts, reference images, or custom light maps

  <Icon icon="book" /> [Go to the docs](/api-reference/image-relight/post-image-relight)
</Update>

<Update label="September 16, 2024">
  ### Image Upscaler on Freepik API

  We're excited to announce the launch of our new Image Upscaler API! This powerful tool allows you to enhance your images using advanced AI algorithms, providing higher resolution and improved quality.

  * **POST /v1/ai/image-upscaler**: Upscale images to 2x, 4x, 8x, or 16x their original size

  <Icon icon="book" /> [Go to the docs](/api-reference/image-upscaler-creative/post-image-upscaler)
</Update>


# Changelog
Source: https://docs.freepik.com/changelog/2025

This section documents changes to the Freepik API, including all patch updates, bug fixes, new version releases, version deprecations, versions unsets, etc.

<Update label="December 15, 2025">
  ### AI Skin Enhancer Modes (Creative, Faithful, Flexible)

  Add AI skin enhancement endpoints for portraits with Creative, Faithful, and Flexible modes, returning task-based results for simple async integration.

  * **POST /v1/ai/skin-enhancer/flexible**: Skin enhancer using AI (Flexible)
  * **POST /v1/ai/skin-enhancer/faithful**: Skin enhancer using AI (Faithful)
  * **POST /v1/ai/skin-enhancer/creative**: Skin enhancer using AI (Creative)

  <Icon icon="book" /> [Go to the docs](/api-reference/skin-enhancer)
</Update>

<Update label="October 23, 2025">
  ### Upscale With Precision An Image With Magnific

  Get ready for something amazing! We're thrilled to announce our new upscale with precision an image with magnific that will revolutionize how you enhance your images with AI-powered upscaling in your applications.

  * **POST /v1/ai/image-upscaler-precision-v2**: Upscale with precision an image with Magnific V2

  <Icon icon="book" /> [Go to the docs](/api-reference/image-upscaler-precision-v2)
</Update>

<Update label="October 20, 2025">
  ### Generate Sound Effects From Text

  We're delighted to unveil our new generate sound effects from text! This game-changing addition to our API makes generate content with AI-powered technology more accessible and powerful than ever before.

  * **POST /v1/ai/sound-effects**: Generate sound effects from text

  <Icon icon="book" /> [Go to the docs](/api-reference/sound-effects)
</Update>

<Update label="October 10, 2025">
  ### Improve Prompt

  We've added 3 new endpoints to enhance our API capabilities across multiple services for improving AI generation prompts.

  * **POST /v1/ai/improve-prompt**: Improve AI generation prompts

  <Icon icon="book" /> [Go to the docs](/api-reference/improve-prompt)
</Update>

<Update label="September 29, 2025">
  ### Image To Prompt

  We've added 3 new endpoints to enhance our API capabilities across multiple services for generating AI prompts from images.

  * **POST /v1/ai/image-to-prompt**: Generate AI prompt from image

  <Icon icon="book" /> [Go to the docs](/api-reference/image-to-prompt)
</Update>

<Update label="September 25, 2025">
  ### Text to Image - Flux Pro 1.1

  We've added 6 new endpoints to enhance our API capabilities across multiple services for text-to-image generation and lip-sync video generation.

  * **POST /v1/ai/text-to-image/flux-pro-v1-1**: Create image from text - Flux pro 1.1

  <Icon icon="book" /> [Go to the docs](/api-reference/text-to-image)
</Update>

<Update label="September 23, 2025">
  ### Image to Video - Kling 2.5 Pro

  We've added 3 new endpoints to enhance our API capabilities across multiple services for creating videos from images.

  * **POST /v1/ai/image-to-video/kling-v2-5-pro**: Create a video from an image - Kling 2.5 pro model

  <Icon icon="book" /> [Go to the docs](/api-reference/image-to-video)
</Update>

<Update label="September 22, 2025">
  ### Image to Video - PixVerse V5 Transition

  We've added 3 new endpoints to enhance our API capabilities across multiple services for video transitions.

  * **POST /v1/ai/image-to-video/pixverse-v5-transition**: Video transition using PixVerse-V5

  <Icon icon="book" /> [Go to the docs](/api-reference/image-to-video)
</Update>

<Update label="September 17, 2025">
  ### Image to Video - PixVerse V5

  We've added 6 new endpoints to enhance our API capabilities across multiple services for video extensions.

  * **POST /v1/ai/image-to-video/pixverse-v5**: Video extension using PixVerse-V5

  <Icon icon="book" /> [Go to the docs](/api-reference/image-to-video)
</Update>

<Update label="September 9, 2025">
  ### Text to Image - Seedream V4

  We've added 6 new endpoints to enhance our API capabilities across multiple services for text-to-image generation and editing.

  * **POST /v1/ai/text-to-image/seedream-v4**: Create image from text - Seedream v4

  <Icon icon="book" /> [Go to the docs](/api-reference/text-to-image)
</Update>

<Update label="August 25, 2025">
  ### Text to Image - Gemini 2.5 Flash

  We've added 3 new endpoints to enhance our API capabilities across multiple services for image generation and editing.

  * **POST /v1/ai/gemini-2-5-flash-image-preview**: Image generation and editing using Gemini 2.5 Flash

  <Icon icon="book" /> [Go to the docs](/api-reference/text-to-image)
</Update>

<Update label="August 21, 2025">
  ### Text to Image - Seedream

  We've added 12 new endpoints to enhance our API capabilities across multiple services for text-to-image generation and image-to-video conversion.

  * **POST /v1/ai/text-to-image/seedream**: Create image from text - Seedream

  <Icon icon="book" /> [Go to the docs](/api-reference/text-to-image)
</Update>

<Update label="August 20, 2025">
  ### Text to Image - Seedream

  We've added 3 new endpoints to enhance our API capabilities across multiple services for text-to-image generation.

  * **POST /v1/ai/text-to-image/seedream**: Create image from text - Seedream

  <Icon icon="book" /> [Go to the docs](/api-reference/text-to-image)
</Update>

<Update label="August 20, 2025">
  ### Text to Image - HyperFlux

  We've added 3 new endpoints to enhance our API capabilities across multiple services for image generation.

  * **POST /v1/ai/text-to-image/hyperflux**: Image generation using HyperFlux

  <Icon icon="book" /> [Go to the docs](/api-reference/text-to-image)
</Update>

<Update label="August 8, 2025">
  ### Image Upscaler Precision

  We've added 3 new endpoints to enhance our API capabilities across multiple services for precision image upscaling.

  * **POST /v1/ai/image-upscaler-precision**: Upscales an image while adding new visual elements or details

  <Icon icon="book" /> [Go to the docs](/api-reference/image-upscaler-precision/post-image-upscaler-precision)
</Update>

<Update label="August 6, 2025">
  ### Image to Video - Seedance Pro

  We've added 15 new endpoints to enhance our API capabilities across multiple services for creating videos from images.

  * **POST /v1/ai/image-to-video/seedance-pro-1080p**: Create a video from image - Seedance Pro 1080p

  <Icon icon="book" /> [Go to the docs](/api-reference/image-to-video)
</Update>

<Update label="July 4, 2025">
  ### Image to Video - MiniMax Hailuo-02

  We've added 6 new endpoints to enhance our API capabilities across multiple services for creating videos from text/images.

  * **POST /v1/ai/image-to-video/minimax-hailuo-02-1080p**: Create a video from text/image - MiniMax Hailuo-02 1080p

  <Icon icon="book" /> [Go to the docs](/api-reference/image-to-video)
</Update>

<Update label="June 17, 2025">
  ### Text to Icon

  We've added 2 new endpoints to enhance our API capabilities across multiple services for AI icon generation.

  * **POST /v1/ai/text-to-icon/preview**: AI Icon generation

  <Icon icon="book" /> [Go to the docs](/api-reference/icon-generation/post-preview)
</Update>

<Update label="June 9, 2025">
  ### Image to Video - Kling 2.1 Master

  We've added 3 new endpoints to enhance our API capabilities across multiple services for creating videos from images.

  * **POST /v1/ai/image-to-video/kling-v2-1-master**: Create a video from an image - Kling 2.1 master model

  <Icon icon="book" /> [Go to the docs](/api-reference/image-to-video)
</Update>


# Changelog
Source: https://docs.freepik.com/changelog/2026

This section documents changes to the Freepik API, including all patch updates, bug fixes, new version releases, version deprecations, versions unsets, etc.

<Update label="April 3, 2026">
  ### WAN 2.7 - Video Generation, Editing, and Reference API

  Generate AI videos with WAN 2.7, Alibaba's latest video model. Four endpoint categories: text-to-video, image-to-video (with video continuation), reference-to-video for character-consistent generation, and video editing with style transfer. All categories support 720P and 1080P resolution, audio-guided generation, and automatic prompt expansion.

  * **POST /v1/ai/text-to-video/wan-2-7**: Generate video from a text prompt (2-15 seconds)
  * **POST /v1/ai/image-to-video/wan-2-7**: Generate video from image, first+last frame, or extend a video (2-15 seconds)
  * **POST /v1/ai/reference-to-video/wan-2-7**: Generate video featuring characters from reference images/videos (2-10 seconds)

  <Icon icon="book" /> [T2V docs](/api-reference/text-to-video/wan-2-7/overview) | [I2V docs](/api-reference/image-to-video/wan-2-7/overview) | [R2V docs](/api-reference/reference-to-video/wan-2-7/overview)
</Update>

<Update label="April 3, 2026">
  ### Veed Fabric 1.0 and Veed Fabric 1.0 Fast - Lip Sync API

  Generate realistic talking videos from a portrait image and audio file with Veed Fabric 1.0. Two variants available: standard for highest quality and Fast for reduced generation time. Output at 720p or 480p resolution in MP4 format.

  * **POST /v1/ai/lip-sync/veed-fabric-1-0**: Generate a lip-synced talking video
  * **POST /v1/ai/lip-sync/veed-fabric-1-0-fast**: Generate a lip-synced talking video (faster processing)
  * **GET /v1/ai/lip-sync/veed-fabric-1-0**: List all Veed Fabric 1.0 tasks
  * **GET /v1/ai/lip-sync/veed-fabric-1-0-fast**: List all Veed Fabric 1.0 Fast tasks

  <Icon icon="book" /> [Veed Fabric 1.0 docs](/api-reference/lip-sync/veed-fabric-1-0/overview) | [Veed Fabric 1.0 Fast docs](/api-reference/lip-sync/veed-fabric-1-0-fast/overview)
</Update>

<Update label="March 26, 2026">
  ### Video Upscaler Precision - AI Video Upscaling API

  AI diffusion-based precision video upscaling with faithful detail recovery. Supports output resolutions of 1K, 2K, and 4K with adjustable sharpening, smart grain, and upscaling strength controls. FPS boost available for smoother motion.

  * **POST /v1/ai/video-upscaler-precision**: Create a precision video upscaling task
  * **GET /v1/ai/video-upscaler-precision**: List all precision upscaler tasks
  * **GET /v1/ai/video-upscaler-precision/**: Get task status and results

  <Icon icon="book" /> [Go to the docs](/api-reference/video/video-upscaler-precision/overview)
</Update>

<Update label="March 11, 2026">
  ### Kling 3 Motion Control - Video Generation API

  Transfer motion from reference videos to character images with Kling 3 Motion Control. Preserves character appearance while applying motion patterns from 3-30 second reference videos. Available in Pro and Standard tiers.

  * **POST /v1/ai/video/kling-v3-motion-control-pro**: Generate motion-controlled video with Kling 3 Pro
  * **POST /v1/ai/video/kling-v3-motion-control-std**: Generate motion-controlled video with Kling 3 Standard

  <Icon icon="book" /> [Go to the docs](/api-reference/video/kling-v3-motion-control/overview)
</Update>

<Update label="March 10, 2026">
  ### Sound Effects API

  Search, filter, and download royalty-free sound effects from the Freepik catalog. Browse 42 categories including ambience, foley, and transitions with full-text search, category filtering, and flexible sorting.

  * **GET /v1/sfx**: Search and filter sound effects
  * **GET /v1/sfx/download**: Download a sound effect audio file

  <Icon icon="book" /> [Go to the docs](/api-reference/sfx/overview)
</Update>

<Update label="March 9, 2026">
  ### Music API

  Search, filter, and download royalty-free music from the Freepik Music catalog. Filter by genre, mood, and premium status with sorting by relevance, popularity, duration, or tempo.

  * **GET /v1/music**: Search and filter music
  * **GET /v1/music/download**: Download a music audio file

  <Icon icon="book" /> [Go to the docs](/api-reference/music/overview)
</Update>

<Update label="March 3, 2026">
  ### Nano Banana Pro Flash - Text To Image API

  Generate images from text with Nano Banana Pro Flash, powered by Google's Gemini 3.1 Flash model. Faster generation with Google Search grounding for real-world accuracy, reference image support (up to 3 images), 10 aspect ratios, and resolutions up to 4K.

  * **POST /v1/ai/text-to-image/nano-banana-pro-flash**: Create a new image generation task
  * **GET /v1/ai/text-to-image/nano-banana-pro-flash**: List all Nano Banana Pro Flash tasks
  * **GET /v1/ai/text-to-image/nano-banana-pro-flash/task-id**: Get task status and results by ID

  <Icon icon="book" /> [Go to the docs](/api-reference/text-to-image/nano-banana-pro-flash/overview)
</Update>

<Update label="February 27, 2026">
  ### Video Upscaler Turbo Endpoint and Frame-Based Pricing

  New dedicated Turbo endpoint for Video Upscaler with faster processing and premium quality automatically applied. Pricing model updated to frame-based billing that varies by output resolution. The `turbo` and `premium_quality` parameters have been removed from the standard endpoint in favor of the separate Turbo path. Turbo tasks use the same list and get-task endpoints as standard tasks.

  * **POST /v1/ai/video-upscaler/turbo**: Create a turbo video upscaling task

  <Icon icon="book" /> [Go to the docs](/api-reference/video/video-upscaler/overview)
</Update>

<Update label="February 27, 2026">
  ### Runway Gen 4.5 - Video Generation API

  Generate high-quality AI videos from text prompts or images with Runway Gen 4.5. Supports both text-to-video and image-to-video workflows with async task processing, polling, and webhook notifications.

  * **POST /v1/ai/text-to-video/runway-4-5**: Generate video from a text prompt
  * **POST /v1/ai/image-to-video/runway-4-5**: Generate video from an image

  <Icon icon="book" /> [Go to the docs](/api-reference/video/runway-gen-4-5/overview)
</Update>

<Update label="February 11, 2026">
  ### Change Camera - Image Perspective API

  Transform the camera angle and perspective of any image with AI. Control horizontal rotation (0-360 degrees), vertical tilt (-30 to 90 degrees), and zoom level (0-10) to generate multi-angle views from a single photo.

  * **POST /v1/ai/image-change-camera**: Create a new camera angle transformation task

  <Icon icon="book" /> [Go to the docs](/api-reference/image-change-camera/overview)
</Update>

<Update label="February 10, 2026">
  ### Seedream V4.5 – Image Expand API

  Outpaint and expand images with Seedream V4.5 by setting per-edge pixel growth. Optional prompt guidance with async tasks, polling, and webhooks support.

  * **POST /v1/ai/image-expand/seedream-v4-5**: Expand an image beyond its boundaries using Seedream V4.5 outpainting

  <Icon icon="book" /> [Go to the docs](/api-reference/image-expand/post-seedream-v4-5)
</Update>

<Update label="February 10, 2026">
  ### Ideogram Image Edit – Inpainting API

  Edit images with Ideogram inpainting using masks and prompts. Choose TURBO/DEFAULT/QUALITY modes, MagicPrompt, and async tasks with webhooks and polling.

  * **POST /v1/ai/ideogram-image-edit**: Inpaint and edit an image using a mask plus a prompt with Ideogram Image Edit

  <Icon icon="book" /> [Go to the docs](/api-reference/ideogram-image-edit/post-ideogram-image-edit)
</Update>

<Update label="February 9, 2026">
  ### Ideogram Image Expand API

  Expand images beyond their original boundaries with AI-powered outpainting using the Ideogram model. Control expansion independently on each edge (left, right, top, bottom) up to 2048 pixels, with optional prompt guidance and auto-prompt generation.

  * **POST /v1/ai/image-expand/ideogram**: Create a new image expansion task

  <Icon icon="book" /> [Go to the docs](/api-reference/image-expand/ideogram/overview)
</Update>

<Update label="February 5, 2026">
  ### Kling 3 - Video Generation API

  Generate AI videos with Kling 3, the latest video generation model from Kuaishou.

  * **POST /v1/ai/video/kling-v3-pro**: Generate video with Kling 3 Pro
  * **POST /v1/ai/video/kling-v3-std**: Generate video with Kling 3 Standard

  <Icon icon="book" /> [Go to the docs](/api-reference/video/kling-v3/overview)
</Update>

<Update label="January 30, 2026">
  ### Google Veo 3.1 Reference-to-Video API

  Generate videos with consistent characters and objects using reference images. Maintain visual identity across scenes for storytelling and multi-scene projects.

  * **POST /v1/ai/reference-to-video/veo-3-1**: Create video with reference images
  * **GET /v1/ai/reference-to-video/veo-3-1**: List all reference-to-video tasks
  * **GET /v1/ai/reference-to-video/veo-3-1/task-id**: Get task status and results

  **Features:**

  * Character/object consistency using 1-3 reference images
  * Multi-resolution output: 720p, 1080p, or 4K
  * Native audio generation with dialogue and sound effects
  * Fixed 8-second duration at 24 FPS
  * Aspect ratios: 16:9 (landscape) or 9:16 (portrait)
  * Up to 20,000 character prompts

  **Use cases:** Multi-scene storytelling, brand mascot videos, product showcases, character animation, episodic content

  <Icon icon="book" /> [Go to the docs](/api-reference/reference-to-video/veo-3-1/overview)
</Update>

<Update label="January 22, 2026">
  ### Nano Banana Pro (Text-to-Image)

  Generate high-quality images with Google's Nano Banana Pro (Gemini 3) model. Supports reference images for guided generation, multiple aspect ratios, and resolution options.

  * **POST /v1/ai/text-to-image/nano-banana-pro**: Create image from text with optional reference images

  **Features:**

  * Up to 3 reference images for guided generation
  * Multiple aspect ratios (1:1, 16:9, 9:16, 4:3, 3:4, etc.)
  * Resolution options: low, medium (default), high (4K)
  * Webhook notifications

  <Icon icon="book" /> [Go to the docs](/api-reference/text-to-image/post-nano-banana-pro)
</Update>


# Welcome to Freepik API
Source: https://docs.freepik.com/introduction



<div>
  <h2>Start Building Today</h2>
  <p>Get your API key now and receive <strong>5 USD in free credits</strong></p>
  <a href="/quickstart">Quick start!</a>
</div>

## Powerful API tools at your fingertips

<div>
  <Columns>
    <Card title="Image generation API" icon="wand-magic-sparkles" href="api-reference/mystic/post-mystic">
      Create custom visuals from text prompts using our state-of-the-art AI models.
    </Card>

    <Card title="Image editing API" icon="up-right-and-down-left-from-center" href="api-reference/image-upscaler-creative/post-image-upscaler">
      Enhance, upscale, relight, and transform images with powerful AI-driven tools.
    </Card>

    <Card title="Video generation API" icon="video" href="api-reference/image-to-video/kling-v2/post-kling-v2">
      Convert static images into dynamic videos with customizable motion effects.
    </Card>

    <Card title="Icon generation API" icon="icons" href="api-reference/icon-generation/post-generate-icon">
      Create stunning icons in different styles from text prompts using our advanced AI models.
    </Card>

    <Card title="AI image classifier API" icon="shapes" href="api-reference/classifier/post-ai-classifier">
      Automatically detect AI-generated content with our advanced classification system.
    </Card>

    <Card title="Stock content API" icon="photo-film" href="api-reference/resources/get-all-resources">
      Access millions of vectors, photos, icons, and templates to enhance your applications.
    </Card>
  </Columns>
</div>

## Why developers choose Freepik API

<div>
  <Card title="Easy integration" icon="layer-group">
    Comprehensive documentation and dedicated support for seamless integration.
  </Card>

  <Card title="Scalable & flexible" icon="rocket">
    From startups to enterprises, our API grows with your needs. Pay only for what you use with transparent, usage-based pricing and no hidden fees.
  </Card>

  <Card title="Robust & reliable" icon="wallet">
    Dependable infrastructure designed for high performance and scalability.
  </Card>
</div>

## LLM-Friendly Documentation

Our documentation is also available in an LLM-friendly format, making it easy to integrate with large language models and AI tools.

You can access it in two ways:

* [llms.txt](https://docs.freepik.com/llms.txt) – A lightweight sitemap that lists all documentation pages.
* [llms-full.txt](https://docs.freepik.com/llms-full.txt) – The full documentation in markdown format. (Note: This may exceed your model’s context window.)

Additionally, any page can be accessed as Markdown by appending .md to the URL.
For example:
[https://docs.freepik.com/introduction](https://docs.freepik.com/introduction) →
[https://docs.freepik.com/introduction.md](https://docs.freepik.com/introduction.md)

## AI Integration with MCP

Want to integrate Freepik directly into your AI assistants like Claude, Cursor, and more? We offer both **open source** and **remote** MCP (Model Context Protocol) solutions that enable seamless search, generation, and resource management from within your AI workflows.

<a href="/modelcontextprotocol">Learn about MCP Integration</a>


# Freepik MCP (Model Context Protocol)
Source: https://docs.freepik.com/modelcontextprotocol



<div>
  <h2>Integrate Freepik into your AI workflows</h2>
  <p>Connect AI assistants like <strong>Claude, Cursor and more</strong> with the Freepik API</p>
  <a href="https://github.com/freepik-company/freepik-mcp">View on GitHub</a>
</div>

## What is Freepik MCP?

Freepik MCP is a server that implements the Model Context Protocol (MCP) to connect AI assistants with the Freepik API. It enables assistants to search, download, and generate images and icons, manage resources, and use AI-powered image classification tools.

<div>
  <Columns>
    <Card title="Content Search" icon="magnifying-glass" href="/api-reference/resources/stock-content">
      Search millions of stock images, icons, and resources directly from your AI assistant.
    </Card>

    <Card title="Content Generation" icon="wand-magic-sparkles" href="/api-reference/mystic/mystic">
      Generate custom images and icons using our state-of-the-art AI models.
    </Card>

    <Card title="Resource Management" icon="folder-open" href="https://docs.freepik.com/api-reference/resources/stock-content">
      Download and manage your favorite resources directly in your workflow.
    </Card>

    <Card title="AI Classification" icon="robot" href="/api-reference/classifier/post-ai-classifier">
      Use AI-powered image classification tools to categorize content.
    </Card>
  </Columns>
</div>

## Remote Version (Beta)

For an even simpler experience, we offer a remote beta version available at `api.freepik.com/mcp` that you can use directly with your Freepik API key. No installation required!

This version uses the **HTTP-stream protocol** to communicate with the remote MCP server.

### Remote Version Benefits

* **No Installation**: Immediate access without local setup
* **Always Updated**: Automatic access to the latest features
* **Easy Configuration**: Only need your API key
* **Zero Maintenance**: We handle everything for you
* **HTTP-stream Protocol**: Secure communication over HTTPS

### Configuration for MCP Clients

Add the MCP configuration below to your MCP client configuration file.

<AccordionGroup>
  <Accordion title="Cursor">
    1. Open full Cursor settings
    2. Navigate to the "MCP" tab
    3. Click "Add new global MCP server"
    4. Add the server config below
    5. Click the refresh button next to the "browsermcp" server to reload the server config

    For more information, see [Cursor's MCP documentation](https://docs.cursor.com/context/model-context-protocol).
  </Accordion>

  <Accordion title="Claude Desktop">
    See [Claude's MCP documentation](https://modelcontextprotocol.io/docs/getting-started/intro)

    <Warning>
      Claude Desktop currently has a [bug](https://github.com/modelcontextprotocol/servers/issues/812) where MCP servers are started twice. This will cause Claude to show an error when using the Browser MCP server but it will still work.
    </Warning>
  </Accordion>

  <Accordion title="Windsurf">
    See [Windsurf's MCP documentation](https://docs.windsurf.com/windsurf/cascade/mcp)
  </Accordion>

  <Accordion title="VS Code">
    See [VS Code's MCP documentation](https://code.visualstudio.com/docs/copilot/chat/mcp-servers)
  </Accordion>
</AccordionGroup>

#### Server configuration

```json theme={null}
{
  "mcpServers": {
    "freepik": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.freepik.com/mcp",
        "--header",
        "x-freepik-api-key:${FREEPIK_API_KEY}"
      ],
      "env": {
        "FREEPIK_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

## Open Source Version

The [Freepik MCP](https://github.com/freepik-company/freepik-mcp) project is available as open source on GitHub, providing full transparency and customization.

This version uses the **stdio protocol** for local communication between your MCP client and the server.

### Key Features

* **Open Source**: Fully transparent and customizable to your needs
* **Easy Installation**: Simple setup with modern tools like `uv`
* **Native Integration**: Compatible with Claude Desktop, Cursor, and other MCP clients
* **Full Functionality**: Access to all Freepik API capabilities
* **Stdio Protocol**: Direct local communication for maximum performance

### Installation

```bash theme={null}
# Clone the repository
git clone https://github.com/freepik-company/freepik-mcp.git
cd freepik-mcp

# Install dependencies with uv
uv sync

# Configure your API key
export FREEPIK_API_KEY="your_api_key_here"
```

### Configuration for Claude Desktop, Cursor & Other MCP Clients

Add this configuration to your MCP client configuration file:

```json theme={null}
{
  "mcpServers": {
    "freepik-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/path/to/freepik-mcp",
        "main.py"
      ],
      "env": {
        "FREEPIK_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

## Getting Started with MCP

<div>
  <Columns>
    <Card title="1. Get your API Key" icon="key" href="/quickstart">
      You need a Freepik API key to use either version of MCP.
    </Card>

    <Card title="2. Choose your Version" icon="code-branch">
      Decide whether you prefer the **open source version** (more control) or the **remote version** (simpler).
    </Card>

    <Card title="3. Configure your Client" icon="gear">
      Follow the configuration instructions for your preferred AI assistant (Claude, Cursor, etc.).
    </Card>

    <Card title="4. Start Creating!" icon="rocket">
      Once configured, you'll be able to search, generate, and download content directly from your assistant.
    </Card>
  </Columns>
</div>

## Support and Contributions

<div>
  <a href="https://github.com/freepik-company/freepik-mcp/wiki">
    <p><Icon icon="book" /> Documentation</p>
  </a>

  <a href="https://github.com/freepik-company/freepik-mcp/issues">
    <p><Icon icon="bugs" /> Issues</p>
  </a>

  <a href="https://github.com/freepik-company/freepik-mcp">
    <p><Icon icon="hand-holding-heart" /> Contributions</p>
  </a>

  <span>
    <p><Icon icon="file" /> MIT License</p>
  </span>
</div>

Have questions or need help? Don't hesitate to open an issue on our GitHub repository or contact our support team.


# Pricing
Source: https://docs.freepik.com/pricing



## Pay‑per‑use, simple and flexible

Only pay for what you generate. No commitments and monthly billing. Start free with trial credits, upgrade anytime, and set a monthly budget from your dashboard. All plans include production access to our AI tools and Freepik’s premium content library.

## Usage & billing controls

Set a monthly cap and track usage in real time from your dashboard. Invoices are issued on the 5th of the following month. For enterprise or high‑volume needs, contact us via the API page.

[View detailed pricing →](https://www.freepik.com/api/pricing)


# Quickstart
Source: https://docs.freepik.com/quickstart

Ready to harness the power of Freepik API?

## Get Started

Follow these steps to begin:

<Steps>
  <Step title="Generate your API key.">
    Visit our [API landing page](https://www.freepik.com/developers/dashboard/api-key) to sign up and get a free API key, plus a 5 USD credit to get started!!
  </Step>

  <Step title="Explore documentation">
    Dive into our comprehensive [API Reference](/api-reference/mystic/post-mystic/) to learn how to integrate our API into your projects effectively.
  </Step>

  <Step title="Start building">
    Start experimenting with our API to access and utilize the vast collection of resources available.
  </Step>

  <Step title="Upgrade your plan">
    To enjoy all our services and greater rate limits, upgrade your plan in the [developers dashboard](https://www.freepik.com/developers/dashboard/billing).
  </Step>

  <Step title="Reach out for support">
    Need assistance or have questions? Contact our dedicated support team via our [support page](https://www.freepik.com/api#contact) for prompt assistance.
  </Step>
</Steps>

<br />


# Rate limiting
Source: https://docs.freepik.com/ratelimits



To ensure the stability and performance of our API, we have implemented rate limiting based on IP address and API key.
This is a crucial security measure to prevent abuse and overuse of the API. Here’s how our rate limiting works:

<Tabs>
  <Tab title="Rate per day">
    Under your contracted `API KEY`, you have the following **daily rate limit** or Requests Per Day (RPD):

    | Service                         | Free RPD | Premium RPD |
    | :------------------------------ | :------: | :---------: |
    | ai-image-generator classic fast |    100   |    10,000   |
    | ai-powered-search               |    300   |      -      |
    | Flux Dev                        |    100   |    3,000    |
    | Flux Pro                        |    100   |    3,000    |
    | Google Imagen 3                 |    100   |    10,000   |
    | icons                           |    25    |    2,500    |
    | ai-icon                         |    25    |      -      |
    | ai-icon-render                  |    27    |      -      |
    | ai-icon-preview                 |    160   |      -      |
    | ai-image-expand-flux-pro        |    100   |    1,250    |
    | ai-image-to-prompt              |    125   |    30,000   |
    | ai-image-upscaler-precision     |    125   |    1,250    |
    | ai-image-upscaler-precision-v2  |    125   |    1,250    |
    | ai-improve-prompt               |    125   |    30,000   |
    | ai-kling-elements-pro-16        |    11    |      50     |
    | ai-kling-elements-std-16        |    20    |      50     |
    | ai-kling-pro                    |    11    |      50     |
    | ai-kling-std                    |    20    |      50     |
    | ai-kling-v2                     |     5    |      50     |
    | ai-kling-v21-master             |     5    |      50     |
    | ai-kling-v21-pro                |    11    |      50     |
    | ai-kling-v21-std                |    20    |      50     |
    | ai-kling-v25-pro                |    11    |      50     |
    | ai-kling-v26-pro                |    11    |      50     |
    | ai-kling-o1-pro                 |     5    |      50     |
    | ai-kling-o1-std                 |     5    |      50     |
    | ai-kling-v26-motion-control-pro |     5    |      50     |
    | ai-kling-v26-motion-control-std |     5    |      50     |
    | ai-latent-sync                  |    20    |     300     |
    | ai-minimax-hailuo02-1080p       |    11    |      50     |
    | ai-minimax-hailuo02-768p        |    20    |      50     |
    | ai-minimax-hailuo23-768p        |     5    |      50     |
    | ai-minimax-hailuo23-1080p       |     5    |      50     |
    | ai-runway-gen4-turbo            |    11    |      50     |
    | ai-t2v-runway-4-5               |     5    |      50     |
    | ai-i2v-runway-4-5               |     5    |      50     |
    | ai-runway-act-two               |    11    |      50     |
    | ai-seedream-v45                 |    500   |     500     |
    | ai-wan-v26-720p                 |    20    |      50     |
    | ai-wan-v26-1080p                |    11    |      50     |
    | ai-mystic                       |    125   |    6,000    |
    | ai-relight                      |    125   |    1,250    |
    | ai-upscaler                     |    125   |    30,000   |
    | images-templates                |    50    |    1,000    |
    | pixverse-v5                     |    125   |    1,250    |
    | pixverse-v5-transition          |    125   |    1,250    |
    | Reimagine flux                  |    100   |    1,000    |
    | Remove background               |    300   |    20,000   |
    | sound-effects                   |    125   |    30,000   |
    | style-transfer                  |    125   |    1,250    |
    | videos                          |    100   |    2,500    |
  </Tab>

  <Tab title="Rate per seconds">
    ### General rate limit

    Our general rate limit policy applies based on `IP address` and allows:

    * **50 hits per second** over a **5-second period**.
      This means that requests originating from the same IP address can make up to 50 API requests per second.
      If you exceed this limit, your requests may be throttled or temporarily blocked. The limit resets every 5 seconds.

    ### Average rate limit

    Additionally, we enforce an average rate limit policy based on IP address:

    * **10 hits per second** averaged over a **2-minute period**.
      This means that over a 2-minute window, the average number of requests from the same IP address should not exceed 10 per second. If you surpass this average rate, your API access might be restricted until your request rate falls back within acceptable limits.
  </Tab>
</Tabs>

<div>
  <Card title="Need a higher rate limit?" icon="circle-info">
    If your application requires a higher rate limit than what's currently provided, we're here to help!
    Please [reach out to our sales](https://www.freepik.com/api#contact) team with details about your use case and expected traffic. We will set you up with a custom plan in no time.
  </Card>
</div>


# Webhooks
Source: https://docs.freepik.com/webhooks

Webhooks are a powerful way to connect different systems and services. Learn about webhooks and how to integrate them securely.

### What are webhooks?

Webhooks are a way for one system to send real-time data to another system. They are a powerful tool for integrating different services and automating workflows. With webhooks, you can receive notifications, updates, and data from external systems without having to poll for changes.

### How do webhooks work?

Webhooks work by allowing you to register a URL with a service that supports them. When an event occurs in the service, it sends an HTTP POST request to the registered URL with relevant data. The receiving system can then process the data and take appropriate actions based on the event.

### Why use webhooks?

Webhooks offer several advantages over traditional polling-based methods:

* **Real-time updates**: Webhooks provide instant notifications, allowing you to react to events as they happen.
* **Efficiency**: They reduce the overhead of constant requests by delivering data only when an event occurs.
* **Automation**: Webhooks trigger automatic workflows, reducing manual processes and streamlining tasks.
* **Seamless integration**: They facilitate easy data exchange between systems, enabling efficient communication between different platforms.

### Common use cases for webhooks

Webhooks are widely used in the following scenarios:

* **Notifications**: Sending real-time alerts and updates to users or systems.
* **Data synchronization**: Ensuring that data remains consistent across multiple platforms.
* **Workflow automation**: Initiating tasks like sending emails, updating databases, or processing transactions based on specific events.

By using webhooks, you can streamline your workflows, improve efficiency, and create seamless integrations between different systems.

## Webhook security

### Why webhook security is important?

Webhooks are a powerful way to connect different systems and services. They allow you to send real-time data from one system to another. However, with great power comes great responsibility. Webhooks can be a security risk if not implemented correctly, as they can be exploited by attackers to send malicious data to your system.

### Webhook security headers

To ensure the integrity and authenticity of incoming webhook requests, we deliver three headers with each request:

* `webhook-id`: A unique identifier for the webhook request. This helps to detect and prevent replay attacks.
* `webhook-timestamp`: A timestamp indicating when the webhook request was sent. This is used to ensure that the request is recent and prevents replay attacks within a specific time window.
* `webhook-signature`: A signature generated using a secret key. This is used to verify the authenticity of the request, ensuring that it was sent by a trusted source.

### Generating the string to sign for verification

You must generate a content string that will be signed and verified. This content is created by concatenating the `webhook-id`, `webhook-timestamp`, and the request body with a period (`.`) separator. You can do this by following these steps:

1. **Retrieve the headers**: Extract the `webhook-id` and `webhook-timestamp` from the request headers.
2. **Access the request body**: Obtain the raw body of the webhook request.
3. **Concatenate the values**: Combine the `webhook-id`, `webhook-timestamp`, and body into a single string using the format mentioned earlier.

Here is an example of how you can generate the content to sign in Python:

<CodeGroup>
  ```python python.py theme={null}
  content_to_sign = f"{webhook_id}.{webhook_timestamp}.{body}"
  ```

  ```javascript javascript.js theme={null}
  const contentToSign = `${webhookId}.${webhookTimestamp}.${body}`;
  ```

  ```php php.php theme={null}
  $content_to_sign = "$webhook_id.$webhook_timestamp.$body";
  ```

  ```java java.java theme={null}
  String contentToSign = webhookId + "." + webhookTimestamp + "." + body;
  ```
</CodeGroup>

### Obtaining the secret key

The secret key is a shared secret between your system and the webhook provider. It is used to generate the signature and verify the authenticity of the request. Make sure to keep the secret key secure and never expose it in your code or configuration files.

To obtain the secret key, you can go to the [User Dashboard](https://www.freepik.com/developers/dashboard/api-key) and generate a new secret key. Copy the secret key and store it securely in your system.

### Generating the signature

For the webhook signature, we use HMAC-SHA256 as the hashing algorithm. You can generate the signature by following these steps:

1. Encode the secret key as bytes.
2. Obtain the HMAC-SHA256 hash as bytes of the content to sign using the secret key.
3. Encode the hash in base64 to get the signature.

Here is an example of how you can generate the signature in Python:

<CodeGroup>
  ```python python.py theme={null}
  import hmac
  import hashlib
  import base64

  def generate_signature(secret_key, content_to_sign):
      secret_key_bytes = secret_key.encode()

      hmac_bytes = hmac.new(secret_key_bytes, content_to_sign.encode(), hashlib.sha256).digest()

      signature = base64.b64encode(hmac_bytes).decode()

      return signature
  ```

  ```javascript javascript.js theme={null}
  const crypto = require('crypto');

  function generateSignature(secretKey, contentToSign) {
      const secretKeyBytes = Buffer.from(secretKey, 'utf-8');

      const hmac = crypto.createHmac('sha256', secretKeyBytes);

      hmac.update(contentToSign);

      const signature = hmac.digest('base64');

      return signature;
  }
  ```

  ```php php.php theme={null}
  function generateSignature($secretKey, $contentToSign) {
      $secretKey = base64_decode($secretKey);

      $hmac = hash_hmac(
          'sha256',
          $contentToSign,
          $secretKey,
          true
      );

      $signature = base64_encode($hmac);

      return $signature;
  }
  ```

  ```java java.java theme={null}
  import javax.crypto.Mac;
  import javax.crypto.spec.SecretKeySpec;
  import java.util.Base64;


  public static String generateSignature(String secretKey, String contentToSign) throws Exception {
      byte[] secretKeyBytes = secretKey.getBytes("UTF-8");

      Mac mac = Mac.getInstance("HmacSHA256");
      SecretKeySpec secretKeySpec = new SecretKeySpec(secretKeyBytes, "HmacSHA256");
      mac.init(secretKeySpec);

      byte[] hmacBytes = mac.doFinal(contentToSign.getBytes("UTF-8"));

      String signature = Base64.getEncoder().encodeToString(hmacBytes);

      return signature;
  }
  ```
</CodeGroup>

The obtained signature must be compared with the `webhook-signature` header in the incoming request to verify the authenticity of the request. If the signatures match, the request is considered valid, and you can process it further.

The `webhook-signature` header is composed of a list of space-delimited signatures and their corresponding version identifiers. This allows you to rotate the secret key without breaking existing webhook integrations. For example, the header might look like this:

```
v1,signature1 v2,signature2
```

You should iterate over the list of signatures and verify each one using the corresponding secret key version. If any of the signatures match, the request is considered valid. For example, you can implement this logic in Python as follows:

<CodeGroup>
  ```python python.py theme={null}
  def verify_signature(generated_signature, header_signatures):
      for signature in header_signatures.split():
          version, expected_signature = signature.split(',')
          if expected_signature == generated_signature:
              return True
      return False
  ```

  ```javascript javascript.js theme={null}
  function verifySignature(generatedSignature, headerSignatures) {
      const signatures = headerSignatures.split(' ');

      for (const signature of signatures) {
          const [version, expectedSignature] = signature.split(',');

          if (expectedSignature === generatedSignature) {
              return true;
          }
      }

      return false;
  }
  ```

  ```php php.php theme={null}
  function verifySignature($generatedSignature, $headerSignatures) {
      $signatures = explode(' ', $headerSignatures);

      foreach ($signatures as $signature) {
          list($version, $expectedSignature) = explode(',', $signature);

          if ($expectedSignature === $generatedSignature) {
              return true;
          }
      }

      return false;
  }
  ```

  ```java java.java theme={null}
  public static boolean verifySignature(String generatedSignature, String headerSignatures) {
      String[] signatures = headerSignatures.split(" ");

      for (String signature : signatures) {
          String[] parts = signature.split(",");
          String version = parts[0];
          String expectedSignature = parts[1];

          if (expectedSignature.equals(generatedSignature)) {
              return true;
          }
      }

      return false;
  }
  ```
</CodeGroup>

By following these steps, you can ensure the security of your webhook implementation and protect your system from unauthorized access and data tampering.


# X402 Web3 Payments
Source: https://docs.freepik.com/x402



<div>
  <div />

  <h2>Pay for AI Image Generation with Web3</h2>
  <p>Seamlessly integrate <strong>cryptocurrency payments</strong> into your AI workflows using Coinbase's x402 protocol</p>
  <a href="https://docs.cdp.coinbase.com/x402/core-concepts/how-it-works">View x402 Documentation</a>
</div>

## What is x402?

X402 is a revolutionary payment protocol developed by Coinbase that enables **programmatic payments over HTTP** using Web3 technologies. It allows applications to request payments for resources in a simple, stateless manner using standard HTTP status codes and headers.

Our integration brings x402 payments to AI image generation, making it possible to pay for premium AI services using cryptocurrency directly through HTTP requests.

<div>
  <Columns>
    <Card title="HTTP-Native Payments" icon="globe">
      Uses standard HTTP 402 status codes and headers for seamless payment integration into existing web infrastructure.
    </Card>

    <Card title="Built for AI Agents" icon="robot">
      Perfect for autonomous AI systems that need to make payments programmatically without human intervention.
    </Card>

    <Card title="Stateless Protocol" icon="shield-check">
      No sessions or complex authentication required. Each payment is self-contained and verifiable.
    </Card>

    <Card title="Developer Friendly" icon="code">
      Simple integration with standard HTTP libraries and familiar request-response patterns.
    </Card>
  </Columns>
</div>

## How X402 Works with Our AI Mystic Endpoint

Our **Mystic** model now supports x402 payments, enabling you to pay for AI image generation using cryptocurrency. Here's how the payment flow works:

### Payment Flow

```mermaid theme={null}
sequenceDiagram
    participant Client
    participant API
    participant Facilitator
    participant Blockchain

    Client->>API: POST /v1/x402/ai/mystic (initial request)
    API-->>Client: HTTP 402 Payment Required + requirements
    Client->>API: POST with X-PAYMENT header
    API->>Facilitator: Verify payment
    Facilitator->>Blockchain: Check on-chain
    Blockchain-->>Facilitator: Payment confirmed
    Facilitator-->>API: Valid payment receipt
    API-->>Client: HTTP 200 + content + X-PAYMENT-RESPONSE
```

<Steps>
  <Step title="Make Initial Request">
    Send a standard HTTP POST request to `/v1/x402/ai/mystic` with your prompt and model parameters.
  </Step>

  <Step title="Receive Payment Requirements">
    Server responds with `HTTP 402 Payment Required` status and payment details including amount, recipient, and network.
  </Step>

  <Step title="Create Payment">
    Your configured wallet automatically creates and signs a payment payload based on the requirements.
  </Step>

  <Step title="Submit Payment">
    The SDK automatically resubmits your request with the `X-PAYMENT` header containing the signed payment.
  </Step>

  <Step title="Verification & Settlement">
    Server verifies the payment with the facilitator and processes it on-chain for transparent settlement.
  </Step>

  <Step title="Receive Content">
    Get your AI-generated image along with settlement details in the `X-PAYMENT-RESPONSE` header.
  </Step>
</Steps>

## Integration Benefits

<CardGroup>
  <Card title="Instant Payments" icon="bolt">
    No waiting for traditional payment processing. Cryptocurrency payments are verified and settled quickly on-chain.
  </Card>

  <Card title="Global Access" icon="earth-americas">
    Accept payments from anywhere in the world without traditional banking restrictions or currency conversions.
  </Card>

  <Card title="Lower Fees" icon="coins">
    Reduced transaction costs compared to traditional payment processors, especially for micro-payments.
  </Card>

  <Card title="Transparent Settlement" icon="magnifying-glass">
    All payments are verifiable on-chain, providing complete transparency and audit trails.
  </Card>
</CardGroup>

## Getting Started

<Steps>
  <Step title="Set Up Your Wallet" icon="wallet">
    Create or connect a Web3 wallet and fund it with USDC on the supported network. Ensure you have enough balance for both payments and gas fees.

    <Note>
      New to Web3 wallets? Check out the <a href="https://docs.cdp.coinbase.com/x402/quickstart-for-buyers#2-create-a-wallet-client">Coinbase guide for creating a wallet</a>.
    </Note>
  </Step>

  <Step title="Install the SDK" icon="cube">
    Add the x402 client library for your programming language. The SDK handles all payment complexity automatically.

    ```bash npm theme={null}
    npm install x402-fetch x402-axios viem
    ```

    ```bash pip theme={null}
    pip install x402 eth-account
    ```
  </Step>

  <Step title="Configure Your Client" icon="gear">
    Initialize your wallet and wrap your HTTP client with the x402 adapter:

    ```javascript theme={null}
    const account = privateKeyToAccount("0xYourPrivateKey");
    const fetchWithPayment = wrapFetchWithPayment(fetch, account);
    ```
  </Step>

  <Step title="Make Your First Request" icon="paper-plane">
    Send a request to `/v1/x402/ai/mystic` - the SDK handles payment automatically:

    ```javascript theme={null}
    const response = await fetchWithPayment(
      "https://api.freepik.com/v1/x402/ai/mystic",
      { method: "POST", body: JSON.stringify({...}) }
    );
    ```
  </Step>
</Steps>

## Implementation Examples

Using the x402 SDKs, payment handling is completely automatic. Just set up your wallet and make requests:

<CodeGroup>
  ```javascript fetch theme={null}
  // Using x402-fetch (Node.js)
  import { wrapFetchWithPayment, decodeXPaymentResponse } from "x402-fetch";
  import { privateKeyToAccount } from "viem/accounts";

  // Set up your wallet
  const account = privateKeyToAccount("0xYourPrivateKey"); // Use env variable

  // Create fetch with automatic payment handling
  const fetchWithPayment = wrapFetchWithPayment(fetch, account);

  // Make request to AI endpoint - payment is automatic!
  const response = await fetchWithPayment("https://api.freepik.com/v1/x402/ai/mystic", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      prompt: "A futuristic city at sunset",
      model: "realism"
    })
  });

  // Get your generated image
  const result = await response.json();
  console.log("Generated image:", result);

  // Optional: Get payment details
  const paymentInfo = decodeXPaymentResponse(
    response.headers.get("x-payment-response")
  );
  console.log("Payment settled:", paymentInfo);
  ```

  ```javascript axios theme={null}
  // Using x402-axios (Node.js)
  import axios from "axios";
  import { withPaymentInterceptor } from "x402-axios";
  import { privateKeyToAccount } from "viem/accounts";

  // Set up your wallet
  const account = privateKeyToAccount("0xYourPrivateKey"); // Use env variable

  // Create axios instance with automatic payment handling
  const api = withPaymentInterceptor(
    axios.create({ baseURL: "https://api.freepik.com" }),
    account
  );

  // Make request - payment is automatic!
  const response = await api.post("/v1/x402/ai/mystic", {
    prompt: "A futuristic city at sunset",
    model: "realism"
  });

  console.log("Generated image:", response.data);
  ```

  ```python requests theme={null}
  # Using x402 with requests (Python)
  import requests
  from eth_account import Account
  from x402.clients.requests import x402_http_adapter

  # Set up your wallet
  account = Account.from_key("your_private_key")  # Use env variable

  # Create session with automatic payment handling
  session = requests.Session()
  adapter = x402_http_adapter(account)
  session.mount("https://", adapter)

  # Make request - payment is automatic!
  response = session.post(
      "https://api.freepik.com/v1/x402/ai/mystic",
      json={
          "prompt": "A futuristic city at sunset",
          "model": "realism"
      }
  )

  print("Generated image:", response.json())

  # Optional: Get payment details from header
  payment_info = response.headers.get("X-PAYMENT-RESPONSE")
  print("Payment settled:", payment_info)
  ```

  ```python httpx theme={null}
  # Using x402 with HTTPX (async Python)
  import httpx
  from eth_account import Account
  from x402.clients.httpx import x402_payment_hooks

  # Set up your wallet
  account = Account.from_key("your_private_key")  # Use env variable

  # Create async client with automatic payment handling
  async with httpx.AsyncClient() as client:
      # Add x402 payment hooks
      client.event_hooks = x402_payment_hooks(account)

      # Make request - payment is automatic!
      response = await client.post(
          "https://api.freepik.com/v1/x402/ai/mystic",
          json={
              "prompt": "A futuristic city at sunset",
              "model": "realism"
          }
      )

      result = await response.json()
      print("Generated image:", result)
  ```
</CodeGroup>

### Installation

<CodeGroup>
  ```bash npm theme={null}
  # For Node.js/JavaScript
  npm install x402-fetch x402-axios viem
  # or
  yarn add x402-fetch x402-axios viem
  ```

  ```bash pip theme={null}
  # For Python
  pip install x402 eth-account httpx
  ```
</CodeGroup>

### Learn More

For complete setup guides including wallet configuration and advanced options, check out the official documentation:

<div>
  <a href="https://docs.cdp.coinbase.com/x402/quickstart-for-buyers#nodejs-viem">
    📦 Node.js Guide
  </a>

  <a href="https://docs.cdp.coinbase.com/x402/quickstart-for-buyers#python-eth-account">
    🐍 Python Guide
  </a>
</div>

## Key Advantages

**For Developers:**

* Simple HTTP-based payment integration
* No complex payment gateway setups
* Standard REST API patterns
* Built-in payment verification

**For Users:**

* Direct cryptocurrency payments
* No account creation required
* Global accessibility
* Transparent, on-chain settlements

**For Businesses:**

* Reduced payment processing costs
* Instant settlement capabilities
* Global market reach
* Programmable payment logic

## Support and Resources

<div>
  <a href="https://docs.cdp.coinbase.com/x402/quickstart-for-sellers">
    <p><Icon icon="book" /> Seller Quickstart</p>
  </a>

  <a href="https://docs.cdp.coinbase.com/x402/quickstart-for-buyers">
    <p><Icon icon="shopping-cart" /> Buyer Quickstart</p>
  </a>

  <a href="https://docs.cdp.coinbase.com/x402/core-concepts/network-support">
    <p><Icon icon="network-wired" /> Network Support</p>
  </a>
</div>

Ready to integrate Web3 payments into your AI workflows? Start by making your first request to `/v1/x402/ai/mystic` and experience the future of programmable payments!