### GET /v1/ai/image-to-video/wan-v2-2-720p

Source: https://docs.magnific.com/api-reference/video/post-kling-4k-i2v

Get the list of WAN 2.2 720p tasks.

```APIDOC
## GET /v1/ai/image-to-video/wan-v2-2-720p

### Description
Get the list of WAN 2.2 720p tasks.

### Method
GET

### Endpoint
/v1/ai/image-to-video/wan-v2-2-720p

### Parameters
#### Query Parameters
- **limit** (integer) - Optional - The maximum number of tasks to return.
- **offset** (integer) - Optional - The number of tasks to skip.

### Response
#### Success Response (200)
- **tasks** (array) - A list of video generation tasks.
  - **task_id** (string) - The ID of the task.
  - **status** (string) - The status of the task.
  - **created_at** (string) - The timestamp when the task was created.

#### Response Example
```json
{
  "tasks": [
    {
      "task_id": "task_ghi789uvw",
      "status": "completed",
      "created_at": "2023-10-27T11:00:00Z"
    },
    {
      "task_id": "task_jkl012xyz",
      "status": "processing",
      "created_at": "2023-10-27T11:05:00Z"
    }
  ]
}
```
```

--------------------------------

### GET /v1/ai/image-to-video/wan-v2-2-580p

Source: https://docs.magnific.com/api-reference/video/post-kling-4k-i2v

Get the list of WAN 2.2 580p tasks.

```APIDOC
## GET /v1/ai/image-to-video/wan-v2-2-580p

### Description
Get the list of WAN 2.2 580p tasks.

### Method
GET

### Endpoint
/v1/ai/image-to-video/wan-v2-2-580p

### Parameters
#### Query Parameters
- **limit** (integer) - Optional - The maximum number of tasks to return.
- **offset** (integer) - Optional - The number of tasks to skip.

### Response
#### Success Response (200)
- **tasks** (array) - A list of video generation tasks.
  - **task_id** (string) - The ID of the task.
  - **status** (string) - The status of the task.
  - **created_at** (string) - The timestamp when the task was created.

#### Response Example
```json
{
  "tasks": [
    {
      "task_id": "task_mno123pqr",
      "status": "completed",
      "created_at": "2023-10-27T12:00:00Z"
    },
    {
      "task_id": "task_stu456vwx",
      "status": "processing",
      "created_at": "2023-10-27T12:05:00Z"
    }
  ]
}
```
```

--------------------------------

### Enhance Skin with Default Settings

Source: https://docs.magnific.com/api-reference/skin-enhancer

This example demonstrates how to use the Skin Enhancer API with default settings to enhance skin in an image. It's a straightforward way to get started.

```APIDOC
## POST /v1/ai/skin-enhancer

### Description
Enhance skin in an image using AI. This is a basic call that uses default parameters for enhancement.

### Method
POST

### Endpoint
/v1/ai/skin-enhancer

### Request Body
- **image_url** (string) - Required - The URL of the image to enhance.

### Request Example
```json
{
  "image_url": "https://docs.magnific.com/images/example.jpg"
}
```

### Response
#### Success Response (200)
- **enhanced_image_url** (string) - The URL of the image with enhanced skin.

#### Response Example
```json
{
  "enhanced_image_url": "https://docs.magnific.com/images/enhanced_example.jpg"
}
```
```

--------------------------------

### POST /v1/ai/image-to-video/minimax-hailuo-2-3-1080p

Source: https://docs.magnific.com/api-reference/image-to-video/minimax-hailuo-2-3-1080p/post-minimax-hailuo-2-3-1080p

Creates a video from text or image using the MiniMax Hailuo 2.3 1080p model. It takes a prompt, optional first and last frame images, a webhook URL for status updates, a boolean for prompt optimization, and the desired video duration.

```APIDOC
## POST /v1/ai/image-to-video/minimax-hailuo-2-3-1080p

### Description
Generate a video from text or image using the MiniMax Hailuo 2.3 1080p model.

### Method
POST

### Endpoint
/v1/ai/image-to-video/minimax-hailuo-2-3-1080p

### Parameters
#### Request Body
- **prompt** (string) - Required - The text prompt to generate the video from.
- **first_frame_image** (string) - Optional - URL of the first frame image.
- **webhook_url** (string) - Optional - URL to send webhook notifications to.
- **prompt_optimizer** (boolean) - Optional - Whether to use prompt optimization.
- **last_frame_image** (string) - Optional - URL of the last frame image.
- **duration** (integer) - Optional - The desired duration of the video in seconds.

### Request Example
```json
{
  "prompt": "A beautiful sunset over the mountains with birds flying in the sky",
  "first_frame_image": "https://img.freepik.com/free-photo/beautiful-sunset-over-mountains_123456-7890.jpg",
  "webhook_url": "https://www.example.com/webhook",
  "prompt_optimizer": true,
  "last_frame_image": "https://img.freepik.com/free-photo/beautiful-sunset-over-mountains_123456-7890.jpg",
  "duration": 6
}
```

### Response
#### Success Response (200)
- **data** (object) - Contains task information.
  - **task_id** (string) - The ID of the created task.
  - **status** (string) - The initial status of the task (e.g., "CREATED").

#### Response Example
```json
{
  "data": {
    "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
    "status": "CREATED"
  }
}
```
```

