PopNowAPI
Odbierz klucz API

MiniMax H3 Plus API

od MiniMax

MiniMax H3: wideo z obrazu z opcjonalną klatką końcową

minimax/h3-plus/image-to-video
  • Do 1080p
  • Klipy 3–15 s
  • Pierwsza i ostatnia klatka
  • Obraz w wideo
  • Wydłuż wideo

Wywołujesz go nazwą modelu minimax/h3-plus/image-to-video w POST /jobs/createTask, od 0,19 USD.

Nazwa modeluminimax/h3-plus/image-to-video
EndpointPOST https://api.popnow.ai/api/v1/jobs/createTask
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "minimax/h3-plus/image-to-video",
  "input": {
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "duration_seconds": 5,
    "resolution": "480p"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

input jest zbudowany ze schematu poniżej, więc przechodzi walidację bez zmian. Zamień prompt i linki na własne.

Cena

OpcjaUSD za sekundę
resolution 480p0,038 USD
resolution 540p0,057 USD
resolution 768p0,084 USD
resolution 1080p0,152 USD

Rozliczenie w USD · Wszystkie opcje i ceny: GET /models/minimax/h3-plus/image-to-video

Limity

Długość klipu
3–15 s
Rozdzielczości
480p · 540p · 768p · 1080p

Parametry

Te pola pochodzą z tego samego schematu, którym sprawdzamy każde żądanie. Pola spoza listy są odrzucane.

  • image_urlstringWymagane

    Obraz, od którego zaczynasz.

    Zakres
    image/jpeg, image/png, image/webp, image/gif
  • last_image_urlstringOpcjonalne

    Opcjonalna ostatnia klatka, żeby klip skończył się dokładnie tam, gdzie chcesz.

    Zakres
    image/jpeg, image/png, image/webp, image/gif
  • promptstringOpcjonalne

    Describe what happens after the opening frame: the action, the camera, and the mood.

  • duration_secondsintegerOpcjonalneZmienia cenę

    Długość klipu. Płacisz za każdą sekundę.

    Domyślnie
    5
    Zakres
    3 – 15
  • resolutionstringOpcjonalneZmienia cenę

    Rozmiar wyniku. Większy jest ostrzejszy i droższy.

    Domyślnie
    "480p"
    Dozwolone wartości
    "480p""540p""768p""1080p"
  • seedintegerOpcjonalne

    Ta sama liczba daje powtarzalny wynik.

    Zakres
    0 – 2147483647
Surowy JSON Schema
{
  "additionalProperties": false,
  "properties": {
    "duration_seconds": {
      "default": 5,
      "description": "Requested output length in seconds, from 3 to 15.",
      "maximum": 15,
      "minimum": 3,
      "type": "integer"
    },
    "image_url": {
      "contentMediaType": [
        "image/jpeg",
        "image/png",
        "image/webp",
        "image/gif"
      ],
      "description": "Opening frame. The clip starts from this image.",
      "type": "string"
    },
    "last_image_url": {
      "contentMediaType": [
        "image/jpeg",
        "image/png",
        "image/webp",
        "image/gif"
      ],
      "description": "Closing frame. It may only be sent together with an opening frame.",
      "type": "string"
    },
    "prompt": {
      "description": "Describe what happens after the opening frame: the action, the camera, and the mood.",
      "type": "string"
    },
    "resolution": {
      "default": "480p",
      "description": "Output resolution.",
      "enum": [
        "480p",
        "540p",
        "768p",
        "1080p"
      ],
      "type": "string"
    },
    "seed": {
      "description": "Random seed for controlled comparisons. Omit it for variety.",
      "maximum": 2147483647,
      "minimum": 0,
      "type": "integer"
    }
  },
  "required": [
    "image_url"
  ],
  "type": "object"
}

Odpowiedzi, odpytywanie i callbacki

Wszystkie modele działają tak samo: utwórz zadanie, a potem odpytuj je albo poczekaj na callback.

Najpierw cena

cURL
curl -X POST https://api.popnow.ai/api/v1/jobs/quote \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "minimax/h3-plus/image-to-video",
  "input": {
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "duration_seconds": 5,
    "resolution": "480p"
  }
}'

