Saltar al contenido principal

Crear claves de API

Hay dos tipos de tokens de API:
  • Los tokens de API personales actúan como tú: las solicitudes se ejecutan con tu propia cuenta de Krea, con tu rol en el workspace y acceso a tus estilos. Cualquier miembro del workspace puede crear uno, y un token personal deja de funcionar si abandonas el workspace.
  • Los tokens de API de servicio actúan como un usuario de servicio independiente en tu workspace, no como la persona que los creó. Solo los propietarios y administradores del workspace pueden crearlos. Los tokens de servicio siguen funcionando si su creador abandona el workspace. Los propietarios y administradores del workspace pueden ver todos los tokens del workspace, con el gasto de los últimos 30 días registrado por cada token de servicio.
Para crear una clave de API:
  1. Ve a krea.ai/app/api/tokens
  2. Haz clic en Create Personal Token o Create Service Token
  3. Dale a tu clave un nombre descriptivo
  4. Guarda el token de forma segura: ¡solo lo verás una vez!
Los tokens de API personales funcionan como tu propia cuenta de Krea, por lo que los estilos que hayas entrenado en la app están disponibles directamente para ellos. Los tokens de API de servicio funcionan como una identidad de usuario independiente dentro de tu workspace: los estilos entrenados en la app no estarán disponibles a través de un token de servicio, y los estilos entrenados a través de un token de servicio no aparecerán en la app, a menos que se compartan con el workspace. Consulta Entrenar un estilo personalizado para más detalles.
Pautas de seguridad
  • Almacena los tokens en variables de entorno, nunca en el código
  • Usa tokens diferentes para desarrollo y producción
  • Revoca los tokens de inmediato si se ven comprometidos
  • Nunca confirmes tokens en el control de versiones
  • Nunca compartas tokens públicamente

Usar claves de API

Incluye tu token en el encabezado Authorization de todas las solicitudes:

Precios

Para conocer los precios por modelo, consulta krea.ai/app/api/pricing ↗. Cada modelo tiene un precio fijo por generación determinado por los parámetros de tu solicitud (resolución, calidad, audio, duración, referencias de estilo, etc.).

Cómo funciona la facturación de la API

Las llamadas directas a la API y las conexiones MCP que utilizan un token de API se descuentan de un saldo en USD independiente en tu workspace, separado de las unidades de cómputo que usa la app web de Krea. Las conexiones MCP que utilizan OAuth se facturan a la cuenta de Krea con la que iniciaste sesión usando unidades de cómputo. El acceso a la API debe estar habilitado en tu workspace antes de que puedas usar claves de API; si no lo está, contacta a support@krea.ai ↗.
La Agent API y las herramientas de Agent son una excepción: los turnos del agente usan el saldo de unidades de cómputo del workspace, incluso cuando se autentican con una clave de API. No usan el saldo de API.
Los trabajos fallidos y cancelados no se facturan. Solo pagas por los trabajos completados.

Cuando se agota tu saldo

Los trabajos en curso finalizan con normalidad. Las nuevas solicitudes a la API se rechazan con HTTP 402 Payment Required:
Recarga en krea.ai/app/api/ para reanudar. No hay un endpoint público para consultar tu saldo de forma programática: revísalo en la app. Ese cuerpo corresponde al 402 de saldo de API. Las respuestas 402 de Zero Data Retention y las demás se detallan en Errores y depuración.

Añadir saldo de API

Añade fondos en krea.ai/app/api/. Solo los propietarios del workspace pueden añadir saldo de API.
  • Importes predefinidos: $10, $25, $50, $100
  • Importe personalizado: $5 mínimo, $10.000 máximo
  • Se paga mediante Stripe Checkout; el saldo se aplica de inmediato tras el pago

Seguimiento del uso

Consulta la página API Usage en krea.ai/app/api/usage para ver los trabajos de API completados y los costos estimados en un rango de fechas seleccionable. Los gestores del workspace ven el uso de todo el workspace; los demás miembros ven el uso de sus propios tokens. La tarjeta de saldo de API en krea.ai/app/api/ también muestra el costo estimado de API de los últimos 7 días.

Enterprise

Los clientes de mayor volumen pueden recibir facturación mensual con términos Net 30 en lugar de pagar por adelantado. Contacta a sales@krea.ai ↗ para hablar sobre facturación empresarial.

Siguientes pasos

Playground interactivo

Realiza tu primera solicitud a la API

APIs de modelos

Explora todos los endpoints disponibles

Ciclo de vida del trabajo

Comprende los estados de los trabajos y el sondeo

Límites de tasa

Comprende los límites de la API según el nivel del plan