--------------------------------

### POST 1080p - Create

Source: https://docs.magnific.com/api-reference/image-to-video/minimax-hailuo-02-1080p/post-minimax-hailuo-02-1080p

Creates a new video generation task using the MiniMax / Hailuo 02 model at 1080p resolution.

```APIDOC
## POST /api-reference/image-to-video/minimax-hailuo-02-1080p/post-minimax-hailuo-02-1080p

### Description
Creates a new video generation task with 1080p resolution using the MiniMax / Hailuo 02 model.

### Method
POST

### Endpoint
/api-reference/image-to-video/minimax-hailuo-02-1080p/post-minimax-hailuo-02-1080p

### Parameters
#### Request Body
(No specific request body parameters are detailed in the source text.)

### Request Example
(No request example is provided in the source text.)

### Response
#### Success Response (200)
(No specific response fields are detailed in the source text.)

#### Response Example
(No response example is provided in the source text.)
```

--------------------------------

### Create a New Team Project

Source: https://docs.magnific.com/api-reference/analytics/team-projects

Creates a new project for the authenticated team. Provide a name and description to get started.

```APIDOC
## POST /teams/{teamId}/projects

### Description
Creates a new project for the authenticated team.

### Method
POST

### Endpoint
/teams/{teamId}/projects

### Parameters
#### Path Parameters
- **teamId** (string) - Required - The unique identifier of the team.

#### Request Body
- **name** (string) - Required - The name of the new project.
- **description** (string) - Optional - A brief description of the project.

### Request Example
{
  "name": "Project Beta",
  "description": "Exploring new market opportunities."
}

### Response
#### Success Response (201)
- **id** (string) - The unique identifier of the newly created project.
- **name** (string) - The name of the project.
- **description** (string) - A brief description of the project.
- **createdAt** (string) - The date and time the project was created.
- **updatedAt** (string) - The date and time the project was last updated.

#### Response Example
{
  "id": "proj_456",
  "name": "Project Beta",
  "description": "Exploring new market opportunities.",
  "createdAt": "2023-10-27T11:00:00Z",
  "updatedAt": "2023-10-27T11:00:00Z"
}
```

--------------------------------

### WAN 2.5 I2V 1080p - List tasks

Source: https://docs.magnific.com/api-reference/icon-generation/post-preview

Get the list of WAN 2.5 Image-to-Video 1080p tasks

```APIDOC
## GET /v1/ai/image-to-video/wan-2-5-i2v-1080p

### Description
Get the list of WAN 2.5 Image-to-Video 1080p tasks.

### Method
GET

### Endpoint
/v1/ai/image-to-video/wan-2-5-i2v-1080p

### Query Parameters
- **limit** (integer) - Optional - The maximum number of tasks to return.
- **offset** (integer) - Optional - The number of tasks to skip.

### Response
#### Success Response (200)
- **tasks** (array) - A list of tasks.
  - **task_id** (string) - The ID of the task.
  - **status** (string) - The status of the task.
  - **created_at** (string) - The timestamp when the task was created.
```

--------------------------------

### Generate Pro Video with Reference

Source: https://docs.magnific.com/api-reference/video/kling-v3-omni/generate-pro-video-reference

Use a reference video (3-10s) to guide motion and style, and combine with an image for start frame control to create high-quality pro output videos.

```APIDOC
## POST /ai/video/kling-v3-omni-pro-reference

### Description
Generates a pro-quality video using a reference video for motion and style guidance, and an optional image for the starting frame.

### Method
POST

### Endpoint
`/ai/video/kling-v3-omni-pro-reference`

### Parameters
#### Request Body
- **prompt** (string) - Required - Your creative prompt describing the desired video.
- **reference_video** (string) - Required - A URL to the reference video (3-10 seconds).
- **image** (string) - Optional - A URL to an image to be used as the start frame.
- **duration** (integer) - Optional - Desired video duration in seconds (default: 5, max: 15).

### Request Example
```json
{
  "prompt": "A futuristic cityscape at sunset, with flying cars",
  "reference_video": "@Video1",
  "image": "https://example.com/start_frame.jpg",
  "duration": 10
}
```

### Response
#### Success Response (200)
- **task_id** (string) - The ID of the video generation task.
- **status** (string) - The current status of the task (e.g., 'processing', 'completed', 'failed').

#### Response Example
```json
{
  "task_id": "task_abc123xyz",
  "status": "processing"
}
```
```

--------------------------------

### Kling 3 Omni Standard - Video-to-video generation

