Clave de API de Flux: qué es y dónde encaja una API de texto
Una clave de API de Flux es una credencial para un servicio de generación de imágenes, y este sitio no vende una. Lo que vende es una clave diferente, para una API de LLM de texto alojada que puede redactar y ampliar los prompts que alimentas a un modelo de imagen.
Actualizado

Puntos clave
- Una clave para un servicio de imágenes Flux y una clave para una API de texto LLM son dos cosas distintas, emitidas por dos proveedores distintos.
- Este sitio es solo de texto: no genera imágenes, audio ni video, y no lo gestiona ningún proveedor de modelos de imagen.
- Una clave de texto es útil junto a una clave de imagen porque la escritura de prompts es una tarea de texto, facturada por token.
- Cambia una URL base y una clave en cualquier cliente de OpenAI para empezar, y un crédito de prueba cubre las primeras pruebas.
Empieza con crédito de prueba
Correo y contraseña; la clave aparece al instante en pantalla.
Obtener clave de APILo que la gente suele entender por clave de Flux
Flux es el nombre de una familia de modelos de texto a imagen. Cuando alguien escribe flux api key en un cuadro de búsqueda, casi siempre quiere una credencial que permita a su código enviar un prompt a un servicio que aloja uno de esos modelos de imagen y obtener una imagen. Esa credencial proviene de la empresa que gestiona el endpoint de imágenes que elegiste. Está vinculada a su cuenta, su facturación y sus términos.
Verás la frase usada de algunas formas ligeramente distintas, y ayuda a ordenarlas antes de pegar una clave en cualquier lugar:
- Una clave de un proveedor de imágenes que sirve modelos Flux, usada en una petición que devuelve una imagen.
- Una clave para una configuración local o autoalojada, donde creas el token tú mismo y nada sale de tu máquina.
- Una clave para otra herramienta en tu pipeline, como un modelo de texto que escribe los prompts, que solo se llama Flux porque el proyecto lleva ese nombre.
Solo las dos primeras generan imágenes. La tercera es donde se sitúa este sitio. Ejecutamos una API de LLM alojada y compatible con OpenAI, y la clave que obtienes aquí funciona con esa API y nada más.
Por qué una clave de imagen no llama a un modelo de chat
Los dos tipos de clave se parecen, ya que ambas son cadenas largas que envías en una cabecera Authorization, pero abren puertas distintas. La clave de un proveedor de imágenes es verificada por el proveedor de imágenes. Si la envías a un endpoint de chat, obtendrás un error de autenticación, y viceversa: una clave de este sitio devuelve un error si la envías a un proveedor de imágenes.
Los cuerpos de las peticiones también difieren. Una llamada de imagen suele llevar un prompt, dimensiones, una semilla y un recuento de imágenes. Una llamada de chat lleva una lista de mensajes con roles, y devuelve texto. No hay un esquema compartido, así que no hay nada que traducir entre ellos. Si tienes un script que funciona con un proveedor de imágenes, mantén ese script y su clave exactamente como están. Añade la llamada de texto como un paso separado delante de él.
Lo que este servicio no hace
Para mantener las expectativas claras: la API aquí es solo de texto. No genera imágenes, audio ni video, no crea embeddings, y no ofrece ajuste fino. No es la API oficial de ningún proveedor de modelos y no es un enrutador entre proveedores. Sirve un único modelo de pesos abiertos, optimizado para responder sin rechazos de contenido para uso adulto lícito, y es ejecutado por un proveedor independiente. El ID del modelo que pasas es uncensored.
Dónde encaja una API de texto junto a una clave de imagen
La escritura de prompts es el punto de encuentro evidente. Los modelos de imagen responden bien a descripciones específicas y estructuradas: sujeto, entorno, objetivo, iluminación, color, estado de ánimo. La mayoría de las personas las escriben a mano, luego las reescriben tras un resultado malo. Un modelo de texto puede hacer el primer borrador, expandir una idea de tres palabras en una descripción completa o producir veinte variaciones sobre un tema mientras vas a por café.
Algunas tareas que encajan bien:
- Expansión. Convierte una idea corta en un prompt detallado en un estilo que configuras una vez en el mensaje del sistema.
- Variación. Pide diez enfoques distintos sobre un mismo sujeto, devueltos como una lista JSON que tu script puede recorrer.
- Limpieza. Reescribe un prompt desordenado escrito por un cliente para que un modelo de imagen lo maneje mejor.
- Scripts y descripciones. Escribe la narración, la lista de planos o la descripción que va junto a la imagen.
Porque el modelo aquí no rechaza por defecto, se adapta a ficción, diseño de personajes y temas maduros que otros modelos alojados suelen rechazar, siempre que el uso sea lícito e involucre adultos. Se aplica un límite estricto en todas partes: no hay contenido sexual que involucre menores de edad. Las peticiones de ese tipo no son algo que admitamos en ninguna forma.
Una primera llamada en menos de un minuto
Cualquier SDK o cliente HTTP de OpenAI funciona una vez que cambias la URL base y la clave. El endpoint para chat es POST /v1/chat/completions, y GET /v1/models lista los modelos. Aquí tienes la misma petición en curl y en 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)
Cualquier cadena que devuelva es lo que entregas a tu servicio de imágenes, usando la clave propia de ese servicio. Los dos nunca se tocan. Para la lista completa de parámetros, incluyendo streaming, llamadas a funciones y modo JSON, consulta la documentación de la API.
¿Necesitas ambas claves?
Depende de lo que estés construyendo. La siguiente tabla es una forma rápida de decidir.
| Tu objetivo | Clave de imagen | Clave de texto |
|---|---|---|
| Generar imágenes a partir de prompts que escribes tú mismo | Sí | No |
| Generar imágenes a partir de prompts que escribe o expande un modelo | Sí | Sí |
| Escribir historias, diálogos o guiones únicamente | No | Sí |
| Construir una aplicación de chat o juego de roles para adultos | No | Sí |
| Producir en lote cientos de variaciones de prompts | Opcional | Sí |
Si solo escribes tus propios prompts y estás satisfecho con ellos, una clave de texto añade poco. Si te encuentras reescribiendo prompts toda la tarde, o necesitas volumen, justifica su coste rápidamente. También tenemos una guía corta sobre el uso de un LLM de texto en flujos de trabajo de video, que sigue la misma idea de un paso de texto delante de un paso de medios.
Errores que surgen al confundir claves
La mayoría de los problemas en una configuración de dos servicios son pequeños y fáciles de detectar una vez que sabes qué buscar.
- URL base incorrecta. Si tu cliente sigue apuntando al proveedor antiguo, la nueva clave se rechaza. Verifica que la URL base termine en
/v1y coincida con la del ejemplo anterior. - Nombre de modelo incorrecto. El único ID de modelo aquí es
uncensored. Pasar el nombre de un modelo de imagen devuelve un error, porque no existe tal modelo en esta API. - Claves en una variable de entorno. Asigna a cada servicio su propia variable, por ejemplo
TEXT_API_KEYyIMAGE_API_KEY. Compartir un nombre es cómo una clave termina enviándose al proveedor equivocado. - Esperar imágenes en la respuesta. La respuesta es texto plano en
choices[0].message.content. Si necesitas una imagen, ese texto debe enviarse a tu servicio de imágenes como una segunda llamada. - Ignorar 429. Una ráfaga superior a 8 peticiones simultáneas devuelve un 429 con el código de error
concurrency, y por encima de 300 peticiones por minuto conrate_limited. Reduce la carga brevemente y reintenta. Una petición en streaming mantiene su espacio hasta que finalice el stream, así que cierra los streams que ya no leas.
La clave de prueba tiene límites más bajos: 2 peticiones simultáneas y 60 por minuto. Eso es suficiente para probar un paso de redacción de prompts a mano, pero un lote grande debe esperar una clave recargada.
Cuánto cuesta escribir un prompt
La facturación es por token y con crédito prepago: $0,15 por cada 1M de tokens de entrada y $0,50 por cada 1M de tokens de salida, sin suscripción. Los trabajos de prompt son pequeños, por lo que los montos son bajos. Toma una petición con un mensaje del sistema de 600 tokens más la idea (entrada) y un prompt ampliado de 250 tokens (salida). La entrada cuesta 600 / 1.000.000 x $0,15 = $0,00009. La salida cuesta 250 / 1.000.000 x $0,50 = $0,000125. Una petición cuesta $0,000215.
Un lote de 1.000 de estas peticiones cuesta aproximadamente $0,215. El crédito de prueba de $0,50, que puedes reclamar con un solo clic en la página de la clave después de registrarte, cubre aproximadamente 2.300 de ellas (0,50 / 0,000215). No requiere tarjeta y dura 7 días. Las peticiones fallidas o rechazadas no se cobran, y el crédito que añadas después nunca caduca. Los detalles están en la página de precios.
Cómo obtener tu clave de texto
Regístrate con Google, o con un correo electrónico y contraseña, luego abre la página de la clave de API. Reclama el crédito de prueba allí si quieres probar primero. Las recargas pagadas van desde $20 hasta $500 en cualquier cantidad entera, con un bono del +5% desde $50, +10% desde $100 y +15% desde $200. Puedes pagar con cripto (USDT en TRC20, USDC en Base).
Mantén la clave fuera del código del lado del cliente y fuera de repositorios públicos. Los prompts que envíes no se usan para entrenamiento, pero una clave filtrada gastará tu crédito. La clave completa permite 8 peticiones simultáneas y 300 peticiones por minuto, por lo que un lote de prompts puede ejecutarse en paralelo sin trabajo adicional.
Más guías
Preguntas y respuestas
¿Puedo usar esta clave para generar imágenes con Flux?
No. La clave funciona solo contra la API de texto de este sitio. La generación de imágenes necesita una clave de un proveedor que aloje un modelo de imagen.
¿Es esta la API oficial de Flux?
No. Esta es una API de texto independiente, alojada y compatible con OpenAI con un modelo, llamado uncensored. No es ejecutada por ningún proveedor de modelos de imagen ni revende sus servicios.
¿Puede el modelo de texto escribir prompts para mi herramienta de imagen?
Sí. Pide un prompt en el mensaje del sistema, toma el texto de la respuesta y pégalo o envíalo a tu servicio de imagen. Los dos servicios permanecen independientes.
¿Necesito una tarjeta para probarlo?
No. Los nuevos usuarios pueden reclamar $0,50 de crédito de prueba con un solo clic en la página de la clave, válido durante 7 días, sin necesidad de tarjeta.
Tu clave está a un formulario de distancia
Crea una cuenta, copia la clave, cambia la URL base. Esa es toda la configuración.