Fine-tuning Jobs

client.fine_tuning.jobs.create(
    model: Union[str, Literal["babbage-002", "davinci-002", "gpt-3.5-turbo", "gpt-4o-mini"]],
    training_file: str,
    hyperparameters: Optional[Hyperparameters] = None,
    integrations: Optional[List[Integration]] = None,
    metadata: Optional[Dict[str, str]] = None,
    method: Optional[Method] = None,
    seed: Optional[int] = None,
    suffix: Optional[str] = None,
    validation_file: Optional[str] = None
) -> FineTuningJob

class FineTuningJob(BaseModel):
    id: str  # Job identifier (e.g., "ftjob-abc123")
    created_at: int  # Unix timestamp
    error: Optional[Error]  # Error details if status is "failed"
    fine_tuned_model: Optional[str]  # Model name when complete
    finished_at: Optional[int]  # Unix timestamp when finished
    hyperparameters: Hyperparameters  # Hyperparameters used
    model: str  # Base model being fine-tuned
    organization_id: str  # Organization owner
    result_files: List[str]  # Result file IDs
    seed: int  # Seed used for training
    status: Literal[
        "validating_files", "queued", "running",
        "succeeded", "failed", "cancelled"
    ]
    trained_tokens: Optional[int]  # Billable tokens processed
    training_file: str  # Training file ID
    validation_file: Optional[str]  # Validation file ID
    estimated_finish: Optional[int]  # Estimated completion time
    integrations: Optional[List[Integration]]  # Enabled integrations
    metadata: Optional[Dict[str, str]]  # Custom metadata
    method: Optional[Method]  # Fine-tuning method used

from openai import OpenAI

client = OpenAI()

# Upload training file first
with open("training_data.jsonl", "rb") as f:
    training_file = client.files.create(file=f, purpose="fine-tune")

# Create fine-tuning job
job = client.fine_tuning.jobs.create(
    model="gpt-4o-mini",
    training_file=training_file.id
)

print(f"Job ID: {job.id}")
print(f"Status: {job.status}")

job = client.fine_tuning.jobs.create(
    model="gpt-4o-mini",
    training_file="file-abc123",
    method={
        "type": "supervised",
        "supervised": {
            "hyperparameters": {
                "n_epochs": 3,
                "batch_size": 4,
                "learning_rate_multiplier": 0.1
            }
        }
    },
    suffix="my-custom-model"
)

# Upload training and validation files
with open("train.jsonl", "rb") as f:
    train_file = client.files.create(file=f, purpose="fine-tune")

with open("validation.jsonl", "rb") as f:
    val_file = client.files.create(file=f, purpose="fine-tune")

# Create job with validation
job = client.fine_tuning.jobs.create(
    model="gpt-4o-mini",
    training_file=train_file.id,
    validation_file=val_file.id
)

job = client.fine_tuning.jobs.create(
    model="gpt-4o-mini",
    training_file="file-abc123",
    integrations=[
        {
            "type": "wandb",
            "wandb": {
                "project": "gpt-finetuning",
                "name": "experiment-1",
                "tags": ["production", "gpt-4o-mini"]
            }
        }
    ]
)

job = client.fine_tuning.jobs.create(
    model="gpt-4o-mini",
    training_file="file-abc123",
    metadata={
        "project": "customer-support",
        "version": "v2.0",
        "owner": "ml-team"
    },
    seed=42  # For reproducibility
)

job = client.fine_tuning.jobs.retrieve("ftjob-abc123")

print(f"Status: {job.status}")
if job.fine_tuned_model:
    print(f"Model: {job.fine_tuned_model}")
if job.error:
    print(f"Error: {job.error.message}")

jobs = client.fine_tuning.jobs.list(limit=10)

for job in jobs:
    print(f"{job.id}: {job.status}")

jobs = client.fine_tuning.jobs.list(
    metadata={"project": "customer-support"}
)

job = client.fine_tuning.jobs.cancel("ftjob-abc123")
print(f"Job status: {job.status}")  # Should be "cancelled"

# Pause a running job
job = client.fine_tuning.jobs.pause("ftjob-abc123")
print(f"Job paused: {job.status}")

# Resume later
job = client.fine_tuning.jobs.resume("ftjob-abc123")
print(f"Job resumed: {job.status}")

events = client.fine_tuning.jobs.list_events(
    "ftjob-abc123",
    limit=20
)

for event in events:
    print(f"{event.created_at}: {event.message}")

from openai import AsyncOpenAI

client = AsyncOpenAI()

job = await client.fine_tuning.jobs.create(
    model="gpt-4o-mini",
    training_file="file-abc123"
)

print(f"Job ID: {job.id}")

{"messages": [{"role": "system", "content": "You are a helpful assistant."}, {"role": "user", "content": "What is the capital of France?"}, {"role": "assistant", "content": "The capital of France is Paris."}]}
{"messages": [{"role": "system", "content": "You are a helpful assistant."}, {"role": "user", "content": "What is 2+2?"}, {"role": "assistant", "content": "2+2 equals 4."}]}

{"prompt": "Question: What is the capital of France?\nAnswer:", "completion": " Paris"}
{"prompt": "Question: What is 2+2?\nAnswer:", "completion": " 4"}