Mulai 11 Mac 2025, kami telah mengeluarkan blok binaan platform Agents baharu kami. Untuk butiran, lihat dokumen API kami bagi Responses API, Tools termasuk Web Search, File Search dan Computer Use, serta Agents SDK kami dengan Tracing. Berdasarkan maklum balas anda untuk Assistants API beta, kami telah memasukkan penambahbaikan utama ke dalam Responses API. Selepas kami mencapai kesetaraan ciri sepenuhnya, kami akan mengumumkan pelan penamatan Assistants API pada akhir tahun ini, dengan sasaran tarikh pemberhentian pada separuh pertama 2026.
Soalan lazim
Apakah itu Assistants API?
Assistants API membolehkan pembangun membina pembantu AI yang berkeupayaan tinggi dalam aplikasi mereka dengan mudah. API ini menghapuskan keperluan untuk mengurus sejarah perbualan dan memberikan akses kepada alat yang dihoskan oleh OpenAI seperti Pentafsir Kod dan Carian Fail. API ini juga menyokong pemanggilan fungsi yang dipertingkat untuk alat pihak ketiga.
Bolehkah saya masih menggunakan API Assistants v1 beta?
Tidak. Mulai 18 Disember 2024, pengguna tidak lagi mempunyai akses kepada versi v1 API Assistant beta. Pada masa ini, kami hanya menyokong v2. Sila rujuk panduan migrasi ini untuk menukar panggilan API anda daripada v1 kepada v2.
Bagaimanakah saya boleh mengaksesnya?
Assistants API tersedia kepada sesiapa sahaja yang mempunyai akaun OpenAI API, tetapi ia telah dinyahgalakkan dan akan dikeluarkan pada Ogos 2026. Untuk projek baharu, gunakan Responses API sebagai ganti. Jika anda sudah menggunakan Assistants API, rancang migrasi anda ke Responses API. Anda masih boleh mengakses assistant sedia ada dalam Assistants Playground selagi API ini masih tersedia.
Apakah itu pembantu?
Pembantu ialah AI yang dibina untuk tujuan khusus, menggunakan model OpenAI dan boleh mengakses fail, mengekalkan utas yang berterusan serta memanggil alat.
Apakah itu utas?
Utas ialah sesi perbualan antara pembantu dengan pengguna. Utas memudahkan pembangunan aplikasi dengan menyimpan sejarah mesej dan memangkasnya apabila perbualan melebihi panjang konteks model.
Apakah itu alat Carian Fail?
Alat file_search menerapkan beberapa amalan terbaik perolehan semula tanpa memerlukan konfigurasi tambahan, bagi membantu anda mengekstrak data yang tepat daripada fail anda untuk memperkaya respons model.
Secara lalai, alat file_search menggunakan tetapan berikut:
Saiz cebisan: 800 token
Pertindihan cebisan: 400 token
Model pembenaman: text-embedding-3-large dengan 256 dimensi
Bilangan maksimum cebisan yang ditambahkan pada konteks: 20
Apakah had untuk muat naik fail?
Had untuk memuat naik fail ialah:
512 MB bagi setiap fail
5 juta token bagi setiap fail
10,000 fail bagi setiap stor vektor
1 stor vektor bagi setiap pembantu
1 stor vektor bagi setiap utas
Had storan keseluruhan bagi setiap projek dalam sesebuah organisasi ialah 100 GB.
Apakah batasan alat Carian Fail?
Terdapat beberapa batasan yang diketahui. Kami sedang berusaha menambah sokongan untuk mengatasinya dalam beberapa bulan akan datang:
Buat masa ini, tetapan pemecahan kepada cebisan, pembenaman atau perolehan semula tidak boleh diubah.
Kami tidak menyokong penghuraian imej dalam dokumen.
Kami tidak menyokong perolehan semula daripada format fail berstruktur (seperti fail .csv atau .jsonl). Lihat jenis fail yang disokong.
Apakah had kadar untuk Assistants API?
Had kadar untuk Assistants API tidak bergantung pada peringkat penggunaan dan model. Sebaliknya, had lalai ditetapkan mengikut jenis permintaan, dengan beberapa pengecualian:
GET: 1000 RPM
POST: 300 RPM
DELETE: 300 permintaan seminit
Berapakah caj untuk Pentafsir Kod dalam API?
Caj untuk Pentafsir Kod ialah $0.03 / sesi. Jika pembantu anda memanggil Pentafsir Kod secara serentak dalam dua utas yang berbeza, dua sesi Pentafsir Kod akan diwujudkan (2 * $0.03). Secara lalai, setiap sesi aktif selama satu jam. Ini bermakna anda hanya perlu membayar caj ini sekali jika pengguna anda terus memberikan arahan kepada Pentafsir Kod dalam utas yang sama selama sehingga satu jam.
Berapakah caj untuk Carian Fail dalam API?
Caj untuk Carian Fail ialah $0.10/GB storan vektor sehari (GB pertama storan adalah percuma). Saiz stor vektor dikira berdasarkan saiz yang terhasil selepas fail anda dihuraikan, dipecahkan kepada cebisan dan dibenamkan.
Mana-mana stor vektor yang dicipta sebelum 17 April 2024 adalah percuma sehingga akhir tahun 2024. Selepas itu, stor tersebut akan sama ada:
Dikenakan caj pada kadar semasa (kini $0.10/GB/hari) jika telah digunakan sekurang-kurangnya sekali dalam Run yang dicipta selepas 17 April 2024.
Dipadamkan jika tidak pernah digunakan dalam mana-mana Run antara 17 April 2024 hingga 31 Disember 2024 — ini bagi mengelakkan anda dikenakan caj untuk stor vektor yang mungkin anda cipta sebelum perubahan harga ini diumumkan tetapi tidak pernah digunakan.
Adakah terdapat had bilangan assistant yang boleh saya cipta?
Tiada had bilangan assistant yang boleh dicipta oleh sesebuah organisasi.
Adakah penstriman tersedia dalam API?
Ya, penstriman tersedia dalam Assistants API.
Adakah mod JSON tersedia dalam Assistants API?
Ya, mod JSON tersedia dalam Assistants API melalui parameter response_format pada objek Assistants atau Run.
Adakah Assistants API turut mengurus permintaan untuk panggilan fungsi pihak ketiga?
Tidak. Walaupun pemanggilan fungsi membolehkan model memilih alat dan memformat permintaan untuk alat tersebut, pelaksanaan panggilan kepada alat pihak ketiga tidak diurus oleh OpenAI.
Bagaimanakah data yang saya hantar kepada OpenAI dikendalikan?
Seperti perkhidmatan lain pada platform kami, data dan fail yang dihantar kepada API OpenAI tidak pernah digunakan untuk melatih model kami, dan anda boleh memadamkan data anda pada bila-bila masa yang diperlukan. Data yang dimuat naik ke Assistants API disimpan tanpa had masa sehingga pengguna memadamkannya secara manual.
Adakah DALL-E tersedia melalui Assistants API?
Buat masa ini, DALL-E tidak tersedia.
Adakah terdapat UI untuk Assistants API?
Anda boleh melihat Playground untuk Assistants API. Pastikan anda berada dalam paparan Assistants pada bar sisi kiri dan menggunakan model yang serasi dengan Tools yang ingin anda hidupkan.

