IT ▾
Ottieni la chiave API

Chiave API Flux: cos'è e dove si inserisce un'API testuale

Una chiave API Flux è una credenziale per un servizio di generazione di immagini e questo sito non ne vende una. Ciò che vende è una chiave diversa, per un'API LLM testuale ospitata che può scrivere ed espandere i prompt che alimenti a un modello per immagini.

Aggiornato

Due chiavi separate, una collegata a un frame per immagini e una alle bolle di chat, due API separate

Punti chiave

  • Una chiave per un servizio di immagini Flux e una chiave per un'API LLM testuale sono due cose separate, emesse da due provider diversi.
  • Questo sito è solo testuale: nessuna generazione di immagini, audio o video, e non è gestito da alcun vendor di modelli per immagini.
  • Una chiave testuale è utile accanto a una chiave per immagini perché la scrittura di prompt è un'attività testuale, fatturata per token.
  • Cambi un solo Base URL e una sola chiave in qualsiasi client OpenAI per iniziare, e un credito di prova copre i primi test.

Cosa le persone intendono di solito per chiave Flux

Flux è il nome di una famiglia di modelli text-to-image. Quando qualcuno digita flux api key in una casella di ricerca, vuole quasi sempre una credenziale che permetta al proprio codice di inviare un prompt a un servizio che ospita uno di questi modelli di immagini e restituire un'immagine. Questa credenziale proviene da qualsiasi azienda gestisca l'endpoint delle immagini che hai scelto. È collegata al loro account, alla loro fatturazione e ai loro termini.

Vedrai la frase usata in alcuni modi leggermente diversi, ed è utile ordinarli prima di incollare una chiave ovunque:

  • Una chiave da un host per immagini che serve modelli Flux, usata in una richiesta che restituisce un'immagine.
  • Una chiave per un'installazione locale o self-hosted, dove crei il token tu stesso e nulla esce dalla tua macchina.
  • Una chiave per qualche altro strumento nella tua pipeline, come un modello testuale che scrive i prompt, che viene chiamato Flux solo perché il progetto si chiama così.

Solo le prime due producono immagini. La terza è dove si colloca questo sito. Gestiamo un'API LLM ospitata compatibile con OpenAI e la chiave che ottieni qui funziona contro quell'API e nient'altro.

Perché una chiave per immagini non chiama un modello di chat

I due tipi di chiave sembrano simili, poiché sono entrambe stringhe lunghe che invii in un'intestazione Authorization, ma aprono porte diverse. La chiave di un provider per immagini viene verificata dal provider per immagini. Se la invii a un endpoint di chat, ottieni un errore di autenticazione, e viceversa: una chiave di questo sito restituisce un errore se la invii a un host per immagini.

Anche i corpi della richiesta differiscono. Una chiamata per immagini di solito trasporta un prompt, dimensioni, un seed e un conteggio di immagini. Una chiamata di chat trasporta un elenco di messaggi con ruoli e restituisce testo. Non esiste uno schema condiviso, quindi non c'è nulla da tradurre tra di loro. Se hai uno script che funziona contro un host per immagini, mantieni quello script e la sua chiave esattamente come sono. Aggiungi la chiamata testuale come passaggio separato davanti ad essa.

Cosa questo servizio non fa

Per mantenere chiare le aspettative: l'API qui è solo per il testo. Non genera immagini, audio o video, non crea embedding e non offre fine-tuning. Non è l'API ufficiale di alcun fornitore di modelli e non è un router tra fornitori. Offre un solo modello a pesi aperti, ottimizzato per rispondere senza rifiuti di contenuti per uso adulto legale, ed è gestito da un provider indipendente. L'ID del modello che passi è uncensored.

Dove si inserisce un'API testuale accanto a una chiave per immagini

La scrittura dei prompt è il punto di incontro ovvio. I modelli per immagini rispondono bene a descrizioni specifiche e strutturate: soggetto, ambientazione, obiettivo, illuminazione, colore, atmosfera. La maggior parte delle persone le scrive a mano, poi le riscrive dopo un risultato scadente. Un modello testuale può fare la prima bozza, espandere un'idea di tre parole in una descrizione completa o produrre venti varianti su un tema mentre vai a prendere il caffè.

Alcuni compiti che si adattano bene:

  • Espansione. Trasforma un'idea breve in un prompt dettagliato con uno stile che imposti una volta nel messaggio di sistema.
  • Variante. Chiedi dieci varianti diverse su un soggetto, restituite come elenco JSON che il tuo script può iterare.
  • Pulizia. Riscrivi un prompt disordinato scritto da un cliente in qualcosa che un modello per immagini gestisce meglio.
  • Script e didascalie. Scrivi la narrazione, la lista delle inquadrature o la didascalia che va accanto all'immagine.

Poiché il modello qui non rifiuta di default, è adatto per narrativa, design di personaggi e temi maturi che altri modelli ospitati spesso rifiutano, purché l'uso sia legale e coinvolga adulti. Si applica un limite rigido ovunque: nessun contenuto sessuale che coinvolga minorenni. Richieste di questo tipo non sono qualcosa che supportiamo in alcuna forma.

Una prima chiamata in meno di un minuto

Qualsiasi SDK OpenAI o client HTTP funziona una volta che scambi il base URL e la chiave. L'endpoint per la chat è POST /v1/chat/completions, e GET /v1/models elenca il modello. Ecco la stessa richiesta in curl e 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)

