Magnific

https://docs.magnific.com
Admin
Magnific is a comprehensive AI API platform offering image generation, image editing, video...
Tokens:712,610
Snippets:4,179
Trust Score:8.8
Update:1 month ago
Show doc for...
Tokens:
Raw
### List all tasks API request examples

Source: https://docs.magnific.com/api-reference/video/seedance-2-pro/tasks

Examples for performing a GET request to retrieve all tasks. Replace <api-key> with your actual Magnific API key.

```bash
curl --request GET \
  --url https://api.magnific.com/v1/ai/video/seedance-2-pro \
  --header 'x-magnific-api-key: <api-key>'
```

```python
import requests

url = "https://api.magnific.com/v1/ai/video/seedance-2-pro"

headers = {"x-magnific-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)
```

```javascript
const options = {method: 'GET', headers: {'x-magnific-api-key': '<api-key>'}};

fetch('https://api.magnific.com/v1/ai/video/seedance-2-pro', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.magnific.com/v1/ai/video/seedance-2-pro",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-magnific-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
```

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.magnific.com/v1/ai/video/seedance-2-pro"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-magnific-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

```java
HttpResponse<String> response = Unirest.get("https://api.magnific.com/v1/ai/video/seedance-2-pro")
  .header("x-magnific-api-key", "<api-key>")
  .asString();
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.magnific.com/v1/ai/video/seedance-2-pro")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-magnific-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body
```

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

### Reference Image Configuration

Source: https://docs.magnific.com/api-reference/music-generation/lyria-3/generate

Example structure for providing reference images to guide music generation.

```yaml
- image: https://example.com/mood-reference.jpg
  mime_type: image/jpeg
```

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

### Get task status API examples

Source: https://docs.magnific.com/api-reference/image-to-video/kling-v3-turbo/task-by-id

Examples for retrieving task status across various programming languages and tools.

```bash
curl --request GET \
  --url https://api.magnific.com/v1/ai/image-to-video/kling-v3-turbo/{task-id} \
  --header 'x-magnific-api-key: <api-key>'
```

```python
import requests

url = "https://api.magnific.com/v1/ai/image-to-video/kling-v3-turbo/{task-id}"

headers = {"x-magnific-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)
```

