Dropstone Support

Menggunakan API dengan paket Anda

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

API Dropstone adalah endpoint yang kompatibel dengan OpenAI untuk kode yang tidak boleh bergantung pada permukaan yang memerlukan 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 yang perlu Anda ketahui.

Membuat kunci API

  1. Buka Settings di dashboard Anda.
  2. Di bawah 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 meng-commit-nya, dan jangan pernah mengirimkannya dalam bundel browser. Siapa pun yang memegangnya dapat menghabiskan saldo di baliknya. 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 milik permukaan yang memerlukan 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 mengisi ulang, alih-alih dilayani dan ditagih kemudian. Tidak ada tier gratis di API.

Kompatibel dengan OpenAI

Endpoint ini mengikuti format chat completions OpenAI, sehingga sebagian besar klien yang 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 Pilih model. Permintaan dapat dilakukan dari bahasa apa pun yang dapat melakukan panggilan HTTP.

Apa yang tidak didukung oleh API

Endpoint ini tanpa status (stateless), dan memang sengaja demikian:

  • Tanpa memori. API tidak membaca memori akun Anda, dan tidak ada jawaban yang direkam 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 bagian dari klien lokal SDK 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 per IP, jauh di atas penggunaan normal, untuk melindungi layanan. Lonjakan yang melampaui batas akan ditolak, jadi mundurlah dan coba lagi, alih-alih memperketat loop.

Ke mana permintaan dikirim

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

Organisasi

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

Related articles

Ctrl+I