認証
Authorization ヘッダーに Bearer トークン。キーは設定で作成でき、いつでも取り消せます。
Authorization: Bearer dk_live_...画像、動画、音声、3D をひとつの API で。支払いはスタジオと同じ残高です。キーは設定で作成できます。CLI は近日公開です。
近日公開Ducklygen CLI は準備中です。このページで使い方を先にご覧いただけます。それまではAPIをご利用ください。
npm i -g @ducklygen/cliモデル 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"
}
}'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" }
メールでサインインし、設定の API キーを開いてキーを作成します。お支払いから €3 以上をチャージしてください。
export DUCKLYGEN_API_KEY="dk_live_..."コマンドラインツールはまだ公開されていません。それまでは、すべてスタジオで使えます。
npm i -g @ducklygen/cliカタログからモデル ID を選び、プロンプトを送信します。--dry-run を付ければ、何も消費せずに価格を確認できます。
ducklygen run <model> -p "duck on teal waves" -o ./out/シェル、CI ジョブ、コーディングエージェントから任意のモデルを実行。すべての生成は開始前に価格が決まり、同じ残高から支払われます。
@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/quoteIdempotency-Key ヘッダーを送れば、再試行したリクエストで二重に請求されることはありません。
Idempotency-Key: render-042キーごとに 1 分あたりの上限と、任意の 1 日の上限があります。上限を超えると API は 429 を返します。
429 Too Many Requestsエラーはコードとメッセージ付きの JSON。失敗した生成は自動的に残高へ返金されます。
{ "status": "refunded" }ベース URLhttps://ducklygen.com/api/v1/api/catalogAPI リファレンス全文 →
/meキーと残高/modelsすべてのモデル/models/detail?id=MODEL_ID1 つのモデルとそのフィールド/quote指定した入力の価格/generations生成を開始/generations最近の生成/generations/ID1 件の生成のステータス/generations/ID/content結果ファイル/generations/ID生成を削除設定でAPIキーを作成すれば、どのモデルも呼び出せます。CLI は近日公開です。失敗した生成は返金されます。