Source: https://docs.magnific.com/api-reference/image-expand/post-seedream-v4-5

Use a reference video (3-10s) to guide motion and style. Combine with an image for start frame control. High-quality pro output.

```APIDOC
## POST /v1/ai/reference-to-video/kling-v3-omni-std

### Description
Generate AI video using Kling 3 Omni Standard with a reference video for motion and style guidance.

### Method
POST

### Endpoint
/v1/ai/reference-to-video/kling-v3-omni-std

### Parameters
#### Request Body
- **video_url** (string) - Required - URL of the reference video.
- **prompt** (string) - Required - Text prompt describing the desired video content.
- **image_url** (string) - Optional - URL of an image to use for the start frame.
- **negative_prompt** (string) - Optional - Text prompt describing content to avoid.
- **style_prompt** (string) - Optional - Text prompt to guide the visual style.
- **aspect_ratio** (string) - Optional - Aspect ratio of the output video (e.g., "16:9", "9:16", "1:1").
- **seed** (integer) - Optional - Seed for reproducible results.
- **controlnet_conditioning_scale** (number) - Optional - Strength of the control net conditioning.
- **controlnet_model** (string) - Optional - Control net model to use.

### Request Example
{
  "video_url": "https://example.com/reference.mp4",
  "prompt": "A futuristic cityscape at sunset",
  "image_url": "https://example.com/start_frame.jpg",
  "aspect_ratio": "16:9"
}

### Response
#### Success Response (200)
- **task_id** (string) - The ID of the video generation task.
- **status** (string) - The current status of the task (e.g., "processing", "completed", "failed").

#### Response Example
{
  "task_id": "task_abc123",
  "status": "processing"
}
```

--------------------------------

### POST /nano-banana-pro

Source: https://docs.magnific.com/api-reference/videos/videos-api

Creates a new video generation task using the Nano Banana Pro model.

```APIDOC
## POST /nano-banana-pro

### Description
Initiates a video generation process using the Nano Banana Pro model. This endpoint is used to create a new task for video generation based on provided parameters.

### Method
POST

### Endpoint
/nano-banana-pro

### Parameters
#### Request Body
- **prompt** (string) - Required - The text prompt to guide video generation.
- **negative_prompt** (string) - Optional - A prompt specifying elements to exclude from the generated video.
- **width** (integer) - Optional - The desired width of the generated video.
- **height** (integer) - Optional - The desired height of the generated video.
- **seed** (integer) - Optional - A seed value for reproducible results.
- **cfg_scale** (number) - Optional - Controls how strongly the generation adheres to the prompt.
- **steps** (integer) - Optional - The number of diffusion steps to perform.
- **model** (string) - Optional - Specifies the model version to use.
- **output_format** (string) - Optional - The desired output format for the video (e.g., 'mp4').
- **num_outputs** (integer) - Optional - The number of video variations to generate.

### Request Example
{
  "prompt": "A futuristic cityscape at sunset, cinematic lighting",
  "negative_prompt": "blurry, low quality, cartoonish",
  "width": 1024,
  "height": 768,
  "seed": 12345,
  "cfg_scale": 7.5,
  "steps": 30,
  "model": "v1.0",
  "output_format": "mp4",
  "num_outputs": 1
}

### Response
#### Success Response (200)
- **task_id** (string) - The unique identifier for the video generation task.
- **status** (string) - The current status of the task (e.g., 'processing', 'completed', 'failed').

#### Response Example
{
  "task_id": "task_abc123xyz",
  "status": "processing"
}
```

--------------------------------

### WAN 2.5 I2V 720p - List tasks

Source: https://docs.magnific.com/api-reference/icon-generation/post-preview

Get the list of WAN 2.5 Image-to-Video 720p tasks

```APIDOC
## GET /v1/ai/image-to-video/wan-2-5-i2v-720p

### Description
Get the list of WAN 2.5 Image-to-Video 720p tasks.

### Method
GET

### Endpoint
/v1/ai/image-to-video/wan-2-5-i2v-720p

### Query Parameters
- **limit** (integer) - Optional - The maximum number of tasks to return.
- **offset** (integer) - Optional - The number of tasks to skip.

### Response
#### Success Response (200)
- **tasks** (array) - A list of tasks.
  - **task_id** (string) - The ID of the task.
  - **status** (string) - The status of the task.
  - **created_at** (string) - The timestamp when the task was created.
```

--------------------------------

### Kling 3 Omni Pro - Video-to-video generation

Source: https://docs.magnific.com/api-reference/image-to-video/pixverse-v5-5/overview

Generate AI video using Kling 3 Omni Pro, guiding motion and style with a reference video. Can be combined with an image for start frame control.

