Développeurs · API v1

Une API. Tous les modèles.

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/cli
Modèles
672
Endpoints
9
Recharge minimale
3 €

Le même appel, n'importe quel résultat

Changez 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"
  }
}'
Exemple de rendu

Premier rendu en trois étapes

  1. 1

    Créez une clé API

    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_..."
  2. 2

    La CLI arrive bientôt

    L'outil en ligne de commande n'est pas encore publié. D'ici là, tout se passe dans le studio.

    npm i -g @ducklygen/cli
  3. 3

    Lancez votre premier rendu

    Choisissez 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/
Bientôt disponibleDucklygen CLI

Rendez depuis le terminal

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.

Scripts et CIChaque champ d'un modèle est une option ; un fichier local est envoyé pour vous.
JSON sur stdoutUn document JSON par exécution, progression et erreurs sur stderr, un code de sortie non nul en cas d'échec.
Agents de codeUn fichier de skill apprend à votre agent à vérifier d'abord le prix et à le plafonner.

Le paquet @ducklygen/cli n'est pas encore publié. Les commandes ci-dessous montrent comment il fonctionnera.

Guide complet de la CLI →
Commande
ducklygen loginCollez votre clé API une fois ; elle est vérifiée et enregistrée
ducklygen whoamiLe nom de la clé et votre solde
ducklygen models --type videoTous les modèles vidéo avec leur prix de départ
ducklygen run <model> -hLes champs d'un modèle, en direct : type, valeur par défaut, valeurs autorisées
ducklygen run <model> -p "<prompt>" -o ./out/Rendre et enregistrer le résultat dans un dossier
ducklygen run <model> -p "..." --dry-runLe prix exact, sans rien dépenser
ducklygen 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 suivante
ducklygen skill installApprendre à votre agent de code à utiliser la CLI

Prête pour la production

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_...

Rendus en arrière-plan

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" }

Le prix d'abord

Demandez le prix exact de vos paramètres sans rien lancer. Tous les montants sont en centimes d'euro.

POST /v1/quote

Relances sans risque

Envoyez un en-tête Idempotency-Key et une requête relancée n'est jamais facturée deux fois.

Idempotency-Key: render-042

Limites

Chaque clé a une limite par minute et un plafond quotidien facultatif. Au-delà, l'API répond 429.

429 Too Many Requests

Erreurs et remboursements

Des erreurs JSON avec un code et un message. Un rendu qui échoue est remboursé automatiquement sur votre solde.

{ "status": "refunded" }

Endpoints

URL de basehttps://ducklygen.com/api/v1/api/catalogRéférence complète de l'API →

GET/meVotre clé et votre solde
GET/modelsTous les modèles
GET/models/detail?id=MODEL_IDUn modèle et ses champs
POST/quotePrix pour des entrées exactes
POST/generationsLancer un rendu
GET/generationsVos rendus récents
GET/generations/IDStatut d'un rendu
GET/generations/ID/contentLe fichier résultat
DELETE/generations/IDSupprimer un rendu

Rechargez 3 € et lancez-vous aujourd'hui

Cré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.