Przed uruchomieniem wyślij tę samą treść żądania do POST /jobs/quote, aby zobaczyć szacowaną i maksymalną opłatę w USD. Wycena nie uruchamia zadania ani nie obciąża salda.

Przyjęte

HTTP
HTTP/1.1 202 Accepted

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "state": "queued"
  },
  "request_id": "req_example_create"
}

HTTP 202 oznacza przyjęcie zadania: maksymalna kwota w USD pozostaje zarezerwowana do rozliczenia. Po przyjęciu zadania rezerwujemy maksymalną kwotę wyceny na saldzie API. Po zakończeniu naliczamy opłatę za rzeczywiste użycie, nie wyższą niż rezerwacja, i zwalniamy resztę. Jeśli zadanie się nie powiedzie, rezerwacja zostaje zwolniona.

Sprawdź status

cURL
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Odpytuj co kilka sekund, stopniowo wydłużając odstęp, i przestań, gdy state ma wartość succeeded, failed, canceled lub expired.

Gotowe zadanie

JSON
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "model": "minimax/h3-plus/image-to-video",
    "state": "succeeded",
    "output": {
      "assets": [
        {
          "url": "https://cdn.popnow.ai/tasks/task_01k3m8x9q2z4v7n5p6r8s0t1w3/output.mp4?signature=FROM_RESPONSE",
          "expiresAt": "2026-10-17T12:20:00Z",
          "mime": "video/mp4",
          "width": 1280,
          "height": 720,
          "durationSeconds": 5
        }
      ]
    },
    "settled": true
  },
  "request_id": "req_example_record"
}

Pobierz plik z url przed expiresAt. Potrzebujesz później nowego linku? Poproś o niego przez POST /common/download-url.

Weryfikacja callbacku

Node.js
import { createHash, createHmac, timingSafeEqual } from "node:crypto";
import express from "express";

const app = express();
// express.raw keeps the exact bytes that were signed; express.json would not match.
app.post("/hooks/popnow", express.raw({ type: "application/json" }), (req, res) => {
  const timestamp = req.header("X-Webhook-Timestamp");
  const signature = req.header("X-Webhook-Signature") ?? "";
  const body = JSON.parse(req.body.toString("utf8"));
  const taskId = body.data?.taskId ?? body.task_id;
  const digest = createHash("sha256").update(req.body).digest("hex");
  const expected = createHmac("sha256", process.env.POPNOW_WEBHOOK_SECRET)
    .update(`${taskId}.${timestamp}.${digest}`)
    .digest("base64");
  const ok = expected.length === signature.length && timingSafeEqual(Buffer.from(expected), Buffer.from(signature));
  // Check the signature first, then reject anything older than five minutes.
  if (!ok || Math.abs(Date.now() / 1000 - Number(timestamp)) > 300) return res.status(401).end();
  res.status(200).end(); // answer fast, then fetch the task and store its files
});

Gdy ustawisz callBackUrl, wyślemy ci gotowe zadanie. Zanim mu zaufasz, sprawdź podpis na surowym ciele żądania.

Wysyłanie pliku lokalnego

cURL
curl -X POST https://api.popnow.ai/api/v1/common/upload-url \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contentType": "image/png", "bytes": 482113}'

# PUT the file bytes to data.uploadUrl with every header in data.headers, then commit it:
curl -X POST https://api.popnow.ai/api/v1/files/$FILE_ID/commit \
  -H "Authorization: Bearer $POPNOW_API_KEY"
# The commit returns a popnow://f/... reference. Put it in any image, video or
# audio field of the task input instead of a public https URL.

Publiczne linki https działają bez zmian. Pliki lokalne przechodzą najpierw przez upload-url i commit.

O modelu MiniMax H3 Plus

MiniMax H3: wideo z obrazu z opcjonalną klatką końcową.

Wywołujesz go nazwą modelu minimax/h3-plus/image-to-video w POST /jobs/createTask, od 0,19 USD.

Parametry żądania

