feat: retrieve file url

Author: shenenqing

api/src/main/java/com/theokanning/openai/file/FileUrl.java

@@ -0,0 +1,22 @@
+package com.theokanning.openai.file;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+import lombok.Data;
+
+/**
+ * A file URL response from OpenAI
+ */
+@Data
+public class FileUrl {
+
+    /**
+     * The URL to access the file.
+     */
+    String url;
+
+    /**
+     * The expiration time of the URL in epoch seconds.
+     */
+    @JsonProperty("expires_at")
+    Long expiresAt;
+}

client/src/main/java/com/theokanning/openai/client/OpenAiApi.java

@@ -33,6 +33,7 @@
 import com.theokanning.openai.embedding.EmbeddingRequest;
 import com.theokanning.openai.embedding.EmbeddingResult;
 import com.theokanning.openai.file.File;
+import com.theokanning.openai.file.FileUrl;
 import com.theokanning.openai.fine_tuning.FineTuningEvent;
 import com.theokanning.openai.fine_tuning.FineTuningJob;
 import com.theokanning.openai.fine_tuning.FineTuningJobCheckpoint;
@@ -114,6 +115,9 @@ public interface OpenAiApi {
     @GET("files/{file_id}/dom-tree/content")
     Single<ResponseBody> retrieveDomTreeContent(@Path("file_id") String fileId);
 
+    @GET("files/{file_id}/url")
+    Single<FileUrl> retrieveFileUrl(@Path("file_id") String fileId);
+
     @POST("fine_tuning/jobs")
     Single<FineTuningJob> createFineTuningJob(@Body FineTuningJobRequest request);
 

service/src/main/java/com/theokanning/openai/service/OpenAiService.java

@@ -59,6 +59,7 @@
 import com.theokanning.openai.embedding.EmbeddingRequest;
 import com.theokanning.openai.embedding.EmbeddingResult;
 import com.theokanning.openai.file.File;
+import com.theokanning.openai.file.FileUrl;
 import com.theokanning.openai.fine_tuning.FineTuningEvent;
 import com.theokanning.openai.fine_tuning.FineTuningJob;
 import com.theokanning.openai.fine_tuning.FineTuningJobCheckpoint;
@@ -301,6 +302,10 @@ public ResponseBody retrieveDomTreeContent(String fileId) {
         return execute(api.retrieveDomTreeContent(fileId));
     }
 
+    public FileUrl retrieveFileUrl(String fileId) {
+        return execute(api.retrieveFileUrl(fileId));
+    }
+
     public FineTuningJob createFineTuningJob(FineTuningJobRequest request) {
         return execute(api.createFineTuningJob(request));
     }