NL ▾
API-sleutel aanvragen

Flux API-sleutel: wat het is en waar een tekst-API past

Een Flux API-sleutel zijn inloggegevens voor een dienst voor het genereren van afbeeldingen, en deze site verkoopt er geen. Wat het wel verkoopt is een andere sleutel, voor een gehoste tekst-LLM API die prompts kan schrijven en uitbreiden die je aan een afbeeldingsmodel voert.

Bijgewerkt

Twee aparte sleutels, één gekoppeld aan een afbeeldingsframe en één aan chatbubbels, twee aparte API's

Belangrijkste punten

  • Een sleutel voor een Flux-afbeeldingsdienst en een sleutel voor een tekst-LLM API zijn twee verschillende dingen, uitgegeven door twee verschillende providers.
  • Deze site is alleen voor tekst: geen afbeeldingen, audio of video, en het wordt niet gerund door een leverancier van afbeeldingsmodellen.
  • Een tekst-sleutel is handig naast een afbeeldingssleutel omdat prompt schrijven een teksttaak is, gefactureerd per token.
  • Je wijzigt één base URL en één sleutel in elke OpenAI-client om te beginnen, en een proeftegoed dekt de eerste tests.

Waarmee mensen meestal een Flux-sleutel bedoelen

Flux is de naam van een familie van text-to-image modellen. Als iemand flux api key in een zoekbalk typt, wil hij bijna altijd inloggegevens waarmee zijn code in staat stelt een prompt naar een service te sturen die een van die afbeeldingsmodellen host, en een afbeelding terug te krijgen. Deze inloggegevens komen van het bedrijf dat het afbeeldingsendpoint beheert dat je hebt gekozen. Ze zijn gekoppeld aan hun account, hun facturatie en hun voorwaarden.

Je zult de uitdrukking op een paar licht verschillende manieren zien gebruikt, en het helpt om ze uit elkaar te halen voordat je een sleutel ergens plakt:

  • Een sleutel van een afbeeldingshost die Flux-modellen serveert, gebruikt in een verzoek dat een afbeelding retourneert.
  • Een sleutel voor een lokale of self-hosted setup, waar je het token zelf aanmaakt en niets je machine verlaat.
  • Een sleutel voor een ander hulpmiddel in je pipeline, zoals een tekstmodel dat de prompts schrijft, dat alleen Flux wordt genoemd omdat het project zo heet.

Alleen de eerste twee produceren afbeeldingen. De derde is waar deze site zit. We beheren een gehoste, OpenAI-compatibele LLM-API, en de sleutel die jij hier krijgt werkt tegen die API en niets anders.

Waarom een afbeeldingssleutel geen chatmodel aanroept

De twee soorten sleutels lijken op elkaar, omdat beide lange strings zijn die je in een Authorization header stuurt, maar ze openen verschillende deuren. De sleutel van een afbeeldingsprovider wordt gecontroleerd door de afbeeldingsprovider. Als je hem naar een chat-endpoint stuurt, krijg je een authenticatiefout, en omgekeerd geldt hetzelfde: een sleutel van deze site retourneert een fout als je hem naar een afbeeldingshost stuurt.

De requestbodies verschillen ook. Een afbeeldingsverzoek bevat meestal een prompt, afmetingen, een seed en een aantal afbeeldingen. Een chatverzoek bevat een lijst van berichten met rollen, en retourneert tekst. Er is geen gedeeld schema, dus er is niets om tussen te vertalen. Als je een script hebt dat werkt tegen een afbeeldingshost, houd dat script en je sleutel dan precies zoals ze zijn. Voeg het tekstverzoek als een aparte stap ervoor toe.

Wat deze dienst niet doet

Om de verwachtingen duidelijk te houden: de API hier is alleen tekst. Het genereert geen afbeeldingen, audio of video, het maakt geen embeddings, en het biedt geen fine-tuning. Het is niet de officiële API van een modelleverancier en het is geen router tussen leveranciers. Het serveert één open-weight model, getuned om zonder inhoudelijke weigeringen te antwoorden voor legaal gebruik door volwassenen, en gerund door een onafhankelijke provider. De model ID die je doorgeeft is uncensored.

