Desarrolladores · API v1

Una API.
Todos los modelos.

Imágenes, vídeo, audio y 3D tras una sola API, pagados con el mismo saldo que el estudio. Crea una clave en Ajustes. La CLI llega pronto.

Obtener una clave de APIInicio rápido

PróximamenteLa CLI y los SDK llegan pronto. La API REST de abajo funciona hoy.

Modelos
672
Endpoints
9
Recarga mínima
3 €
01 · Ejemplos

La misma llamada, cualquier resultado

Cambia el ID del modelo para pasar de imagen a vídeo o voz. Los campos siguen al modelo.

1# 1. Generate an image2curl -X POST https://femimg.com/api/v1/api/catalog/generations \3  -H "Authorization: Bearer $FEMIMG_API_KEY" \4  -H 'Content-Type: application/json' \5  -H "Idempotency-Key: $(uuidgen)" \6  -d '{7  "modelId": "luma/uni-v1/text-to-image",8  "inputs": {9    "prompt": "Neon city street after rain, cinematic night",10    "size": "16:9"11  }12}'13 14# 2. Poll with the generation id from step 1 until its status is succeeded15curl https://femimg.com/api/v1/api/catalog/generations/$ID \16  -H "Authorization: Bearer $FEMIMG_API_KEY"17 18# 3. Download the file19curl https://femimg.com/api/v1/api/catalog/generations/$ID/content \20  -H "Authorization: Bearer $FEMIMG_API_KEY" \21  -o result.jpeg
landing.dev.outputTitleluma/uni-v1/text-to-image
02 · Inicio rápido

Tu primer render en tres pasos

  1. 01Crea una clave de APIEn Ajustes > Claves de API, ponle nombre a una clave y cópiala una vez. Recarga desde 3 € en Facturación.export FEMIMG_API_KEY="YOUR_API_KEY"
  2. 02Inicia un renderEnvía el ID del modelo y sus entradas. Recibes de inmediato una generación con estado queued.POST /api/v1/api/catalog/generations
  3. 03Consulta y descargaConsulta la generación hasta que su estado sea succeeded y descarga el archivo.GET /api/v1/api/catalog/generations/ID/content
03 · CLIPróximamente

Renderiza desde la terminal

Una herramienta de línea de comandos para scripts, CI y agentes de código está en camino, con las mismas claves y el mismo saldo que la API. Hasta entonces, todas las llamadas de esta página funcionan con curl.

Scripts y CIRenderiza desde cualquier shell, tarea o cron.
Salida JSONUn documento JSON por ejecución, listo para el siguiente paso.
Agentes de códigoTu agente consulta el precio antes y limita lo que gasta.
04 · Lo esencial de la API

Hecha para producción

Autenticación

Un token Bearer en la cabecera Authorization. Crea claves en Ajustes.

Authorization: Bearer YOUR_API_KEY

Renders en segundo plano

Iniciar un render responde al instante con estado queued. Consúltalo hasta que sea succeeded, failed o refunded.

{ "status": "queued" }

Primero el precio

Pide el precio exacto de tus entradas sin iniciar nada. Todo importe va en céntimos de euro.

POST /api/v1/api/catalog/quote

Reintentos seguros

Envía una cabecera Idempotency-Key y un reintento nunca cobra dos veces.

Idempotency-Key: render-042

Límites

Cada clave tiene un límite de peticiones por minuto. Al superarlo, recibes un error 429.

429 Too Many Requests

Errores y reembolsos

Errores JSON con código y mensaje. Un render fallido se reembolsa solo a tu saldo.

{ "status": "refunded" }
05 · Referencia

Endpoints

URL base https://femimg.com/api/v1

GET/api/catalog/meNombre y límite de la clave, y tu saldo
GET/api/catalog/modelsEl catálogo de modelos con sus precios
GET/api/catalog/models/detail?id=MODEL_IDUn modelo con todos sus campos
POST/api/catalog/quoteEl precio exacto de unas entradas
POST/api/catalog/generationsInicia un render con cualquier modelo
GET/api/catalog/generationsTus generaciones recientes
GET/api/catalog/generations/IDEstado, coste y resultado de una generación
GET/api/catalog/generations/ID/contentDescarga el archivo terminado
DELETE/api/catalog/generations/IDElimina una generación

Recarga 3 € y publica hoy

La API y el estudio comparten un solo saldo. Un render fallido se reembolsa.

Obtener una clave de APIVer precios