Riferimento API di MiniMax H3
Clip espressive con audio, fino al 2K
Con una sola chiave API di PopNow chiami MiniMax H3 dal tuo codice. Qui trovi gli ID del modello da inviare, ogni campo di input accettato, quanti crediti costa ogni richiesta e una richiesta da incollare nel terminale così com’è.
Le descrizioni dei parametri provengono dallo schema di input del modello e sono disponibili solo in inglese.
In sintesi
- Sviluppato da
- MiniMax
- Risultato
- Video
- Da
- 5.55 crediti per secondo generato ($0.0555)
- Tempo tipico
- circa 33 s
1 credito = 0,01 $. All’accettazione l’attività trattiene l’importo massimo possibile e alla fine addebita il consumo reale, arrotondato al credito superiore; il resto viene sbloccato. Le attività non riuscite non vengono addebitate. Per conoscere la cifra esatta prima di eseguire, chiama POST /api/v1/jobs/quote.
Crea video
minimax/h3/text-to-video
Prezzo
| Opzione | Crediti (per secondo generato) | Dollari USA |
|---|---|---|
768p | 5.55 | $0.0555 |
2k | 8.7 | $0.087 |
Parametri
| Campo | Tipo | Predefinito | Valori ammessi | A cosa serve |
|---|---|---|---|---|
promptObbligatorio | string | — | fino a 7000 caratteri | Describe the picture, the action, the camera, the sound, and the boundaries for the shot. |
aspect_ratioFacoltativo | string | 16:9 | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 | Output aspect ratio. |
resolutionFacoltativo | string | 768p | 768p, 2k | Output resolution. |
duration_secondsFacoltativo | integer | 5 | da 5 a 15 | Requested output length in seconds. |
enable_prompt_expansionFacoltativo | boolean | false | false | Accepted for compatibility only. This endpoint does not expand prompts, so the only allowed value is false. |
Richiesta di esempio
Questa richiesta funziona così com’è; i campi omessi usano il valore predefinito. Prima salva la tua chiave in POPNOW_API_KEY.
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"
}
}'La risposta contiene subito un taskId. Recupera il risultato con GET /api/v1/jobs/recordInfo, oppure aggiungi callBackUrl per ricevere una notifica.
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
-H "Authorization: Bearer $POPNOW_API_KEY"Da immagine a video
minimax/h3/image-to-video
Prezzo
| Opzione | Crediti (per secondo generato) | Dollari USA |
|---|---|---|
768p | 5.55 | $0.0555 |
2k | 8.7 | $0.087 |
Parametri
| Campo | Tipo | Predefinito | Valori ammessi | A cosa serve |
|---|---|---|---|---|
promptObbligatorio | string | — | fino a 7000 caratteri | Describe what happens after the opening frame: the action, the camera, and the sound. |
image_urlObbligatorio | string (uri) | — | — | Authorised opening frame. |
last_image_urlFacoltativo | string (uri) | — | — | Optional closing frame the clip should resolve to. |
resolutionFacoltativo | string | 768p | 768p, 2k | Output resolution. |
duration_secondsFacoltativo | integer | 5 | da 4 a 15 | Requested output length in seconds. |
enable_prompt_expansionFacoltativo | boolean | false | false | Accepted for compatibility only. This endpoint does not expand prompts, so the only allowed value is false. |
Richiesta di esempio
Questa richiesta funziona così com’è; i campi omessi usano il valore predefinito. Prima salva la tua chiave in POPNOW_API_KEY.
L’esempio usa file di prova di PopNow in image_url. Sostituiscili con i tuoi link HTTPS pubblici, file caricati o asset salvati.
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"
}
}'La risposta contiene subito un taskId. Recupera il risultato con GET /api/v1/jobs/recordInfo, oppure aggiungi callBackUrl per ricevere una notifica.
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
-H "Authorization: Bearer $POPNOW_API_KEY"Da riferimenti a video
minimax/h3/reference-to-video
Prezzo
| Opzione | Crediti (per secondo generato) | Dollari USA |
|---|---|---|
768p | 5.55 | $0.0555 |
2k | 8.7 | $0.087 |
Parametri
| Campo | Tipo | Predefinito | Valori ammessi | A cosa serve |
|---|---|---|---|---|
promptObbligatorio | string | — | fino a 7000 caratteri | Refer to the references by number and describe the shot they should produce. |
reference_image_urlsObbligatorio | array<string (uri)> | — | fino a 9 elementi | Authorised image references, up to nine. |
reference_video_urlsFacoltativo | array<string (uri)> | — | fino a 3 elementi | Up 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_urlsFacoltativo | array<string (uri)> | — | fino a 3 elementi | Up 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_ratioFacoltativo | string | 16:9 | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 | Output aspect ratio. |
resolutionFacoltativo | string | 768p | 768p, 2k | Output resolution. |
duration_secondsFacoltativo | integer | 5 | da 4 a 15 | Requested output length in seconds. |
enable_prompt_expansionFacoltativo | boolean | false | false | Accepted for compatibility only. This endpoint does not expand prompts, so the only allowed value is false. |
Richiesta di esempio
Questa richiesta funziona così com’è; i campi omessi usano il valore predefinito. Prima salva la tua chiave in POPNOW_API_KEY.
L’esempio usa file di prova di PopNow in reference_image_urls. Sostituiscili con i tuoi link HTTPS pubblici, file caricati o asset salvati.
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"
}
}'La risposta contiene subito un taskId. Recupera il risultato con GET /api/v1/jobs/recordInfo, oppure aggiungi callBackUrl per ricevere una notifica.
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
-H "Authorization: Bearer $POPNOW_API_KEY"Allunga video
minimax/h3/video-extend
Prezzo
| Opzione | Crediti (per secondo generato) | Dollari USA |
|---|---|---|
768p | 5.55 | $0.0555 |
2k | 8.7 | $0.087 |
Parametri
| Campo | Tipo | Predefinito | Valori ammessi | A cosa serve |
|---|---|---|---|---|
promptObbligatorio | string | — | fino a 7000 caratteri | Describe what happens next: the action that follows, the camera move and the sound. |
video_urlObbligatorio | string (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_urlFacoltativo | string (uri) | — | — | Optional target end frame: the new segment closes on this image. |
resolutionFacoltativo | string | 768p | 768p, 2k | Resolution of the new segment. It sets how sharp the new part is generated; match your source clip. |
duration_secondsFacoltativo | integer | 5 | da 4 a 15 | Length of the new segment in seconds, from 4 to 15. The source clip is added on top and is not billed. |
enable_prompt_expansionFacoltativo | boolean | false | false | Accepted for compatibility only. This endpoint does not expand prompts, so the only allowed value is false. |
Richiesta di esempio
Questa richiesta funziona così com’è; i campi omessi usano il valore predefinito. Prima salva la tua chiave in POPNOW_API_KEY.
L’esempio usa file di prova di PopNow in video_url. Sostituiscili con i tuoi link HTTPS pubblici, file caricati o asset salvati.
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"
}
}'La risposta contiene subito un taskId. Recupera il risultato con GET /api/v1/jobs/recordInfo, oppure aggiungi callBackUrl per ricevere una notifica.
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
-H "Authorization: Bearer $POPNOW_API_KEY"
