Consola de la API

Autenticación

Cada petición necesita una clave de API en la cabecera Authorization: Authorization: Bearer fk_live_.... Las claves se crean más abajo y solo se muestran una vez, al crearlas: guarda la tuya en un lugar seguro.

Tu clave de API

Modelos

Elige un modelo con el campo model. Los precios son por imagen, en Fellowi Coins, y son exactamente los que cobra el Image Studio web. El texto a imagen es lo que obtienes con una lista images vacía; si envías referencias, se usa el modelo de edición, que puede costar una cantidad distinta.

Si omites model, obtienes fellowi-text-to-image: el mismo modelo y el mismo precio que siempre ha tenido una integración escrita antes de que existiera esta opción.

curl https://fellowi.com/api/v1/api/models

Crear una imagen

POST /v1/api/images devuelve 202 de inmediato con una generación en cola; la imagen en sí tarda hasta unos minutos. Envía una cabecera Idempotency-Key para que un reintento nunca se cobre dos veces.

images es opcional: hasta 10 URL públicas de imágenes a partir de las cuales el modelo edita (una foto de un compañero, tu propia referencia). Cada una suma 10 monedas al precio, y una lista no vacía usa el modelo de edición en lugar del de texto a imagen.

curl -X POST https://fellowi.com/api/v1/api/images \
  -H "Authorization: Bearer fk_live_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "prompt": "a neon-lit cyberpunk portrait",
    "model": "fellowi-text-to-image",
    "quality": "standard",
    "format": "png",
    "aspectRatio": "1:1",
    "enhancePrompt": false,
    "enhanceStyle": "default",
    "images": []
  }'

Opciones de la petición

Todo lo que aparece a continuación es opcional. Cada valor predeterminado es el comportamiento que tenía la API antes de que existiera esa opción, así que una integración antigua sigue funcionando sin cambios.

quality

standard o high. Define la resolución y el precio: mira la tabla de arriba.

format

png o jpeg. Por defecto, png.

aspectRatio

auto (el valor por defecto) o una de 1:1, 3:4, 4:3, 2:3, 3:2, 4:5, 5:4, 16:9, 9:16, 2:1, 1:2, 3:1, 1:3, 21:9, 9:21.

enhancePrompt / enhanceStyle

Pon enhancePrompt en true para que tu prompt se reescriba antes de generar, por 10 monedas más. enhanceStyle orienta esa reescritura: default, artistic, photographic, technical, anime o realistic. Se ignora si enhancePrompt está desactivado.

images

Hasta 10 URL de imágenes accesibles públicamente desde las que editar. Si envías alguna, la petición pasa al modelo de edición. Cada imagen de referencia en images suma 10 monedas más.

Consultar el resultado

Consulta GET /v1/api/images/{id} hasta que status sea succeeded y luego descarga imageUrl. Las generaciones failed se reembolsan automáticamente.

curl https://fellowi.com/api/v1/api/images/{id} \
  -H "Authorization: Bearer fk_live_..."

Cuando una generación falla

Una generación fallida reembolsa sus monedas e informa de uno de cuatro códigos en failureCode: TIMEOUT, MODERATION_REJECTED, VENDOR_ERROR o UNKNOWN. No se publica nada más específico: un código interno te contaría cosas de nuestro sistema, no de tu petición.

Límites de uso y coste

Cada clave tiene su propio límite de peticiones por minuto (lo ves en el panel de abajo) y puede llevar un tope diario de monedas. Son protecciones contra el abuso, no el techo real: lo que de verdad limita cuántas imágenes puedes generar es tu saldo de Fellowi Coins. 403 con una página HTML: la petición se detuvo antes de llegar a la API, normalmente por su User-Agent. El predeterminado de Python-urllib está bloqueado, así que envía el tuyo, por ejemplo User-Agent: my-app/1.0.