Nieda t-Tuning Fin permezz tal-API
F'din il-paġna
Aġġornament 2 ta’ Novembru, 2026 — Disponibbiltà tat-Tuning Fin. Is-servizz awtonomu ta’ tuning fin ta’ OpenAI qed jiġi rtirat: mill-7 ta’ Mejju, 2026, l-organizzazzjonijiet li qatt ma ħaddmu kompitu ta’ tuning fin ma jistgħux joħolqu wieħed ġdid; mit-2 ta’ Lulju, trid tkun użajt mudell imwettaq b’tuning fin fi żmien l-aħħar 60 jum; u mill-6 ta’ Jannar, 2027, l-ebda klijent ma jkun jista’ jnieda kompiti ġodda. Il-mudelli diġà mħarrġa jibqgħu użabbli sakemm il-mudell bażi tagħhom jiġi rtirat. Dan il-kors jibqa’ utli biex tifhem u tisfrutta mudell eżistenti; għal proġetti ġodda, agħti prijorità lill-inġinerija tal-prompt, RAG, u l-evalwazzjonijiet.
Ħarsa Ġenerali lejn il-Proċess
Id-data tiegħek hija lesta, ivvalidata u maqsuma f’settijiet ta’ taħriġ u ta’ validazzjoni. Il-pass attwali tat-taħriġ jinżel għal tliet passi: ittella’ l-fajl tad-data tiegħek, oħloq kompitu ta’ tuning fin, imbagħad stenna sakemm jintemm it-taħriġ. Kollox jgħaddi mill-SDK uffiċjali tal-Python, u se tara li l-kodiċi jidħol f’madwar tletin linja—il-biċċa l-kbira tax-xogħol saret qabel.
Installa u Ikkonfigura l-SDK
Il-klijent jiġi istanzjat mingħajr argumenti: jaqra awtomatikament il-varjabbli tal-ambjent OPENAI_API_KEY.
# Installazzjoni
# pip install openai
from openai import OpenAI
# Il-klijent juża awtomatikament il-varjabbli tal-ambjent OPENAI_API_KEY
client = OpenAI()
Żgur li din il-varjabbli hija stabbilita qabel ma tħaddem l-iskript, inkella l-istanzjar se jfalli fl-ewwel talba. Fil-produzzjoni, qatt ma tħalli l-key tiegħek miktuba direttament fil-kodiċi: key miktuba b’test ċar tispiċċa fl-istorja ta’ Git, u tneħħiha wara l-fatt tiswik ħafna aktar milli taqraha mill-ambjent mill-ewwel jum.
Ittella’ l-Fajls
It-tlugħ juża purpose="fine-tune", li jgħid lil OpenAI li l-fajl huwa maħsub għat-taħriġ u jattiva l-verifiki tal-format korrispondenti. Ittella’ l-fajl ta’ validazzjoni minnufih: huwa teknikament fakultattiv, iżda mingħajru t-taħriġ jimxi bl-għama, peress li l-ebda telf ta’ validazzjoni ma jissinjala overfitting waqt li l-kompitu jkun għaddej.
# Ittella' l-fajl tat-taħriġ
training_file = client.files.create(
file=open("training_data.jsonl", "rb"),
purpose="fine-tune"
)
print(f"File ID: {training_file.id}")
print(f"Status: {training_file.status}")
# Fakultattiv: ittella' l-fajl ta' validazzjoni
validation_file = client.files.create(
file=open("validation_data.jsonl", "rb"),
purpose="fine-tune"
)
print(f"Validation ID: {validation_file.id}")
Il-fajl jgħaddi minn fażi ta’ ipproċessar fuq in-naħa ta’ OpenAI. Stenna sakemm l-istatus ikun processed qabel ma tniedi l-kompitu: kompitu maħluq fuq fajl li għadu qed jiġi pproċessat se jfalli, u se titlef ftit minuti tfittex kawża li ma teżistix fil-JSONL tiegħek.
Oħloq il-Kompitu ta’ Tuning Fin
job = client.fine_tuning.jobs.create(
training_file=training_file.id,
validation_file=validation_file.id, # fakultattiv iżda rrakkomandat
model="gpt-5.6-luna", # jew "gpt-5.6-luna"
suffix="my-assistant-v1" # suffiss biex tidentifika l-mudell tiegħek
)
print(f"Job ID: {job.id}")
print(f"Status: {job.status}")
print(f"Base model: {job.model}")
Il-parametru suffix jiġi miżjud mal-isem tal-mudell tiegħek imwettaq b’tuning fin: b’"my-assistant-v1", il-mudell li jirriżulta jissejjaħ ft:gpt-5.6-luna:your-org::my-assistant-v1:xxxxxxxx. Ħu d-drawwa li tpoġġi l-każ ta’ użu u numru ta’ verżjoni hemmhekk. Il-jum li tliet mudelli jkunu jeżistu flimkien fil-kont tiegħek, dik hija l-unika ħaġa li tgħidlek liema jagħmel xiex mingħajr ma tiftaħ il-console.
Segwi l-Progress
Kompitu jgħaddi minn diversi status f’sekwenza, u retrieve jagħtik dak attwali fi kwalunkwe mument.
# Ikseb l-istatus tal-kompitu
job = client.fine_tuning.jobs.retrieve(job.id)
print(f"Status: {job.status}")
# Status possibbli: validating_files, queued, running, succeeded, failed, cancelled
L-istatus waħdu jibqa’ lakoniku. L-avvenimenti, min-naħa l-oħra, jirrakkontaw l-istorja: validazzjoni tal-fajl, bidu, progress pass pass, tmiem.
# Ara l-avvenimenti tal-kompitu
events = client.fine_tuning.jobs.list_events(
fine_tuning_job_id=job.id,
limit=20
)
for event in events.data:
print(f"[{event.created_at}] {event.message}")
Minflok ma ssejjaħ retrieve manwalment kull ħames minuti, ilbes l-istennija f’loop li jirritorna l-kontroll hekk kif il-kompitu jilħaq stat terminali. Innota li t-tliet każijiet ta’ ħruġ huma ttrattati separatament: kompitu kkanċellat mhuwiex kompitu fallut, u trid tkun taf tagħmel id-distinzjoni bejniethom fil-logs tiegħek.
import time
def track_job(client: OpenAI, job_id: str, interval: int = 30):
"""Issegwi kompitu ta' tuning fin sakemm jintemm."""
while True:
job = client.fine_tuning.jobs.retrieve(job_id)
print(f"Status: {job.status}")
if job.status == "succeeded":
print(f"Fine-tuned model: {job.fine_tuned_model}")
return job
if job.status == "failed":
print(f"Failure: {job.error}")
return job
if job.status == "cancelled":
print("Job cancelled.")
return job
time.sleep(interval)
# Użu
final_job = track_job(client, job.id)
Uża l-Mudell imwettaq b’Tuning Fin
Ladarba l-kompitu jintemm b’suċċess, il-mudell tiegħek jissejjaħ eżattament bħal mudell standard. Biss il-valur mogħti lil model jinbidel, li jfisser li l-bidla għall-mudell personalizzat tiegħek tinżel, f’applikazzjoni eżistenti, għall-modifika ta’ varjabbli ta’ konfigurazzjoni.
response = client.responses.create(
model=final_job.fine_tuned_model, # eż. "ft:gpt-5.6-luna:org::suffix:xxxxxxxx"
input="Hello, I have a problem with my order."
)
print(response.output_text)
Immaniġġja l-Kompiti Tiegħek
Żewġ sejħiet biżżejjed biex tamministra kollox: elenka x’jeżisti, u waqqaf dak li qed ikun għaddej. Il-kanċellazzjoni hija utli hekk kif il-monitoraġġ juri li t-taħriġ qed imur ħażin—l-ebda sens ma hemm li tħallas għal tokens minn kompitu li diġà taf li se jipproduċi mudell ħażin.
# Elenska l-kompiti kollha ta' tuning fin tiegħek
jobs = client.fine_tuning.jobs.list(limit=10)
for j in jobs.data:
print(f"{j.id} | {j.status} | {j.model} | {j.fine_tuned_model}")
# Ikkansella kompitu li għaddej
client.fine_tuning.jobs.cancel(job.id)
Spejjeż u Tul ta’ Żmien
It-taħriġ jiġi fatturat skont in-numru ta’ tokens ipproċessati. It-tul ta’ żmien, min-naħa l-oħra, jiddependi fuq id-daqs tad-data tiegħek u n-numru ta’ epoki.
| Daqs tas-sett tad-data | Tul ta’ żmien tat-taħriġ |
|---|---|
| 50 eżempju | Ftit minuti |
| 500 eżempju | 15 sa 30 minuta |
| 5,000 eżempju | 1 sa 2 siegħa |
Dawn l-ordnijiet ta’ kobor jgħinuk prinċipalment biex tiddimensjona ċ-ċiklu tax-xogħol tiegħek: f’ftit minuti għal kull ġirja, titerà fl-istess sessjoni; f’sagħtejn, tippjana. Il-prezzijiet eżatti jvarjaw skont il-mudell magħżul; iċċekkja l-paġna tal-prezzijiet ta’ OpenAI għar-rati attwali.
Punti Ewlenin
- Il-fluss tax-xogħol huwa: ittella’ fajl, oħloq kompitu, stenna, uża l-mudell
- Żid
suffixdeskrittiv biex tidentifika l-mudelli tiegħek faċilment - Dejjem uża fajl ta’ validazzjoni biex tevalwa l-kwalità
- Il-mudell imwettaq b’tuning fin jintuża eżattament bħall-mudell bażi permezz tal-API
- Żomm l-ID tal-kompiti u tal-mudelli tiegħek—se jkollok bżonnhom għall-verżjonament