Spesifikasi API

Kirim permintaan pertama, pilih model dari katalog, dan simpan pengenal permintaan untuk diagnosis.

Kirim kunci API dalam header Bearer dan pisahkan kredensial produksi dari kredensial pengembangan.

Gunakan URL dasar yang berbeda untuk klien bergaya OpenAI dan Messages: keduanya menargetkan spesifikasi yang sama, tetapi menyusun path dengan cara berbeda.

Konfigurasikan klien dengan kunci, model, dan URL dasar yang sesuai dengan protokolnya; simpan rahasia di lingkungan.

Jawaban praktis singkat tentang kunci, URL dasar, model, biaya, dan diagnosis integrasi.

Bangun pemilihan model dari data katalog, bukan daftar yang dikodekan langsung dalam aplikasi Anda.

Pisahkan kunci, pemilik, anggaran, dan jejak penggunaan antar aplikasi dan ruang kerja.

Perlakukan batas kunci, organisasi, model, dan perutean sebagai bagian dari alur kerja pengguna.

Hubungkan metadata respons dan log permintaan Anda sendiri ke tindakan pengguna yang nyata.

Minimalkan data yang dikirim, pisahkan pengenal pengguna akhir dari konten, dan kendalikan retensi dalam produk Anda.

Buat percakapan multi-giliran dalam format messages yang dikenal dan pilih model untuk setiap permintaan.

Gunakan format Messages untuk percakapan dengan instruksi sistem tingkat atas dan batas output eksplisit.

Gunakan satu objek input bila aplikasi Anda memperoleh manfaat dari penanganan item output dan tindakan dalam satu model data.

Terima token dan delta terstruktur melalui SSE tanpa menunggu respons lengkap.

Jelaskan fungsi dengan JSON Schema, jalankan pemanggilan dalam aplikasi Anda, lalu kembalikan hasilnya ke percakapan.

Minta objek JSON atau JSON Schema ketika respons akan digunakan perangkat lunak, bukan manusia.

Tetapkan tingkat upaya penalaran per permintaan hanya untuk model yang menyatakan kemampuan tersebut.

Nyatakan persyaratan eksekusi dalam preferensi terkait penyedia dan simpan hasil sebenarnya untuk observabilitas.

Pisahkan konteks berulang agar klien dapat menggunakan penyimpanan cache yang kompatibel jika model yang dipilih mendukungnya.

Ambil sumber terbaru melalui fungsi `web_search` yang dijalankan klien dan pisahkan tautan dari teks yang dihasilkan.

Unggah file melalui operasi khusus, simpan ID-nya, lalu teruskan referensinya dalam permintaan kompatibel berikutnya.

Buat gambar melalui satu rute dan pilih parameter dari kemampuan model yang dipilih.

Mulai pembuatan video sebagai tugas asinkron, simpan ID tugasnya, dan pisahkan pembuatan dari pembacaan hasil.

Gunakan operasi terpisah untuk sintesis ucapan, transkripsi, dan input audio ke model.

Ubah teks atau input yang didukung menjadi vektor untuk pencarian, pengelompokan, dan rekomendasi.

Urutkan kembali sekumpulan kecil kandidat terhadap kueri untuk meningkatkan presisi pengambilan informasi pada tahap akhir.

Proses operasi yang independen dalam kelompok terkendali jika alur kerja mengizinkan pengiriman asinkron.

Hubungkan klien AI ke alat, sumber daya, dan prompt yang diizinkan melalui URL koneksi yang diterbitkan di pengaturan akun.

Bangun penanganan berdasarkan status HTTP, isi kesalahan terstruktur, dan ID permintaan, bukan teks pesan.