CheaperGen
MiniMaxGuida

Come usare l’API di MiniMax H3 Fast

Una guida passo passo all’API di MiniMax H3 Fast con Node.js, Python e cURL: invia un job da testo a video, controllane lo stato o ricevi un webhook e scarica il video. L’esempio qui sotto costa $0,33.

Endpoint
3
Da testo a video · Da immagine a video · Da riferimento a video
Richiesta di esempio
$0,33
Da testo a video
Linguaggi
3
Node.js · Python · cURL
Generazioni non riuscite
$0
rimborsate automaticamente
Ottieni una chiave APICrea con MiniMax H3 FastDocumentazione API
1

Ottieni una chiave API

Crea un account, aggiungi crediti e crea una chiave nella Dashboard → Chiavi API. Salvala come CHEAPERGEN_API_KEY sul tuo server. Ogni richiesta la invia come token Bearer.

Come ottenere una chiave API MiniMax H3 Fast
2

Scegli un endpoint MiniMax H3 Fast

Ogni attività ha il proprio endpoint. Tutti accettano un corpo JSON e restituiscono una generazione di cui puoi controllare lo stato.

Endpoint API di MiniMax H3 Fast, input obbligatori e prezzi
AttivitàEndpointObbligatorioDa
Da testo a videominimax/h3-fast/text-to-videoprompt$0,0369 al secondo
Da immagine a videominimax/h3-fast/image-to-videoprompt, image_url$0,0369 al secondo
Da riferimento a videominimax/h3-fast/reference-to-videoprompt$0,0369 al secondo
3

Invia un job da testo a video

Questo programma invia il job, controlla ogni 3 secondi finché non termina e stampa l’URL video. Sostituisci il prompt e le impostazioni con i tuoi.

const API = "https://cheapergen.com/api/v1";
const headers = {
  Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
  "Content-Type": "application/json",
};

// 1. Submit the job
let job = await fetch(`${API}/run/minimax/h3-fast/text-to-video`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": "Una barchetta di carta scivola lungo una cunetta piena di pioggia al crepuscolo, lo scroscio della pioggia e il campanello di un tram in lontananza",
    "aspect_ratio": "16:9",
    "resolution": "768P",
    "duration": 6
  }),
}).then((r) => r.json());

// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
  await new Promise((r) => setTimeout(r, 3000));
  job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}

console.log(job.status === "succeeded" ? job.output.video.url : job.error);
4

Imposta i parametri rilevanti

Le impostazioni di minimax/h3-fast/text-to-video e il loro effetto sul prezzo.

Parametri MiniMax H3 Fast Da testo a video e relativo effetto sul prezzo
ParametroTipo · predefinitoDescrizioneEffetto sul prezzo
aspect_ratiostring (enum) · 16:9Formato del fotogramma in output.
16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9
Sì
resolutionstring (enum) · 768PRisoluzione dell’output. Le risoluzioni più alte costano di più al secondo.
480P · 768P
480P: $0,0369 al secondo
768P: $0,0546 al secondo
durationinteger · 6Durata della clip generata in secondi (4–15 s). Paghi al secondo.Fatturato al secondo
seedintegerUsa lo stesso seed e le stesse impostazioni per riprodurre un risultato. Lascia vuoto per un valore casuale.Nessuno
enable_safety_checkerboolean · trueIf set to true, the safety checker will be enabled. Content our Acceptable Use Policy prohibits stays blocked either way.Nessuno

Gli altri endpoint MiniMax H3 Fast hanno la stessa struttura, ma input diversi:

POST /api/v1/run/minimax/h3-fast/image-to-video

{
  "prompt": "Il fiore si apre lentamente nella luce del mattino, con il canto degli uccelli in sottofondo",
  "image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
  "aspect_ratio": "16:9",
  "resolution": "768P",
  "duration": 6
}

POST /api/v1/run/minimax/h3-fast/reference-to-video

