Langkau ke kandungan
DER.run
Buka studio

API

API penjanaan imej dan video AI

Model dan alat dalam studio tersedia melalui HTTPS dengan kunci API: baca katalog model, hantar penjanaan, tinjau statusnya dan muat turun hasil. Atau sambungkan DER ke ejen AI anda melalui MCP.

Dapatkan kunci APISambungkan ejen AI
  • PengesahanKunci API Bearer
  • Model dan alat55 dalam katalog
  • TinjauanSetiap 5–30 s
  • Harga1 kredit = US$0.01

Dua cara masuk

REST untuk kod, MCP untuk ejen

API REST

https://api.der.run/v1

Untuk kod anda sendiri. Hantar penjanaan, tinjau statusnya, muat turun hasil.

  • GET/v1/capabilitiesSetiap model dengan parameter, slot muat naik, mod harga dan selang tinjauannya
  • POST/v1/quotesDapatkan harga penjanaan sebelum anda menghantarnya
  • POST/v1/uploadsMulakan muat naik, kemudian PUT fail ke alamat yang dipulangkan
  • POST/v1/uploads/{id}/completeSelesaikan muat naik dan dapatkan ID aset untuk digunakan dalam input
  • POST/v1/jobsHantar penjanaan · Idempotency-Key diperlukan
  • GET/v1/jobsPenjanaan anda, terbaharu dahulu, sehingga 100 setiap halaman
  • GET/v1/jobs/{id}Status penjanaan
  • GET/v1/jobs/{id}/assets/{index}Muat turun output melalui pautan peribadi yang berfungsi selama kira-kira sejam

Pelayan MCP & kemahiran DER

https://api.der.run/mcp

Untuk ejen AI seperti Claude Code, Cursor dan Codex. Tambah alamat, log masuk dengan akaun DER anda, kemudian minta dalam bahasa biasa.

  • der_list_modelsModel, harga dan had
  • der_quoteDapatkan harga tugasan sebelum ia berjalan (percuma)
  • der_create_jobMulakan tugasan video, imej, AIdol, tukar muka atau muzik
  • der_get_jobStatus dan pautan hasil
  • der_get_resultsPautan muat turun
  • + 13 alat lagi dalam pelayan MCP
Sediakan ejen AI anda

Pengesahan

Satu kunci, seluruh akaun anda

Hantar kunci API anda sebagai token Bearer. Kunci bertindak sebagai akaun anda: kredit yang sama, tahap yang sama. Kunci kekal sehingga 366 hari — cipta dan batalkannya dalam “Kunci API”. Sehingga 10 kunci pada satu masa.

Pengepala HTTP
# setiap permintaan
Authorization: Bearer der_user_…

Mula pantas

Penjanaan pertama anda dalam tiga langkah

  1. Cipta kunci API

    Dalam studio, di bawah “Kunci API”. Kunci ditunjukkan sekali sahaja — simpan di tempat yang selamat.

    Buka Kunci API

  2. Baca katalog

    GET /v1/capabilities menyenaraikan setiap model dengan parameter, slot muat naik, mod harga dan selang tinjauannya.

    Terminal
    curl "https://api.der.run/v1/capabilities" \
  -H "Authorization: Bearer $DER_API_KEY"

  3. Hantar dan tinjau

    Muat naik foto anda dahulu, kemudian POST /v1/jobs dengan Idempotency-Key dan tinjau GET /v1/jobs/{id} sehingga penjanaan selesai. Menghantar kunci yang sama sekali lagi memulangkan penjanaan yang sama.

    Terminal
    curl -X POST "https://api.der.run/v1/jobs" \
  -H "Authorization: Bearer $DER_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "der-v2",
    "params": {
      "prompt": "…"
    },
    "inputs": {
      "image": "<asset id>"
    }
  }'

curl "https://api.der.run/v1/jobs/{id}" \
  -H "Authorization: Bearer $DER_API_KEY"

Perlu diketahui

Sebelum anda melancarkan

  • Hasil adalah peribadi

    Melalui REST, output dimuat turun dengan kunci anda: GET /v1/jobs/{id}/assets/{index} menghantar anda ke pautan peribadi yang berfungsi selama kira-kira sejam. Tiada pautan awam, dan alat MCP memberikan jenis pautan yang sama. Hasil dan fail yang dimuat naik disimpan selama 7 hari, kemudian dipadam secara automatik.

  • Senarai datang dalam halaman

    GET /v1/jobs memulangkan sehingga 100 penjanaan, terbaharu dahulu. Hantar next_before sebagai before untuk mendapatkan yang lebih lama, dan tapis mengikut model, output atau keadaan.

  • Harga

    Sesetengah model mempunyai harga tetap dalam katalog; yang lain diberi harga apabila anda menghantar. POST /v1/quotes memberitahu anda harganya dahulu.

  • Tahap

    Sesetengah model memerlukan akaun Pro atau Max. Permintaan untuk salah satu model itu daripada tahap yang lebih rendah akan mendapat 403.

  • Kredit yang sama

    API membelanjakan kredit yang sama seperti studio. Kredit penjanaan yang gagal dipulangkan secara automatik.

  • Tinjau mengikut kadar model

    Setiap model mempunyai poll_seconds sendiri dalam katalog. Terlalu banyak permintaan akan mendapat 429 dengan pengepala Retry-After.

Untuk ejen AI

Gunakan DER daripada Claude Code, Cursor atau Codex

Satu arahan untuk bersambung. Model yang sama, kredit yang sama, dan hasil turut muncul dalam studio.

Buka panduan ejen AI