Berapakah had aksara untuk arahan pembantu dalam Assistants API?
Medan arahan pembantu mempunyai panjang maksimum 256,000 aksara.
Saya menerima ralat seperti “Pelayan mengalami ralat semasa memproses permintaan anda. Maaf atas masalah ini! Anda boleh mencuba semula permintaan anda atau menghubungi kami melalui pusat bantuan kami di help.openai.com jika ralat berterusan. ” Apakah yang perlu saya lakukan?
Jika anda menerima ralat ini, prom anda mungkin tidak disediakan dengan betul. Jika permintaan masih gagal walaupun anda mencubanya berulang kali, berikut ialah beberapa perkara yang boleh dicuba:
susun semula prom anda supaya sebarang perintah yang menyerupai fungsi dikendalikan sebagai fungsi
tambahkan sebarang perintah dalam prom anda sebagai fungsi pada tools
Mengapakah alat Carian Fail saya tidak berfungsi dengan baik?
Apabila menggunakan alat Carian Fail, kami mengesyorkan agar max_prompt_tokens ditetapkan kepada sekurang-kurangnya 20,000. Untuk perbualan yang lebih panjang atau interaksi berulang dengan Carian Fail, pertimbangkan untuk menaikkan had ini kepada 50,000. Sebaik-baiknya, hapuskan terus had max_prompt_tokens untuk mendapatkan hasil yang paling berkualiti.
Bagaimanakah saya boleh memberikan maklum balas?
Kami mengalu-alukan maklum balas anda di Forum Pembangun kami, melalui Pusat Bantuan di help.openai.com, atau di Twitter @OpenAIDevs.
