Skip to main content
POST

Otorisasi

string
wajib
##Semua API memerlukan autentikasi Bearer Token##Dapatkan API Key:Kunjungi Halaman Manajemen API Key untuk mendapatkan API Key AndaTambahkan ke header request:

Body

string
default:"gpt-5.2-pro"
wajib
Nama modelModel yang didukung meliputi:
  • gpt-5.2-pro
  • gpt-5.2-codex
  • qwen3.8-max
  • Model lainnya segera hadir…
array
wajib
Daftar konten inputArray input; setiap item berisi field role dan content.💡 Pengisian cepat (area Try it):
  1. Klik ”+ Add an item” untuk menambahkan item input
  2. Input role: user (pesan pengguna), assistant (respons AI), atau system (prompt sistem)
  3. Tambahkan blok konten di content (dapat mencakup teks dan gambar)
number
Mengontrol keacakan output, rentang 0-2
  • Nilai yang lebih rendah (misalnya 0,2) membuat output lebih deterministik
  • Nilai yang lebih tinggi (misalnya 1,8) membuat output lebih acak
Default: 1.0
integer
Jumlah maksimum token yang akan dibuatSetiap model memiliki batas maksimum yang berbeda; lihat dokumentasi model terkait
boolean
Apakah akan menggunakan output streaming
  • true: Respons streaming (format SSE)
  • false: Mengembalikan respons lengkap sekaligus
Default: false
number
Parameter nucleus sampling, rentang 0-1Mengontrol keragaman teks yang dihasilkan; sebaiknya digunakan sebagai alternatif temperatureDefault: 1.0
array
Daftar tool untuk memperluas kemampuan modelJenis tool yang didukung:
  • Web Search (web_search): Pencarian informasi internet real-time
  • File Search (file_search): Mencari konten file yang diunggah
  • Function Calling (function): Memanggil fungsi kustom
  • Remote MCP (remote_mcp): Terhubung ke layanan Model Context Protocol jarak jauh
Contoh: [{"type": "web_search"}]

Respons

string
Pengidentifikasi unik untuk respons
string
Jenis objek, tetap sebagai response
integer
Timestamp pembuatan
string
Nama model aktual yang digunakan
array
Daftar balasan yang dihasilkan
object
Statistik penggunaan token

Contoh Penggunaan

Input Teks Saja

cURL Example

Pemahaman Gambar

Analisis Multi-Gambar

Gambar yang Dikodekan Base64

Menggunakan Function Calling

Menggunakan Remote MCP

Menggabungkan Beberapa Tool

Spesifikasi Jenis Konten

input_text

Jenis input teks Properti:
  • type: Tetap sebagai "input_text"
  • text: Konten teks (string)

input_image

Jenis input gambar Properti:
  • type: Tetap sebagai "input_image"
  • image_url: URL gambar atau data URI yang dikodekan Base64
Format gambar yang didukung:
  • JPEG
  • PNG
  • GIF
  • WebP
Batas ukuran gambar:
  • Ukuran file maksimum: 20MB
  • aspect_ratio yang disarankan: tidak lebih dari 2048x2048 piksel

Detail Penggunaan Tool

Tool web search memungkinkan model mengakses informasi internet real-time. Contoh konfigurasi:
Kasus penggunaan:
  • Menanyakan berita terbaru dan peristiwa terkini
  • Mendapatkan data real-time (saham, cuaca, nilai tukar, dan sebagainya)
  • Mencari dokumentasi teknis terbaru
  • Memverifikasi informasi faktual
Tool file search memungkinkan model mencari informasi relevan dalam dokumen yang diunggah. Contoh konfigurasi:
Kasus penggunaan:
  • Menganalisis dokumen internal perusahaan
  • Mencari spesifikasi teknis dan manual
  • Menanyakan kontrak dan dokumen hukum
  • Sistem tanya jawab basis pengetahuan

Function Calling

Definisikan fungsi kustom agar model dapat memanggil API eksternal atau menjalankan operasi tertentu. Contoh konfigurasi lengkap:
Deskripsi parameter:
  • name: Nama fungsi (wajib)
  • description: Deskripsi fungsi (wajib)
  • parameters: Definisi parameter menggunakan format JSON Schema
    • type: Jenis parameter
    • properties: Definisi properti parameter
    • required: Daftar parameter wajib
Kasus penggunaan:
  • Memanggil API pihak ketiga
  • Menjalankan kueri basis data
  • Memicu proses bisnis
  • Berintegrasi dengan sistem internal

Remote MCP

Terhubung ke layanan Model Context Protocol (MCP) jarak jauh untuk memperluas kemampuan model. Contoh konfigurasi:
Deskripsi parameter:
  • url: Alamat server MCP (wajib)
  • auth_token: Token autentikasi (opsional)
  • timeout: Timeout dalam detik, default 30 detik
Kasus penggunaan:
  • Terhubung ke layanan AI tingkat enterprise
  • Menggunakan model khusus domain
  • Mengakses sumber data terlindungi
  • Integrasi sistem AI terdistribusi

Format Respons Tool

Saat model menggunakan tool, format respons akan menyertakan informasi pemanggilan tool:
Alur kerja pemanggilan tool:
  1. Model menerima input pengguna
  2. Menganalisis apakah tool diperlukan
  3. Jika diperlukan, mengembalikan request pemanggilan tool
  4. Klien menjalankan pemanggilan tool
  5. Mengembalikan hasil tool ke model
  6. Model menghasilkan respons akhir

Catatan Penting

  1. Persyaratan URL gambar:
    • Harus berupa URL yang dapat diakses publik
    • Atau gunakan format Data URI yang dikodekan Base64
  2. Penagihan token:
    • Gambar mengonsumsi token berdasarkan aspect_ratio
    • Gambar dengan aspect_ratio tinggi akan diubah ukurannya secara otomatis untuk mengoptimalkan biaya
    • Pemanggilan tool juga mengonsumsi token tambahan
  3. Urutan konten:
    • Urutan elemen dalam array konten memengaruhi pemahaman model
    • Disarankan menempatkan instruksi teks terlebih dahulu, lalu gambar
  4. Kombinasi multimodal:
    • Dapat mencampur beberapa teks dan gambar dalam satu request
    • Mendukung percakapan multi-giliran dengan koherensi konteks
  5. Batasan penggunaan tool:
    • Saat beberapa tool digunakan sekaligus, model akan memilih tool yang paling sesuai secara cerdas
    • Function calling memerlukan definisi fungsi dan deskripsi parameter yang jelas
    • Hasil web search dapat dibatasi oleh wilayah dan waktu
  6. Kompatibilitas API:
    • Sepenuhnya kompatibel dengan format OpenAI Responses API
    • Memigrasikan kode OpenAI yang sudah ada dengan lancar
    • Mendukung semua fitur ekstensi tool OpenAI