# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Segmind Fine Tuning API
  version: 1.0.0
extends: openapi/segmind-fine-tuning-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 6
- target: $.paths['/finetune/request/submit'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a fine-tuning job
      effect: write
      questions:
      - How do I kick off fine-tuning a model on my own training data?
      - Can I start a new fine-tune job after uploading my dataset?
      instructions:
      - text: Start a new fine-tuning job.
      - text: Submit a fine-tune request using my uploaded training data.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/finetune/request/details'].get
  update:
    x-apievangelist-phrasing:
      intent: Get details of a fine-tuning request
      effect: read
      questions:
      - What is the progress and configuration of one specific fine-tune request?
      - Can I look up the details of a single fine-tuning job by its request ID?
      instructions:
      - text: Show the details of fine-tune request {request_id}.
        slots:
          request_id: query.request_id
      - text: Check how fine-tuning job {request_id} is going.
        slots:
          request_id: query.request_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/finetune/request/list'].get
  update:
    x-apievangelist-phrasing:
      intent: List my fine-tuning requests
      effect: read
      questions:
      - Which fine-tuning jobs have I submitted so far?
      - Can I see all of my fine-tune requests in one list?
      instructions:
      - text: List all my fine-tuning requests.
      - text: Show every fine-tune job on my account.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/finetune/request/access-update'].put
  update:
    x-apievangelist-phrasing:
      intent: Make a fine-tuned model public or private
      effect: write
      questions:
      - How do I make my fine-tuned model public so others can use it?
      - Can I switch a fine-tuned model back to private after sharing it?
      instructions:
      - text: Set the access of fine-tuned model {request_id} to {access}.
        slots:
          request_id: requestBody.request_id
          access: requestBody.access
      - text: Make the model from fine-tune request {request_id} private.
        slots:
          request_id: requestBody.request_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/finetune/request/upload/pre-signed-url'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a pre-signed URL to upload training data
      effect: read
      questions:
      - Where do I upload my training images before starting a fine-tune?
      - Can I get a pre-signed URL to send my fine-tuning dataset to?
      instructions:
      - text: Get me a pre-signed upload URL for my fine-tuning dataset.
      - text: Generate an upload link for fine-tune training data.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/finetune/request/file/download'].get
  update:
    x-apievangelist-phrasing:
      intent: Download trained model weights
      effect: read
      questions:
      - How do I download the weights of a model I fine-tuned?
      - Can I export the trained weights file once my fine-tune job is done?
      instructions:
      - text: Download the trained weights from fine-tune request {request_id}.
        slots:
          request_id: query.request_id
      - text: Give me the model weights file for job {request_id}.
        slots:
          request_id: query.request_id
      method: generated
      generated: '2026-10-01'