PopNowAPI-Doku
Hauptinhalt

MiniMax H3 API-Referenz

Ausdrucksstarke Clips mit Ton, bis 2K

Mit einem einzigen PopNow-API-Schlüssel rufst du MiniMax H3 aus deinem eigenen Code auf. Hier findest du die Modell-IDs, jedes Eingabefeld, die Kosten pro Anfrage in Credits und eine Anfrage, die du direkt ins Terminal kopieren kannst.

Die Parameterbeschreibungen stammen aus dem Eingabeschema des Modells und sind nur auf Englisch verfügbar.

Auf einen Blick

Hersteller
MiniMax
Ergebnis
Video
Ab
5.55 Credits pro Sekunde Ergebnis ($0.0555)
Typische Dauer
etwa 33 s

1 Credit = 0,01 $. Bei Annahme reserviert ein Task den höchstmöglichen Betrag und rechnet am Ende den tatsächlichen Verbrauch ab, auf ganze Credits aufgerundet; der Rest wird freigegeben. Fehlgeschlagene Tasks kosten nichts. Den genauen Betrag vorab liefert POST /api/v1/jobs/quote.

Video erstellen

minimax/h3/text-to-video

Preis

OptionCredits (pro Sekunde Ergebnis)US-Dollar
768p5.55$0.0555
2k8.7$0.087

Parameter

FeldTypStandardwertErlaubtBedeutung
promptPflichtstring—bis zu 7.000 ZeichenDescribe the picture, the action, the camera, the sound, and the boundaries for the shot.
aspect_ratioOptionalstring16:916:9, 9:16, 1:1, 4:3, 3:4, 21:9Output aspect ratio.
resolutionOptionalstring768p768p, 2kOutput resolution.
duration_secondsOptionalinteger55 bis 15Requested output length in seconds.
enable_prompt_expansionOptionalbooleanfalsefalseAccepted for compatibility only. This endpoint does not expand prompts, so the only allowed value is false.

Beispielanfrage

Diese Anfrage läuft so, wie sie ist; weggelassene Felder behalten ihren Standardwert. Leg deinen Schlüssel vorher in POPNOW_API_KEY ab.

POST /api/v1/jobs/createTask?wait=60
curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask?wait=60" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "minimax/h3/text-to-video",
  "input": {
    "prompt": "A paper boat drifts down a rain-soaked street at dusk, neon signs reflecting in the water, slow tracking shot at ground level",
    "duration_seconds": 5,
    "resolution": "768p"
  }
}'

Die Antwort enthält sofort eine taskId. Das Ergebnis holst du mit GET /api/v1/jobs/recordInfo ab – oder du gibst callBackUrl mit und wirst benachrichtigt.

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

Bild zu Video

minimax/h3/image-to-video

Preis

OptionCredits (pro Sekunde Ergebnis)US-Dollar
768p5.55$0.0555
2k8.7$0.087

Parameter

FeldTypStandardwertErlaubtBedeutung
promptPflichtstring—bis zu 7.000 ZeichenDescribe what happens after the opening frame: the action, the camera, and the sound.
image_urlPflichtstring (uri)——Authorised opening frame.
last_image_urlOptionalstring (uri)——Optional closing frame the clip should resolve to.
resolutionOptionalstring768p768p, 2kOutput resolution.
duration_secondsOptionalinteger54 bis 15Requested output length in seconds.
enable_prompt_expansionOptionalbooleanfalsefalseAccepted for compatibility only. This endpoint does not expand prompts, so the only allowed value is false.

Beispielanfrage

Diese Anfrage läuft so, wie sie ist; weggelassene Felder behalten ihren Standardwert. Leg deinen Schlüssel vorher in POPNOW_API_KEY ab.

Das Beispiel nutzt in image_url Beispieldateien von PopNow. Ersetze sie durch eigene öffentliche HTTPS-Links, Uploads oder gespeicherte Assets.

POST /api/v1/jobs/createTask
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: $(uuidgen)" \
  -d '{
  "model": "minimax/h3/image-to-video",
  "input": {
    "prompt": "He lands softly on the rooftop, laughs and turns toward the camera while the balloons sway in the evening breeze; slow push-in",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "duration_seconds": 5,
    "resolution": "768p"
  }
}'

Die Antwort enthält sofort eine taskId. Das Ergebnis holst du mit GET /api/v1/jobs/recordInfo ab – oder du gibst callBackUrl mit und wirst benachrichtigt.

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

