Query parameters

• after string

  Identifier for the last job from the previous pagination request.

• limit integer

  Number of fine-tuning jobs to retrieve.

  Default value is 20.

Responses

• 200 application/json

  OK

  Hide response attributes Show response attributes object

  • data array[object] Required

    The fine_tuning.job object represents a fine-tuning job that has been created through the API.

    Hide data attributes Show data attributes object

    • id string Required

      The object identifier, which can be referenced in the API endpoints.

    • created_at integer Required

      The Unix timestamp (in seconds) for when the fine-tuning job was created.

    • error object | null Required

      For fine-tuning jobs that have failed, this will contain more information on the cause of the failure.

      Hide error attributes Show error attributes object | null

      • code string Required

        A machine-readable error code.

      • message string Required

        A human-readable error message.

      • param string | null Required

        The parameter that was invalid, usually training_file or validation_file. This field will be null if the failure was not parameter-specific.

    • fine_tuned_model string | null Required

      The name of the fine-tuned model that is being created. The value will be null if the fine-tuning job is still running.

    • finished_at integer | null Required

      The Unix timestamp (in seconds) for when the fine-tuning job was finished. The value will be null if the fine-tuning job is still running.

    • hyperparameters object Required

      The hyperparameters used for the fine-tuning job. See the fine-tuning guide for more details.

      Hide hyperparameters attribute Show hyperparameters attribute object

      • n_epochs string | integer Required

        One of:

        string-1 string integer-2 integer

        The number of epochs to train the model for. An epoch refers to one full cycle through the training dataset. "auto" decides the optimal number of epochs based on the size of the dataset. If setting the number manually, we support any number between 1 and 50 epochs.

        Value is auto. Default value is auto.

        The number of epochs to train the model for. An epoch refers to one full cycle through the training dataset. "auto" decides the optimal number of epochs based on the size of the dataset. If setting the number manually, we support any number between 1 and 50 epochs.

        Minimum value is 1, maximum value is 50. Default value is auto.

    • model string Required

      The base model that is being fine-tuned.

    • object string Required

      The object type, which is always "fine_tuning.job".

      Value is fine_tuning.job.

    • organization_id string Required

      The organization that owns the fine-tuning job.

    • result_files array[string] Required

      The compiled results file ID(s) for the fine-tuning job. You can retrieve the results with the Files API.

    • status string Required

      The current status of the fine-tuning job, which can be either validating_files, queued, running, succeeded, failed, or cancelled.

      Values are validating_files, queued, running, succeeded, failed, or cancelled.

    • trained_tokens integer | null Required

      The total number of billable tokens processed by this fine-tuning job. The value will be null if the fine-tuning job is still running.

    • training_file string Required

      The file ID used for training. You can retrieve the training data with the Files API.

    • validation_file string | null Required

      The file ID used for validation. You can retrieve the validation results with the Files API.

    • integrations array[object] | null

      A list of integrations to enable for this fine-tuning job.

      Not more than 5 elements.

      Hide integrations attributes Show integrations attributes object

      • type string Required

        The type of the integration being enabled for the fine-tuning job

        Value is wandb.

      • wandb object Required

        The settings for your integration with Weights and Biases. This payload specifies the project that metrics will be sent to. Optionally, you can set an explicit display name for your run, add tags to your run, and set a default entity (team, username, etc) to be associated with your run.

        Hide wandb attributes Show wandb attributes object

        • project string Required

          The name of the project that the new run will be created under.

        • name string | null

          A display name to set for the run. If not set, we will use the Job ID as the name.

        • entity string | null

          The entity to use for the run. This allows you to set the team or username of the WandB user that you would like associated with the run. If not set, the default entity for the registered WandB API key is used.

        • tags array[string]

          A list of tags to be attached to the newly created run. These tags are passed through directly to WandB. Some default tags are generated by OpenAI: "openai/finetune", "openai/{base-model}", "openai/{ftjob-abcdef}".

    • seed integer Required

      The seed used for the fine-tuning job.

    • estimated_finish integer | null

      The Unix timestamp (in seconds) for when the fine-tuning job is estimated to finish. The value will be null if the fine-tuning job is not running.

  • has_more boolean Required
  • object string Required

    Value is list.