Ideogram
Ideogram V3 Character
ideogram-v3-character
Utilizza l'immagine di riferimento per bloccare lo stesso personaggio, mantenendo coerenti il volto e l'abbigliamento attraverso cambi di scena, posa e illuminazione, e proseguendo con il vantaggio di Ideogram nella composizione tipografica all'interno dell'immagine
Prova ideogram-v3-character
Input
Creazioni
Vedi tutte le creazioniOutput
imagePrezzi
ideogram-v3-character per image
| Specifiche | Prezzo unitario |
|---|---|
| TURBO | $0.090 |
| BALANCED | $0.130 |
| QUALITY | $0.180 |
Panoramica della posizione
ideogram-v3-character è un modello di generazione di immagini che utilizza un'immagine di riferimento come ancora visiva del personaggio: fornendo una foto nitida del personaggio, è in grado di preservare i tratti del volto, l'acconciatura, l'abbigliamento e le proporzioni corporee nelle diverse generazioni, consentendo al contempo di cambiare scenario, posa, illuminazione e sfondo tramite il prompt. È adatto a sviluppatori e team creativi che necessitano di riutilizzare lo stesso personaggio in tavole di fumetti, illustrazioni per serie social o estensioni di mascotte aziendali, e prosegue la capacità di Ideogram nella tipografia testuale all'interno delle immagini.
Punti di forza principali
- Una sola immagine di riferimento è sufficiente per bloccare il personaggio — è necessario solo un'immagine del personaggio in JPEG, PNG o WebP come input, e il modello la utilizza come ancora visiva per mantenere coerente l'aspetto del personaggio.
- Cambia la scena, non la persona — mentre blocca l'aspetto del personaggio, è possibile modificare ampiamente scena, posa, illuminazione e sfondo tramite il prompt.
- Controllo dei parametri riproducibile — supporta seed, prompt negativo e livelli di velocità di rendering, per una generazione stabile in batch e la regolazione di dettagli e ritmo secondo necessità.
Descrizione delle capacità
Coerenza del personaggio dall'immagine di riferimento: con un'immagine di riferimento del personaggio come input, il risultato generato preserva volto, acconciatura, abbigliamento e proporzioni corporee, ideale per contenuti seriali che richiedono il riutilizzo dello stesso personaggio su più immagini.
Trasformazione della scena guidata dal prompt: con il personaggio bloccato, è possibile descrivere nuovi scenari e pose con un prompt fino a 5000 caratteri, ed escludere elementi indesiderati tramite il prompt negativo.
Generazione riproducibile: supporta l'impostazione di un seed casuale, utile per riprodurre lo stesso risultato in fase di debug o produzione in batch, riducendo i costi di selezione.
Selezione del livello di rendering: offre tre livelli di velocità di rendering TURBO, BALANCED e QUALITY, consentendo agli sviluppatori di bilanciare velocità e qualità in base al ritmo di generazione e ai requisiti di dettaglio.
Casi d'uso
- Autori di fumetti e tavole: sequenze continue dello stesso personaggio — inserendo l'immagine di riferimento del personaggio e la descrizione di una singola vignetta, si producono tavole con un'immagine coerente, pronte per l'impaginazione e il post-processing.
- Gestione social: immagine del personaggio coerente nelle serie di contenuti — generando in batch illustrazioni a tema diverso da un'immagine di riferimento fissa del personaggio, si mantiene coerente il protagonista visivo di più episodi.
- Team di brand: estensione della mascotte in più scenari — utilizzando l'immagine della mascotte per generare materiali estesi in diversi contesti di evento, stagione o poster, da impiegare nella distribuzione di materiali di marketing.
Limiti e consigli per la scelta
La coerenza del personaggio non è assoluta: in scenari complessi, pose esagerate e variazioni di espressione, volti e dettagli possono comunque presentare deviazioni visibili. La qualità dell'immagine di riferimento influisce direttamente sul risultato; si consiglia di utilizzare immagini del personaggio con volto nitido, illuminazione uniforme e poche occlusioni. Se serve solo una singola immagine creativa indipendente senza un personaggio fisso, è più adatto un modello di text-to-image convenzionale. Per progetti commerciali con requisiti di fedeltà del personaggio molto elevati, si consiglia di verificare la coerenza con un piccolo campione prima della generazione in batch.
Novità
Vedi il changelog →- Nuovo modello Aggiunta di ideogram-v3-character per la generazione coerente del personaggio e ideogram-v3-character/edit…
Domande frequenti
Vedi tutte le domande →-
Quali sono i requisiti della maschera?
La maschera deve avere lo stesso rapporto larghezza-altezza dell'immagine originale; le aree nere vengono ridisegnate, le parti bianche vengono conservate. È più naturale se l'area è leggermente più grande del contorno del personaggio.
-
Qual è la dimensione dell'output?
L'output segue le dimensioni dell'immagine originale; ad esempio, un'immagine originale di 1024×768 produce un risultato di 1024×768.
-
Nell'immagine originale è già presente una persona, è possibile sostituirla?
Sì, dipingi la persona da sostituire nella maschera e descrivi l'azione del nuovo personaggio nel prompt; le persone e lo sfondo al di fuori della maschera verranno mantenuti.
-
In quale formato va usata la maschera?
Usa un'immagine con lo stesso rapporto larghezza-altezza dell'immagine originale, con lo sfondo bianco e le aree da ridisegnare delineate in nero; il caso di questa pagina utilizza una maschera PNG.
Crea un'attività di generazione
https://api.hiapi.ai/v1/tasks Header
AuthorizationstringObbligatorioChiave API dell'account. Obbligatoria in ogni richiesta. Esempio: Bearer YOUR_HIAPI_API_KEY. Ottieni una chiave API
Content-TypestringOpzionaleIl corpo della richiesta viene sempre interpretato come JSON; se inviato, è accettato solo application/json (charset facoltativo) — qualsiasi altro valore restituisce 415. Esempio: application/json.
Idempotency-KeystringOpzionaleChiave di idempotenza, fino a 255 byte. I retry con la stessa chiave dello stesso account creano l'attività una sola volta; i replay restituiscono il taskId originale.
In caso di timeout di rete o retry automatici del client, la stessa chiave crea l'attività una sola volta, senza doppi addebiti (ambito = l'account della chiave API). Usa un identificatore univoco di business (es. "order-42"); i replay restituiscono il taskId originale e le chiavi scadono 24 ore dopo la prima richiesta. La matrice completa degli scenari è nell'introduzione dell'API asincrona unificata.
Corpo
modelstringObbligatorioValore fisso attuale: ideogram-v3-character
routestringOpzionaleValore fisso attuale: default
inputobjectObbligatorio
Oggetto di parametri di business per ideogram-v3-character e la route default — vedi la tabella dei parametri sotto.
seedintegerOpzionalemin 0max 2147483647Seme casuale per risultati di generazione riproducibili; il valore è un numero intero e lo stesso seme consente di riprodurre lo stesso output.
stylestringOpzionalePredefinito: "AUTO"Tipo di stile, controlla lo stile complessivo dell'immagine generata; valore predefinito AUTO.
AUTOREALISTICFICTIONpromptstringObbligatoriominLength 1maxLength 5000Prompt di scena che descrive il personaggio di riferimento, lunghezza massima 5000 caratteri.
expand_promptbooleanOpzionalePredefinito: trueIndica se abilitare MagicPrompt per espandere il prompt; valore predefinito true.
negative_promptstringOpzionalemaxLength 5000Prompt negativo, specifica i contenuti da escludere dall'immagine, lunghezza massima 5000 caratteri.
rendering_speedstringOpzionalePredefinito: "BALANCED"Livello di velocità di rendering: TURBO è il più veloce ed economico, QUALITY offre il maggior livello di dettaglio, livelli diversi hanno costi diversi; valore predefinito BALANCED.
TURBOBALANCEDQUALITYreference_image_urlsarrayObbligatoriominItems 1maxItems 1Array di immagini di riferimento del personaggio, deve contenere esattamente un'immagine di riferimento del personaggio, supporta formati JPEG, PNG o WebP, dimensione massima 10 MB per immagine.
Array [ string ]
callbackobjectOpzionale
Configurazione di notifica dello stato terminale. Se omessa, nessun callback: interroga l'attività per conto tuo.
Fornisci callback.url in creazione e HiAPI invierà un POST al tuo servizio allo stato terminale, senza polling. Il corpo del callback replica la struttura del dettaglio attività; verifica firma, retry e idempotenza sono descritti nell'introduzione dell'API asincrona unificata.
urlstringObbligatorioObbligatoria se è presente callback. Allo stato terminale viene inviato un POST a questo URL; deve essere un URL http(s) valido.
whenstringOpzionalePredefinito: "final"Al momento è supportato solo final: notifica sia su success sia su fail.
finalstoragestringOpzionalePredefinito: "temp"Livello di archiviazione degli artefatti: temp (predefinito, ~7 giorni) o persistent (a lungo termine, fatturato per dimensione). Saldo insufficiente o superamento del limite ⇒ declassamento silenzioso a temp; il livello effettivo è visibile nella risposta di dettaglio.
temppersistentEsempi di richiesta
# Invia un'attività asincrona; restituisce subito un taskId (senza attendere la generazione)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "ideogram-v3-character",
"input": {
"style": "AUTO",
"prompt": "…",
"expand_prompt": true,
"rendering_speed": "BALANCED",
"reference_image_urls": "…"
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "ideogram-v3-character",
input: {
"style": "AUTO",
"prompt": "…",
"expand_prompt": true,
"rendering_speed": "BALANCED",
"reference_image_urls": "…"
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "ideogram-v3-character",
"input": {
"style": "AUTO",
"prompt": "…",
"expand_prompt": True,
"rendering_speed": "BALANCED",
"reference_image_urls": "…"
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Ottieni i dettagli dell'attività
https://api.hiapi.ai/v1/tasks/:id Campi della risposta
taskIdstringObbligatorioID attività, sempre con prefisso tk-hiapi-.
modelstringObbligatorioNome completo risolto del modello. Le attività inviate con il parametro route restituiscono base@route (es. gpt-image-2/text-to-image@ext); altrimenti coincide con il nome inviato.
routestringOpzionalePresente solo se è stato usato il parametro route esplicito; restituisce il valore inviato.
statusstringObbligatorioStato dell'attività.
queued In coda, non avviata.
handling In elaborazione.
archiving Elaborazione conclusa, preparazione artefatti.
success Terminale: completato, artefatti disponibili (restituisce output).
fail Terminale: errore (restituisce error).
Dopo l'invio, segui status: success e fail sono terminali, il resto no. Esegui polling ogni 1–3 s fino allo stato terminale. In caso di successo scarica gli artefatti da output[].url e trasferiscili prima di expireAt; per conservazione lunga usa storage: "persistent" in creazione.
creatednumberObbligatorioIstante di creazione dell'attività (secondi Unix).
completednumberObbligatorioSecondi Unix dello stato terminale; 0 finché non terminale.
outputarrayOpzionale
Presente solo con status == success. Elenco artefatti — sempre un array; un'attività può restituire più type contemporaneamente (es. video + first_frame).
Array [ object ]
Elementi dell'array
urlstringObbligatorioURL dell'artefatto, scaricabile direttamente.
typestringObbligatorioValori attualmente possibili: video, image, audio, first_frame, last_frame, thumbnail; potrebbero essere ampliati in futuro.
expireAtnumberObbligatorioSecondi Unix di disponibilità dell'artefatto; scarica o trasferisci prima della scadenza.
errorobjectOpzionale
Presente solo con status == fail.
codestringObbligatorioCodice errore di business.
messagestringObbligatorioDescrizione dell'errore.
Esempi di risposta
Successo
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} In elaborazione (non terminale)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Non riuscito
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Articoli
Vedi tutti gli articoli →-
Tutoriale
Come chiamare kling-4.0/image-to-video su HiAPI: curl, Python e polling
-
Tutoriale
Come usare kling-4.0/text-to-video tramite l'API HiAPI: curl, Python e un esempio di richiesta funzionante
Guida pratica per sviluppatori: prompt cinematografici, audio sincronizzato, polling asincrono e download dell'output
-
Tutoriale
recraft-v4.1-flash text-to-image in pratica: 5 scenari di business ad alto valore e punti chiave di integrazione
Partendo da un costo di $0,01 per immagine, pianificare l'implementazione della generazione di immagini nei processi di business reali
-
Confronto e valutazione
Confronto orizzontale di Recraft v4.1 Flash per la generazione di immagini da testo: guida alla scelta e alla migrazione per gli sviluppatori
Con un costo di $0,01 per immagine e la capacità di generazione puramente testuale, valuta se è adatto alla tua pipeline di generazione di immagini
-
Tutoriale
Come chiamare hailuo-2.3-fast/image-to-video tramite l'API HiAPI: pratica con curl e Python
La prima richiesta funzionante per il livello image-to-video veloce ed economico — dall'ID del modello al download di un MP4
-
Tutoriale
Tutorial su kandinsky-6.0-pro/image-to-video tramite HiAPI: curl + Python
Avvia una richiesta funzionante di image-to-video su HiAPI: dal caricamento del primo fotogramma al polling asincrono fino al download finale
-
Tutoriale
Come chiamare hailuo-2.3/text-to-video tramite l'API HiAPI: curl, Python ed esempi di richiesta eseguibili
-
Confronto e valutazione
hailuo-2.3-fast/image-to-video confronto orizzontale: come scegliere un modello image-to-video e i punti chiave per la migrazione
-
Tutoriale
Utilizzare Kandinsky 6.0 Pro su HiAPI per la generazione di video da testo: tutorial con curl e Python
Dimostrazione pratica guidata dalla richiesta: costruire la chiamata da prompt a clip video, inviare la richiesta, monitorare lo stato di completamento e scaricare il risultato
Modelli correlati
Vedi tutti i modelli →Stesso tipo
-
Krea 3 Krea $0.036 /immagine -
FASHN Tryon v1.6 FASHN $0.107 /immagine -
Seedream 5.0 ByteDance $0.025 /immagine -
Qwen Image 2.0 Alibaba $0.042 /immagine -
Nano Banana 2 Google $0.036 /immagine -
851 Labs Background Remover 851 Labs $0.002 /immagine -
Nano Banana Google $0.021 /immagine -
Ideogram V4 Ideogram $0.050 /immagine -
FLUX 3 Image Black Forest Labs $0.041 /immagine -
BRIA Eraser Bria $0.058 /immagine -
Muse Image 1.0 Meta $0.015 per task -
Imagen 4 Google $0.030 /immagine