Referenz zu Video

minimax/h3/reference-to-video

Preis

OptionCredits (pro Sekunde Ergebnis)US-Dollar
768p5.55$0.0555
2k8.7$0.087

Parameter

FeldTypStandardwertErlaubtBedeutung
promptPflichtstring—bis zu 7.000 ZeichenRefer to the references by number and describe the shot they should produce.
reference_image_urlsPflichtarray<string (uri)>—bis zu 9 EinträgeAuthorised image references, up to nine.
reference_video_urlsOptionalarray<string (uri)>—bis zu 3 EinträgeUp to three reference videos, 2 to 15 seconds each and 15 seconds in total. Refer to them in the prompt as <Video 1> and so on. Their seconds have their own per-second rate, lower than output seconds.
reference_audio_urlsOptionalarray<string (uri)>—bis zu 3 EinträgeUp to three reference audio clips (WAV or MP3), 2 to 15 seconds each and 15 seconds in total, for a voice or a sound.
aspect_ratioOptionalstring16:916:9, 9:16, 1:1, 4:3, 3:4, 21:9Output aspect ratio.
resolutionOptionalstring768p768p, 2kOutput resolution.
duration_secondsOptionalinteger54 bis 15Requested output length in seconds.
enable_prompt_expansionOptionalbooleanfalsefalseAccepted for compatibility only. This endpoint does not expand prompts, so the only allowed value is false.

Beispielanfrage

Diese Anfrage läuft so, wie sie ist; weggelassene Felder behalten ihren Standardwert. Leg deinen Schlüssel vorher in POPNOW_API_KEY ab.

Das Beispiel nutzt in reference_image_urls Beispieldateien von PopNow. Ersetze sie durch eigene öffentliche HTTPS-Links, Uploads oder gespeicherte Assets.

POST /api/v1/jobs/createTask
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: $(uuidgen)" \
  -d '{
  "model": "minimax/h3/reference-to-video",
  "input": {
    "prompt": "The man from the reference image jogs across a sunlit rooftop at golden hour and smiles at the camera; smooth tracking shot",
    "reference_image_urls": [
      "https://media.popnow.ai/influencer/examples/ava.webp"
    ],
    "duration_seconds": 5,
    "resolution": "768p"
  }
}'

Die Antwort enthält sofort eine taskId. Das Ergebnis holst du mit GET /api/v1/jobs/recordInfo ab – oder du gibst callBackUrl mit und wirst benachrichtigt.

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

Video verlängern

minimax/h3/video-extend

Preis

OptionCredits (pro Sekunde Ergebnis)US-Dollar
768p5.55$0.0555
2k8.7$0.087

Parameter

FeldTypStandardwertErlaubtBedeutung
promptPflichtstring—bis zu 7.000 ZeichenDescribe what happens next: the action that follows, the camera move and the sound.
video_urlPflichtstring (uri)——The clip to continue: MP4, MOV or WebM, up to 60 seconds. Its last frame opens the new segment, and the result is your clip with the new segment joined on.
last_image_urlOptionalstring (uri)——Optional target end frame: the new segment closes on this image.
resolutionOptionalstring768p768p, 2kResolution of the new segment. It sets how sharp the new part is generated; match your source clip.
duration_secondsOptionalinteger54 bis 15Length of the new segment in seconds, from 4 to 15. The source clip is added on top and is not billed.
enable_prompt_expansionOptionalbooleanfalsefalseAccepted for compatibility only. This endpoint does not expand prompts, so the only allowed value is false.

Beispielanfrage

Diese Anfrage läuft so, wie sie ist; weggelassene Felder behalten ihren Standardwert. Leg deinen Schlüssel vorher in POPNOW_API_KEY ab.

Das Beispiel nutzt in video_url Beispieldateien von PopNow. Ersetze sie durch eigene öffentliche HTTPS-Links, Uploads oder gespeicherte Assets.

POST /api/v1/jobs/createTask
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: $(uuidgen)" \
  -d '{
  "model": "minimax/h3/video-extend",
  "input": {
    "prompt": "The flowers keep opening while the camera slowly pulls back to reveal a sunlit meadow",
    "video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
    "duration_seconds": 5,
    "resolution": "768p"
  }
}'

Die Antwort enthält sofort eine taskId. Das Ergebnis holst du mit GET /api/v1/jobs/recordInfo ab – oder du gibst callBackUrl mit und wirst benachrichtigt.

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

Weiter geht’s

Auf dieser Seite