開発者向け · API v1

ひとつの API。 すべてのモデル。

画像、動画、音声、3D をひとつの API で。支払いはスタジオと同じ残高です。キーは設定で作成できます。CLI は近日公開です。

近日公開Ducklygen CLI は準備中です。このページで使い方を先にご覧いただけます。それまではAPIをご利用ください。

$npm i -g @ducklygen/cli
モデル
672
エンドポイント
9
最低チャージ額
€3

同じ呼び出しで、どんな出力も

モデル ID を変えるだけで、画像・動画・音声を切り替えられます。フィールドはモデルに合わせて変わります。

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"
  }
}'
レンダーのサンプル

3 ステップで最初の生成

  1. 1

    API キーを作成

    メールでサインインし、設定の API キーを開いてキーを作成します。お支払いから €3 以上をチャージしてください。

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

    CLIは近日公開

    コマンドラインツールはまだ公開されていません。それまでは、すべてスタジオで使えます。

    npm i -g @ducklygen/cli
  3. 3

    最初の生成を実行

    カタログからモデル ID を選び、プロンプトを送信します。--dry-run を付ければ、何も消費せずに価格を確認できます。

    ducklygen run <model> -p "duck on teal waves" -o ./out/
近日公開Ducklygen CLI

ターミナルから生成

シェル、CI ジョブ、コーディングエージェントから任意のモデルを実行。すべての生成は開始前に価格が決まり、同じ残高から支払われます。

スクリプトと CIモデルのすべてのフィールドがフラグになります。ローカルファイルは自動でアップロードされます。
stdout に JSON実行ごとに JSON ドキュメントをひとつ出力。進捗とエラーは stderr へ、失敗時は 0 以外の終了コード。
コーディングエージェントスキルファイルが、まず価格を確認して上限を設けるようエージェントに教えます。

@ducklygen/cliパッケージはまだ公開されていません。以下のコマンドで使い方を紹介します。

CLI ガイド全文 →
コマンド
ducklygen loginAPI キーを一度貼り付けるだけ。検証して保存します
ducklygen whoamiキーの名前と残高
ducklygen models --type videoすべての動画モデルと開始価格
ducklygen run <model> -hモデルのフィールドをリアルタイムで取得: 型、デフォルト、許可される値
ducklygen run <model> -p "<prompt>" -o ./out/生成して結果をフォルダーに保存
ducklygen run <model> -p "..." --dry-run正確な価格を、何も消費せずに
ducklygen run <model> -p "..." --max-price 0.50価格が上限を超えたら実行しない
ducklygen run <model> -p "..." --json -o ./out/次のステップにそのまま使える JSON の結果
ducklygen skill installコーディングエージェントに CLI の使い方を教える

本番運用のための設計

認証

Authorization ヘッダーに Bearer トークン。キーは設定で作成でき、いつでも取り消せます。

Authorization: Bearer dk_live_...

バックグラウンド生成

生成を開始すると、すぐに queued ステータスが返ります。成功、失敗、返金のいずれかになるまでポーリングしてください。

{ "status": "queued" }

まず価格を確認

何も開始せずに、入力内容の正確な価格を取得できます。金額はすべてユーロセント単位です。

POST /v1/quote

安全な再試行

Idempotency-Key ヘッダーを送れば、再試行したリクエストで二重に請求されることはありません。

Idempotency-Key: render-042

制限

キーごとに 1 分あたりの上限と、任意の 1 日の上限があります。上限を超えると API は 429 を返します。

429 Too Many Requests

エラーと返金

エラーはコードとメッセージ付きの JSON。失敗した生成は自動的に残高へ返金されます。

{ "status": "refunded" }

エンドポイント

ベース URLhttps://ducklygen.com/api/v1/api/catalogAPI リファレンス全文 →

GET/meキーと残高
GET/modelsすべてのモデル
GET/models/detail?id=MODEL_ID1 つのモデルとそのフィールド
POST/quote指定した入力の価格
POST/generations生成を開始
GET/generations最近の生成
GET/generations/ID1 件の生成のステータス
GET/generations/ID/content結果ファイル
DELETE/generations/ID生成を削除

€3 をチャージして、今日リリース

設定でAPIキーを作成すれば、どのモデルも呼び出せます。CLI は近日公開です。失敗した生成は返金されます。