Fine Tuning - Create

Layanan:: Azure AI Services

Versi API:: 2024-10-21

Membuat pekerjaan yang menyempurnakan model tertentu dari file pelatihan tertentu. Respons mencakup detail pekerjaan yang diantrekan termasuk status pekerjaan dan parameter hyper. Nama model yang disempurnakan ditambahkan ke respons setelah selesai.

POST {endpoint}/openai/fine_tuning/jobs?api-version=2024-10-21

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
endpoint	path	True	string (url)	Titik akhir Cognitive Services yang didukung (protokol dan nama host, misalnya: https://aoairesource.openai.azure.com. Ganti "aoairesource" dengan nama akun Azure OpenAI Anda).
api-version	query	True	string	Versi API yang diminta.

Header Permintaan

Nama	Diperlukan	Jenis	Deskripsi
api-key	True	string	Berikan kunci akun Azure OpenAI Cognitive Services Anda di sini.

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
model	True	string minLength: 1	Pengidentifikasi (model-id) dari model dasar yang digunakan untuk menyempurnakan ini.
training_file	True	string minLength: 1	Identitas file (file-id) yang digunakan untuk melatih model yang disempurnakan ini.
hyperparameters		FineTuningHyperParameters	FineTuningHyperParameters Pengaturan parameter hyper yang digunakan dalam pekerjaan penyetelan halus.
seed		integer (int32)	Benih yang digunakan untuk pekerjaan penyempurnaan. Meneruskan seed dan parameter pekerjaan yang sama harus menghasilkan hasil yang sama, tetapi mungkin berbeda dalam kasus yang jarang terjadi. Jika benih tidak ditentukan, satu akan dihasilkan untuk Anda.
suffix		string	Akhiran yang digunakan untuk mengidentifikasi model yang disempurnakan. Akhiran dapat berisi hingga 40 karakter (a-z, A-Z, 0-9,- dan _) yang akan ditambahkan ke nama model yang disempurnakan.
validation_file		string	Identitas file (file-id) yang digunakan untuk mengevaluasi model yang disempurnakan selama pelatihan.

Respons

Nama	Jenis	Deskripsi
201 Created	FineTuningJob	Penyetelan halus telah berhasil dibuat. Header Location: string
Other Status Codes	ErrorResponse	Terjadi kesalahan.

Nama

Jenis

Deskripsi

201 Created

FineTuningJob

Penyetelan halus telah berhasil dibuat.

Header

Location: string

Other Status Codes

ErrorResponse

Terjadi kesalahan.

Keamanan

api-key

Berikan kunci akun Azure OpenAI Cognitive Services Anda di sini.

Jenis: apiKey
Dalam: header

Contoh

Creating a fine tuning job.

Permintaan sampel

HTTP

POST https://aoairesource.openai.azure.com/openai/fine_tuning/jobs?api-version=2024-10-21


{
  "model": "curie",
  "training_file": "file-181a1cbdcdcf4677ada87f63a0928099"
}

Respon sampel

Kode status:: 201

location: https://aoairesource.openai.azure.com/openai/fine_tuning/jobs/ft-72a2792ef7d24ba7b82c7fe4a37e379f

{
  "hyperparameters": {
    "n_epochs": -1
  },
  "status": "pending",
  "model": "curie",
  "training_file": "file-181a1cbdcdcf4677ada87f63a0928099",
  "id": "ft-72a2792ef7d24ba7b82c7fe4a37e379f",
  "created_at": 1646126127,
  "object": "fine_tuning.job"
}

Definisi

Nama	Deskripsi
Error	Kesalahan
ErrorCode	ErrorCode
ErrorResponse	ErrorResponse
FineTuningHyperParameters	FineTuningHyperParameters
FineTuningJob	FineTuningJob
FineTuningJobCreation	FineTuningJobCreation
FineTuningJobError	FineTuningJobError
FineTuningState	FineTuningState
InnerError	InnerError
InnerErrorCode	InnerErrorCode
TypeDiscriminator	TypeDiscriminator

Error

Objek

Kesalahan

Nama	Jenis	Deskripsi
code	ErrorCode	ErrorCode Kode kesalahan seperti yang didefinisikan dalam panduan Microsoft REST (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).
details	Error[]	Detail kesalahan jika tersedia.
innererror	InnerError	InnerError Kesalahan dalam seperti yang didefinisikan dalam panduan Microsoft REST (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).
message	string minLength: 1	Pesan kesalahan ini.
target	string	Lokasi tempat kesalahan terjadi jika tersedia.

ErrorCode

Enumerasi

ErrorCode

Nilai	Deskripsi
conflict	Operasi yang diminta berkonflik dengan status sumber daya saat ini.
invalidPayload	Data permintaan tidak valid untuk operasi ini.
forbidden	Operasi dilarang untuk kunci pengguna/api saat ini.
notFound	Sumber daya tidak ditemukan.
unexpectedEntityState	Operasi tidak dapat dijalankan dalam status sumber daya saat ini.
itemDoesAlreadyExist	Item sudah ada.
serviceUnavailable	Layanan saat ini tidak tersedia.
internalFailure	Kesalahan internal. Silakan coba lagi.
quotaExceeded	Kuota terlampaui.
jsonlValidationFailed	Validasi data jsonl gagal.
fileImportFailed	Impor file gagal.
tooManyRequests	Terlalu banyak permintaan. Silakan coba lagi nanti.
unauthorized	Kunci pengguna/api saat ini tidak diotorisasi untuk operasi.
contentFilter	Pembuatan gambar gagal sebagai akibat dari sistem keamanan kami.

ErrorResponse

Objek

ErrorResponse

Nama	Jenis	Deskripsi
error	Error	Kesalahan Konten kesalahan seperti yang didefinisikan dalam panduan Microsoft REST (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).

FineTuningHyperParameters

Objek

FineTuningHyperParameters

Nama	Jenis	Deskripsi
batch_size	integer (int32)	Ukuran batch yang digunakan untuk pelatihan. Ukuran batch adalah jumlah contoh pelatihan yang digunakan untuk melatih satu pass maju dan mundur. Secara umum, kami telah menemukan bahwa ukuran batch yang lebih besar cenderung bekerja lebih baik untuk himpunan data yang lebih besar. Nilai default serta nilai maksimum untuk properti ini khusus untuk model dasar.
learning_rate_multiplier	number (double)	Pengali tingkat pembelajaran yang digunakan untuk pelatihan. Tingkat pembelajaran yang menyempurnakan adalah tingkat pembelajaran asli yang digunakan untuk pra-pelatihan dikalikan dengan nilai ini. Tingkat pembelajaran yang lebih besar cenderung berkinerja lebih baik dengan ukuran batch yang lebih besar. Sebaiknya bereksperimen dengan nilai dalam rentang 0,02 hingga 0,2 untuk melihat apa yang menghasilkan hasil terbaik.
n_epochs	integer (int32)	Jumlah epoch untuk melatih model. Epoch mengacu pada satu siklus penuh melalui himpunan data pelatihan.

FineTuningJob

Objek

FineTuningJob

Nama	Jenis	Deskripsi
created_at	integer (unixtime)	Tanda waktu ketika pekerjaan atau item ini dibuat (dalam epoch unix).
error	FineTuningJobError	FineTuningJobError Untuk pekerjaan penyempurnaan yang gagal, ini akan berisi lebih banyak informasi tentang penyebab kegagalan.
estimated_finish	integer (int32)	Tanda waktu Unix (dalam detik) ketika pekerjaan penyempurnaan diperkirakan selesai. Nilai akan null jika pekerjaan penyempurnaan tidak berjalan.
fine_tuned_model	string	Pengidentifikasi (model-id) dari model yang disempurnakan yang dihasilkan. Properti ini hanya diisi untuk eksekusi penyempurnaan yang berhasil diselesaikan. Gunakan pengidentifikasi ini untuk membuat penyebaran untuk inferensi.
finished_at	integer (int32)	Tanda waktu ketika pekerjaan atau item ini telah berhasil diselesaikan (dalam epoch unix).
hyperparameters	FineTuningHyperParameters	FineTuningHyperParameters Pengaturan parameter hyper yang digunakan dalam pekerjaan penyetelan halus.
id	string	Identitas item ini.
model	string minLength: 1	Pengidentifikasi (model-id) dari model dasar yang digunakan untuk menyempurnakan.
object	TypeDiscriminator	TypeDiscriminator Menentukan jenis objek.
organisation_id	string	Id organisasi dari pekerjaan penyetelan halus ini. Tidak digunakan di Azure OpenAI; hanya kompatibilitas untuk OpenAI.
result_files	string[]	Identitas file hasil (file-id) yang berisi metrik pelatihan dan evaluasi dalam format csv. File hanya tersedia untuk eksekusi penyempurnaan yang berhasil diselesaikan.
seed	integer (int32)	Benih yang digunakan untuk pekerjaan penyempurnaan.
status	FineTuningState	FineTuningState Status objek finetunes atau pekerjaan penyetelan halus.
suffix	string	Akhiran yang digunakan untuk mengidentifikasi model yang disempurnakan. Akhiran dapat berisi hingga 40 karakter (a-z, A-Z, 0-9,- dan _) yang akan ditambahkan ke nama model yang disempurnakan.
trained_tokens	integer (int32)	Jumlah total token yang dapat ditagih yang diproses oleh pekerjaan penyetelan halus ini.
training_file	string minLength: 1	File yang digunakan untuk pelatihan.
validation_file	string	File yang digunakan untuk mengevaluasi model yang disempurnakan selama pelatihan.

FineTuningJobCreation

Objek

FineTuningJobCreation

Nama	Jenis	Deskripsi
hyperparameters	FineTuningHyperParameters	FineTuningHyperParameters Pengaturan parameter hyper yang digunakan dalam pekerjaan penyetelan halus.
model	string minLength: 1	Pengidentifikasi (model-id) dari model dasar yang digunakan untuk menyempurnakan ini.
seed	integer (int32)	Benih yang digunakan untuk pekerjaan penyempurnaan. Meneruskan seed dan parameter pekerjaan yang sama harus menghasilkan hasil yang sama, tetapi mungkin berbeda dalam kasus yang jarang terjadi. Jika benih tidak ditentukan, satu akan dihasilkan untuk Anda.
suffix	string	Akhiran yang digunakan untuk mengidentifikasi model yang disempurnakan. Akhiran dapat berisi hingga 40 karakter (a-z, A-Z, 0-9,- dan _) yang akan ditambahkan ke nama model yang disempurnakan.
training_file	string minLength: 1	Identitas file (file-id) yang digunakan untuk melatih model yang disempurnakan ini.
validation_file	string	Identitas file (file-id) yang digunakan untuk mengevaluasi model yang disempurnakan selama pelatihan.

FineTuningJobError

Objek

FineTuningJobError

Nama	Jenis	Deskripsi
code	string	Kode kesalahan yang dapat dibaca mesin..
message	string	Pesan kesalahan yang dapat dibaca manusia.
param	string	Parameter yang tidak valid, biasanya training_file atau validation_file. Bidang ini akan null jika kegagalan tidak spesifik parameter.

FineTuningState

Enumerasi

FineTuningState

Nilai	Deskripsi
created	Operasi dibuat. Status ini tidak dikembalikan oleh Azure OpenAI dan hanya diekspos untuk kompatibilitas. Ini dapat dikategorikan sebagai status tidak aktif.
pending	Operasi ini belum diantrekan untuk diproses di masa mendatang. Ini dapat dikategorikan sebagai status tidak aktif.
running	Operasi telah mulai diproses. Ini dapat dikategorikan sebagai status aktif.
succeeded	Operasi telah berhasil diproses dan siap untuk dikonsumsi. Ini dapat dikategorikan sebagai status terminal.
cancelled	Operasi telah dibatalkan dan tidak lengkap. Ini dapat dikategorikan sebagai status terminal.
failed	Operasi telah menyelesaikan pemrosesan dengan kegagalan dan tidak dapat dikonsumsi lebih lanjut. Ini dapat dikategorikan sebagai status terminal.

InnerError

Objek

InnerError

Nama	Jenis	Deskripsi
code	InnerErrorCode	InnerErrorCode Kode kesalahan dalam seperti yang didefinisikan dalam panduan Microsoft REST (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).
innererror	InnerError	InnerError Kesalahan dalam seperti yang didefinisikan dalam panduan Microsoft REST (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).

InnerErrorCode

Enumerasi

InnerErrorCode

Nilai	Deskripsi
invalidPayload	Data permintaan tidak valid untuk operasi ini.

TypeDiscriminator

Enumerasi

TypeDiscriminator

Nilai	Deskripsi
list	Objek ini mewakili daftar objek lain.
fine_tuning.job	Objek ini mewakili pekerjaan penyetelan halus.
file	Objek ini mewakili file.
fine_tuning.job.event	Objek ini mewakili peristiwa pekerjaan penyetelan halus.
fine_tuning.job.checkpoint	Objek ini mewakili titik pemeriksaan dari pekerjaan penyetelan halus.
model	Objek ini mewakili model (dapat menjadi model dasar atau menyempurnakan hasil pekerjaan).
batch	Objek ini mewakili batch.
upload	Objek ini mewakili unggahan file.
upload.part	Objek ini mewakili bagian dari unggahan file.