Selamat datang di perpustakaan Python resmi untuk RunPod API & SDK.
Daftar isi
|Instalasi
Pekerja Tanpa Server (SDK)
Mulai Cepat
Pekerja Tes Lokal
Pustaka Bahasa API (Pembungkus GraphQL)
Titik akhir
GPU Cloud (Pod)
Direktori
Komunitas dan Berkontribusi
# Instal versi rilis terbarupip install runpod# atau# Instal versi pengembangan terbaru (cabang utama)pip install git+https://github.com/runpod/runpod-python.git
Python 3.8 atau lebih tinggi diperlukan untuk menggunakan versi terbaru paket ini.
Paket python ini juga dapat digunakan untuk membuat pekerja tanpa server yang dapat diterapkan ke RunPod sebagai API titik akhir khusus.
Buat skrip python di proyek Anda yang berisi definisi model dan kode awal pekerja RunPod. Jalankan kode python ini sebagai perintah awal kontainer default Anda:
# my_worker.pyimport runpoddef is_even(job):job_input = job["input"]the_number = job_input["number"]if not isinstance(the_number, int):return {"error": "Manusia konyol, Anda harus melewati integer."}if the_number % 2 == 0:return Truereturn Falserunpod.serverless.start({"handler": is_even})
Pastikan file ini dijalankan saat penampung Anda dimulai. Hal ini dapat dilakukan dengan memanggilnya dalam perintah docker ketika Anda menyiapkan templat di runpod.io/console/serverless/user/templates atau dengan menetapkannya sebagai perintah default di Dockerfile Anda.
Lihat postingan blog kami untuk membuat API Tanpa Server dasar, atau lihat dokumen detail untuk informasi lebih lanjut.
Anda juga dapat menguji pekerja Anda secara lokal sebelum menerapkannya ke RunPod. Ini berguna untuk debugging dan pengujian.
python my_worker.py --rp_serve_api
Saat berinteraksi dengan RunPod API Anda dapat menggunakan perpustakaan ini untuk membuat permintaan ke API.
import runpodrunpod.api_key = "your_runpod_api_key_found_under_settings"
Anda dapat berinteraksi dengan titik akhir RunPod melalui metode run
atau run_sync
.
titik akhir = runpod.Endpoint("ENDPOINT_ID")run_request = titik akhir.run( {"kunci_input_model_anda": "nilai_input_model_anda"} )# Periksa status eksekusi endpoint requestprint(run_request.status())# Dapatkan output dari permintaan eksekusi endpoint, blokir hingga eksekusi endpoint selesai.print(run_request.output())
titik akhir = runpod.Endpoint("ENDPOINT_ID")run_request = titik akhir.run_sync( {"kunci_input_model_anda": "nilai_input_model_anda"} )# Mengembalikan hasil pekerjaan jika selesai dalam waktu 90 detik, jika tidak, mengembalikan status pekerjaan.print(run_request )
import runpodrunpod.api_key = "your_runpod_api_key_found_under_settings"# Dapatkan semua podspod saya = runpod.get_pods()# Dapatkan podpod tertentu = runpod.get_pod(pod.id)# Buat podpod = runpod.create_pod("test", "runpod/stack ", "NVIDIA GeForce RTX 3070")# Hentikan podrunpod.stop_pod(pod.id)# Melanjutkan podrunpod.resume_pod(pod.id)# Hentikan podrunpod.terminate_pod(pod.id)
.├── dokumen # Dokumentasi├── contoh # Contoh├── runpod # Paket kode sumber│ ├── api_wrapper # Pustaka bahasa - API (GraphQL)│ ├── cli # Fungsi Antarmuka Baris Perintah│ ├── titik akhir # Pustaka bahasa - Titik Akhir│ └── tanpa server # SDK - Pekerja Tanpa Server└── pengujian # Paket tes
Kami menerima permintaan penarikan dan masalah di GitHub. Perbaikan bug dan fitur baru dianjurkan, namun harap baca panduan kontribusi kami terlebih dahulu.