Saltar al contenido principal
POST
/
v1
/
videos
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "MiniMax-Hailuo-02",
    "prompt": "A cute cat running on the grass",
    "duration": 5,
    "resolution": "768p",
    "prompt_optimizer": true,
    "fast_pretreatment": false,
    "watermark": false
  }'
import requests

url = "https://api.apimart.ai/v1/videos/generations"

payload = {
    "model": "MiniMax-Hailuo-02",
    "prompt": "A cute cat running on the grass",
    "duration": 5,
    "resolution": "768p",
    "prompt_optimizer": True,
    "fast_pretreatment": False,
    "watermark": False
}

headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())
const url = "https://api.apimart.ai/v1/videos/generations";

const payload = {
  model: "MiniMax-Hailuo-02",
  prompt: "A cute cat running on the grass",
  duration: 5,
  resolution: "768p",
  prompt_optimizer: true,
  fast_pretreatment: false,
  watermark: false
};

const headers = {
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
};

fetch(url, {
  method: "POST",
  headers: headers,
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));
package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io/ioutil"
    "net/http"
)

func main() {
    url := "https://api.apimart.ai/v1/videos/generations"

    payload := map[string]interface{}{
        "model":              "MiniMax-Hailuo-02",
        "prompt":             "A cute cat running on the grass",
        "duration":           5,
        "resolution":         "768p",
        "prompt_optimizer":   true,
        "fast_pretreatment":  false,
        "watermark":          false,
    }

    jsonData, _ := json.Marshal(payload)

    req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
    req.Header.Set("Authorization", "Bearer <token>")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := ioutil.ReadAll(resp.Body)
    fmt.Println(string(body))
}
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
    public static void main(String[] args) throws Exception {
        String url = "https://api.apimart.ai/v1/videos/generations";

        String payload = """
        {
          "model": "MiniMax-Hailuo-02",
          "prompt": "A cute cat running on the grass",
          "duration": 5,
          "resolution": "768p",
          "prompt_optimizer": true,
          "fast_pretreatment": false,
          "watermark": false
        }
        """;

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(url))
            .header("Authorization", "Bearer <token>")
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(payload))
            .build();

        HttpResponse<String> response = client.send(request,
            HttpResponse.BodyHandlers.ofString());

        System.out.println(response.body());
    }
}
<?php

$url = "https://api.apimart.ai/v1/videos/generations";

$payload = [
    "model" => "MiniMax-Hailuo-02",
    "prompt" => "A cute cat running on the grass",
    "duration" => 5,
    "resolution" => "768p",
    "prompt_optimizer" => true,
    "fast_pretreatment" => false,
    "watermark" => false
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>
require 'net/http'
require 'json'
require 'uri'

url = URI("https://api.apimart.ai/v1/videos/generations")

payload = {
  model: "MiniMax-Hailuo-02",
  prompt: "A cute cat running on the grass",
  duration: 5,
  resolution: "768p",
  prompt_optimizer: true,
  fast_pretreatment: false,
  watermark: false
}

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = "Bearer <token>"
request["Content-Type"] = "application/json"
request.body = payload.to_json

response = http.request(request)
puts response.body
import Foundation

let url = URL(string: "https://api.apimart.ai/v1/videos/generations")!

let payload: [String: Any] = [
    "model": "MiniMax-Hailuo-02",
    "prompt": "A cute cat running on the grass",
    "duration": 5,
    "resolution": "768p",
    "prompt_optimizer": true,
    "fast_pretreatment": false,
    "watermark": false
]

var request = URLRequest(url: url)
request.httpMethod = "POST"
request.setValue("Bearer <token>", forHTTPHeaderField: "Authorization")
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
request.httpBody = try? JSONSerialization.data(withJSONObject: payload)

let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let error = error {
        print("Error: \(error)")
        return
    }
    
    if let data = data, let responseString = String(data: data, encoding: .utf8) {
        print(responseString)
    }
}