Waar een tekst-API past naast een afbeeldingssleutel

Prompt schrijven is het voor de hand liggende snijvlak. Afbeeldingsmodellen reageren goed op specifieke, gestructureerde beschrijvingen: onderwerp, setting, lens, verlichting, kleur, sfeer. De meeste mensen schrijven die met de hand, en herschrijven ze dan na een slecht resultaat. Een tekstmodel kan de eerste versie doen, een idee van drie woorden uitbreiden tot een volledige beschrijving, of twintig variaties op een thema produceren terwijl jij koffie gaat halen.

Een paar taken die goed passen:

  • Uitbreiding. Zet een kort idee om in een gedetailleerde prompt in een stijl die je eenmaal in het systeembericht instelt.
  • Variatie. Vraag om tien verschillende interpretaties van één onderwerp, geretourneerd als een JSON-lijst waar je script over kan loopen.
  • Opschonen. Herschrijf een rommelige prompt die door een klant is geschreven naar iets wat een afbeeldingsmodel beter aankan.
  • Scripts en bijschriften. Schrijf de voice-over, shotlist of bijschrift dat naast de afbeelding gaat.

Omdat het model hier niet standaard weigert, is het geschikt voor fictie, personageontwerp en volwassen thema's die andere gehoste modellen vaak weigeren, zolang het gebruik wettelijk is en volwassenen betreft. Er geldt één harde limiet overal: geen seksuele inhoud met minderjarigen. Verzoeken daarover zijn iets wat we in geen enkele vorm ondersteunen.

Een eerste aanroep in minder dan een minuut

Elke OpenAI SDK of HTTP-client werkt zodra je de base URL en sleutel verwisselt. Het endpoint voor chat is POST /v1/chat/completions, en GET /v1/models somt het model op. Hier is hetzelfde verzoek in curl en in Python.

curl https://api.fluxapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You write detailed image prompts. Reply with the prompt only."},
      {"role": "user", "content": "a lighthouse in a storm, painterly"}
    ]
  }'
from openai import OpenAI

client = OpenAI(
    base_url="https://api.fluxapikey.com/v1",
    api_key="YOUR_KEY",
)

reply = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You write detailed image prompts. Reply with the prompt only."},
        {"role": "user", "content": "a lighthouse in a storm, painterly"},
    ],
)
print(reply.choices[0].message.content)

Wat voor string er ook terugkomt, dat geef je aan je afbeeldingsdienst, met de sleutel van die dienst zelf. De twee raken elkaar nooit. Voor de volledige lijst van parameters, inclusief streaming, function calling en JSON-modus, zie de API-documentatie.

Heb je beide sleutels nodig?

Het hangt af van wat je bouwt. De tabel hieronder is een snelle manier om te beslissen.

Je doelAfbeeldingssleutelTekstsleutel
Genereer afbeeldingen uit prompts die je zelf schrijftJaNee
Genereer afbeeldingen uit prompts die een model schrijft of uitbreidtJaJa
Schrijf alleen verhalen, dialoog of scriptsNeeJa
Bouw een chat- of roleplay-app voor volwassenenNeeJa
Produceer batchsgewijs honderden promptvariatiesOptioneelJa

Als je alleen je eigen prompts typt en daar blij mee bent, voegt een tekst-sleutel weinig toe. Als je merkt dat je de hele middag prompts herschrijft, of als je volume nodig hebt, verdient het zijn kosten snel terug. We hebben ook een korte walkthrough over het gebruik van een tekst-LLM in video-workflows, die hetzelfde idee volgt van een tekststap voorafgaand aan een mediastap.

Fouten die ontstaan door sleutels door elkaar te halen