```APIDOC
## POST /v1/ai/reference-to-video/kling-v3-omni-pro

### Description
Generate AI video using Kling 3 Omni Pro mode with a reference video to guide motion and style. This endpoint is specifically for video-to-video generation.

### Method
POST

### Endpoint
/v1/ai/reference-to-video/kling-v3-omni-pro

### Parameters
#### Request Body
- **prompt** (string) - Required - The text prompt describing the desired video content.
- **video_url** (string) - Required - URL of the reference video (3-10s) to guide motion and style.
- **image_url** (string) - Optional - URL of an image to be used as the start frame.
- **negative_prompt** (string) - Optional - Text prompt describing content to exclude from the video.

### Response
#### Success Response (200)
- **task_id** (string) - The ID of the video generation task.
- **status** (string) - The current status of the task (e.g., 'processing', 'completed', 'failed').
```

--------------------------------

### Video Generation Async Pattern

Source: https://docs.magnific.com/api-reference/image-to-video

Illustrates the asynchronous workflow for video generation. It involves an initial POST request to start generation, followed by polling for the task status using a GET request or receiving a webhook notification.

```text
1. POST a generation request with your prompt and/or image.
2. Receive a task_id immediately.
3. Poll with GET /v1/ai/{model}/{task_id} or receive a webhook notification.
4. Download the resulting video from the video_url in the response.
```

--------------------------------

### GET /v1/ai/image-to-video/minimax-hailuo-2-3-1080p

Source: https://docs.magnific.com/api-reference/image-to-video/happy-horse-1/overview

Get the list of tasks for the MiniMax Hailuo 2.3 1080p model.

```APIDOC
## GET /v1/ai/image-to-video/minimax-hailuo-2-3-1080p

### Description
Retrieve a list of all tasks associated with the MiniMax Hailuo 2.3 1080p model.

### Method
GET

### Endpoint
/v1/ai/image-to-video/minimax-hailuo-2-3-1080p

### Parameters
(Not specified in the source)

### Request Example
(Not specified in the source)

### Response
#### Success Response (200)
(Not specified in the source)

### Error Handling
(Not specified in the source)
```

--------------------------------

### Kling 3 Omni Pro - Generate video with reference

Source: https://docs.magnific.com/api-reference/text-to-image/post-flux-2-pro

Generate high-quality AI video using Kling 3 Omni Pro, guided by a reference video for motion and style. This endpoint allows combining a reference video with an image for start frame control, offering the highest quality output.

```APIDOC
## POST /v1/ai/reference-to-video/kling-v3-omni-pro

### Description
Generate AI video using Kling 3 Omni Pro with a reference video for motion and style guidance. This is a video-to-video generation endpoint.

### Method
POST

### Endpoint
/v1/ai/reference-to-video/kling-v3-omni-pro

### Parameters
#### Request Body
- **prompt** (string) - Required - Your creative prompt to guide the video generation.
- **video_url** (string) - Required - URL of the reference video (3-10 seconds).
- **image_url** (string) - Optional - URL of an image to control the start frame.

### Response
#### Success Response (200)
- **task_id** (string) - The ID of the video generation task.
- **status** (string) - The current status of the task (e.g., 'processing', 'completed', 'failed').
- **result_url** (string) - The URL of the generated video if the task is completed.
```

--------------------------------

### GET 1080p - List tasks

Source: https://docs.magnific.com/api-reference/image-to-video/minimax-hailuo-02-1080p/post-minimax-hailuo-02-1080p

Retrieves a list of all video generation tasks for the MiniMax / Hailuo 02 model at 1080p resolution.

```APIDOC
## GET /api-reference/image-to-video/minimax-hailuo-02-1080p/get-minimax-hailuo-02-1080p

### Description
Retrieves a list of video generation tasks created with the MiniMax / Hailuo 02 model at 1080p resolution.

### Method
GET

### Endpoint
/api-reference/image-to-video/minimax-hailuo-02-1080p/get-minimax-hailuo-02-1080p

### Parameters
(No specific parameters are detailed in the source text.)

### Request Example
(No request example is provided in the source text.)

### Response
#### Success Response (200)
(No specific response fields are detailed in the source text.)

#### Response Example
(No response example is provided in the source text.)
```

--------------------------------

### Create Video from Text and Image using cURL

Source: https://docs.magnific.com/api-reference/image-to-video/minimax-hailuo-2-3-1080p/post-minimax-hailuo-2-3-1080p

Use this cURL command to send a POST request to the MiniMax Hailuo 2.3 1080p API. Include your prompt, image URLs, and optional parameters like webhook URL, prompt optimizer, and duration. Ensure you replace `<api-key>` with your actual Magnific API key.

```cURL
curl --request POST \
  --url https://api.magnific.com/v1/ai/image-to-video/minimax-hailuo-2-3-1080p \
  --header 'Content-Type: application/json' \
  --header 'x-magnific-api-key: <api-key>' \
  --data '
{
  "prompt": "A beautiful sunset over the mountains with birds flying in the sky",
  "first_frame_image": "https://img.freepik.com/free-photo/beautiful-sunset-over-mountains_123456-7890.jpg",
  "webhook_url": "https://www.example.com/webhook",
  "prompt_optimizer": true,
  "last_frame_image": "https://img.freepik.com/free-photo/beautiful-sunset-over-mountains_123456-7890.jpg",
  "duration": 6
}
'
```

