Pengembang · API v1

Satu API. Semua model.

Gambar, video, audio, dan 3D di balik satu API, dibayar dari saldo yang sama dengan studio. Buat kunci di Pengaturan; CLI segera hadir.

Segera hadirCLI Ducklygen segera hadir. Halaman ini memperlihatkan cara kerjanya; sampai saat itu, gunakan API.

$npm i -g @ducklygen/cli
Model
672
Endpoint
9
Isi saldo minimum
€3

Panggilan yang sama, output apa pun

Ganti ID model untuk beralih antara gambar, video, dan suara. Kolomnya mengikuti model.

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"
  }
}'
Contoh render

Render pertama dalam tiga langkah

  1. 1

    Buat kunci API

    Masuk dengan email Anda, buka Pengaturan, Kunci API, lalu buat kunci. Isi saldo mulai €3 di Tagihan.

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

    CLI segera hadir

    Alat baris perintah belum dirilis. Sampai saat itu, semuanya berjalan di studio.

    npm i -g @ducklygen/cli
  3. 3

    Buat render pertama

    Pilih ID model dari katalog dan kirim prompt. Tambahkan --dry-run untuk melihat harga tanpa mengeluarkan apa pun.

    ducklygen run <model> -p "duck on teal waves" -o ./out/
Segera hadirDucklygen CLI

Render dari terminal

Jalankan model apa pun dari shell, job CI, atau agen coding. Setiap render diberi harga sebelum dimulai dan dibayar dari saldo yang sama.

Skrip dan CISetiap kolom model adalah flag; file lokal diunggah untuk Anda.
JSON di stdoutSatu dokumen JSON per eksekusi, progres dan error di stderr, kode keluar bukan nol jika gagal.
Agen codingFile skill mengajari agen Anda untuk memeriksa harga terlebih dahulu dan membatasinya.

Paket @ducklygen/cli belum dipublikasikan. Perintah di bawah menunjukkan cara kerjanya nanti.

Panduan lengkap CLI →
Perintah
ducklygen loginTempel kunci API Anda sekali; kunci diperiksa lalu disimpan
ducklygen whoamiNama kunci dan saldo Anda
ducklygen models --type videoSemua model video beserta harga awalnya
ducklygen run <model> -hKolom sebuah model, diambil langsung: tipe, default, nilai yang diizinkan
ducklygen run <model> -p "<prompt>" -o ./out/Render dan simpan hasilnya di folder
ducklygen run <model> -p "..." --dry-runHarga pastinya, tanpa mengeluarkan apa pun
ducklygen run <model> -p "..." --max-price 0.50Menolak berjalan jika harganya lebih tinggi
ducklygen run <model> -p "..." --json -o ./out/Satu hasil JSON, siap untuk langkah berikutnya
ducklygen skill installAjari agen coding Anda memakai CLI

Siap untuk produksi

Autentikasi

Token Bearer di header Authorization. Buat kunci di Pengaturan dan cabut kunci mana pun kapan saja.

Authorization: Bearer dk_live_...

Render di latar belakang

Memulai render langsung menjawab dengan status queued. Polling render sampai berhasil, gagal, atau dikembalikan dananya.

{ "status": "queued" }

Harga dulu

Minta harga pasti untuk input Anda tanpa memulai apa pun. Semua jumlah dalam sen euro.

POST /v1/quote

Coba ulang dengan aman

Kirim header Idempotency-Key dan permintaan yang diulang tidak akan pernah ditagih dua kali.

Idempotency-Key: render-042

Batas

Setiap kunci punya batas per menit dan batas harian opsional. Melewati batas, API menjawab 429.

429 Too Many Requests

Error dan pengembalian dana

Error JSON dengan kode dan pesan. Render yang gagal otomatis dikembalikan ke saldo Anda.

{ "status": "refunded" }

Endpoint

URL dasarhttps://ducklygen.com/api/v1/api/catalogReferensi API lengkap →

GET/meKunci dan saldo Anda
GET/modelsSemua model
GET/models/detail?id=MODEL_IDSatu model dan kolomnya
POST/quoteHarga untuk input tertentu
POST/generationsMulai render
GET/generationsRender terbaru Anda
GET/generations/IDStatus satu render
GET/generations/ID/contentFile hasil
DELETE/generations/IDHapus render

Isi saldo €3 dan rilis hari ini

Buat kunci API di Pengaturan dan panggil model apa pun. CLI segera hadir. Render yang gagal dikembalikan.