개발자 · 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"
  }
}'
예시 렌더

세 단계로 첫 렌더

  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

한도

키마다 분당 한도와 선택적인 일일 상한이 있습니다. 한도를 넘으면 API가 429로 응답합니다.

429 Too Many Requests

오류와 환불

코드와 메시지가 담긴 JSON 오류. 실패한 렌더는 자동으로 잔액에 환불됩니다.

{ "status": "refunded" }

엔드포인트

기본 URLhttps://ducklygen.com/api/v1/api/catalog전체 API 레퍼런스 →

GET/me내 키와 잔액
GET/models전체 모델
GET/models/detail?id=MODEL_ID모델 하나와 해당 필드
POST/quote정확한 입력값의 가격
POST/generations렌더링 시작
GET/generations최근 렌더링 목록
GET/generations/ID렌더링 하나의 상태
GET/generations/ID/content결과 파일
DELETE/generations/ID렌더링 삭제

€3 충전하고 오늘 바로 출시하세요

설정에서 API 키를 만들고 어떤 모델이든 호출하세요. CLI는 곧 출시됩니다. 실패한 렌더는 환불됩니다.