Desarrolladores · API v1

Una API. Todos los modelos.

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

Referencia completa de la API Inicio rápido

PróximamenteLa CLI de Ducklygen está en camino. Esta página muestra cómo funcionará; mientras tanto, usa la API.

$npm i -g @ducklygen/cli

Modelos: 672
Endpoints: 9
Recarga mínima: 3 €

La misma llamada, cualquier resultado

Cambia el ID del modelo para pasar de imagen a video o voz. Los campos dependen del modelo.

curl -X POST https://ducklygen.com/api/v1/api/catalog/generations \
  -H "Authorization: Bearer $DUCKLYGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "modelId": "image-model-id",
  "inputs": {
    "prompt": "rubber duck floating on teal water, soft light"
  }
}'

const res = await fetch("https://ducklygen.com/api/v1/api/catalog/generations", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.DUCKLYGEN_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ modelId: "image-model-id", inputs: { prompt: "rubber duck floating on teal water, soft light" } }),
});
const job = await res.json(); // { id, status: "queued" }

import os, requests

job = requests.post(
    "https://ducklygen.com/api/v1/api/catalog/generations",
    headers={"Authorization": f"Bearer {os.environ['DUCKLYGEN_API_KEY']}"},
    json={"modelId": "image-model-id", "inputs": {"prompt": "rubber duck floating on teal water, soft light"}},
).json()  # { id, status: "queued" }

Render de ejemplo

Tu primer render en tres pasos

1
Crea una clave de API
Inicia sesión con tu email, abre Ajustes, Claves de API y crea una clave. Recarga desde 3 € en Facturación.
export DUCKLYGEN_API_KEY="dk_live_..."
2
La CLI llega pronto
La herramienta de línea de comandos aún no está publicada. Hasta entonces, todo funciona en el estudio.
npm i -g @ducklygen/cli
3
Haz tu primer render
Elige un ID de modelo del catálogo y envía un prompt. Añade --dry-run para ver el precio sin gastar nada.
ducklygen run <model> -p "duck on teal waves" -o ./out/

PróximamenteDucklygen CLI

Renderiza desde la terminal

Ejecuta cualquier modelo desde una shell, un job de CI o un agente de código. Cada render se cotiza antes de empezar y se cobra del mismo saldo.

Scripts y CICada campo de un modelo es un flag; un archivo local se sube por ti.

JSON en stdoutUn documento JSON por ejecución, progreso y errores en stderr, código de salida distinto de cero si falla.

Agentes de códigoUn archivo de skill enseña a tu agente a consultar primero el precio y a limitarlo.

El paquete @ducklygen/cli aún no está publicado. Los comandos de abajo muestran cómo funcionará.

Guía completa de la CLI →

Comando

ducklygen loginPega tu clave de API una vez; se verifica y se guarda

ducklygen whoamiEl nombre de la clave y tu saldo

ducklygen models --type videoTodos los modelos de video con su precio inicial

ducklygen run <model> -hLos campos de un modelo, en vivo: tipo, valor por defecto, valores permitidos

ducklygen run <model> -p "<prompt>" -o ./out/Renderiza y guarda el resultado en una carpeta

ducklygen run <model> -p "..." --dry-runEl precio exacto, sin gastar nada

ducklygen run <model> -p "..." --max-price 0.50No ejecuta si el precio es mayor

ducklygen run <model> -p "..." --json -o ./out/Un resultado JSON, listo para el siguiente paso

ducklygen skill installEnseña a tu agente de código a usar la CLI

Lista para producción

Autenticación

Un token Bearer en el encabezado Authorization. Crea claves en Ajustes y revoca cualquiera en cualquier momento.

Authorization: Bearer dk_live_...

Renders en segundo plano

Iniciar un render responde al instante con el estado queued. Consulta el render hasta que termine con éxito, falle o se reembolse.

{ "status": "queued" }

Primero el precio

Pide el precio exacto de tus parámetros sin iniciar nada. Todos los importes están en céntimos de euro.

POST /v1/quote

Reintentos seguros

Envía un encabezado Idempotency-Key y una petición repetida nunca cobra dos veces.

Idempotency-Key: render-042

Límites

Cada clave tiene un límite por minuto y un tope diario opcional. Al superarlo, la API responde 429.

429 Too Many Requests

Errores y reembolsos

Errores JSON con un código y un mensaje. Un render fallido se reembolsa a tu saldo automáticamente.

{ "status": "refunded" }

Endpoints

URL basehttps://ducklygen.com/api/v1/api/catalogReferencia completa de la API →

GET/meTu clave y tu saldo

GET/modelsTodos los modelos

GET/models/detail?id=MODEL_IDUn modelo y sus campos

POST/quotePrecio para entradas exactas

POST/generationsIniciar una generación

GET/generationsTus generaciones recientes

GET/generations/IDEstado de una generación

GET/generations/ID/contentEl archivo resultante

DELETE/generations/IDEliminar una generación

Recarga 3 € y lanza hoy

Crea una clave API en Ajustes y llama a cualquier modelo. La CLI llega pronto. Los renders fallidos se reembolsan.

Obtener una clave API Ver precios