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_...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/cliTroque 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"
}
}'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" }
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_..."A ferramenta de linha de comando ainda não foi publicada. Até lá, tudo roda no estúdio.
npm i -g @ducklygen/cliEscolha 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/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.
O pacote @ducklygen/cli ainda não foi publicado. Os comandos abaixo mostram como ele vai funcionar.
Guia completo da CLI →ducklygen loginCole sua chave de API uma vez; ela é verificada e salvaducklygen whoamiO nome da chave e o seu saldoducklygen models --type videoTodos os modelos de vídeo com o preço inicialducklygen run <model> -hOs campos de um modelo, ao vivo: tipo, padrão, valores permitidosducklygen run <model> -p "<prompt>" -o ./out/Renderiza e salva o resultado em uma pastaducklygen run <model> -p "..." --dry-runO preço exato, sem gastar nadaducklygen run <model> -p "..." --max-price 0.50Não executa se o preço for maiorducklygen run <model> -p "..." --json -o ./out/Um resultado em JSON, pronto para o próximo passoducklygen skill installEnsine seu agente de código a usar a CLIUm token Bearer no cabeçalho Authorization. Crie chaves em Configurações e revogue qualquer uma a qualquer momento.
Authorization: Bearer dk_live_...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" }Peça o preço exato dos seus parâmetros sem iniciar nada. Todos os valores estão em centavos de euro.
POST /v1/quoteEnvie um cabeçalho Idempotency-Key e uma requisição repetida nunca cobra duas vezes.
Idempotency-Key: render-042Cada chave tem um limite por minuto e um teto diário opcional. Acima do limite, a API responde 429.
429 Too Many RequestsErros em JSON com um código e uma mensagem. Um render que falha é reembolsado no seu saldo automaticamente.
{ "status": "refunded" }URL basehttps://ducklygen.com/api/v1/api/catalogReferência completa da API →
/meSua chave e seu saldo/modelsTodos os modelos/models/detail?id=MODEL_IDUm modelo e seus campos/quotePreço para entradas exatas/generationsIniciar uma geração/generationsSuas gerações recentes/generations/IDStatus de uma geração/generations/ID/contentO arquivo de resultado/generations/IDExcluir uma geraçãoCrie uma chave de API em Configurações e chame qualquer modelo. A CLI chega em breve. Renders com falha são reembolsados.