{
  "prompt": "Il cantante di @Image1 si esibisce sul tetto, seguendo il movimento della camera in @Video1, con la voce di @Audio1",
  "reference_image_urls": [
    "https://cdn.cheapergen.com/samples/reference-1.jpg"
  ],
  "reference_video_urls": [
    "https://cdn.cheapergen.com/samples/reference-1.mp4"
  ],
  "reference_audio_urls": [
    "https://cdn.cheapergen.com/samples/reference-1.mp3"
  ],
  "aspect_ratio": "16:9",
  "resolution": "768P",
  "duration": 6
}
5

Ottieni il risultato

Un job passa da queued a running, poi a succeeded, failed o canceled. Interroga GET /api/v1/generations/{id} oppure imposta webhook_url: invieremo il risultato con POST. Scarica l’output e conservalo tu.

200 — completata
{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "minimax/h3-fast",
  "endpoint": "minimax/h3-fast/text-to-video",
  "mode": "text-to-video",
  "status": "succeeded",
  "input": {
    "prompt": "Una barchetta di carta scivola lungo una cunetta piena di pioggia al crepuscolo, lo scroscio della pioggia e il campanello di un tram in lontananza",
    "aspect_ratio": "16:9",
    "resolution": "768P",
    "duration": 6
  },
  "output": {
    "video": {
      "url": "https://cdn.cheapergen.com/outputs/gen_8c2Q.mp4",
      "content_type": "video/mp4",
      "duration": 5,
      "width": 1280,
      "height": 720
    }
  },
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": false,
    "official_usd": 0.264,
    "list_price_source": "reference",
    "list_price_label": "Official MiniMax H3 API",
    "saved_usd": 0.0385
  },
  "source": "api",
  "created_at": "2026-10-15T09:21:04Z",
  "started_at": "2026-10-15T09:21:06Z",
  "completed_at": "2026-10-15T09:22:31Z"
}
Verifica le firme dei webhook
6

Calcola il prezzo prima dell'avvio

L'endpoint dei preventivi è gratuito e non richiede una chiave. Restituisce il prezzo, il prezzo official MiniMax H3 API e lo sconto applicato per l'input esatto che invii.

curl -X POST https://cheapergen.com/api/v1/quote/minimax/h3-fast/text-to-video \
  -H "Content-Type: application/json" \
  -d '{"prompt":"Una barchetta di carta scivola lungo una cunetta piena di pioggia al crepuscolo, lo scroscio della pioggia e il campanello di un tram in lontananza","aspect_ratio":"16:9","resolution":"768P","duration":6}'
Errori API e come risolverli
StatoCodiceDescrizione
400invalid_requestManca un parametro o il suo valore è fuori intervallo: il messaggio indica quale.
401unauthorizedChiave API mancante, non valida o revocata.
402insufficient_balanceCrediti insufficienti per il prezzo indicato; aggiungine altri o attiva la ricarica automatica.
429rate_limitedTroppe richieste o generazioni in corso: attendi e riprova con backoff.
502upstream_errorIl fornitore del modello ha avuto un errore; l'importo bloccato viene rimborsato e puoi riprovare.
503model_unavailableAl momento non ci sono percorsi di elaborazione disponibili: riprova più tardi o scegli un altro modello.
Documentazione API completa di MiniMax H3 Fast

FAQ

Domande sull’API di MiniMax H3 Fast

No. L'API usa HTTPS semplice e JSON, quindi gli esempi con Node.js (fetch) e Python (requests) in questa pagina sono programmi completi. Funziona qualsiasi linguaggio in grado di inviare una richiesta HTTP.

Sì. Aggiungi "webhook_url" al corpo della richiesta e invieremo la generazione completata con una richiesta POST, firmata nell'intestazione CheaperGen-Signature (HMAC-SHA256 del timestamp e del corpo grezzo). Puoi anche eseguire il polling con GET /api/v1/generations/{id}.

Passa URL pubblici in "image_url", "end_image_url", "reference_image_urls", "reference_video_urls", "reference_audio_urls". Se i file non hanno un URL pubblico, caricali prima con POST /api/v1/uploads: la risposta contiene un URL da usare nella richiesta.

Da testo a video parte da $0,0369 al secondo; l'esempio di richiesta in questa pagina costa $0,33, 32% in meno rispetto a il prezzo official MiniMax H3 API. Le generazioni non riuscite vengono rimborsate automaticamente.