Het korte antwoord
De term image gen api openai kan twee verschillende dingen betekenen, en het helpt ze te scheiden. De ene is OpenAI's eigen afbeeldingsgeneratieservice, die eigendom is van OpenAI en die je bereikt met een OpenAI-account. De andere is elke service die het verzoekformaat van OpenAI kopieert, zodat bestaande SDK's en tools blijven werken. Deze site is het tweede type, en alleen voor tekst.
Wat je hier krijgt, is een gehoste, ongecensureerde tekst-LLM-API. Je richt een OpenAI-client op de onderstaande base URL, stelt het model in op uncensored en ontvangt chatcompleties. Er worden geen pixels teruggegeven. Er is geen afbeeldings-, audio- of videogeneratie, geen embeddings en geen fine-tuning, en geen van deze features staat op de planning zoals beschreven op deze pagina's.
Wat compatibel is en wat niet
Het woord "compatibel" wordt in marketing vaak uitvergroot, dus hier is de exacte interface. De base URL is https://api.imagegenapi.com/v1, authenticatie verloopt via Authorization: Bearer <key>, en er zijn twee methoden beschikbaar.
| Endpoint | Beschikbaar hier | Opmerkingen |
|---|---|---|
POST /v1/chat/completions | Ja | Streaming, tool calling, JSON-modus |
GET /v1/models | Ja | Lijst uncensored |
| Image-generatie-endpoints | Nee | Alleen tekstservice |
| Embeddings, audio, fine-tuning | Nee | Niet aangeboden |
Als je code een image-pad aanroept op deze base URL, verwacht dan een fout, geen afbeelding. Dat geldt ook voor elke OpenAI-functie buiten de twee methoden hierboven. De sampling-controls die je kent, werken wel: temperature, top_p, stop, seed en de penalties worden doorgegeven, en een antwoord kan het volledige contextvenster van 100.000 tokens delen tussen prompt en completion.
Het is ook de moeite waard om duidelijk te zijn over identiteit. Het model achter uncensored is een enkel open-weight model, gerund door een onafhankelijke provider. Dit is niet de API van OpenAI, het proxyt geen OpenAI-modellen, en het is niet gelieerd aan OpenAI. De bijpassende pagina op deze site, GPT image API en ongecensureerde tekst, behandelt hetzelfde onderscheid vanuit het oogpunt van image-modelnamen.
Waarom de vraag naar voren komt
Mensen komen om begrijpelijke redenen op pagina's zoals deze. Image-tools worden aangedreven door tekstprompts, tekstprompts worden geschreven door taalmodellen, en veel taalmodelgateways delen één verzoekformaat. De natuurlijke gok is dat één API beide taken doet.
In de praktijk zijn de twee taken aparte systemen met aparte sleutels, aparte prijzen en aparte regels. Een imageservice neemt een prompt aan en retourneert een afbeelding. Een tekstservice neemt berichten aan en retourneert meer tekst. De link tussen hen is jij, of een script dat je schrijft, dat de tekst van de ene naar de andere draagt. Zodra je het zo ziet, verandert de nuttige vraag van "maakt deze API afbeeldingen" in "kan deze API betere prompts schrijven voor het image-model dat ik al gebruik".
Dat is een echte use case, en een plek waar een ongecensureerd tekstmodel van belang kan zijn. Algemene assistants herschrijven, verzachten of weigeren vaak promptverzoeken die te maken hebben met volwassen fictie, geweld in een verhalende setting of donkere esthetiek. Een model dat is afgestemd op het beantwoorden van legale verzoeken van volwassenen zonder weigeringen, zal de schrijftaak meestal uitvoeren zoals gevraagd. De harde limiet blijft bestaan: geen seksuele inhoud waarbij minderjarigen betrokken zijn, onder welke vorm dan ook.
De tekst-API gebruiken om image-prompts te schrijven
Hier is een klein, werkend voorbeeld. Het vraagt het model om een gedetailleerde prompt, die je vervolgens plakt in welke image-generator je ook gebruikt. De code gebruikt de officiële OpenAI Python SDK tegen deze 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)
Dezelfde aanroep vanaf de command line:
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."}]}'
De uitvoer bruikbaar maken
Afbeeldingsgeneratoren verschillen in wat ze accepteren, dus stuur het resultaat met je system message. Vraag om een vaste structuur, een woordlimiet en een lijst van te vermijden elementen. Als je de prompt in een pipeline nodig hebt, vraag dan JSON aan met response_format ingesteld op type json_object en vraag om sleutels zoals prompt en negative. Parse het daarna en geef de velden door aan je afbeeldingsclient. Het instellen van een seed en een lage temperature geeft meer reproduceerbare output als je iteratieert aan de formulering.
Een batchworkflow met echte cijfers
Stel je voor dat je prompts genereert voor 1.000 scènes. Elk verzoek verzendt ongeveer 300 tokens (instructies plus een korte scènenotitie) en ontvangt een prompt van ongeveer 200 tokens. Prijzen zijn $0,15 per 1M input tokens en $0,50 per 1M output tokens.
- Eén verzoek, input: 300 / 1.000.000 x $0,15 = $0,000045.
- Eén verzoek, output: 200 / 1.000.000 x $0,50 = $0,0001.
- Eén verzoek in totaal: $0,000145.
- 1.000 verzoeken: 1.000 x $0,000145 = $0,145.
Dus duizend prompts kosten ongeveer 14,5 cent, en de tekststap is meestal een klein deel van de rekening vergeleken met de image-generatie zelf, waarvan je de prijs bij die provider moet controleren. Een volledige sleutel staat 8 gelijktijdige verzoeken en 300 verzoeken per minuut toe, dus 1.000 verzoeken passen in een paar minuten met een kleine worker pool. Behandel HTTP 429 door te wachten; de Retry-After: 5 header vertelt je hoe lang bij tijdelijke overbelasting.
Je kunt dit allemaal uitproberen zonder te betalen. Na het aanmelden heeft de API-sleutelpagina een proeftegoed van $0,50 met één klik, geldig voor 7 dagen. Op lange termijn lopen opwaarderingen van $20 tot $500 en worden betaald in crypto (USDT op TRC20 of USDC op Base); zie prijzen voor de bonusniveaus.
Fouten om te vermijden
Een paar fouten komen steeds weer voor als iemand probeert een OpenAI-vormig endpoint te gebruiken voor image-werk.
- Een image-pad aanroepen en een afbeelding verwachten. Alleen de twee gedocumenteerde methoden bestaan hier. Controleer de error body in plaats van te herhalen, omdat herhalingen de uitkomst niet zullen veranderen.
- Het tekstmodel vragen om iets te "tekenen". Het kan antwoorden met ASCII-art, een beschrijving of een verontschuldiging. Als je een afbeelding wilt, stuur dan de prompt die het schrijft naar een echte image-generator.
- De modellijst overslaan. Een snelle
GET /v1/modelsaanroep bevestigt dat de sleutel werkt en dat het enige modeluncensoredis. Het kost niets. - 429-responsen negeren. Een proefsleutel staat 2 gelijktijdige verzoeken toe, dus een lus met tien workers zal snel falen. Beperk je aantal workers of voeg een korte wacht toe.
- Zeer grote request bodies verzenden. De limiet is 8 MB per verzoek. Prompt-schrijfverzoeken zijn klein, dus dit maakt zelden uit, maar geplakte documenten kunnen het raken.
Geen van deze is moeilijk op te lossen, en de snelste genezing is een testscript van tien regels dat je uitvoert voordat je iets in een grotere tool integreert.
Wanneer een andere service beter past
Wees praktisch in de keuze. Als je de afbeelding zelf nodig hebt, heb je een image-provider nodig, en OpenAI is er een van meerdere; kijk naar de huidige documentatie en prijzen voor de details van wat het aanbiedt. Als je enige doel een schone prompt in een mainstream-stijl is, is een standaard assistant misschien genoeg en heb je deze service helemaal niet nodig.
Deze API is de betere keuze wanneer de tekststap de bottleneck is: de assistant die je gebruikt weigert of verwatert je promptverzoeken, je hebt een hoog volume aan prompts nodig tegen een voorspelbare prijs per token, of je wilt een OpenAI-compatible endpoint voor fictie, roleplay en companion tools voor legaal gebruik door volwassenen zonder je client code te herschrijven. Voor volledige parameterdetails heeft de documentatie het verzoekformaat en de error codes.
Nog een praktische opmerking: prompts die naar deze API worden verzonden, worden niet gebruikt voor training. Behandel elke gehoste service echter als buiten je machine en vermijd het verzenden van geheimen die je niet in een webformulier zou plakken.