```javascript
const options = {method: 'GET', headers: {'x-magnific-api-key': '<api-key>'}};

fetch('https://api.magnific.com/v1/ai/image-to-video/kling-v3-turbo/{task-id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.magnific.com/v1/ai/image-to-video/kling-v3-turbo/{task-id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-magnific-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
```

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.magnific.com/v1/ai/image-to-video/kling-v3-turbo/{task-id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-magnific-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

```java
HttpResponse<String> response = Unirest.get("https://api.magnific.com/v1/ai/image-to-video/kling-v3-turbo/{task-id}")
  .header("x-magnific-api-key", "<api-key>")
  .asString();
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.magnific.com/v1/ai/image-to-video/kling-v3-turbo/{task-id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-magnific-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body
```

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

### List Tasks API Requests

Source: https://docs.magnific.com/api-reference/text-to-video/happy-horse-1/happy-horse-1-t2v-tasks

Examples of how to perform a GET request to list tasks across various programming languages.

```bash
curl --request GET \
  --url https://api.magnific.com/v1/ai/text-to-video/happy-horse-1 \
  --header 'x-magnific-api-key: <api-key>'
```

```python
import requests

url = "https://api.magnific.com/v1/ai/text-to-video/happy-horse-1"

headers = {"x-magnific-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)
```

```javascript
const options = {method: 'GET', headers: {'x-magnific-api-key': '<api-key>'}};

fetch('https://api.magnific.com/v1/ai/text-to-video/happy-horse-1', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.magnific.com/v1/ai/text-to-video/happy-horse-1",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-magnific-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
```

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.magnific.com/v1/ai/text-to-video/happy-horse-1"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-magnific-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

```java
HttpResponse<String> response = Unirest.get("https://api.magnific.com/v1/ai/text-to-video/happy-horse-1")
  .header("x-magnific-api-key", "<api-key>")
  .asString();
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.magnific.com/v1/ai/text-to-video/happy-horse-1")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-magnific-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body
```

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

### Task Completion Example

Source: https://docs.magnific.com/api-reference/text-to-image/get-runway-task

Example response for a successfully completed task.

```yaml
summary: Success - Task completed
value:
  data:
    generated:
      - https://ai-statics.freepik.com/completed_task_image.jpg
    task_id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
    status: COMPLETED
```

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

### Task Response Examples

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

Examples of successful task creation and status updates.

```yaml
    200-task-created:
      summary: Success - Task created
      value:
        data:
          generated: []
          task_id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
          status: CREATED
    200-task-in-progress:
      summary: Success - Task in progress
      value:
        data:
          generated: []
```

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

### Relight Image with Full Parameters

Source: https://docs.magnific.com/api-reference/image-relight/post-image-relight

Example request body demonstrating the use of advanced settings, light transfer references, and style configurations.

```yaml
image: >-
  iVBORw0KGgoAAAANSUhEUgAAASwAAAEsAQAAAABRBrPYAAABrElEQVR4nO3BMQEAAADCoPVPbQ0Po...
prompt: A sunlit forest clearing at golden hour
transfer_light_from_reference_image: >-
  iVBORw0KGgoAAAANSUhEUgAAASwAAAEsAQAAAABRBrPYAAABrElEQVR4nO3BMQEAAADCoPVPbQ0Po...
light_transfer_strength: 100
interpolate_from_original: false
change_background: true
style: smooth
advanced_settings:
  whites: 60
  blacks: 60
  brightness: 30
  contrast: 40
  saturation: 50
  engine: illusio
  transfer_light_a: low
  transfer_light_b: soft_in
  fixed_generation: true
```

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

### Get Flow Response Schema

Source: https://docs.magnific.com/api-reference/flows/get-flow

Example structure for a successful flow retrieval response.

```yaml
get_flow_200_response:
  example:
    data:
      sqid: uqzQLDr2Aw
      name: Sketch to Realism
      inputs:
        - id: input-4050c3f3-8a26-4953-97a8-cb97bceb4816-1
          api_key: text_prompt
          key: text_prompt
          type: text
          label: 'Text #1'
          config: null
          nodeId: 4050c3f3-8a26-4953-97a8-cb97bceb4816
          default: null
          required: true
          presentation:
            mode: textarea
            type: text
        - id: input-4050c3f3-8a26-4953-97a8-cb97bceb4816-1
          api_key: text_prompt
          key: text_prompt
          type: text
          label: 'Text #1'
          config: null
          nodeId: 4050c3f3-8a26-4953-97a8-cb97bceb4816
          default: null
          required: true
          presentation:
            mode: textarea
            type: text
      tool_metadata:
        icon: workflow
        description_key: description_key
        translation_key: translation_key
        category: general
        sort_order: 999
        total_cost: 5
```

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

### SfxDownloadResponse Schema Example

Source: https://docs.magnific.com/api-reference/sfx/download-sfx

Example structure for a successful sound effect download response.

```yaml
example:
  id: 1
  title: Thunder Rumble
  download_url: https://cdn.freepik.com/sfx/thunder-rumble.mp3
```

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

### Example Text Prompt

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

A sample text prompt used to guide the animation process.

```text
The character walks forward slowly with wind blowing through their hair
```

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

### Run Flow Request Example

Source: https://docs.magnific.com/api-reference/flows/run-flow

Example JSON body for initiating a flow execution with specific inputs and a webhook URL.

```json
{
  "inputs": {
    "image": "car in the forest"
  },
  "webhook": "https://www.example.com/webhook"
}
```

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

### Video Download URL Example

Source: https://docs.magnific.com/api-reference/videos/download-an-option-video

A direct URL example for verifying and downloading a video resource.

```text
https://joy1.videvo.net/verify_download_video.php?path=video/free/video0466&vid=_import_61490450321f37.49858282.mov&source=freepik&videvo_id=1109082&filename=1109082_1080p_4k_2k_4096x2160.mov&verify=lkdadslfjads3434
```

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

### OpenAPI Definition for Get Flow Run Status

Source: https://docs.magnific.com/api-reference/flows/get-run

The OpenAPI specification defining the GET request for flow run status, including parameter requirements and example response payloads for completed and running states.

```yaml
openapi: 3.0.0
info:
  description: >-
    The Magnific API is your gateway to a vast collection of high-quality
    digital resources for your applications and projects. As a leading platform,
    it offers a wide range of graphics, including vectors, photos,
    illustrations, icons, PSD templates, and more, all curated by talented
    designers from around the world.
  title: Magnific API
  version: 1.0.0
servers:
  - description: B2B API Production V1
    url: https://api.magnific.com
security:
  - magnificApiKey: []
paths:
  /v1/ai/flows/runs/{run-id}:
    get:
      tags:
        - flows
      summary: Flows - Get run status
      description: >
        Retrieve the current status and results of a flow execution run.


        Use this endpoint to **poll** the status of a run after calling the

        `POST /v1/ai/flows/{flow-id}/run` endpoint. The `run_id` path parameter

        corresponds to the `workflow_run_identifier` returned in the run
        response.


        **Polling strategy:**

        - Wait 2-3 seconds after starting the run before the first poll

        - Poll every 3-5 seconds

        - When `status` is `completed`, the `result` field contains download
        URLs

        - When `status` is `failed`, the `error_message` field describes the
        failure


        **Asset URLs** in the `result` field are temporary and valid for **12
        hours**.


        **Statuses:**

        | Status | Description |

        |--------|-------------|

        | `pending` | Run is queued but has not started yet |

        | `running` | Flow is executing |

        | `completed` | Finished successfully, `result` is available |

        | `completed_with_errors` | Execution finished but some nodes failed |

        | `failed` | Execution failed, see `error_message` |

        | `cancelled` | Execution was cancelled |
      operationId: get_flow_run
      parameters:
        - description: >
            Unique identifier (SQID) of the flow run. This is the

            `workflow_run_identifier` value returned by the `POST
            /v1/ai/flows/{flow-id}/run` endpoint.
          in: path
          name: run-id
          required: true
          schema:
            example: omps2OH829
            type: string
      responses:
        '200':
          content:
            application/json:
              examples:
                completed:
                  summary: Completed run with image results
                  value:
                    data:
                      run_id: omps2OH829
                      status: completed
                      app_id: uqzQLDr2Aw
                      started_at: '2026-02-25T12:00:00.000Z'
                      completed_at: '2026-02-25T12:02:00.000Z'
                      error_message: null
                      result:
                        images:
                          - id: abc123
                            url: >-
                              https://pikaso.cdnpk.net/private/production/1234567890/render.png?token=exp_1234567890~hmac_abc123
                            tool: text-to-image
                            duration: null
                            width: 1024
                            height: 1024
                            created_at: '2026-02-25T12:02:00.000Z'
                        videos: []
                        audios: []
                running:
                  summary: Run still in progress
                  value:
                    data:
                      run_id: omps2OH829
                      status: running
                      app_id: uqzQLDr2Aw
                      started_at: '2026-02-25T12:00:00.000Z'
                      completed_at: null
```

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

### Task Detail Object Example

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

Example of the task detail object including generated media URLs.

```json
{
  "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
  "status": "CREATED",
  "generated": [
    "https://openapi-generator.tech",
    "https://openapi-generator.tech"
  ]
}
```

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

### Resource Detail Response Example

Source: https://docs.magnific.com/api-reference/resources/get-the-detail-of-a-resource-psd-vector-or-photo

Example of the JSON structure returned when fetching resource details, including author information and related items.

```yaml
            slug: merry-christmas
            type: vector
            is_ai_generated: true
            new: true
            premium: true
            url: >-
              https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm
            preview:
              url: >-
                https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm
              width: 300
              height: 500
            has_prompt: true
            author:
              id: 2147483647
              name: John Doe
              avatar: https://avatar.cdnpk.net/61668527-220726032514.jpg
              assets: 0
              slug: merry-christmas
        same_series:
          url: https://www.freepik.com/serie/32689488
          items:
            - id: 15667327
              name: White t-shirt with copy space on gray background
              slug: merry-christmas
              type: vector
              is_ai_generated: true
              new: true
              premium: true
              url: >-
                https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm
              preview:
                url: >-
                  https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm
                width: 300
                height: 500
              has_prompt: true
              author:
                id: 2147483647
                name: John Doe
                avatar: https://avatar.cdnpk.net/61668527-220726032514.jpg
                assets: 0
                slug: merry-christmas
            - id: 15667327
              name: White t-shirt with copy space on gray background
              slug: merry-christmas
              type: vector
              is_ai_generated: true
              new: true
              premium: true
              url: >-
                https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm
              preview:
                url: >-
                  https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm
                width: 300
                height: 500
              has_prompt: true
              author:
                id: 2147483647
                name: John Doe
                avatar: https://avatar.cdnpk.net/61668527-220726032514.jpg
                assets: 0
                slug: merry-christmas
        same_collection:
          url: https://www.freepik.com/collection/shining
          items:
            - id: 15667327
              name: White t-shirt with copy space on gray background
              slug: merry-christmas
              type: vector
              is_ai_generated: true
              new: true
              premium: true
              url: >-
                https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm
              preview:
                url: >-
                  https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm
                width: 300
                height: 500
              has_prompt: true
              author:
                id: 2147483647
                name: John Doe
                avatar: https://avatar.cdnpk.net/61668527-220726032514.jpg
                assets: 0
                slug: merry-christmas
            - id: 15667327
              name: White t-shirt with copy space on gray background
              slug: merry-christmas
              type: vector
              is_ai_generated: true
              new: true
              premium: true
              url: >-
                https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm
              preview:
                url: >-
                  https://www.freepik.com/free-ai-image/surreal-landscape_41357833.htm
                width: 300
                height: 500
              has_prompt: true
              author:
                id: 2147483647
                name: John Doe
                avatar: https://avatar.cdnpk.net/61668527-220726032514.jpg
                assets: 0
                slug: merry-christmas
```

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

### OpenAPI Specification for Get Task Status

Source: https://docs.magnific.com/api-reference/image-relight/get-image-relight

Defines the endpoint for retrieving relight task status, including success and error response examples.

```yaml
openapi: 3.0.0
info:
  description: >-
    The Magnific API is your gateway to a vast collection of high-quality
    digital resources for your applications and projects. As a leading platform,
    it offers a wide range of graphics, including vectors, photos,
    illustrations, icons, PSD templates, and more, all curated by talented
    designers from around the world.
  title: Magnific API
  version: 1.0.0
servers:
  - description: B2B API Production V1
    url: https://api.magnific.com
security:
  - magnificApiKey: []
paths:
  /v1/ai/image-relight/{task-id}:
    get:
      tags:
        - image-relight
      summary: Relight - Get task status
      description: Get the status of the relight task
      parameters:
        - description: ID of the task
          in: path
          name: task-id
          required: true
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              examples:
                success - completed task:
                  $ref: '#/components/examples/200-task-completed'
                success - in progress task:
                  $ref: '#/components/examples/200-task-in-progress'
              schema:
                $ref: >-
                  #/components/schemas/get_style_transfer_task_status_200_response
          description: OK - The task exists and the status is returned
        '400':
          content:
            application/json:
              examples:
                invalid_page:
                  summary: Parameter 'page' is not valid
                  value:
                    message: Parameter 'page' must be greater than 0
                invalid_query:
                  summary: Parameter 'query' is not valid
                  value:
                    message: Parameter 'query' must not be empty
                invalid_filter:
                  summary: Parameter 'filter' is not valid
                  value:
                    message: Parameter 'filter' is not valid
                generic_bad_request:
                  summary: Bad Request
                  value:
                    message: Parameter ':attribute' is not valid
              schema:
                $ref: '#/components/schemas/get_all_style_transfer_tasks_400_response'
            application/problem+json:
              examples:
                invalid_page:
                  summary: Parameter 'page' is not valid
                  value:
                    message: Validation error
                    invalid_params:
                      - field: page
                        reason: Parameter 'page' must be greater than 0
                      - field: per_page
                        reason: Parameter 'per_page' must be greater than 0
              schema:
                $ref: >-
                  #/components/schemas/get_all_style_transfer_tasks_400_response_1
          description: >-
            Bad Request - The server could not understand the request due to
            invalid syntax.
        '401':
          content:
            application/json:
              examples:
                invalid_api_key:
                  summary: API key is not valid
                  value:
                    message: Invalid API key
                missing_api_key:
                  summary: API key is not provided
                  value:
                    message: Missing API key
              schema:
                $ref: '#/components/schemas/get_all_style_transfer_tasks_400_response'
          description: >-
            Unauthorized - The client must authenticate itself to get the
            requested response.
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/get_all_style_transfer_tasks_500_response'
          description: >-
            Internal Server Error - The server has encountered a situation it
            doesn't know how to handle.
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/get_all_style_transfer_tasks_503_response'
          description: Service Unavailable
components:
  examples:
    200-task-completed:
      summary: Success - Task completed
      value:
        data:
          generated:
            - https://ai-statics.freepik.com/completed_task_image.jpg
          task_id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
          status: COMPLETED
    200-task-in-progress:
      summary: Success - Task in progress
      value:
        data:
          generated: []
          task_id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
```

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

### Available Formats Schema Example

Source: https://docs.magnific.com/api-reference/resources/get-all-resources

Example structure for the available_formats_1 schema, detailing various file types and their associated items.

```yaml
example:
        psd:
          total: 1
          items:
            - name: image.jpg
              colorspace: RGB
            - name: image.jpg
              colorspace: RGB
        ai:
          total: 1
          items:
            - name: image.jpg
              colorspace: RGB
            - name: image.jpg
              colorspace: RGB
        eps:
          total: 1
          items:
            - name: image.jpg
              colorspace: RGB
            - name: image.jpg
              colorspace: RGB
        atn:
          total: 1
          items:
            - name: image.jpg
              colorspace: RGB
            - name: image.jpg
              colorspace: RGB
        fonts:
          total: 1
          items:
            - name: image.jpg
              colorspace: RGB
            - name: image.jpg
              colorspace: RGB
        resources:
          total: 1
          items:
            - name: image.jpg
              colorspace: RGB
            - name: image.jpg
              colorspace: RGB
        png:
          total: 1
          items:
            - name: image.jpg
              colorspace: RGB
            - name: image.jpg
              colorspace: RGB
        jpg:
          total: 1
          items:
            - name: image.jpg
              colorspace: RGB
            - name: image.jpg
              colorspace: RGB
        3d-render:
          total: 1
          items:
            - name: image.jpg
              colorspace: RGB
            - name: image.jpg
              colorspace: RGB
        zip:
          total: 1
          items:
            - name: image.jpg
              colorspace: RGB
            - name: image.jpg
              colorspace: RGB
        svg:
          total: 1
          items:
            - name: image.jpg
              colorspace: RGB
            - name: image.jpg
              colorspace: RGB
```

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

### OpenAPI Specification for List Tasks

Source: https://docs.magnific.com/api-reference/video-edit/happy-horse-1/happy-horse-1-video-edit-tasks

Defines the GET endpoint for retrieving video edit tasks, including response schemas and error handling examples.

```yaml
openapi: 3.0.0
info:
  description: >-
    The Magnific API is your gateway to a vast collection of high-quality
    digital resources for your applications and projects. As a leading platform,
    it offers a wide range of graphics, including vectors, photos,
    illustrations, icons, PSD templates, and more, all curated by talented
    designers from around the world.
  title: Magnific API
  version: 1.0.0
servers:
  - description: B2B API Production V1
    url: https://api.magnific.com
security:
  - magnificApiKey: []
paths:
  /v1/ai/video-edit/happy-horse-1:
    get:
      tags:
        - video-edit
      summary: Happy Horse 1.0 Video Edit - List tasks
      description: >-
        Retrieve the list of all Happy Horse 1.0 video edit tasks for the
        authenticated user.
      operationId: get_all_happy_horse_1_video_edit_tasks
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/get_all_style_transfer_tasks_200_response'
          description: OK - Returns a list of tasks for the current type of Task
        '400':
          content:
            application/json:
              examples:
                invalid_page:
                  summary: Parameter 'page' is not valid
                  value:
                    message: Parameter 'page' must be greater than 0
                invalid_query:
                  summary: Parameter 'query' is not valid
                  value:
                    message: Parameter 'query' must not be empty
                invalid_filter:
                  summary: Parameter 'filter' is not valid
                  value:
                    message: Parameter 'filter' is not valid
                generic_bad_request:
                  summary: Bad Request
                  value:
                    message: Parameter ':attribute' is not valid
              schema:
                $ref: '#/components/schemas/get_all_style_transfer_tasks_400_response'
            application/problem+json:
              examples:
                invalid_page:
                  summary: Parameter 'page' is not valid
                  value:
                    message: Validation error
                    invalid_params:
                      - field: page
                        reason: Parameter 'page' must be greater than 0
                      - field: per_page
                        reason: Parameter 'per_page' must be greater than 0
              schema:
                $ref: >-
                  #/components/schemas/get_all_style_transfer_tasks_400_response_1
          description: >-
            Bad Request - The server could not understand the request due to
            invalid syntax.
        '401':
          content:
            application/json:
              examples:
                invalid_api_key:
                  summary: API key is not valid
                  value:
                    message: Invalid API key
                missing_api_key:
                  summary: API key is not provided
                  value:
                    message: Missing API key
              schema:
                $ref: '#/components/schemas/get_all_style_transfer_tasks_400_response'
          description: >-
            Unauthorized - The client must authenticate itself to get the
            requested response.
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/get_all_style_transfer_tasks_500_response'
          description: >-
            Internal Server Error - The server has encountered a situation it
            doesn't know how to handle.
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/get_all_style_transfer_tasks_503_response'
          description: Service Unavailable
components:
  schemas:
    get_all_style_transfer_tasks_200_response:
      example:
        data:
          - task_id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
            status: CREATED
          - task_id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
            status: CREATED
      properties:
        data:
          items:
            $ref: '#/components/schemas/task'
          type: array
      required:
        - data
      type: object
    get_all_style_transfer_tasks_400_response:
      example:
        message: message
      properties:
        message:
          type: string
      type: object
    get_all_style_transfer_tasks_400_response_1:
      properties:
        problem:
```

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

### OpenAPI Specification for Ideogram Image Edit Tasks

Source: https://docs.magnific.com/api-reference/ideogram-image-edit/get-ideogram-image-edit

The OpenAPI definition for the GET /v1/ai/ideogram-image-edit endpoint, including request parameters, response schemas, and error handling examples.

```yaml
openapi: 3.0.0
info:
  description: >-
    The Magnific API is your gateway to a vast collection of high-quality
    digital resources for your applications and projects. As a leading platform,
    it offers a wide range of graphics, including vectors, photos,
    illustrations, icons, PSD templates, and more, all curated by talented
    designers from around the world.
  title: Magnific API
  version: 1.0.0
servers:
  - description: B2B API Production V1
    url: https://api.magnific.com
security:
  - magnificApiKey: []
paths:
  /v1/ai/ideogram-image-edit:
    get:
      tags:
        - ideogram-image-edit
      summary: Ideogram Image Edit - List tasks
      description: Get the status of all Ideogram Image Edit tasks
      operationId: get_all_ideogram_image_edit_tasks
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/get_all_style_transfer_tasks_200_response'
          description: OK - Returns a list of tasks for the current type of Task
        '400':
          content:
            application/json:
              examples:
                invalid_page:
                  summary: Parameter 'page' is not valid
                  value:
                    message: Parameter 'page' must be greater than 0
                invalid_query:
                  summary: Parameter 'query' is not valid
                  value:
                    message: Parameter 'query' must not be empty
                invalid_filter:
                  summary: Parameter 'filter' is not valid
                  value:
                    message: Parameter 'filter' is not valid
                generic_bad_request:
                  summary: Bad Request
                  value:
                    message: Parameter ':attribute' is not valid
              schema:
                $ref: '#/components/schemas/get_all_style_transfer_tasks_400_response'
            application/problem+json:
              examples:
                invalid_page:
                  summary: Parameter 'page' is not valid
                  value:
                    message: Validation error
                    invalid_params:
                      - field: page
                        reason: Parameter 'page' must be greater than 0
                      - field: per_page
                        reason: Parameter 'per_page' must be greater than 0
              schema:
                $ref: >-
                  #/components/schemas/get_all_style_transfer_tasks_400_response_1
          description: >-
            Bad Request - The server could not understand the request due to
            invalid syntax.
        '401':
          content:
            application/json:
              examples:
                invalid_api_key:
                  summary: API key is not valid
                  value:
                    message: Invalid API key
                missing_api_key:
                  summary: API key is not provided
                  value:
                    message: Missing API key
              schema:
                $ref: '#/components/schemas/get_all_style_transfer_tasks_400_response'
          description: >-
            Unauthorized - The client must authenticate itself to get the
            requested response.
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/get_all_style_transfer_tasks_500_response'
          description: >-
            Internal Server Error - The server has encountered a situation it
            doesn't know how to handle.
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/get_all_style_transfer_tasks_503_response'
          description: Service Unavailable
components:
  schemas:
    get_all_style_transfer_tasks_200_response:
      example:
        data:
          - task_id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
            status: CREATED
          - task_id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
            status: CREATED
      properties:
        data:
          items:
            $ref: '#/components/schemas/task'
          type: array
      required:
        - data
      type: object
    get_all_style_transfer_tasks_400_response:
      example:
        message: message
      properties:
        message:
          type: string
      type: object
    get_all_style_transfer_tasks_400_response_1:
      properties:
        problem:
          $ref: >-
            #/components/schemas/get_all_style_transfer_tasks_400_response_1_problem
      type: object
```

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

### OpenAPI Specification for Listing Kling 3 Omni Tasks

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

Defines the GET endpoint for retrieving reference-to-video tasks, including pagination parameters and various error response examples.

```yaml
openapi: 3.0.0
info:
  description: >-
    The Magnific API is your gateway to a vast collection of high-quality
    digital resources for your applications and projects. As a leading platform,
    it offers a wide range of graphics, including vectors, photos,
    illustrations, icons, PSD templates, and more, all curated by talented
    designers from around the world.
  title: Magnific API
  version: 1.0.0
servers:
  - description: B2B API Production V1
    url: https://api.magnific.com
security:
  - magnificApiKey: []
paths:
  /v1/ai/reference-to-video/kling-v3-omni:
    get:
      tags:
        - reference-to-video
        - kling-v3-omni-r2v
      summary: Kling 3 Omni Reference-to-Video - List tasks
      description: >-
        Retrieve the list of all Kling 3 Omni reference-to-video tasks (both Pro
        and Standard) for the authenticated user.
      operationId: getAiReferenceToVideoKlingV3OmniTasks
      parameters:
        - description: Page number for pagination (1-indexed)
          in: query
          name: page
          schema:
            default: 1
            minimum: 1
            type: integer
        - description: Number of items per page
          in: query
          name: page_size
          schema:
            default: 20
            maximum: 100
            minimum: 1
            type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/get_all_style_transfer_tasks_200_response'
          description: OK - The list of Kling 3 Omni reference-to-video tasks is returned
        '400':
          content:
            application/json:
              examples:
                invalid_page:
                  summary: Parameter 'page' is not valid
                  value:
                    message: Parameter 'page' must be greater than 0
                invalid_query:
                  summary: Parameter 'query' is not valid
                  value:
                    message: Parameter 'query' must not be empty
                invalid_filter:
                  summary: Parameter 'filter' is not valid
                  value:
                    message: Parameter 'filter' is not valid
                generic_bad_request:
                  summary: Bad Request
                  value:
                    message: Parameter ':attribute' is not valid
              schema:
                $ref: '#/components/schemas/get_all_style_transfer_tasks_400_response'
            application/problem+json:
              examples:
                invalid_page:
                  summary: Parameter 'page' is not valid
                  value:
                    message: Validation error
                    invalid_params:
                      - field: page
                        reason: Parameter 'page' must be greater than 0
                      - field: per_page
                        reason: Parameter 'per_page' must be greater than 0
              schema:
                $ref: >-
                  #/components/schemas/get_all_style_transfer_tasks_400_response_1
          description: >-
            Bad Request - The server could not understand the request due to
            invalid syntax.
        '401':
          content:
            application/json:
              examples:
                invalid_api_key:
                  summary: API key is not valid
                  value:
                    message: Invalid API key
                missing_api_key:
                  summary: API key is not provided
                  value:
                    message: Missing API key
              schema:
                $ref: '#/components/schemas/get_all_style_transfer_tasks_400_response'
          description: >-
            Unauthorized - The client must authenticate itself to get the
            requested response.
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/get_all_style_transfer_tasks_500_response'
          description: >-
            Internal Server Error - The server has encountered a situation it
            doesn't know how to handle.
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/get_all_style_transfer_tasks_503_response'
          description: Service Unavailable
components:
  schemas:
    get_all_style_transfer_tasks_200_response:
      example:
        data:
```

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

### Create Pixverse V6 Transition Request

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

Examples of how to initiate a transition request using different programming languages.

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.magnific.com/v1/ai/image-to-video/pixverse-v6-transition"

	payload := strings.NewReader("{\n  \"prompt\": \"<string>\",\n  \"first_image_url\": \"<string>\",\n  \"end_image_url\": \"<string>\",\n  \"aspect_ratio\": \"widescreen_16_9\",\n  \"duration\": 5,\n  \"negative_prompt\": \"\",\n  \"style\": \"anime\",\n  \"seed\": 123,\n  \"generate_audio_switch\": false,\n  \"generate_multi_clip_switch\": false,\n  \"thinking_type\": \"enabled\",\n  \"webhook_url\": \"https://www.example.com/webhook\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-magnific-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

```java
HttpResponse<String> response = Unirest.post("https://api.magnific.com/v1/ai/image-to-video/pixverse-v6-transition")
  .header("x-magnific-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"prompt\": \"<string>\",\n  \"first_image_url\": \"<string>\",\n  \"end_image_url\": \"<string>\",\n  \"aspect_ratio\": \"widescreen_16_9\",\n  \"duration\": 5,\n  \"negative_prompt\": \"\",\n  \"style\": \"anime\",\n  \"seed\": 123,\n  \"generate_audio_switch\": false,\n  \"generate_multi_clip_switch\": false,\n  \"thinking_type\": \"enabled\",\n  \"webhook_url\": \"https://www.example.com/webhook\"\n}")
  .asString();
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.magnific.com/v1/ai/image-to-video/pixverse-v6-transition")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-magnific-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"prompt\": \"<string>\",\n  \"first_image_url\": \"<string>\",\n  \"end_image_url\": \"<string>\",\n  \"aspect_ratio\": \"widescreen_16_9\",\n  \"duration\": 5,\n  \"negative_prompt\": \"\",\n  \"style\": \"anime\",\n  \"seed\": 123,\n  \"generate_audio_switch\": false,\n  \"generate_multi_clip_switch\": false,\n  \"thinking_type\": \"enabled\",\n  \"webhook_url\": \"https://www.example.com/webhook\"\n}"

response = http.request(request)
puts response.read_body
```

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

### Dimension Property Example

Source: https://docs.magnific.com/api-reference/resources/get-the-detail-of-a-resource-psd-vector-or-photo

Individual examples for width and height integer properties.

```yaml
          example: 2000
```

```yaml
          example: 3000
```
Tokens:
Raw