De meeste problemen in een setup met twee diensten zijn klein en makkelijk te spotten zodra je weet waar je op moet letten.

  • Verkeerde base URL. Als je client nog steeds naar de oude host wijst, wordt de nieuwe sleutel afgewezen. Controleer dat de base URL eindigt op /v1 en overeenkomt met die in het voorbeeld hierboven.
  • Verkeerde modelnaam. De enige model ID hier is uncensored. Het doorgeven van de naam van een afbeeldingsmodel retourneert een fout, omdat er geen dergelijk model op deze API is.
  • Sleutels in één omgevingsvariabele. Geef elke dienst zijn eigen variabele, bijvoorbeeld TEXT_API_KEY en IMAGE_API_KEY. Eén naam delen is hoe een sleutel naar de verkeerde host wordt gestuurd.
  • Afbeeldingen verwachten in het antwoord. De response is platte tekst in choices[0].message.content. Als je een afbeelding nodig hebt, moet die tekst naar je imageservice als een tweede verzoek.
  • 429 negeren. Een burst boven 8 gelijktijdige verzoeken retourneert een 429 met de error code concurrency, en boven 300 verzoeken per minuut met rate_limited. Wacht kort en probeer opnieuw. Een gestreamd verzoek houdt zijn slot vast tot de stream klaar is, dus sluit streams die je niet langer leest.

De proefsleutel heeft lagere plafonds: 2 gelijktijdige verzoeken en 60 per minuut. Dat is meer dan genoeg om een prompt-schrijfstap met de hand te testen, maar een grote batch moet wachten op een opgewaardeerde sleutel.

Wat het schrijven van prompts kost

Facturatie is per token en prepaid: $0,15 per 1M input tokens en $0,50 per 1M output tokens, zonder abonnement. Prompttaken zijn klein, dus de bedragen zijn klein. Neem een verzoek met een 600-token systeembericht plus idee (input) en een 250-token uitgebreide prompt (output). Input kost 600 / 1.000.000 x $0,15 = $0,00009. Output kost 250 / 1.000.000 x $0,50 = $0,000125. Eén verzoek is $0,000215.

Een batch van 1.000 van zulke verzoeken kost dus ongeveer $0,215. Het proeftegoed van $0,50, dat je met één klik op de sleutelpagina na het aanmelden kunt claimen, dekt ongeveer 2.300 van deze verzoeken (0,50 / 0,000215). Er is geen kaart nodig en het geldt 7 dagen. Mislukte of geweigerde verzoeken worden niet in rekening gebracht, en tegoed dat je later toevoegt, vervalt nooit. Details staan op de prijzenpagina.

Je tekst-sleutel verkrijgen

Meld je aan met Google, of met een e-mail en wachtwoord, en open dan de API-sleutelpagina. Claim het gratis proeftegoed daar als je eerst wilt testen. Betaalde top-ups lopen van $20 tot $500 in elk geheel bedrag, met +5% bonus vanaf $50, +10% vanaf $100 en +15% vanaf $200. Je kunt betalen met crypto (USDT op TRC20, USDC op Base).

Houd de sleutel buiten client-side code en openbare repositories. Prompts die je verstuurt, worden niet gebruikt voor training, maar een gelekte sleutel verbruikt je tegoed. De volledige sleutel staat 8 gelijktijdige verzoeken en 300 verzoeken per minuut toe, dus een prompt batch kan parallel draaien zonder extra werk.

Vragen en antwoorden

Kan ik deze sleutel gebruiken om afbeeldingen met Flux te genereren?

Nee. De sleutel werkt alleen tegen de tekst-API van deze site. Afbeeldingsgeneratie vereist een sleutel van een provider die een afbeeldingsmodel host.

Is dit de officiële Flux API?

Nee. Dit is een onafhankelijke, gehoste, OpenAI-compatibele tekst-API met één model, genaamd uncensored. Het wordt niet gerund door een leverancier van afbeeldingsmodellen en verkoopt hun diensten niet door.

Kan het tekstmodel prompts schrijven voor mijn afbeeldingstool?

Ja. Vraag om een prompt in de systeembericht, neem de antwoordtekst en plak of verstuur deze naar je afbeeldingsdienst. De twee diensten blijven onafhankelijk.

Heb ik een kaart nodig om het te proberen?

Nee. Nieuwe gebruikers kunnen $0,50 aan proeftegoed met één klik op de sleutelpagina claimen, geldig voor 7 dagen, zonder dat een kaart nodig is.

Je sleutel is nog maar één formulier verwijderd

Maak een account aan, kopieer de sleutel, pas de base URL aan. Dat is de hele setup.

API-sleutel aanvragen