--------------------------------

### Kling 3 Omni Pro - Video-to-video generation

Source: https://docs.magnific.com/api-reference/image-to-video/kling-elements-pro/post-kling-elements-pro

Generate AI video using Kling 3 Omni Pro with a reference video for motion and style guidance. This endpoint allows for high-quality output by leveraging a reference video (3-10s) to guide motion and style, and can be combined with an image for start frame control.

```APIDOC
## POST /v1/ai/reference-to-video/kling-v3-omni-pro

### Description
Generate AI video using Kling 3 Omni Pro with a reference video for motion and style guidance. This endpoint allows for high-quality output by leveraging a reference video (3-10s) to guide motion and style, and can be combined with an image for start frame control.

### Method
POST

### Endpoint
/v1/ai/reference-to-video/kling-v3-omni-pro

### Parameters
#### Request Body
- **prompt** (string) - Required - The text prompt describing the desired video content.
- **video_url** (string) - Required - The URL of the reference video (3-10 seconds).
- **image_url** (string) - Optional - The URL of an image to be used as the start frame.
- **negative_prompt** (string) - Optional - A prompt describing content to exclude from the video.
- **seed** (integer) - Optional - A seed for reproducible generation.
- **style_prompt** (string) - Optional - A prompt to guide the visual style.
- **aspect_ratio** (string) - Optional - The aspect ratio of the output video (e.g., "16:9", "1:1").

### Request Example
```json
{
  "prompt": "A futuristic cityscape at sunset",
  "video_url": "https://example.com/reference.mp4",
  "image_url": "https://example.com/start_frame.jpg",
  "negative_prompt": "blurry, low quality",
  "seed": 12345,
  "style_prompt": "cinematic, vibrant colors",
  "aspect_ratio": "16:9"
}
```

### Response
#### Success Response (200)
- **task_id** (string) - The ID of the video generation task.
- **status** (string) - The current status of the task (e.g., "processing", "completed", "failed").

#### Response Example
```json
{
  "task_id": "task_abc123",
  "status": "processing"
}
```
```

--------------------------------

### WAN 2.7 - Create video from text

Source: https://docs.magnific.com/api-reference/reference-to-video/wan-2-7/overview

Generate a 1080p video from a text prompt using the WAN 2.7 model.

```APIDOC
## POST /v1/ai/text-to-video/wan-2-7

### Description
Generate a 1080p video from a text prompt using the WAN 2.7 model.

### Method
POST

### Endpoint
/v1/ai/text-to-video/wan-2-7

### Request Body
- **prompt** (string) - Required - The text prompt to generate the video from.
- **negative_prompt** (string) - Optional - The text prompt to exclude from the video generation.
- **seed** (integer) - Optional - A seed for reproducible results.
- **duration_seconds** (integer) - Optional - The duration of the video in seconds (e.g., 4, 6, 8).

### Response
#### Success Response (200)
- **task_id** (string) - The ID of the generated task.
- **status** (string) - The status of the task (e.g., "processing", "completed", "failed").

### Response Example
{
  "task_id": "abc123xyz789",
  "status": "processing"
}
```

--------------------------------

### Kling 3 Omni - Generate Pro Video (Reference)

Source: https://docs.magnific.com/api-reference/voiceover/overview

Generate AI video using Kling 3 Omni Pro with a reference video for motion and style guidance. This endpoint is suitable for video-to-video generation where motion and style from a reference video are transferred to a new video, optionally guided by an image for the start frame.

```APIDOC
## POST /v1/ai/reference-to-video/kling-v3-omni-pro

### Description
Generate AI video using Kling 3 Omni Pro with a reference video for motion and style guidance. This endpoint is suitable for video-to-video generation where motion and style from a reference video are transferred to a new video, optionally guided by an image for the start frame.

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

--------------------------------

### Image to Video 1080p - List tasks

Source: https://docs.magnific.com/api-reference/image-to-video/kling-v2.5-pro/overview

Get the list of WAN 2.5 Image-to-Video 1080p tasks.

```APIDOC
## GET /v1/ai/image-to-video/wan-2-5-i2v-1080p

### Description
Get the list of WAN 2.5 Image-to-Video 1080p tasks.

### Method
GET

### Endpoint
/v1/ai/image-to-video/wan-2-5-i2v-1080p

### Query Parameters
- **limit** (integer) - Optional - Maximum number of tasks to return.
- **offset** (integer) - Optional - Number of tasks to skip.

### Response
#### Success Response (200)
- **tasks** (array) - A list of tasks.
  - **task_id** (string) - The ID of the task.
  - **status** (string) - The status of the task.
  - **created_at** (string) - The timestamp when the task was created.