ParametrWymaganyOpis
duration_secondsNieDługość klipu. Płacisz za każdą sekundę. ≥ 3 · ≤ 15 · Domyślnie: 5
image_urlTakObraz, od którego zaczynasz.
last_image_urlNieOpcjonalna ostatnia klatka, żeby klip skończył się dokładnie tam, gdzie chcesz.
promptNieDescribe what happens after the opening frame: the action, the camera, and the mood.
resolutionNieRozmiar wyniku. Większy jest ostrzejszy i droższy. 480p · 540p · 768p · 1080p · Domyślnie: 480p
seedNieTa sama liczba daje powtarzalny wynik. ≥ 0 · ≤ 2147483647

Ceny

Ceny podano w USD. API korzysta z oddzielnego salda w dolarach amerykańskich. Kredytów strony nie można używać w API ani zamieniać na saldo API. Nie można też zamieniać salda API na kredyty strony. Po przyjęciu zadania rezerwujemy maksymalną kwotę wyceny na saldzie API. Po zakończeniu naliczamy opłatę za rzeczywiste użycie, nie wyższą niż rezerwacja, i zwalniamy resztę. Jeśli zadanie się nie powiedzie, rezerwacja zostaje zwolniona.

OpcjaUSD za sekundę
resolution 480p0,038 USD
resolution 540p0,057 USD
resolution 768p0,084 USD
resolution 1080p0,152 USD

Przed uruchomieniem wyślij tę samą treść żądania do POST /jobs/quote, aby zobaczyć szacowaną i maksymalną opłatę w USD. Wycena nie uruchamia zadania ani nie obciąża salda.

Szybki start z API

Wywołaj API MiniMax H3 Plus w trzech krokach

  1. Utwórz klucz API. Zaloguj się do PopNow i utwórz klucz w konsoli API. Klucze zaczynają się od sk-popnow-. Wywołania korzystają z oddzielnego salda w dolarach amerykańskich.
  2. Wyślij żądanie. Wyślij POST /jobs/createTask z model minimax/h3-plus/image-to-video i obiektem input zgodnym z tabelą parametrów. Odpowiedź od razu zwraca ID zadania.
  3. Odbierz wynik. Odpytuj GET /jobs/recordInfo po ID zadania albo podaj callBackUrl, a wyślemy tam wynik. Gdy zadanie się powiedzie, pobierz pliki z linków wyjściowych.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "minimax/h3-plus/image-to-video",
  "input": {
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "duration_seconds": 5,
    "resolution": "480p"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Podmień prompt i linki na własne. Odniesienie do odpowiedzi, odpytywania i callbacku znajdziesz na karcie API.

Pytania o API MiniMax H3 Plus

Ile kosztuje API MiniMax H3 Plus?

MiniMax H3 Plus kosztuje od 0,19 USD za klip 5-sekundowy – najtańsze zadanie to „Obraz w wideo”. Ceny według opcji: 480p 0,038 USD za sekundę, 540p 0,057 USD za sekundę, 768p 0,084 USD za sekundę, 1080p 0,152 USD za sekundę. API korzysta z oddzielnego salda w dolarach amerykańskich. Kredytów strony nie można używać w API ani zamieniać na saldo API. Nie można też zamieniać salda API na kredyty strony. Po przyjęciu zadania rezerwujemy maksymalną kwotę wyceny na saldzie API. Po zakończeniu naliczamy opłatę za rzeczywiste użycie, nie wyższą niż rezerwacja, i zwalniamy resztę. Jeśli zadanie się nie powiedzie, rezerwacja zostaje zwolniona.

Jaka jest nazwa modelu MiniMax H3 Plus w API?

Wpisz minimax/h3-plus/image-to-video do zadania Obraz w wideo; minimax/h3-plus/video-extend do zadania Wydłuż wideo w polu model żądania POST /jobs/createTask.

Jakie limity ma API MiniMax H3 Plus?

Długość klipu: 3–15 s; Rozdzielczości: 480p · 540p · 768p · 1080p. Żądania poza tymi limitami są odrzucane, zanim cokolwiek zostanie pobrane.

Więcej o MiniMax H3 Plus