Add spec & docs for Model#delete

Author: alexrudall

README.md

@@ -328,6 +328,12 @@ client.models.list
 client.models.retrieve(id: "gpt-4o")
 ```
 
+You can also delete any finetuned model you generated, if you're an account Owner on your OpenAI organization:
+
+```ruby
+client.models.delete(id: "ft:gpt-4o-mini:acemeco:suffix:abc123")
+```
+
 ### Chat
 
 GPT is a model that can be used to generate text in a conversational style. You can use it to [generate a response](https://platform.openai.com/docs/api-reference/chat/create) to a sequence of [messages](https://platform.openai.com/docs/guides/chat/introduction):
@@ -858,6 +864,12 @@ You can also capture the events for a job:
 client.finetunes.list_events(id: fine_tune_id)
 ```
 
+You can also delete any finetuned model you generated, if you're an account Owner on your OpenAI organization:
+
+```ruby
+client.models.delete(id: fine_tune_id)
+```
+
 ### Vector Stores
 
 Vector Store objects give the File Search tool the ability to search your files.

spec/fixtures/cassettes/models_delete.yml

@@ -22,4 +22,21 @@
       end
     end
   end
+
+  describe "#delete" do
+    let(:cassette) { "models delete" }
+    let(:model_id) { "ft:123" }
+
+    it "sends request to the correct endpoint" do
+      VCR.use_cassette(cassette) do
+        OpenAI::Client.new.models.delete(id: model_id)
+      rescue Faraday::ResourceNotFound => e
+        error_expected = "The model '#{model_id}' does not exist"
+        expect(e.response.dig(:body, "error", "message")).to eq(error_expected)
+
+        # Just verify the exception is raised as expected
+        expect(e).to be_a(Faraday::ResourceNotFound)
+      end
+    end
+  end
 end