Ir al contenido
DER.run
Abrir el estudio

API

API de generación de imágenes y videos con IA

Los modelos y herramientas del estudio están disponibles por HTTPS con una clave de API: consulta el catálogo de modelos, envía generaciones, consulta su estado y descarga los resultados. O conecta DER a tu agente de IA por MCP.

Obtener una clave de APIConectar un agente de IA
  • AutenticaciónClave de API Bearer
  • Modelos y herramientas55 en el catálogo
  • SondeoCada 5–30 s
  • Precios1 crédito = US$0.01

Dos vías de acceso

REST para tu código, MCP para tus agentes

API REST

https://api.der.run/v1

Para tu propio código. Envía una generación, consulta su estado y descarga el resultado.

  • GET/v1/capabilitiesTodos los modelos con sus parámetros, espacios de subida, modo de precio e intervalo de sondeo
  • POST/v1/quotesCotiza una generación antes de enviarla
  • POST/v1/uploadsInicia una subida y luego haz PUT del archivo a la dirección que devuelve
  • POST/v1/uploads/{id}/completeTermina la subida y obtén el ID del recurso para usarlo en las entradas
  • POST/v1/jobsEnvía una generación · requiere Idempotency-Key
  • GET/v1/jobsTus generaciones, de la más reciente a la más antigua, hasta 100 por página
  • GET/v1/jobs/{id}Estado de una generación
  • GET/v1/jobs/{id}/assets/{index}Descarga un resultado mediante un enlace privado que funciona durante aproximadamente una hora

Servidor MCP y skill de DER

https://api.der.run/mcp

Para agentes de IA como Claude Code, Cursor y Codex. Agrega la dirección, inicia sesión con tu cuenta de DER y pide lo que quieras con tus palabras.

  • der_list_modelsModelos, precios y límites
  • der_quoteCotizar un trabajo antes de ejecutarlo (gratis)
  • der_create_jobIniciar un trabajo de video, imagen, AIdol, cambio de cara o música
  • der_get_jobEstado y enlaces del resultado
  • der_get_resultsEnlaces de descarga
  • + 13 herramientas más en el servidor MCP
Configura tu agente de IA

Autenticación

Una clave, toda tu cuenta

Envía tu clave de API como token Bearer. Una clave actúa como tu cuenta: los mismos créditos, el mismo nivel. Las claves duran hasta 366 días; créalas y revócalas en “Claves de API”. Hasta 10 claves a la vez.

Encabezado HTTP
# en cada solicitud
Authorization: Bearer der_user_…

Inicio rápido

Tu primera generación en tres pasos

  1. Crea una clave de API

    En el estudio, en “Claves de API”. La clave se muestra una sola vez: guárdala en un lugar seguro.

    Abrir “Claves de API”

  2. Consulta el catálogo

    GET /v1/capabilities enumera todos los modelos con sus parámetros, espacios de subida, modo de precio e intervalo de sondeo.

    Terminal
    curl "https://api.der.run/v1/capabilities" \
  -H "Authorization: Bearer $DER_API_KEY"

  3. Envía y consulta el estado

    Primero sube tu foto, luego haz POST /v1/jobs con una Idempotency-Key y consulta GET /v1/jobs/{id} hasta que la generación termine. Si vuelves a enviar la misma clave, recibes la misma generación.

    Terminal
    curl -X POST "https://api.der.run/v1/jobs" \
  -H "Authorization: Bearer $DER_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "der-v2",
    "params": {
      "prompt": "…"
    },
    "inputs": {
      "image": "<asset id>"
    }
  }'

curl "https://api.der.run/v1/jobs/{id}" \
  -H "Authorization: Bearer $DER_API_KEY"

Datos útiles

Antes de lanzar

  • Los resultados son privados

    Por REST, los resultados se descargan con tu clave: GET /v1/jobs/{id}/assets/{index} te redirige a un enlace privado que funciona durante aproximadamente una hora. No hay enlaces públicos, y las herramientas MCP entregan el mismo tipo de enlace. Los resultados y los archivos subidos se conservan 7 días y después se eliminan automáticamente.

  • Las listas vienen por páginas

    GET /v1/jobs devuelve hasta 100 generaciones, de la más reciente a la más antigua. Para obtener las anteriores, usa el valor de next_before en el parámetro before; también puedes filtrar por modelo, tipo de salida o estado.

  • Precios

    Algunos modelos tienen un precio fijo en el catálogo; el resto se cotiza al enviar. POST /v1/quotes te dice el precio antes.

  • Niveles

    Algunos modelos requieren una cuenta Pro o Max. Una solicitud a uno de ellos desde un nivel inferior recibe un 403.

  • Los mismos créditos

    La API gasta los mismos créditos que el estudio. Los créditos de las generaciones fallidas se devuelven automáticamente.

  • Consulta al ritmo del modelo

    Cada modelo tiene su propio poll_seconds en el catálogo. Si haces demasiadas solicitudes, recibes un 429 con un encabezado Retry-After.

Para agentes de IA

Usa DER desde Claude Code, Cursor o Codex

Un comando para conectarte. Los mismos modelos, los mismos créditos, y los resultados también aparecen en el estudio.

Abrir la guía de agentes de IA