```

--------------------------------

### Kling 3 Omni Standard - Video-to-video generation

Source: https://docs.magnific.com/api-reference/video/runway-act-two

Generate AI video using Kling 3 Omni Standard with a reference video for motion and style guidance. This endpoint uses a reference video (3-10s) to guide motion and style, and can be combined with an image for start frame control, offering faster generation at slightly lower quality.

```APIDOC
## POST /v1/ai/reference-to-video/kling-v3-omni-std

### Description
Generate AI video using Kling 3 Omni Standard with a reference video for motion and style guidance.

### Method
POST

### Endpoint
/v1/ai/reference-to-video/kling-v3-omni-std

### Parameters
#### Request Body
- **prompt** (string) - Required - The text prompt describing the desired video content.
- **video_url** (string) - Required - The URL of the reference video (3-10 seconds).
- **image_url** (string) - Optional - The URL of an image to control the start frame.
- **negative_prompt** (string) - Optional - A prompt describing content to avoid.
- **seed** (integer) - Optional - The seed for random number generation.
- **guidance_scale** (number) - Optional - Controls how strongly the prompt influences the generation.
- **num_inference_steps** (integer) - Optional - The number of diffusion steps to run.

### Request Example
```json
{
  "prompt": "A cat playing with a ball of yarn",
  "video_url": "https://example.com/cat_video.mp4",
  "image_url": "https://example.com/cat_start.jpg"
}
```

### Response
#### Success Response (200)
- **task_id** (string) - The ID of the video generation task.

#### Response Example
```json
{
  "task_id": "task_def456uvw"
}
```
```

--------------------------------

### PixVerse V6 - Generate video from image

Source: https://docs.magnific.com/api-reference/image-to-video/pixverse-v6/overview

Generate AI video using PixVerse V6 with image-to-video capabilities. This endpoint allows users to create videos by providing starting and/or ending frame images to guide the generation process. It supports multi-shot video creation and element control for consistent character or style across shots.

```APIDOC
## POST /v1/ai/video/pixverse-v6

### Description
Generate AI video using PixVerse V6 with image-to-video capabilities. Use start and/or end frame images to guide generation. Supports multi-shot video (up to 6 shots, max 15s total) and element control for consistent character/style.

### Method
POST

### Endpoint
/v1/ai/video/pixverse-v6

### Parameters
#### Request Body
- **prompt** (string) - Required - Text description of the desired video content.
- **start_frame_image** (string) - Optional - URL of the starting frame image.
- **end_frame_image** (string) - Optional - URL of the ending frame image.
- **shots** (integer) - Optional - Number of shots to generate (default: 1, max: 6).
- **duration_seconds** (integer) - Optional - Total duration of the video in seconds (default: 5, max: 15).
- **element_images** (array of strings) - Optional - URLs of reference images for element consistency.

### Request Example
```json
{
  "prompt": "A futuristic cityscape at sunset",
  "start_frame_image": "https://example.com/start.jpg",
  "end_frame_image": "https://example.com/end.jpg",
  "shots": 3,
  "duration_seconds": 10,
  "element_images": ["https://example.com/char.jpg"]
}
```

### Response
#### Success Response (200)
- **task_id** (string) - The ID of the video generation task.
- **status** (string) - The current status of the task (e.g., PENDING, PROCESSING, COMPLETED, FAILED).

#### Response Example
```json
{
  "task_id": "pixv6-task-12345abcde",
  "status": "PENDING"
}
```
```

--------------------------------

### POST /minimax-hailuo-2-3-1080p - Create

Source: https://docs.magnific.com/api-reference/image-to-video/minimax-hailuo-2-3-1080p/post-minimax-hailuo-2-3-1080p

Initiates the creation of a video from a given image using the MiniMax Hailuo 2.3 model. This endpoint is suitable for generating 1080p resolution videos.

```APIDOC
## POST /minimax-hailuo-2-3-1080p

### Description
Creates a video from an image using the MiniMax Hailuo 2.3 model at 1080p resolution.

### Method
POST

### Endpoint
/minimax-hailuo-2-3-1080p

### Request Body
- **image** (string) - Required - The base64 encoded image to be used for video generation.
- **prompt** (string) - Required - A text description of the desired video content.
- **negative_prompt** (string) - Optional - A text description of content to exclude from the video.
- **seed** (integer) - Optional - A seed for reproducible results.
- **guidance_scale** (number) - Optional - Controls how strongly the video generation follows the prompt.
- **num_inference_steps** (integer) - Optional - The number of diffusion steps to run.
- **width** (integer) - Optional - The width of the generated video. Defaults to 1920.
- **height** (integer) - Optional - The height of the generated video. Defaults to 1080.

### Request Example
```json
{
  "image": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=",
  "prompt": "A majestic dragon flying over a castle",
  "negative_prompt": "blurry, low quality",
  "seed": 12345,
  "guidance_scale": 7.5,
  "num_inference_steps": 50,
  "width": 1920,
  "height": 1080
}
```

