finetunes

Creates, updates, deletes, gets or lists a finetunes resource.

Overview

Name	finetunes
Type	Resource
Id	cloudflare.ai.finetunes

Fields

The following fields are returned by SELECT queries:

list

Returns all finetunes

Name	Datatype	Description
id	string (uuid)
name	string
created_at	string (date-time)
description	string
model	string
modified_at	string (date-time)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list	select	account_id		Lists all fine-tuning jobs created by the account, including status and metrics.
create	insert	account_id, model, name		Creates a new fine-tuning job for a Workers AI model using custom training data.
upload_asset	exec	account_id, finetune_id, file_name, file		Uploads training data assets for a Workers AI fine-tuning job.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
account_id	string	The Cloudflare account ID.
finetune_id	string

SELECT examples

list

Lists all fine-tuning jobs created by the account, including status and metrics.

SELECT
id,
name,
created_at,
description,
model,
modified_at
FROM cloudflare.ai.finetunes
WHERE account_id = '{{ account_id }}' -- required
;

INSERT examples

create

Creates a new fine-tuning job for a Workers AI model using custom training data.

INSERT INTO cloudflare.ai.finetunes (
description,
model,
name,
public,
account_id
)
SELECT 
'{{ description }}',
'{{ model }}' /* required */,
'{{ name }}' /* required */,
{{ public }},
'{{ account_id }}'
RETURNING
result,
success
;

Manifest

# Description fields are for documentation purposes
- name: finetunes
props:
  - name: account_id
    value: "{{ account_id }}"
    description: Required parameter for the finetunes resource.
  - name: description
    value: "{{ description }}"
  - name: model
    value: "{{ model }}"
  - name: name
    value: "{{ name }}"
  - name: public
    value: {{ public }}
    default: false

Lifecycle Methods

upload_asset

Uploads training data assets for a Workers AI fine-tuning job.

EXEC cloudflare.ai.finetunes.upload_asset 
@account_id='{{ account_id }}' --required, 
@finetune_id='{{ finetune_id }}' --required 
@@json=
'{
"file": "{{ file }}", 
"file_name": "{{ file_name }}"
}'
;