oc_prompt, quindi il backend di rendering selezionato crea l'immagine. La richiesta restituisce un img_uuid asincrono per il polling o la gestione del callback.API OC Maker per la Generazione di Personaggi Originali
Aggiungi un flusso di lavoro per personaggi a due fasi al tuo prodotto tramite GoEnhance. Il tuo prompt guida un modello linguistico a produrre dati strutturati del personaggio con un
Crea una Chiave API
Trasforma i Brief dei Personaggi in Risultati Strutturati e Renderizzati
Definisci i Dati del Personaggio
Fornisci il prompt completo per la fase testuale e definisci i campi JSON di cui la tua applicazione ha bisogno. La risposta deve contenere oc_prompt, mentre campi come nome del ruolo, aspetto, personalità o retroscena possono essere trasmessi insieme ai dati del personaggio generati.
Scegli il Percorso di Rendering
Seleziona seedream o gpt-image-2 per la fase dell'immagine e imposta facoltativamente un rapporto supportato. Un ratio a livello di richiesta sovrascrive l'oc_ratio dal JSON generato, mantenendo le decisioni sul layout sotto il controllo dell'applicazione.
Sviluppa basandoti sul contratto documentato di richiesta e risultato invece di presumere un endpoint di immagine generico.
Funzionalità dell'API OC Maker
Generazione a Due Fasi
Una richiesta esegue prima la creazione strutturata del personaggio e poi il rendering dell'immagine.
Contratto di Prompt Personalizzato
Definisci le istruzioni per la fase testuale e richiedi un JSON analizzabile con un campo <code>oc_prompt</code>.
Campi Personaggio Flessibili
Richiedi campi aggiuntivi come aspetto, personalità, nome del ruolo o retroscena per un utilizzo a valle.
Scelta del Backend di Rendering
Imposta <code>image_render_model</code> su <code>seedream</code> o <code>gpt-image-2</code>.
Rapporti di Output Supportati
Scegli 1:1, 2:3, 3:2, 4:3, 3:4, 16:9 o 9:16; l'impostazione predefinita è 3:4.
Gestione Asincrona dei Risultati
Conserva l'<code>img_uuid</code>, quindi esegui il polling dei dettagli del lavoro o elabora un callback HTTPS pubblico.
La tariffa documentata copre sia la fase del modello linguistico che quella di rendering dell'immagine in un'unica richiesta fatturata.
Prezzi dell'API OC Maker
1 Token per Richiesta
Ogni richiesta OC Maker costa 1 token GoEnhance per entrambe le fasi di elaborazione.
$0,02 per Richiesta
L'equivalente in USD attualmente documentato è di $0,02 per una richiesta OC Maker completa.
Lavori Falliti Rimborsati
La documentazione afferma che un errore in una delle due fasi annulla l'intero lavoro e rimborsa i token.
Integra l'API OC Maker in quattro passaggi
1
1. Scrivi il prompt per la fase testuale
Indica al modello di restituire solo JSON analizzabile contenente
oc_prompt. Aggiungi tutti i campi carattere di cui la tua applicazione ha bisogno. 2
2. Configura il rendering
Invia tramite POST
model: oc-maker, il tuo prompt e un image_render_model obbligatorio. Facoltativamente, imposta il rapporto di output, il modello di testo, il prompt di sistema o l'URL di callback. 3
3. Traccia il lavoro e leggi entrambi i risultati
Convalida la risposta di invio e conserva
data.img_uuid con il tuo record di attività. Esegui il polling di GET /api/v1/jobs/detail o elabora i callback fino allo stato terminale, quindi leggi l'oggetto strutturato dalla voce JSON e l'URL dell'asset dalla voce dell'immagine.Utilizza dati strutturati del personaggio e una visuale corrispondente dove entrambi gli output supportano lo stesso flusso di lavoro del prodotto.
Casi d'uso dell'API OC Maker
Costruttori di personaggi per giochi di ruolo
Genera un profilo del personaggio e una visuale corrispondente per la revisione all'interno di uno strumento di gioco di ruolo.
Pipeline di concept di gioco
Trasforma brief strutturati in record di personaggi preliminari e immagini per un processo di concept guidato dall'uomo.
Strumenti per lo sviluppo di storie
Crea campi per aspetto, personalità e retroscena insieme a un riferimento visivo per gli scrittori.
Flussi di creazione di avatar
Raccogli le scelte dell'utente, componi un prompt controllato e restituisci un ritratto del personaggio generato o un risultato a figura intera.
App per prototipi creativi
Testa le idee dei personaggi mantenendo dati strutturati che possono alimentare interfacce di modifica o approvazione.
Flussi di lavoro automatizzati per gli asset
Collega il completamento dell'attività alla moderazione, all'archiviazione, alla revisione e ai sistemi di contenuto a valle.
Risposte a domande comuni su prezzi, prompt, rendering e integrazione.