Finetuning¶

Use these endpoints to submit finetuning preparation jobs and monitor progress.

Create job¶

POST /cr/generate_questions

Creates a finetuning preparation job from uploaded files and returns a job_id.

Field	Type	Required	Description
`files`	file[]	yes	Input files.
`numQs`	integer	no	Target QA count.
`mode`	string	no	Defaults to `pretraining`.
`modelName`	string	no	Result model display name.
`modelType`	string	no	Base model id.

Returns

200 OK with job_id, dataset_name, and queue status.

{
  "job_id": "ebf7d8a5-5ff7-4d74-a7b4-1c6a8f40da2a",
  "dataset_name": "steve-icosacomputing.com_...",
  "build_id": null,
  "status": "queued"
}

curl -s -X POST "https://cr-api.icosacomputing.com/cr/generate_questions" \
  -H "X-API-Key: <your_api_key>" \
  -F "files=@/absolute/path/to/file1.pdf" \
  -F "files=@/absolute/path/to/file2.docx" \
  -F "numQs=1000" \
  -F "mode=pretraining" \
  -F "modelName=my-custom-model" \
  -F "modelType=openai/gpt-oss-20b"

import requests

files = [
    ("files", ("file1.pdf", open("/absolute/path/to/file1.pdf", "rb"), "application/pdf")),
    ("files", ("file2.docx", open("/absolute/path/to/file2.docx", "rb"), "application/vnd.openxmlformats-officedocument.wordprocessingml.document")),
]

resp = requests.post(
    "https://cr-api.icosacomputing.com/cr/generate_questions",
    headers={"X-API-Key": "<your_api_key>"},
    files=files,
    data={"numQs": 1000, "mode": "pretraining", "modelName": "my-custom-model", "modelType": "openai/gpt-oss-20b"},
    timeout=300,
)
print(resp.json())

const form = new FormData();
form.append("files", fileInput1.files[0]);
form.append("files", fileInput2.files[0]);
form.append("numQs", "1000");
form.append("mode", "pretraining");
form.append("modelName", "my-custom-model");
form.append("modelType", "openai/gpt-oss-20b");

const res = await fetch("https://cr-api.icosacomputing.com/cr/generate_questions", {
  method: "POST",
  headers: { "X-API-Key": "<your_api_key>" },
  body: form,
});

console.log(await res.json());

Poll job status¶

GET /cr/generate_questions_status?job_id=...

Returns current status for a finetuning job.

Field	Type	Required	Description
`job_id`	query string	yes	Job id from create call.

Returns

200 OK with current job state and metadata.

{
  "status": "running",
  "dataset_name": "...",
  "build_id": null,
  "error": null
}

curl -s "https://cr-api.icosacomputing.com/cr/generate_questions_status?job_id=<job_id>" \
  -H "X-API-Key: <your_api_key>"

import requests

resp = requests.get(
    "https://cr-api.icosacomputing.com/cr/generate_questions_status",
    headers={"X-API-Key": "<your_api_key>"},
    params={"job_id": "<job_id>"},
    timeout=30,
)
print(resp.json())

const res = await fetch(
  "https://cr-api.icosacomputing.com/cr/generate_questions_status?job_id=<job_id>",
  { headers: { "X-API-Key": "<your_api_key>" } }
);

console.log(await res.json());