인증
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키마다 분당 한도와 선택적인 일일 상한이 있습니다. 한도를 넘으면 API가 429로 응답합니다.
429 Too Many Requests코드와 메시지가 담긴 JSON 오류. 실패한 렌더는 자동으로 잔액에 환불됩니다.
{ "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는 곧 출시됩니다. 실패한 렌더는 환불됩니다.