Authentification
Un jeton Bearer dans l'en-tête Authorization. Créez des clés dans Paramètres et révoquez-en une à tout moment.
Authorization: Bearer dk_live_...Images, vidéo, audio et 3D derrière une seule API, avec le même solde que le studio. Créez une clé dans Réglages ; la CLI arrive bientôt.
Bientôt disponibleLa CLI Ducklygen arrive. Cette page montre son fonctionnement ; d'ici là, utilisez l'API.
npm i -g @ducklygen/cliChangez l'ID du modèle pour passer de l'image à la vidéo ou à la voix. Les champs suivent le modèle.
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" }
Connectez-vous avec votre email, ouvrez Paramètres, Clés API et créez une clé. Rechargez dès 3 € dans Facturation.
export DUCKLYGEN_API_KEY="dk_live_..."L'outil en ligne de commande n'est pas encore publié. D'ici là, tout se passe dans le studio.
npm i -g @ducklygen/cliChoisissez un ID de modèle dans le catalogue et envoyez un prompt. Ajoutez --dry-run pour voir le prix sans rien dépenser.
ducklygen run <model> -p "duck on teal waves" -o ./out/Lancez n'importe quel modèle depuis un shell, un job CI ou un agent de code. Chaque rendu est chiffré avant de démarrer et débité du même solde.
Le paquet @ducklygen/cli n'est pas encore publié. Les commandes ci-dessous montrent comment il fonctionnera.
Guide complet de la CLI →ducklygen loginCollez votre clé API une fois ; elle est vérifiée et enregistréeducklygen whoamiLe nom de la clé et votre soldeducklygen models --type videoTous les modèles vidéo avec leur prix de départducklygen run <model> -hLes champs d'un modèle, en direct : type, valeur par défaut, valeurs autoriséesducklygen run <model> -p "<prompt>" -o ./out/Rendre et enregistrer le résultat dans un dossierducklygen run <model> -p "..." --dry-runLe prix exact, sans rien dépenserducklygen run <model> -p "..." --max-price 0.50Refuser de lancer si le prix est plus élevéducklygen run <model> -p "..." --json -o ./out/Un résultat JSON, prêt pour l'étape suivanteducklygen skill installApprendre à votre agent de code à utiliser la CLIUn jeton Bearer dans l'en-tête Authorization. Créez des clés dans Paramètres et révoquez-en une à tout moment.
Authorization: Bearer dk_live_...Lancer un rendu répond aussitôt avec le statut queued. Interrogez le rendu jusqu'à ce qu'il réussisse, échoue ou soit remboursé.
{ "status": "queued" }Demandez le prix exact de vos paramètres sans rien lancer. Tous les montants sont en centimes d'euro.
POST /v1/quoteEnvoyez un en-tête Idempotency-Key et une requête relancée n'est jamais facturée deux fois.
Idempotency-Key: render-042Chaque clé a une limite par minute et un plafond quotidien facultatif. Au-delà, l'API répond 429.
429 Too Many RequestsDes erreurs JSON avec un code et un message. Un rendu qui échoue est remboursé automatiquement sur votre solde.
{ "status": "refunded" }URL de basehttps://ducklygen.com/api/v1/api/catalogRéférence complète de l'API →
/meVotre clé et votre solde/modelsTous les modèles/models/detail?id=MODEL_IDUn modèle et ses champs/quotePrix pour des entrées exactes/generationsLancer un rendu/generationsVos rendus récents/generations/IDStatut d'un rendu/generations/ID/contentLe fichier résultat/generations/IDSupprimer un renduCréez une clé API dans Réglages et appelez n'importe quel modèle. La CLI arrive bientôt. Les rendus échoués sont remboursés.