身份验证
在 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/从 shell、CI 任务或编程智能体运行任意模型。每次生成在开始前都会报价,并从同一个余额中扣除。
@ducklygen/cli 包尚未发布。下面的命令展示它将如何工作。
完整 CLI 指南 →ducklygen login粘贴一次 API 密钥,验证后即保存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每个密钥都有每分钟限额和可选的每日上限。超出限额时,API 返回 429。
429 Too Many RequestsJSON 格式的错误,包含错误码和消息。失败的生成会自动退还到你的余额。
{ "status": "refunded" }基础 URLhttps://ducklygen.com/api/v1/api/catalog完整 API 参考 →
/me你的密钥和余额/models所有模型/models/detail?id=MODEL_ID单个模型及其字段/quote指定输入的价格/generations开始生成/generations你最近的生成/generations/ID单个生成的状态/generations/ID/content结果文件/generations/ID删除生成在设置中创建 API 密钥,即可调用任何模型。CLI 即将推出。失败的渲染会退款。