Add support for models.create endpoint

Author: mattt

index.d.ts

@@ -1,5 +1,6 @@
 declare module 'replicate' {
   type Status = 'starting' | 'processing' | 'succeeded' | 'failed' | 'canceled';
+  type Visibility = 'public' | 'private';
   type WebhookEventType = 'start' | 'output' | 'logs' | 'completed';
 
   export interface ApiError extends Error {
@@ -142,6 +143,17 @@ declare module 'replicate' {
     models: {
       get(model_owner: string, model_name: string): Promise<Model>;
       list(): Promise<Page<Model>>;
+      create(options: {
+        owner: string;
+        name: string;
+        visibility: Visibility;
+        hardware: string;
+        description?: string;
+        github_url?: string;
+        paper_url?: string;
+        license_url?: string;
+        cover_image_url?: string;
+      }): Promise<Model>;
       versions: {
         list(model_owner: string, model_name: string): Promise<ModelVersion[]>;
         get(

index.js

@@ -63,6 +63,7 @@ class Replicate {
     this.models = {
       get: models.get.bind(this),
       list: models.list.bind(this),
+      create: models.create.bind(this),
       versions: {
         list: models.versions.list.bind(this),
         get: models.versions.get.bind(this),

index.test.ts

@@ -684,6 +684,34 @@ describe('Replicate client', () => {
     // Add more tests for error handling, edge cases, etc.
   });
 
+  describe('models.create', () => {
+    test('Calls the correct API route with the correct payload', async () => {
+      nock(BASE_URL)
+        .post('/models')
+        .reply(200, {
+          owner: 'test-owner',
+          name: 'test-model',
+          visibility: 'public',
+          hardware: 'cpu',
+          description: 'A test model',
+        });
+
+      const model = await client.models.create({
+        owner: 'test-owner',
+        name: 'test-model',
+        visibility: 'public',
+        hardware: 'cpu',
+        description: 'A test model',
+      });
+
+      expect(model.owner).toBe('test-owner');
+      expect(model.name).toBe('test-model');
+      expect(model.visibility).toBe('public');
+      // expect(model.hardware).toBe('test-hardware');
+      expect(model.description).toBe('A test model');
+    });
+  });
+
   describe('run', () => {
     test('Calls the correct API routes', async () => {
       let firstPollingRequest = true;

lib/models.js

@@ -57,8 +57,35 @@ async function listModels() {
   return response.json();
 }
 
+/**
+ * Create a new model
+ *
+ * @param {object} options
+ * @param {string} options.owner - Required. The name of the user or organization that will own the model. This must be the same as the user or organization that is making the API request. In other words, the API token used in the request must belong to this user or organization.
+ * @param {string} options.name - Required. The name of the model. This must be unique among all models owned by the user or organization.
+ * @param {("public"|"private")} options.visibility - Required. Whether the model should be public or private. A public model can be viewed and run by anyone, whereas a private model can be viewed and run only by the user or organization members that own the model.
+ * @param {string} options.hardware - Required. The SKU for the hardware used to run the model. Possible values can be found by calling `Replicate.hardware.list()`.
+ * @param {string} options.description - A description of the model.
+ * @param {string} options.github_url - A URL for the model's source code on GitHub.
+ * @param {string} options.paper_url - A URL for the model's paper.
+ * @param {string} options.license_url - A URL for the model's license.
+ * @param {string} options.cover_image_url - A URL for the model's cover image. This should be an image file.
+ * @returns {Promise<object>} Resolves with the model version data
+ */
+async function createModel(options) {
+  const data = { ...options };
+
+  const response = await this.request('/models', {
+    method: 'POST',
+    data,
+  });
+
+  return response.json();
+}
+
 module.exports = {
   get: getModel,
   list: listModels,
+  create: createModel,
   versions: { list: listModelVersions, get: getModelVersion },
 };