Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Nieda t-Tuning Fin permezz tal-API

Lezzjoni 5 / 16 Aġġornat 2 ta’ Novembru 2026 Avvanzat
F'din il-paġna
  1. Ħarsa Ġenerali lejn il-Proċess
  2. Installa u Ikkonfigura l-SDK
  3. Ittella’ l-Fajls
  4. Oħloq il-Kompitu ta’ Tuning Fin
  5. Segwi l-Progress
  6. Uża l-Mudell imwettaq b’Tuning Fin
  7. Immaniġġja l-Kompiti Tiegħek
  8. Spejjeż u Tul ta’ Żmien
  9. Punti Ewlenin

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-dataTul ta’ żmien tat-taħriġ
50 eżempjuFtit minuti
500 eżempju15 sa 30 minuta
5,000 eżempju1 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 suffix deskrittiv 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