Desenvolvedores · API v1

Uma API. Todos os modelos.

Imagens, vídeo, áudio e 3D numa só API, com o mesmo saldo do estúdio. Crie uma chave em Configurações; a CLI chega em breve.

Em breveA CLI do Ducklygen está a caminho. Esta página mostra como vai funcionar; até lá, use a API.

$npm i -g @ducklygen/cli
Modelos
672
Endpoints
9
Recarga mínima
€ 3

A mesma chamada, qualquer resultado

Troque o ID do modelo para alternar entre imagem, vídeo e voz. Os campos seguem o 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"
  }
}'
Render de exemplo

Seu primeiro render em três passos

  1. 1

    Crie uma chave de API

    Entre com seu email, abra Configurações, Chaves de API e crie uma chave. Recarregue a partir de € 3 em Cobrança.

    export DUCKLYGEN_API_KEY="dk_live_..."
  2. 2

    A CLI chega em breve

    A ferramenta de linha de comando ainda não foi publicada. Até lá, tudo roda no estúdio.

    npm i -g @ducklygen/cli
  3. 3

    Faça seu primeiro render

    Escolha um ID de modelo no catálogo e envie um prompt. Adicione --dry-run para ver o preço sem gastar nada.

    ducklygen run <model> -p "duck on teal waves" -o ./out/
Em breveDucklygen CLI

Renderize pelo terminal

Execute qualquer modelo a partir de um shell, um job de CI ou um agente de código. Cada render tem o preço calculado antes de começar e é pago com o mesmo saldo.

Scripts e CICada campo de um modelo é uma flag; um arquivo local é enviado para você.
JSON no stdoutUm documento JSON por execução, progresso e erros no stderr, código de saída diferente de zero em caso de falha.
Agentes de códigoUm arquivo de skill ensina seu agente a verificar o preço primeiro e a limitá-lo.

O pacote @ducklygen/cli ainda não foi publicado. Os comandos abaixo mostram como ele vai funcionar.

Guia completo da CLI →
Comando
ducklygen loginCole sua chave de API uma vez; ela é verificada e salva
ducklygen whoamiO nome da chave e o seu saldo
ducklygen models --type videoTodos os modelos de vídeo com o preço inicial
ducklygen run <model> -hOs campos de um modelo, ao vivo: tipo, padrão, valores permitidos
ducklygen run <model> -p "<prompt>" -o ./out/Renderiza e salva o resultado em uma pasta
ducklygen run <model> -p "..." --dry-runO preço exato, sem gastar nada
ducklygen run <model> -p "..." --max-price 0.50Não executa se o preço for maior
ducklygen run <model> -p "..." --json -o ./out/Um resultado em JSON, pronto para o próximo passo
ducklygen skill installEnsine seu agente de código a usar a CLI

Pronta para produção

Autenticação

Um token Bearer no cabeçalho Authorization. Crie chaves em Configurações e revogue qualquer uma a qualquer momento.

Authorization: Bearer dk_live_...

Renders em segundo plano

Iniciar um render responde na hora com o status queued. Consulte o render até que ele seja concluído, falhe ou seja reembolsado.

{ "status": "queued" }

Preço primeiro

Peça o preço exato dos seus parâmetros sem iniciar nada. Todos os valores estão em centavos de euro.

POST /v1/quote

Repetições seguras

Envie um cabeçalho Idempotency-Key e uma requisição repetida nunca cobra duas vezes.

Idempotency-Key: render-042

Limites

Cada chave tem um limite por minuto e um teto diário opcional. Acima do limite, a API responde 429.

429 Too Many Requests

Erros e reembolsos

Erros em JSON com um código e uma mensagem. Um render que falha é reembolsado no seu saldo automaticamente.

{ "status": "refunded" }

Endpoints

URL basehttps://ducklygen.com/api/v1/api/catalogReferência completa da API →

GET/meSua chave e seu saldo
GET/modelsTodos os modelos
GET/models/detail?id=MODEL_IDUm modelo e seus campos
POST/quotePreço para entradas exatas
POST/generationsIniciar uma geração
GET/generationsSuas gerações recentes
GET/generations/IDStatus de uma geração
GET/generations/ID/contentO arquivo de resultado
DELETE/generations/IDExcluir uma geração

Recarregue € 3 e lance hoje

Crie uma chave de API em Configurações e chame qualquer modelo. A CLI chega em breve. Renders com falha são reembolsados.