La risposta breve
La frase image gen api openai può significare due cose diverse ed è utile separarle. Una è il servizio di generazione immagini proprietario di OpenAI, che appartiene a OpenAI e a cui si accede con un account OpenAI. L'altra è qualsiasi servizio che copia il formato delle richieste OpenAI in modo che gli SDK e gli strumenti esistenti continuino a funzionare. Questo sito è del secondo tipo e solo per il testo.
Quello che ottieni qui è un'API LLM di testo ospitata e senza censura. Punti un client OpenAI al base URL qui sotto, imposti il modello su uncensored e ricevi le completazioni della chat. Non tornano pixel. Non c'è generazione di immagini, audio o video, né embedding né fine-tuning, e nessuno di questi è previsto nelle pagine descritte.
Cosa è compatibile e cosa no
La parola "compatibile" viene spesso gonfiata dal marketing, quindi ecco la superficie esatta. Il base URL è https://api.imagegenapi.com/v1, l'autenticazione è Authorization: Bearer <key> ed esistono due metodi.
| Endpoint | Disponibili qui | Note |
|---|---|---|
POST /v1/chat/completions | Sì | Streaming, chiamata di funzioni, modalità JSON |
GET /v1/models | Sì | Elenca uncensored |
| Endpoint di generazione immagini | No | Servizio solo testo |
| Embedding, audio, fine-tuning | No | Non offerto |
Se il tuo codice chiama un percorso immagine su questo URL di base, aspettati un errore, non un'immagine. Lo stesso vale per qualsiasi funzionalità OpenAI al di fuori dei due metodi sopra. I controlli di campionamento che conosci funzionano: temperature, top_p, stop, seed e le penalità vengono trasmesse, e una risposta può utilizzare l'intera finestra di 100.000 token condivisa tra prompt e completamento.
Vale anche la pena essere chiari sull'identità. Il modello dietro uncensored è un singolo modello a pesi aperti, gestito da un provider indipendente. Questa non è l'API di OpenAI, non fa da proxy per i modelli di OpenAI e non è affiliata a OpenAI. La pagina corrispondente su questo sito, GPT image API and uncensored text, copre la stessa distinzione dalla prospettiva dei nomi dei modelli di immagine.
Perché sorge la domanda
Le persone atterrano su pagine come questa per motivi comprensibili. Gli strumenti per le immagini sono guidati da prompt testuali, i prompt testuali sono scritti da modelli linguistici e molti gateway di modelli linguistici condividono un formato di richiesta. L'ipotesi naturale è che un'API faccia entrambe le cose.
In pratica i due lavori sono sistemi separati con chiavi separate, prezzi separati e regole separate. Un servizio di immagini prende un prompt e restituisce un'immagine. Un servizio di testo prende messaggi e restituisce altro testo. Il collegamento tra loro sei tu, o uno script che scrivi, che trasporta il testo da uno all'altro. Una volta che lo vedi in questo modo, la domanda utile cambia da "questa API genera immagini" a "questa API può scrivere prompt migliori per il modello di immagini che uso già".
Questo è un caso d'uso reale e un punto in cui un modello di testo senza censura può fare la differenza. Gli assistenti generalisti spesso riscrivono, attenuano o rifiutano le richieste di prompt che toccano temi per adulti nella narrativa, violenza in un contesto di storia o estetiche oscure. Un modello ottimizzato per rispondere alle richieste legali per adulti senza rifiuti di solito eseguirà il compito di scrittura come richiesto. Il limite rigido rimane: nessun contenuto sessuale che coinvolga minorenni, in qualsiasi contesto.
Usare l'API di testo per scrivere prompt per immagini
Ecco un piccolo esempio funzionante. Chiede al modello un prompt dettagliato, che poi incolli nel generatore di immagini che usi. Il codice usa l'SDK Python ufficiale di OpenAI contro questo base URL.
from openai import OpenAI
client = OpenAI(base_url="https://api.imagegenapi.com/v1", api_key="YOUR_KEY")
reply = client.chat.completions.create(
model="uncensored",
temperature=0.8,
messages=[
{"role": "system", "content": "You write prompts for text-to-image models. Reply with one paragraph: subject, composition, lighting, palette, lens or style. No preamble."},
{"role": "user", "content": "A ruined lighthouse at dusk for a dark fantasy book cover."},
],
)
print(reply.choices[0].message.content)La stessa chiamata da riga di comando:
curl https://api.imagegenapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Write a one-paragraph image prompt: a ruined lighthouse at dusk, dark fantasy cover art."}]}'Rendere l'output utilizzabile
I generatori di immagini differiscono in ciò che accettano, quindi modella il risultato con il tuo messaggio di sistema. Chiedi una struttura fissa, un limite di parole e un elenco di cose da evitare. Se hai bisogno del prompt all'interno di una pipeline, richiedi JSON con response_format impostato su tipo json_object e chiedi chiavi come prompt e negative. Poi analizzalo e passa i campi al tuo client di immagine. Impostare un seed e un basso temperature dà output più ripetibili quando si itera sulla formulazione.
Un flusso di lavoro batch con numeri reali
Supponi di generare prompt per 1.000 scene. Ogni richiesta invia circa 300 token (istruzioni più una breve nota sulla scena) e riceve un prompt di circa 200 token. Il prezzo è $0,15 per 1M di token in input e $0,50 per 1M di token in output.
- Una richiesta, input: 300 / 1.000.000 x $0,15 = $0,000045.
- Una richiesta, output: 200 / 1.000.000 x $0,50 = $0,0001.
- Una richiesta in totale: $0,000145.
- 1.000 richieste: 1.000 x $0,000145 = $0,145.
Quindi mille prompt costano circa 14,5 centesimi e il passaggio di testo è solitamente una piccola parte del conto rispetto alla generazione di immagini stessa, il cui prezzo dovresti verificare con quel provider. Una chiave completa permette 8 richieste concorrenti e 300 richieste al minuto, quindi 1.000 richieste si adattano in pochi minuti con un piccolo pool di worker. Gestisci l'HTTP 429 aspettando; l'intestazione Retry-After: 5 ti dice per quanto tempo in caso di sovraccarico temporaneo.
Puoi provare tutto questo senza pagare. Dopo la registrazione, la pagina della chiave API ha un credito di prova da $0,50 con un clic, valido per 7 giorni. Nel lungo termine, le ricariche vanno da $20 a $500 e sono pagati in cripto (USDT su TRC20 o USDC su Base); vedi prezzi per i livelli di bonus.
Errori da evitare
Alcuni errori si presentano ripetutamente quando qualcuno prova a usare un endpoint a forma di OpenAI per il lavoro sulle immagini.
- Chiamare un percorso immagine e aspettarsi un'immagine. Esistono solo i due metodi documentati qui. Controlla il corpo dell'errore invece di ritentare, perché i ritentativi non cambieranno il risultato.
- Chiedere al modello di testo di "disegnare" qualcosa. Potrebbe rispondere con arte ASCII, una descrizione o una scusa. Se vuoi un'immagine, invia il prompt che scrive a un vero generatore di immagini.
- Saltare l'elenco dei modelli. Una rapida chiamata
GET /v1/modelsconferma che la chiave funziona e che l'unico modello èuncensored. Non costa nulla. - Ignorare le risposte 429. Una chiave di prova permette 2 richieste concorrenti, quindi un loop con dieci worker fallirà rapidamente. Limita il conteggio dei worker o aggiungi una breve attesa.
- Inviare body molto grandi. Il limite è di 8 MB per richiesta. Le chiamate di scrittura del prompt sono minuscole, quindi questo raramente conta, ma i documenti incollati possono superarlo.
Nessuno di questi è difficile da risolvere e la cura più rapida è uno script di test di dieci righe eseguito prima di collegare qualsiasi cosa a un tool più grande.
Quando un altro servizio è la scelta migliore
Sii pratico nella scelta. Se hai bisogno dell'immagine stessa, hai bisogno di un provider di immagini e OpenAI è uno dei diversi; guarda la sua documentazione e i prezzi attuali per i dettagli su cosa offre. Se il tuo unico obiettivo è un prompt pulito in uno stile mainstream, un assistente standard potrebbe essere sufficiente e non avrai affatto bisogno di questo servizio.
Questa API è la scelta migliore quando il passaggio di testo è il collo di bottiglia: l'assistente che usi rifiuta o diluisce le tue richieste di prompt, hai bisogno di un alto volume di prompt a un prezzo per token prevedibile o vuoi un endpoint compatibile con OpenAI per narrativa, roleplay e strumenti per compagni per uso adulto legale senza riscrivere il codice del client. Per i dettagli completi sui parametri, la documentazione ha il formato della richiesta e i codici di errore.
Un'altra nota pratica: i prompt inviati a questa API non sono usati per l'addestramento. Tuttavia, tratta qualsiasi servizio ospitato come esterno alla tua macchina ed evita di inviare segreti che non incolleresti in un modulo web.