task.resume()
using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        var url = "https://api.apimart.ai/v1/videos/generations";

        var payload = @"{
            ""model"": ""MiniMax-Hailuo-02"",
            ""prompt"": ""A cute cat running on the grass"",
            ""duration"": 5,
            ""resolution"": ""768p"",
            ""prompt_optimizer"": true,
            ""fast_pretreatment"": false,
            ""watermark"": false
        }";

        using var client = new HttpClient();
        client.DefaultRequestHeaders.Add("Authorization", "Bearer <token>");

        var content = new StringContent(payload, Encoding.UTF8, "application/json");
        var response = await client.PostAsync(url, content);
        var result = await response.Content.ReadAsStringAsync();

        Console.WriteLine(result);
    }
}
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}
{
  "error": {
    "code": 400,
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}
{
  "error": {
    "code": 401,
    "message": "Authentication failed, please check your API key",
    "type": "authentication_error"
  }
}
{
  "error": {
    "code": 402,
    "message": "Insufficient account balance, please recharge",
    "type": "payment_required"
  }
}
{
  "error": {
    "code": 429,
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}
{
  "error": {
    "code": 500,
    "message": "Internal server error, please try again later",
    "type": "server_error"
  }
}
curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "MiniMax-Hailuo-02",
    "prompt": "A cute cat running on the grass",
    "duration": 5,
    "resolution": "768p",
    "prompt_optimizer": true,
    "fast_pretreatment": false,
    "watermark": false
  }'
import requests

url = "https://api.apimart.ai/v1/videos/generations"

payload = {
    "model": "MiniMax-Hailuo-02",
    "prompt": "A cute cat running on the grass",
    "duration": 5,
    "resolution": "768p",
    "prompt_optimizer": True,
    "fast_pretreatment": False,
    "watermark": False
}

headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())
const url = "https://api.apimart.ai/v1/videos/generations";

const payload = {
  model: "MiniMax-Hailuo-02",
  prompt: "A cute cat running on the grass",
  duration: 5,
  resolution: "768p",
  prompt_optimizer: true,
  fast_pretreatment: false,
  watermark: false
};

const headers = {
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
};

fetch(url, {
  method: "POST",
  headers: headers,
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));
package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io/ioutil"
    "net/http"
)

func main() {
    url := "https://api.apimart.ai/v1/videos/generations"

    payload := map[string]interface{}{
        "model":              "MiniMax-Hailuo-02",
        "prompt":             "A cute cat running on the grass",
        "duration":           5,
        "resolution":         "768p",
        "prompt_optimizer":   true,
        "fast_pretreatment":  false,
        "watermark":          false,
    }

    jsonData, _ := json.Marshal(payload)

    req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
    req.Header.Set("Authorization", "Bearer <token>")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := ioutil.ReadAll(resp.Body)
    fmt.Println(string(body))
}
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
    public static void main(String[] args) throws Exception {
        String url = "https://api.apimart.ai/v1/videos/generations";

        String payload = """
        {
          "model": "MiniMax-Hailuo-02",
          "prompt": "A cute cat running on the grass",
          "duration": 5,
          "resolution": "768p",
          "prompt_optimizer": true,
          "fast_pretreatment": false,
          "watermark": false
        }
        """;

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(url))
            .header("Authorization", "Bearer <token>")
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(payload))
            .build();

        HttpResponse<String> response = client.send(request,
            HttpResponse.BodyHandlers.ofString());

        System.out.println(response.body());
    }
}
<?php

$url = "https://api.apimart.ai/v1/videos/generations";

$payload = [
    "model" => "MiniMax-Hailuo-02",
    "prompt" => "A cute cat running on the grass",
    "duration" => 5,
    "resolution" => "768p",
    "prompt_optimizer" => true,
    "fast_pretreatment" => false,
    "watermark" => false
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>
require 'net/http'
require 'json'
require 'uri'

url = URI("https://api.apimart.ai/v1/videos/generations")

payload = {
  model: "MiniMax-Hailuo-02",
  prompt: "A cute cat running on the grass",
  duration: 5,
  resolution: "768p",
  prompt_optimizer: true,
  fast_pretreatment: false,
  watermark: false
}

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = "Bearer <token>"
request["Content-Type"] = "application/json"
request.body = payload.to_json

response = http.request(request)
puts response.body
import Foundation

let url = URL(string: "https://api.apimart.ai/v1/videos/generations")!

let payload: [String: Any] = [
    "model": "MiniMax-Hailuo-02",
    "prompt": "A cute cat running on the grass",
    "duration": 5,
    "resolution": "768p",
    "prompt_optimizer": true,
    "fast_pretreatment": false,
    "watermark": false
]

var request = URLRequest(url: url)
request.httpMethod = "POST"
request.setValue("Bearer <token>", forHTTPHeaderField: "Authorization")
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
request.httpBody = try? JSONSerialization.data(withJSONObject: payload)

let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let error = error {
        print("Error: \(error)")
        return
    }
    
    if let data = data, let responseString = String(data: data, encoding: .utf8) {
        print(responseString)
    }
}

