Pular para o conteúdo
DER.run
Abrir o estúdio

API

API de geração de imagem e vídeo com IA

Os modelos e as ferramentas do estúdio estão disponíveis via HTTPS com uma chave de API: leia o catálogo de modelos, envie gerações, consulte o status e baixe os resultados. Ou conecte a DER ao seu agente de IA via MCP.

Obter uma chave de APIConectar um agente de IA
  • AutenticaçãoChave de API Bearer
  • Modelos e ferramentas55 no catálogo
  • Intervalo de consultaA cada 5–30 s
  • Preços1 crédito = US$ 0,01

Duas formas de acesso

REST para código, MCP para agentes

API REST

https://api.der.run/v1

Para o seu próprio código. Envie uma geração, consulte o status e baixe o resultado.

  • GET/v1/capabilitiesTodos os modelos com parâmetros, campos de envio, modo de preço e intervalo de consulta
  • POST/v1/quotesVeja o preço de uma geração antes de enviá-la
  • POST/v1/uploadsInicie um envio e depois faça PUT do arquivo no endereço retornado
  • POST/v1/uploads/{id}/completeConclua o envio e receba o ID do arquivo para usar nas entradas
  • POST/v1/jobsEnvie uma geração · Idempotency-Key obrigatória
  • GET/v1/jobsSuas gerações, das mais recentes às mais antigas, até 100 por página
  • GET/v1/jobs/{id}Status de uma geração
  • GET/v1/jobs/{id}/assets/{index}Baixe um resultado por um link privado que funciona por cerca de uma hora

Servidor MCP e skill da DER

https://api.der.run/mcp

Para agentes de IA como Claude Code, Cursor e Codex. Adicione o endereço, entre com a sua conta da DER e peça com suas próprias palavras.

  • der_list_modelsModelos, preços e limites
  • der_quoteCotar uma tarefa antes de executar (grátis)
  • der_create_jobIniciar uma tarefa de vídeo, imagem, AIdol, troca de rosto ou música
  • der_get_jobStatus e links do resultado
  • der_get_resultsLinks de download
  • + 13 ferramentas a mais no servidor MCP
Configurar o seu agente de IA

Autenticação

Uma chave, a sua conta inteira

Envie a sua chave de API como token Bearer. A chave age como a sua conta: mesmos créditos, mesmo nível. As chaves duram até 366 dias — crie e revogue chaves em “Chaves de API”. Até 10 chaves ao mesmo tempo.

Cabeçalho HTTP
# em toda solicitação
Authorization: Bearer der_user_…

Início rápido

Sua primeira geração em três passos

  1. Crie uma chave de API

    No estúdio, em “Chaves de API”. A chave aparece uma única vez — guarde-a em um lugar seguro.

    Abrir chaves de API

  2. Leia o catálogo

    GET /v1/capabilities lista todos os modelos com parâmetros, campos de envio, modo de preço e intervalo de consulta.

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

  3. Envie e consulte

    Envie a sua foto primeiro, depois faça POST /v1/jobs com uma Idempotency-Key e consulte GET /v1/jobs/{id} até a geração terminar. Enviar a mesma chave de novo retorna a mesma geração.

    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"

Bom saber

Antes de publicar

  • Os resultados são privados

    Via REST, os resultados são baixados com a sua chave: GET /v1/jobs/{id}/assets/{index} redireciona para um link privado que funciona por cerca de uma hora. Não há links públicos, e as ferramentas MCP fornecem o mesmo tipo de link. Os resultados e os arquivos enviados são mantidos por 7 dias e depois excluídos automaticamente.

  • As listas vêm em páginas

    GET /v1/jobs retorna até 100 gerações, das mais recentes às mais antigas. Para ver as mais antigas, envie o valor de next_before no parâmetro before; dá para filtrar por modelo, tipo de saída ou estado.

  • Preços

    Alguns modelos têm preço fixo no catálogo; os demais são cotados quando você envia. POST /v1/quotes informa o preço antes.

  • Níveis

    Alguns modelos exigem uma conta Pro ou Max. Uma solicitação para um deles vinda de um nível inferior recebe um 403.

  • Os mesmos créditos

    A API gasta os mesmos créditos do estúdio. Se uma geração falhar, os créditos são devolvidos automaticamente.

  • Consulte no ritmo do modelo

    Cada modelo tem o próprio poll_seconds no catálogo. Solicitações demais recebem um 429 com o cabeçalho Retry-After.

Para agentes de IA

A DER no Claude Code, no Cursor ou no Codex

Um comando para conectar. Mesmos modelos, mesmos créditos, e os resultados também aparecem no estúdio.

Abrir o guia de agentes de IA