Dropstone Support

Gunakan Dropstone API dengan paket Anda

Panggil Dropstone melalui HTTP dengan kunci API. Endpoint-nya kompatibel dengan OpenAI, ditagih sesuai pemakaian dari saldo kredit Anda, dan dapat digunakan dari bahasa apa pun. Kunci, error, batas kecepatan, dan hal-hal yang tidak didukung oleh API.

Dropstone API adalah endpoint yang kompatibel dengan OpenAI untuk kode yang tidak boleh bergantung pada antarmuka yang mengharuskan login: pekerjaan CI, fungsi serverless, layanan dalam bahasa lain. Buat kunci, arahkan klien ke Dropstone, dan Anda memanggil tiga model yang sama seperti Chat dan CLI.

Referensi endpoint tersedia di docs.dropstone.io/cli/api. Halaman ini membahas kunci, penagihan, dan hal-hal yang perlu Anda ketahui.

Membuat kunci API

  1. Buka Settings di dashboard Anda.
  2. Di bagian API keys, pilih Create key dan beri nama.
  3. Salin kunci tersebut. Bentuknya seperti dsk_live_... dan hanya ditampilkan sekali.

Perlakukan kunci seperti kata sandi: jangan pernah menyimpannya di dalam kode, dan jangan pernah mengirimkannya dalam bundel browser. Siapa pun yang memegang kunci tersebut dapat menghabiskan saldo di belakangnya. Anda dapat melihat kapan setiap kunci terakhir digunakan dan mencabut salah satunya dari halaman yang sama.

Penagihan: bayar sesuai pemakaian

Permintaan dengan kunci API ditagih sesuai pemakaian dari saldo kredit Anda. Jatah paket tidak berlaku untuk permintaan tersebut.

Jatah mingguan berlaku untuk permukaan yang mengharuskan login: Chat, CLI, dan sesi SDK lokal. API dihitung secara terpisah, sehingga lalu lintas pipeline tidak pernah menghabiskan jatah tempat Anda bekerja, dan minggu yang sibuk di Chat tidak pernah menghentikan pipeline. Isi ulang dari Billing di dashboard.

Kunci dengan saldo kosong akan ditolak dengan error yang menjelaskan hal tersebut beserta tautan untuk isi ulang, bukan dilayani lalu ditagih kemudian. Tidak ada tier gratis di API.

Kompatibel dengan OpenAI

Endpoint ini mengikuti format chat completions OpenAI, sehingga sebagian besar klien yang sudah ada dapat berfungsi hanya dengan mengubah base URL dan kunci:

import OpenAI from "openai"

const openai = new OpenAI({
  baseURL: "https://api.dropstone.io/api/v1",
  apiKey: process.env.DROPSTONE_API_KEY,
})

Modelnya adalah dropstone-fast, dropstone-pro, dan dropstone-heavy; lihat Model AI apa saja yang digunakan Dropstone?. Menyebut tier tanpa versi akan menjalankan jajaran model saat ini, sehingga skrip mengikuti jajaran model tersebut ke depan secara otomatis. Untuk mengunci versi tertentu, gunakan bentuk ber-versi, misalnya dropstone-fast-1.7. Versi model dan jajaran bulanan membahas keduanya. Permintaan dapat dilakukan dari bahasa apa pun yang dapat melakukan panggilan HTTP.

Hal-hal yang tidak didukung API

Endpoint ini bersifat stateless, dan memang sengaja demikian:

  • Tanpa memori. API tidak membaca memori akun Anda, dan tidak ada jawaban yang dicatat di sana. Input yang sama memberikan jawaban yang sama, apa pun yang Anda ajarkan ke Dropstone minggu lalu.
  • Tanpa tools dan tanpa loop agen. API hanya menjawab chat completion. Membaca codebase, mengedit file, dan menjalankan perintah adalah tugas dari SDK klien lokal dan CLI.

Jika Anda ingin kode Anda menggunakan agen beserta memorinya, gunakan klien lokal SDK. Lihat Satu memori di setiap permukaan.

Batas kecepatan

Permintaan dibatasi kecepatannya per IP, jauh di atas penggunaan normal, untuk melindungi layanan. Ledakan permintaan yang melampaui batas akan ditolak, jadi mundurlah dan coba lagi, jangan memperketat loop.

Ke mana permintaan dikirim

Permintaan API diproses di Amerika Serikat, sama seperti permukaan lainnya. Lihat Ke mana permintaan Anda dijalankan.

Organisasi

Anggota organisasi membuat kunci di bawah akun mereka sendiri, dan saldo di belakang kunci adalah milik pemilik kunci. Admin organisasi dapat melihat penggunaan API per anggota di dashboard organisasi, dan kunci berhenti berfungsi ketika akun di belakangnya dinonaktifkan, yang terjadi ketika anggota dihapus melalui SCIM.

Related articles

Ctrl+I