Package xyz.felh.openai
Interface OpenAiApi
public interface OpenAiApi
Retrofit2 API interface
-
Method Summary
Modifier and TypeMethodDescriptionio.reactivex.rxjava3.core.Single<FineTuningJob>cancelFineTuningJob(String fineTuningJobId) Immediately cancel a fine-tune job.io.reactivex.rxjava3.core.Single<AudioResponse>createAudioTranscription(okhttp3.RequestBody request) Create transcriptionBeta Transcribes audio into the input language.io.reactivex.rxjava3.core.Single<AudioResponse>createAudioTranslation(okhttp3.RequestBody request) Create translationBeta Translates audio into English.io.reactivex.rxjava3.core.Single<ChatCompletion>Create chat completionBeta Creates a completion for the chat messageio.reactivex.rxjava3.core.Single<Completion>createCompletion(CreateCompletionRequest request) Create completion Creates a completion for the provided prompt and parametersio.reactivex.rxjava3.core.Single<CreateEmbeddingResponse>createEmbedding(CreateEmbeddingRequest request) Create embeddings Creates an embedding vector representing the input text.io.reactivex.rxjava3.core.Single<FineTuningJob>Creates a job that fine-tunes a specified model from a given dataset.io.reactivex.rxjava3.core.Single<ImageResponse>createImage(CreateImageRequest request) Create image Beta Creates an image given a prompt.io.reactivex.rxjava3.core.Single<ImageResponse>createImageEdit(okhttp3.RequestBody request) Create image editBeta Creates an edited or extended image given an original image and a prompt.io.reactivex.rxjava3.core.Single<ImageResponse>createImageVariation(okhttp3.RequestBody request) Create image variationBeta Creates a variation of a given image.io.reactivex.rxjava3.core.Single<CreateModerationResponse>createModeration(CreateModerationRequest request) Create moderation Classifies if text violates OpenAI's Content Policyio.reactivex.rxjava3.core.Single<DeleteResponse>deleteFile(String fileId) Delete file Delete a file.io.reactivex.rxjava3.core.Single<Model>Retrieve modelio.reactivex.rxjava3.core.Single<OpenAiApiListResponse<File>>List files Returns a list of files that belong to the user's organization.io.reactivex.rxjava3.core.Single<OpenAiApiListResponse<FineTuningJobEvent>>listFineTuningEvents(String fineTuningJobId, String after, Integer limit) Get status updates for a fine-tuning job.io.reactivex.rxjava3.core.Single<OpenAiApiListResponse<Model>>List modelsio.reactivex.rxjava3.core.Single<File>retrieveFile(String fileId) Retrieve fileio.reactivex.rxjava3.core.Single<String>retrieveFileContent(String fileId) Retrieve file contentio.reactivex.rxjava3.core.Single<FineTuningJob>retrieveFineTuningJob(String fineTuningJobId) Get info about a fine-tuning job.io.reactivex.rxjava3.core.Single<File>uploadFile(okhttp3.MultipartBody.Part file, okhttp3.RequestBody purpose) Upload file Upload a file that contains document(s) to be used across various endpoints/features.
-
Method Details
-
listModels
List models- Returns:
- Lists the currently available models, and provides basic information about each one such as the owner and availability.
-
getModel
@GET("/v1/models/{model_id}") io.reactivex.rxjava3.core.Single<Model> getModel(@Path("model_id") String modelId) Retrieve model- Parameters:
modelId- model ID- Returns:
- Retrieves a model instance, providing basic information about the model such as the owner and permission.
-
createCompletion
@POST("/v1/completions") io.reactivex.rxjava3.core.Single<Completion> createCompletion(@Body CreateCompletionRequest request) Create completion Creates a completion for the provided prompt and parameters- Parameters:
request- Create completion request- Returns:
- Completion detail information
-
createChatCompletion
@POST("/v1/chat/completions") io.reactivex.rxjava3.core.Single<ChatCompletion> createChatCompletion(@Body CreateChatCompletionRequest request) Create chat completionBeta Creates a completion for the chat message- Parameters:
request- Create chat completion request- Returns:
- Chat Completion information
-
createImage
@POST("/v1/images/generations") io.reactivex.rxjava3.core.Single<ImageResponse> createImage(@Body CreateImageRequest request) Create image Beta Creates an image given a prompt.- Parameters:
request- create image request- Returns:
- Image Information Wrapper
-
createImageEdit
@POST("/v1/images/edits") io.reactivex.rxjava3.core.Single<ImageResponse> createImageEdit(@Body okhttp3.RequestBody request) Create image editBeta Creates an edited or extended image given an original image and a prompt.- Parameters:
request- request body- Returns:
- Image Information Wrapper
-
createImageVariation
@POST("/v1/images/variations") io.reactivex.rxjava3.core.Single<ImageResponse> createImageVariation(@Body okhttp3.RequestBody request) Create image variationBeta Creates a variation of a given image.- Parameters:
request- request body- Returns:
- Image Information Wrapper
-
createEmbedding
@POST("/v1/embeddings") io.reactivex.rxjava3.core.Single<CreateEmbeddingResponse> createEmbedding(@Body CreateEmbeddingRequest request) Create embeddings Creates an embedding vector representing the input text.- Parameters:
request- create embedding request- Returns:
- Embeddings
-
createAudioTranscription
@POST("/v1/audio/transcriptions") io.reactivex.rxjava3.core.Single<AudioResponse> createAudioTranscription(@Body okhttp3.RequestBody request) Create transcriptionBeta Transcribes audio into the input language.- Parameters:
request- body- Returns:
- Text of audio
-
createAudioTranslation
@POST("/v1/audio/translations") io.reactivex.rxjava3.core.Single<AudioResponse> createAudioTranslation(@Body okhttp3.RequestBody request) Create translationBeta Translates audio into English.- Parameters:
request- body- Returns:
- Text of audio
-
createModeration
@POST("/v1/moderations") io.reactivex.rxjava3.core.Single<CreateModerationResponse> createModeration(@Body CreateModerationRequest request) Create moderation Classifies if text violates OpenAI's Content Policy- Parameters:
request- create moderation request- Returns:
- Moderation
-
listFiles
List files Returns a list of files that belong to the user's organization.- Returns:
- File list
-
uploadFile
@Multipart @POST("/v1/files") io.reactivex.rxjava3.core.Single<File> uploadFile(@Part okhttp3.MultipartBody.Part file, @Part("purpose") okhttp3.RequestBody purpose) Upload file Upload a file that contains document(s) to be used across various endpoints/features. Currently, the size of all the files uploaded by one organization can be up to 1 GB. Please contact us if you need to increase the storage limit.- Parameters:
file- filepurpose- request body- Returns:
- File information
-
deleteFile
@DELETE("/v1/files/{file_id}") io.reactivex.rxjava3.core.Single<DeleteResponse> deleteFile(@Path("file_id") String fileId) Delete file Delete a file.- Parameters:
fileId- fileId- Returns:
- Delete file and status
-
retrieveFile
@GET("/v1/files/{file_id}") io.reactivex.rxjava3.core.Single<File> retrieveFile(@Path("file_id") String fileId) Retrieve file- Parameters:
fileId- fileId- Returns:
- information about a specific file.
-
retrieveFileContent
@GET("/v1/files/{file_id}/content") io.reactivex.rxjava3.core.Single<String> retrieveFileContent(@Path("file_id") String fileId) Retrieve file content- Parameters:
fileId- fileId- Returns:
- the contents of the specified file
-
createFineTuningJob
@POST("/v1/fine_tuning/jobs") io.reactivex.rxjava3.core.Single<FineTuningJob> createFineTuningJob(@Body CreateFineTuningJobRequest request) Creates a job that fine-tunes a specified model from a given dataset. Response includes details of the enqueued job including job status and the name of the fine-tuned models once complete.- Parameters:
request- create fine tuning job request- Returns:
- fine tuning
-
cancelFineTuningJob
@POST("/v1/fine_tuning/jobs/{fine_tuning_job_id}/cancel") io.reactivex.rxjava3.core.Single<FineTuningJob> cancelFineTuningJob(@Path("fine_tuning_job_id") String fineTuningJobId) Immediately cancel a fine-tune job.- Parameters:
fineTuningJobId- fine_tuning_job_id- Returns:
- The cancelled fine-tuning object.
-
retrieveFineTuningJob
@GET("/v1/fine_tuning/jobs/{fine_tuning_job_id}") io.reactivex.rxjava3.core.Single<FineTuningJob> retrieveFineTuningJob(@Path("fine_tuning_job_id") String fineTuningJobId) Get info about a fine-tuning job.- Parameters:
fineTuningJobId- fine_tuning_job_id- Returns:
- fine tuning
-
listFineTuningEvents
@GET("/v1/fine_tuning/jobs/{fine_tuning_job_id}/events") io.reactivex.rxjava3.core.Single<OpenAiApiListResponse<FineTuningJobEvent>> listFineTuningEvents(@Path("fine_tuning_job_id") String fineTuningJobId, @Query("after") String after, @Query("limit") Integer limit) Get status updates for a fine-tuning job.- Parameters:
fineTuningJobId- fine_tuning_job_idafter- Optional Identifier for the last event from the previous pagination request.limit- Optional Defaults to 20 Number of events to retrieve.- Returns:
- A list of fine-tuning event objects.
-