### Response
#### Success Response (200)
- **task_id** (string) - The ID of the video generation task.

#### Response Example
```json
{
  "task_id": "a1b2c3d4-e5f6-7890-1234-567890abcdef"
}
```
```

--------------------------------

### GET /v1/ai/text-to-image/imagen3

Source: https://docs.magnific.com/api-reference/audio-isolation/isolate

Get the status of all Imagen3 tasks.

```APIDOC
## GET /v1/ai/text-to-image/imagen3

### Description
Get the status of all Imagen3 tasks.

### Method
GET

### Endpoint
/v1/ai/text-to-image/imagen3

### Response
#### Success Response (200)
- **tasks** (array) - A list of image generation tasks.
  - **task_id** (string) - The ID of the image generation task.
  - **status** (string) - The current status of the task.
  - **created_at** (string) - The timestamp when the task was created.

#### Response Example
{
  "tasks": [
    {
      "task_id": "img_abc123xyz",
      "status": "completed",
      "created_at": "2023-10-27T10:00:00Z"
    },
    {
      "task_id": "img_def456uvw",
      "status": "processing",
      "created_at": "2023-10-27T10:05:00Z"
    }
  ]
}
```

--------------------------------

### POST /v1/ai/text-to-video/wan-2-5-t2v-1080p

Source: https://docs.magnific.com/api-reference/video/post-kling-4k-i2v

Generate a 1080p video from a text prompt using the WAN 2.5 model.

```APIDOC
## POST /v1/ai/text-to-video/wan-2-5-t2v-1080p

### Description
Generate a 1080p video from a text prompt using the WAN 2.5 model.

### Method
POST

### Endpoint
/v1/ai/text-to-video/wan-2-5-t2v-1080p

### Parameters
#### Request Body
- **prompt** (string) - Required - The text prompt to generate the video from.
- **negative_prompt** (string) - Optional - The text prompt to exclude from the video generation.
- **seed** (integer) - Optional - A seed for reproducible results.
- **duration** (integer) - Optional - The duration of the video in seconds (e.g., 4).

### Request Example
```json
{
  "prompt": "A majestic dragon flying over a medieval castle",
  "negative_prompt": "blurry, low quality, cartoonish",
  "seed": 12345,
  "duration": 4
}
```

### Response
#### Success Response (200)
- **task_id** (string) - The ID of the generated task.
- **status** (string) - The status of the task (e.g., "processing", "completed", "failed").

#### Response Example
```json
{
  "task_id": "task_abc123xyz",
  "status": "processing"
}
```
```

--------------------------------

### POST /v1/ai/image-to-video/minimax-hailuo-2-3-768p-fast

Source: https://docs.magnific.com/api-reference/image-to-video/pixverse-v6/overview

Generate a video from text or image using the MiniMax Hailuo 2.3 768p model with fast prompt optimization.

```APIDOC
## POST /v1/ai/image-to-video/minimax-hailuo-2-3-768p-fast

### Description
Generate a video from text or image using the MiniMax Hailuo 2.3 768p model with fast prompt optimization.

### Method
POST

### Endpoint
/v1/ai/image-to-video/minimax-hailuo-2-3-768p-fast

### Parameters
#### Request Body
- **prompt** (string) - Required - The text prompt for video generation.
- **image** (string) - Optional - The input image for video generation (base64 encoded).

### Request Example
{
  "example": "{\"prompt\": \"A fast-paced action scene\", \"image\": \"base64_encoded_image_string\"}"
}

### Response
#### Success Response (200)
- **task_id** (string) - The ID of the generated task.

#### Response Example
{
  "example": "{\"task_id\": \"445566cdef\"}"
}
```

--------------------------------

### GET /v1/ai/image-to-video/kling-std/{task-id}

Source: https://docs.magnific.com/api-reference/image-upscaler-precision-v2

Get the status of the kling task.

```APIDOC
## GET /v1/ai/image-to-video/kling-std/{task-id}

### Description
Get the status of the kling task.

### Method
GET

### Endpoint
/v1/ai/image-to-video/kling-std/{task-id}

### Parameters
#### Path Parameters
- **task-id** (string) - Required - The ID of the task to retrieve status for.
```

--------------------------------

### GET /nano-banana-pro

Source: https://docs.magnific.com/api-reference/videos/videos-api

Retrieves a list of video generation tasks created with the Nano Banana Pro model.

```APIDOC
## GET /nano-banana-pro

### Description
Fetches a list of all video generation tasks initiated using the Nano Banana Pro model. This endpoint allows users to track the status of their video generation requests.

### Method
GET

### Endpoint
/nano-banana-pro

### Parameters
#### Query Parameters
- **limit** (integer) - Optional - The maximum number of tasks to return.
- **offset** (integer) - Optional - The number of tasks to skip before starting to collect the result set.
- **status** (string) - Optional - Filters tasks by their current status (e.g., 'completed', 'failed').