task.resume()
using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        var url = "https://api.apimart.ai/v1/videos/generations";

        var payload = @"{
            ""model"": ""MiniMax-Hailuo-02"",
            ""prompt"": ""A cute cat running on the grass"",
            ""duration"": 5,
            ""resolution"": ""768p"",
            ""prompt_optimizer"": true,
            ""fast_pretreatment"": false,
            ""watermark"": false
        }";

        using var client = new HttpClient();
        client.DefaultRequestHeaders.Add("Authorization", "Bearer <token>");

        var content = new StringContent(payload, Encoding.UTF8, "application/json");
        var response = await client.PostAsync(url, content);
        var result = await response.Content.ReadAsStringAsync();

        Console.WriteLine(result);
    }
}
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}
{
  "error": {
    "code": 400,
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}
{
  "error": {
    "code": 401,
    "message": "Authentication failed, please check your API key",
    "type": "authentication_error"
  }
}
{
  "error": {
    "code": 402,
    "message": "Insufficient account balance, please recharge",
    "type": "payment_required"
  }
}
{
  "error": {
    "code": 429,
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}
{
  "error": {
    "code": 500,
    "message": "Internal server error, please try again later",
    "type": "server_error"
  }
}

Autorización

Authorization
string
requerido
Todos los endpoints de la API requieren autenticación mediante Bearer TokenObtenga su API Key:Visite la página de gestión de API Keys para obtener su API KeyAñádala a la cabecera de la solicitud:
Authorization: Bearer YOUR_API_KEY

Parámetros de la solicitud

model
string
requerido
Nombre del modelo de generación de videoValor fijo: MiniMax-Hailuo-02
prompt
string
requerido
Descripción del contenido del videoDescriba la escena, las acciones, el estilo, etc. en detalle para obtener mejores resultadosEjemplo: "A cute cat running on the grass"
duration
integer
predeterminado:"5"
Duración del video (segundos)Opciones:
  • 5 - Video de 5 segundos
  • 10 - Video de 10 segundos
Predeterminado: 5
Limitación 1080p: Cuando se usa la resolución 1080p, solo se admite duración de 5 segundos
resolution
string
predeterminado:"768p"
Resolución del videoOpciones:
  • 512p - Definición estándar
  • 768p - Alta definición
  • 1080p - Full HD (solo admite duración de 5 segundos)
Predeterminado: 768p
prompt_optimizer
boolean
predeterminado:"true"
Si se debe optimizar automáticamente el promptCuando se habilita, el sistema optimizará automáticamente su prompt para obtener mejores resultadosPredeterminado: true
fast_pretreatment
boolean
predeterminado:"false"
Si se reduce el tiempo de optimización del promptHabilitarlo puede acelerar el procesamiento, pero puede afectar ligeramente a la calidad de la optimizaciónPredeterminado: false
watermark
boolean
predeterminado:"false"
Si se añade marca de aguaPredeterminado: false
first_frame_image
string
Imagen del primer fotograma del videoAdmite dos formatos:
  • URL pública: https://example.com/start.jpg
  • Codificado en Base64: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
Se usa para especificar el fotograma inicial del video
last_frame_image
string
Imagen del último fotograma del videoAdmite dos formatos:
  • URL pública: https://example.com/end.jpg
  • Codificado en Base64: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
Se usa para especificar el fotograma final del video

Limitaciones de los parámetros

LimitaciónDescripción
DuraciónSolo admite 5 o 10 segundos
Resolución 1080pSolo admite duración de 5 segundos
Formato de imagenAdmite URL pública o codificación Base64 (data:image/jpeg;base64,...)

Combinaciones de resolución y duración

ResoluciónDuración admitidaNotas
512p5s, 10sTodas admitidas
768p5s, 10sTodas admitidas
1080p5s10s no admitido

Respuesta

code
integer
Código de estado de la respuesta, 200 en caso de éxito
data
array
Array de datos de la respuesta

Casos de uso

Caso 1: Generación rápida texto-a-video

{
  "model": "MiniMax-Hailuo-02",
  "prompt": "A cute cat running on the grass in bright sunshine"
}

Caso 2: Generar video 1080p de alta calidad

{
  "model": "MiniMax-Hailuo-02",
  "prompt": "City night scene, neon lights flashing, traffic flowing",
  "duration": 5,
  "resolution": "1080p",
  "prompt_optimizer": true,
  "watermark": false
}

Caso 3: Generar video a partir del primer fotograma

{
  "model": "MiniMax-Hailuo-02",
  "prompt": "Person slowly turning around with a smile",
  "duration": 5,
  "resolution": "768p",
  "first_frame_image": "https://example.com/portrait.jpg"
}

Caso 4: Video de transición con control de primer y último fotograma

{
  "model": "MiniMax-Hailuo-02",
  "prompt": "Scene gradually transitions from day to night, sky color changing",
  "duration": 10,
  "resolution": "768p",
  "first_frame_image": "https://example.com/day.jpg",
  "last_frame_image": "https://example.com/night.jpg",
  "prompt_optimizer": true
}

Caso 5: Modo de preprocesamiento rápido

{
  "model": "MiniMax-Hailuo-02",
  "prompt": "Waves crashing on the beach at sunset",
  "duration": 5,
  "resolution": "768p",
  "prompt_optimizer": true,
  "fast_pretreatment": true
}
Consultar los resultados de la tareaLa generación de video es una tarea asíncrona que devuelve un task_id al enviarla. Use el endpoint Obtener estado de tarea para consultar el progreso y los resultados de la generación.