Qualsiasi stringa che torna è ciò che consegni al tuo servizio per immagini, usando la chiave di quel servizio. I due non si toccano mai. Per l'elenco completo dei parametri, incluso lo streaming, la chiamata di funzioni e la modalità JSON, consulta la documentazione API.

Hai bisogno di entrambe le chiavi?

Dipende da cosa stai costruendo. La tabella sottostante è un modo rapido per decidere.

Il tuo obiettivoChiave per immaginiChiave testuale
Genera immagini da prompt che scrivi tu stessoSìNo
Genera immagini da prompt scritti o espansi da un modelloSìSì
Scrivi solo storie, dialoghi o scriptNoSì
Crea un'app di chat o roleplay per adultiNoSì
Produci in batch centinaia di varianti di promptOpzionaleSì

Se digiti sempre i tuoi prompt e ne sei soddisfatto, una chiave testuale aggiunge poco. Se ti trovi a riscrivere prompt tutto il pomeriggio, o hai bisogno di volume, guadagna rapidamente il suo costo. Abbiamo anche una breve guida su l'uso di un LLM testuale nei flussi video, che segue la stessa idea di un passaggio testuale davanti a un passaggio multimediale.

Errori dovuti alla confusione tra chiavi

La maggior parte dei problemi in un'infrastruttura a due servizi sono piccoli e facili da individuare una volta che sai cosa cercare.

  • Base URL errato. Se il tuo client punta ancora al vecchio host, la nuova chiave viene rifiutata. Controlla che il base URL finisca con /v1 e corrisponda a quello nell'esempio sopra.
  • Nome del modello errato. L'unico ID del modello qui è uncensored. Passare il nome di un modello per immagini restituisce un errore, perché non esiste tale modello su questa API.
  • Chiavi in una variabile d'ambiente. Assegna a ogni servizio la propria variabile, ad esempio TEXT_API_KEY e IMAGE_API_KEY. Condividere un nome è il modo in cui una chiave finisce per essere inviata all'host sbagliato.
  • Aspettarsi immagini nella risposta. La risposta è testo semplice in choices[0].message.content. Se hai bisogno di un'immagine, quel testo deve essere inviato al tuo servizio per immagini come seconda chiamata.
  • Ignorare 429. Un burst oltre 8 richieste parallele restituisce un 429 con il codice errore concurrency, e oltre 300 richieste al minuto con rate_limited. Riduci il carico brevemente e riprova. Una richiesta in streaming mantiene il suo slot fino al termine dello streaming, quindi chiudi gli stream che non leggi più.

La chiave di prova ha tetti più bassi: 2 richieste parallele e 60 al minuto. È più che sufficiente per testare manualmente un passaggio di scrittura di prompt, ma un batch grande dovrebbe aspettare una chiave ricaricata.

Quanto costa scrivere un prompt

La fatturazione è per token e prepagata: $0,15 per 1 milione di token di input e $0,50 per 1 milione di token di output, senza abbonamento. I job di prompt sono piccoli, quindi i numeri sono ridotti. Prendi una richiesta con un messaggio di sistema di 600 token più idea (input) e un prompt espanso di 250 token (output). L'input costa 600 / 1.000.000 x $0,15 = $0,00009. L'output costa 250 / 1.000.000 x $0,50 = $0,000125. Una richiesta costa $0,000215.

Un batch di 1.000 tali richieste costa quindi circa $0,215. Il credito di prova di $0,50, che puoi richiedere con un clic dalla pagina della chiave dopo la registrazione, copre circa 2.300 di esse (0,50 / 0,000215). Non serve una carta e dura 7 giorni. Le richieste fallite o rifiutate non vengono addebitate e il credito che aggiungi in seguito non scade mai. I dettagli sono nella pagina dei prezzi.

Ottenere la tua chiave testuale

Registrati con Google, o con un'email e una password, poi apri la pagina della chiave API. Richiedi il credito di prova lì se vuoi testare prima. Le ricariche a pagamento vanno da $20 a $500 in qualsiasi importo intero, con un bonus del +5% da $50, +10% da $100 e +15% da $200. Puoi pagare con cripto (USDT su TRC20, USDC su Base).

Tieni la chiave fuori dal codice lato client e dai repository pubblici. I prompt che invii non vengono usati per l'addestramento, ma una chiave rubata spende il tuo credito. La chiave completa permette 8 richieste concorrenti e 300 richieste al minuto, quindi un batch di prompt può essere eseguito in parallelo senza lavoro aggiuntivo.

Domande e risposte

Posso usare questa chiave per generare immagini con Flux?

No. La chiave funziona solo contro l'API testuale di questo sito. La generazione di immagini richiede una chiave da un provider che ospita un modello di immagine.

È l'API ufficiale di Flux?

No. Questa è un'API testuale indipendente, ospitata e compatibile con OpenAI, con un solo modello, chiamato uncensored. Non è gestita da alcun fornitore di modelli di immagine e non rivende i loro servizi.

Il modello testuale può scrivere prompt per il mio strumento di immagine?

Sì. Chiedi un prompt nel messaggio di sistema, prendi il testo della risposta e incollalo o invialo al tuo servizio di immagini. I due servizi rimangono indipendenti.

Ho bisogno di una carta per provarlo?

No. I nuovi utenti possono richiedere $0,50 di credito di prova con un clic nella pagina delle chiavi, valido per 7 giorni, senza bisogno della carta.

La tua chiave è a un modulo di distanza

Crea un account, copia la chiave, modifica il Base URL. È tutta la configurazione.

Ottieni la chiave API