### Response
#### Success Response (200)
- **tasks** (array) - A list of video generation tasks.
  - **task_id** (string) - The unique identifier for the task.
  - **status** (string) - The current status of the task.
  - **created_at** (string) - The timestamp when the task was created.

#### Response Example
{
  "tasks": [
    {
      "task_id": "task_abc123xyz",
      "status": "completed",
      "created_at": "2023-10-27T10:00:00Z"
    },
    {
      "task_id": "task_def456uvw",
      "status": "processing",
      "created_at": "2023-10-27T10:05:00Z"
    }
  ]
}
```

--------------------------------

### GET /v1/ai/text-to-image/seedream-v4

Source: https://docs.magnific.com/llms-full.txt

Get the status of all Seedream v4 tasks.

```APIDOC
## GET /v1/ai/text-to-image/seedream-v4

### Description
Get the status of all Seedream v4 tasks.

### Method
GET

### Endpoint
/v1/ai/text-to-image/seedream-v4

### Response
#### Success Response (200)
- **tasks** (array) - A list of Seedream v4 tasks.
  - **task_id** (string) - The ID of the task.
  - **status** (string) - The current status of the task (e.g., PENDING, PROCESSING, COMPLETED, FAILED).
  - **created_at** (string) - Timestamp when the task was created.

#### Response Example
```json
{
  "tasks": [
    {
      "task_id": "task_abc123xyz",
      "status": "COMPLETED",
      "created_at": "2023-10-27T10:00:00Z"
    },
    {
      "task_id": "task_def456uvw",
      "status": "PENDING",
      "created_at": "2023-10-27T10:05:00Z"
    }
  ]
}
```
```

--------------------------------

### GET /v1/ai/icon-generation

Source: https://docs.magnific.com/api-reference/icon-generation/post-preview

Get the list of icon generation tasks.

```APIDOC
## GET /v1/ai/icon-generation

### Description
Get the list of icon generation tasks.

### Method
GET

### Endpoint
/v1/ai/icon-generation

### Response
#### Success Response (200)
- **tasks** (array) - A list of icon generation tasks.
  - **task_id** (string) - The ID of the task.
  - **status** (string) - The status of the task.
  - **created_at** (string) - The timestamp when the task was created.

#### Response Example
```json
{
  "tasks": [
    {
      "task_id": "icon-gen-task-12345",
      "status": "completed",
      "created_at": "2023-10-27T10:00:00Z"
    },
    {
      "task_id": "icon-gen-task-67890",
      "status": "processing",
      "created_at": "2023-10-27T10:05:00Z"
    }
  ]
}
```
```

--------------------------------

### MiniMax Hailuo 2.3 1080p - List tasks

Source: https://docs.magnific.com/api-reference/audio-isolation/overview

Get the list of MiniMax Hailuo 2.3 1080p tasks.

```APIDOC
## GET /v1/ai/image-to-video/minimax-hailuo-2-3-1080p

### Description
Get the list of MiniMax Hailuo 2.3 1080p tasks.

### Method
GET

### Endpoint
/v1/ai/image-to-video/minimax-hailuo-2-3-1080p
```

--------------------------------

### WAN 2.5 1080p - Create video from text

Source: https://docs.magnific.com/api-reference/analytics/team-credit-usage/query

Generate a 1080p video from text prompt using the WAN 2.5 model.

```APIDOC
## POST /v1/ai/text-to-video/wan-2-5-t2v-1080p

### Description
Generate a 1080p video from a text prompt using the WAN 2.5 model.

### Method
POST

### Endpoint
/v1/ai/text-to-video/wan-2-5-t2v-1080p

### Parameters
#### Request Body
- **prompt** (string) - Required - The text prompt to generate video from.
- **negative_prompt** (string) - Optional - A text prompt to guide video generation away from certain elements.
- **seed** (integer) - Optional - Seed for reproducible results.
- **guidance_scale** (number) - Optional - Scale for prompt guidance.
- **num_inference_steps** (integer) - Optional - Number of diffusion inference steps.
- **motion_adapter** (string) - Optional - Specify a motion adapter for specific motion styles.
- **motion_control_net** (file) - Optional - ControlNet model for motion control.
- **motion_control_net_weight** (number) - Optional - Weight for the motion ControlNet.
- **scheduler** (string) - Optional - Scheduler type for the diffusion process.
- **output_format** (string) - Optional - Desired output video format (e.g., 'mp4').
- **output_fps** (integer) - Optional - Frames per second for the output video.
- **output_width** (integer) - Optional - Width of the output video.
- **output_height** (integer) - Optional - Height of the output video.

### Response
#### Success Response (200)
- **task_id** (string) - The ID of the generated task.
- **status** (string) - The current status of the task (e.g., 'processing', 'completed', 'failed').
- **created_at** (string) - Timestamp when the task was created.

#### Response Example
{
  "task_id": "task_stu901",
  "status": "processing",
  "created_at": "2023-10-27T10:50:00Z"
}
```