API Ultineo Reasoning
Jalankan aplikasi katalog dari perangkat lunak Anda sendiri. API ini menggunakan JSON melalui HTTPS, mengautentikasi setiap panggilan dengan kunci proyek, dan menjawab setiap panggilan dalam amplop yang sama.
Dibangun di sekitar aplikasi, eksekusi, dan kunci
- Aplikasi
Buat aplikasi dari kolom input dan instruksinya, lalu tampilkan, baca, dan edit aplikasi Anda.
- Runs and usage
Satu panggilan menjalankan aplikasi dengan inputnya; panggilan lain membaca kembali eksekusi beserta jawabannya. Ringkasan menampilkan token yang digunakan dalam minggu penagihan berjalan beserta jumlah biayanya.
- Kunci
Kunci proyek dengan cakupan, masa berlaku opsional, dan status yang dapat Anda nonaktifkan.
Integrasikan di mana saja
- In your software
Add a reasoning step to an existing screen: a summary, a suggested reply, a classification.
- Di otomasi Anda
A script or an automation tool launches a run at each event: a form received, a file dropped.
- Dari satu jawaban ke yang berikutnya
Jawaban dari satu eksekusi dapat menjadi bidang dari eksekusi berikutnya: kode Anda merangkai langkah-langkah sesuai keinginan.
The same run, through the API
Your software sends the application’s identifier and its fields, then reads the run back until it is finished.
Yang Anda kirim
{
"app_id": "mapp_0ceacb46e5b3a99e91b6",
"data": {
"message": "My parcel has not arrived and the tracking has not moved for a week."
}
} Apa yang Anda baca kembali
{
"id": "runi_1b7f4e0c96a2d8531fca",
"object": "reasoning",
"status": "finished",
"response": { "miid_9a4c07e5b312df8641ca": "urgent" },
"tokens": { "input": 412, "output": 3, "total": 415 },
"duration": 1.84
} Autentikasi dan cakupan
- Kunci bearer
Kirim kunci proyek Anda di header Authorization pada setiap panggilan, hanya melalui HTTPS.
- Terbatas pada satu proyek
Sebuah kunci terikat pada satu proyek dan tidak pernah dapat membaca atau menulis data proyek lain, apa pun permintaannya.
- Disimpan sebagai hash
Hanya hash dari kunci yang disimpan, sehingga kunci ditampilkan lengkap hanya satu kali. Kunci yang hilang diganti, tidak pernah dipulihkan.
Jalankan eksekusi dan baca jawabannya
- Buat
Sebutkan aplikasinya dan berikan satu nilai untuk setiap kolom input, dengan nama kolom yang dikembalikan aplikasi sebagai kuncinya.
- Pantau
Eksekusi berjalan secara asinkron: baca kembali eksekusi hingga statusnya selesai atau gagal. Keduanya bersifat final.
- Baca
Eksekusi yang selesai memuat jawabannya, durasinya, serta jumlah token input dan output.
The runs your software started, one by one
Every call made through the API appears in the reasonings list, marked API, with its duration and its tokens. Each application shows the identifier your software calls.
Satu amplop untuk setiap jawaban
- Tiga kolom yang sama
Setiap jawaban memuat kode status, judul singkat, dan respons, baik saat berhasil maupun gagal.
- Pesan yang stabil
Pesan kesalahan berupa string bahasa Inggris yang stabil dan menyebutkan cakupan yang kurang atau nilai yang ditolak.
- Refusals are explicit
A call that cannot be accepted, for example while an invoice is overdue, is refused with its own status code.
Mendapatkan kunci
API access is included with Ultineo Reasoning. There is no self-service sign-up: our team opens your project and hands you its first key.
Hubungkan perangkat lunak Anda ke Ultineo Reasoning
Beri tahu kami apa yang ingin Anda otomatiskan, dan kami akan membuka proyek Anda beserta kunci API-nya.
Pertanyaan tentang API
Yes. Every project can call the API; a call is billed like any other run, on the tokens it uses.
Tidak. Instruksi adalah milik pemilik aplikasi. API mengembalikan kolom input, yaitu yang diisi oleh pemanggil.
Pembuatan eksekusi langsung kembali dengan status baru. Baca kembali eksekusi hingga selesai untuk mendapatkan jawabannya.
Ya. Setiap kunci memiliki cakupan dan masa berlaku opsional, dan sebuah kunci tidak pernah dapat membuat kunci lain dengan cakupan yang lebih luas dari miliknya sendiri.