MiniMax H3 Image Highspeed

Esempio rapido

Invia una richiesta di immagine, salva l'id restituito e interroga lo stato finché l'attività non è completed o failed. Questa API usa attività asincrone e risultati tramite URL.

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"minimax-h3-image-highspeed","prompt":"An amber bottle on pale limestone in soft morning light","area":"1K","aspect_ratio":"3:2"}'

Endpoint e intestazioni

POST https://api.seedrouter.ai/v1/images/generations

Conserva la chiave sul tuo server. Un esito HTTP positivo conferma la ricezione di un'attività; non significa che la sua immagine sia pronta.

Parametri

I campi accettati sono 13. Solo model e prompt sono obbligatori. Ometti i campi facoltativi per usare i valori predefiniti; nessun campo accetta null. Il Playground offre il modello fisso e dieci input modificabili. Il formato di risposta URL e la consegna delle attività senza streaming sono fissi.

Dipendenze di dimensioni e prompt

Un valore esplicito di size deve contenere dimensioni intere positive con un'area compresa tra 655.360 e 20.000.000 pixel, estremi inclusi. La larghezza divisa per l'altezza deve essere compresa tra 1/3 e 3. Ad esempio, 2048x1152 è valido. Quando usi dimensioni esplicite, ometti sia aspect_ratio sia area, anche se il loro valore fosse auto.

Se ometti le dimensioni o usi auto, usa aspect_ratio e area insieme. L'area è una dimensione obiettivo; controlla il file consegnato per conoscere le dimensioni esatte. Non rappresenta un prezzo fisso per singola immagine.

L'impostazione disable_prompt_enhanced: true richiede dimensioni esplicite in pixel o un rapporto d'aspetto fisso. Con il miglioramento disattivato, il modello legge circa i primi 4096 token del prompt. Il limite di invio di 32.000 caratteri resta valido. La modifica migliora sempre i prompt, quindi true viene rifiutato quando è presente images.

Non sono accettati campi per maschera, seed, stile, qualità, prompt negativo, sfondo o risoluzione separata. I parametri sconosciuti restituiscono un errore prima dell'invio. Questa API non offre streaming, immagini base64 o output WebP.

Immagini di riferimento

Usa URL HTTP(S) pubblicamente accessibili senza credenziali incorporate. Ogni immagine deve essere JPEG, PNG, WebP, HEIC o HEIF; avere al massimo 64 MiB; 128–8192 pixel per lato; e un rapporto tra lato lungo e corto non superiore a 4. Mantieni il corpo JSON entro 64 MiB. I file immagine sono referenziati tramite URL; i loro byte non sono incorporati nel corpo JSON.

Assegna uno scopo chiaro a ogni riferimento e descrivi cosa deve restare invariato. L'ordine dell'array identifica <Picture 1>, <Picture 2> e così via.

{
  "model": "minimax-h3-image-highspeed",
  "prompt": "Use <Picture 1> as the product and <Picture 2> as the setting. Preserve the product's shape and label. Match the setting's light and perspective.",
  "images": [
    {"image_url": "https://example.com/product.jpg"},
    {"image_url": "https://example.com/setting.jpg"}
  ],
  "aspect_ratio": "3:2",
  "area": "2K",
  "n": 1,
  "output_format": "png"
}

Sostituisci gli URL illustrativi con i tuoi file immagine accessibili.

Fatturazione

La fatturazione comprende tre categorie di token: testo in ingresso, immagini in ingresso e immagini in uscita. Moltiplica l'utilizzo effettivo di ogni categoria per la relativa tariffa corrente. Il numero di risultati, le dimensioni delle immagini e le immagini di riferimento influiscono sull'utilizzo; i nomi delle risoluzioni non definiscono un importo fisso. Le richieste non riuscite non vengono addebitate. Consulta i prezzi attuali.

Risposta dell'attività e polling

Una richiesta accettata restituisce un'attività asincrona:

{"id":"task_example","model":"minimax-h3-image-highspeed","status":"processing"}

curl https://api.seedrouter.ai/v1/tasks/task_example \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

Una risposta completata contiene gli URL delle immagini in output.data. Ogni immagine consegnata include il suo size e può includere revised_prompt (la descrizione migliorata). output.created è l'ora di creazione in secondi Unix, mentre output.output_format identifica il formato consegnato. output.usage espone i conteggi dei token di testo in ingresso, immagini in ingresso e immagini in uscita e il conteggio delle generated_images consegnate. Gli URL e gli ID seguenti sono illustrativi:

{
  "id": "task_example",
  "model": "minimax-h3-image-highspeed",
  "status": "completed",
  "output": {"data": [{"url": "https://file.deepytb.com/generated/example.jpg"}]}
}

Esegui il polling ogni 10–20 secondi. Un timeout del client non indica un'attività fallita: conserva il suo ID e continua il polling anziché inviare una richiesta duplicata. Le risposte pubbliche non contengono saldi dell'account o costi.

Errori

Gli errori HTTP usano {"error":{"code":integer,"message":string}}. Un'attività fallita ha status: "failed" e un errore. Correggi i parametri non validi prima di un nuovo invio. Consulta il catalogo degli errori condiviso e il ciclo di vita dell'attività.

Pagine correlate

• Playground e prezzi di MiniMax H3 Image Highspeed
• MiniMax H3 Image