wkok.openai-clojure.api — net.clojars.wkok/openai-clojure 0.22.0

cancel-fine-tuning-job clj

(cancel-fine-tuning-job params)

(cancel-fine-tuning-job params options)

Immediately cancel a fine-tuning job.

Example:

(cancel-fine-tuning-job {:fine_tuning_job_id "ft-1wefweub"})

Also see the OpenAI documentation

cancel-run clj

(cancel-run params)

(cancel-run params options)

Returns a list of run steps belonging to a run.

Example:

(cancel-run {:thread_id    "----id----"
             :run_id       "----id----"})

Also see the OpenAI documentation

create-assistant clj

(create-assistant params)

(create-assistant params options)

Create an assistant with a model and instructions.

Example:

(create-assistant {:name "My PDF Assistant"
                   :model "gpt-4-1106-preview"
                   :instructions "You are my personal PDF assistant. You modify
                                   and extract pages from the file."
                   :tools [{:type "code_interpreter"}]}

Also see the OpenAI documentation

create-chat-completion clj

(create-chat-completion params)

(create-chat-completion params options)

Creates a completion for the chat message

Example:

(create-chat-completion {:model "gpt-3.5-turbo"
                         :messages [{:role "system" :content "You are a helpful assistant."}
                                    {:role "user" :content "Who won the world series in 2020?"}
                                    {:role "assistant" :content "The Los Angeles Dodgers won the World Series in 2020."}
                                    {:role "user" :content "Where was it played?"}]})

For Azure OpenAI pass {:impl :azure} for the options argument

Streaming of token events is supported via the :stream param, see Streaming Tokens

Also see the OpenAI documentation / Azure OpenAI documentation

create-completion clj

(create-completion params)

(create-completion params options)

Creates a completion for the provided prompt and parameters

Example:

(create-completion {:model "text-davinci-003"
                    :prompt "Say this is a test"
                    :max_tokens 7
                    :temperature 0})

For Azure OpenAI pass {:impl :azure} for the options argument

Streaming of token events is supported via the :stream param, see Streaming Tokens

Also see the OpenAI / Azure OpenAI documentation

create-embedding clj

(create-embedding params)

(create-embedding params options)

Creates an embedding vector representing the input text.

Example:

(create-embedding {:model "text-embedding-ada-002"
                   :input "The food was delicious and the waiter..."})

For Azure OpenAI pass {:impl :azure} for the options argument

Also see the OpenAI / Azure OpenAI documentation

create-file clj

(create-file params)

(create-file params options)

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.

Example:

(create-file {:purpose "fine-tune"
              :file (clojure.java.io/file "path/to/fine-tune.jsonl")})

Also see the OpenAI documentation

create-fine-tuning-job clj

(create-fine-tuning-job params)

(create-fine-tuning-job params options)

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.

Example:

(create-fine-tuning-job {:training_file "file-xuhfiwuefb"
                         :model "gpt-3.5-turbo"})

Also see the OpenAI documentation

create-image clj

(create-image params)

(create-image params options)

Creates an image given a prompt.

Example:

(create-image {:prompt "A cute baby sea otter"
               :n 2
               :size "1024x1024"})

For Azure OpenAI pass {:impl :azure} for the options argument

Also see the OpenAI / Azure OpenAI documentation

create-image-edit clj

(create-image-edit params)

(create-image-edit params options)

Creates an edited or extended image given an original image and a prompt.

Example:

(create-image-edit {:image (clojure.java.io/file "path/to/otter.png")
                    :mask (clojure.java.io/file "path/to/mask.png")
                    :prompt "A cute baby sea otter wearing a beret"
                    :n 2
                    :size "1024x1024"})

Also see the OpenAI documentation

create-image-variation clj

(create-image-variation params)

(create-image-variation params options)

Creates a variation of a given image.

Example:

(create-image-variation {:image (clojure.java.io/file "path/to/otter.png")
                         :n 2
                         :size "1024x1024"})

Also see the OpenAI documentation

create-message clj

(create-message params)

(create-message params options)

Create a message.

Example:

(create-message {:thread_id "----id----"
                 :role      "user"
                 :content   "How does AI work"})

Also see the OpenAI documentation

create-moderation clj

(create-moderation params)

(create-moderation params options)

Classifies if text violates OpenAI's Content Policy

Example:

(create-moderation {:input "I want to kill them"})

Also see the OpenAI documentation

create-run clj

(create-run params)

(create-run params options)

Create a run.

Example:

(create-run {:thread_id   "----id----"
             :assistant_id   "----id----"})

Also see the OpenAI documentation

create-speech clj

(create-speech params)

(create-speech params options)

Creates audio from text.

Example:

(create-speech {:model "tts-1"
                :input "Hello! Nice to meet you!."
                :voice "alloy"
                :response_format "mp3"})

Also see the OpenAI documentation

create-thread clj

(create-thread)

(create-thread params)

(create-thread params options)

Create a thread.

Example:

(create-thread) or
(create-thread {:messages [{:role    "user"
                            :content "Hello, what is AI?"}
                           {:role    "user"
                            :content "How does AI work? Explain it in simple terms."}]})

Also see the OpenAI documentation

create-thread-and-run clj

(create-thread-and-run params)

(create-thread-and-run params options)

Create a thread and run it in one request.

Example:

(create-thread-and-run {:assistant_id    "----id----"})

Also see the OpenAI documentation

create-transcription clj

(create-transcription params)

(create-transcription params options)

Transcribes audio into the input language.

Example:

(create-transcription {:file (clojure.java.io/file "path/to/audio.mp3")
                       :model "whisper-1"})

For Azure OpenAI pass {:impl :azure} for the options argument

Also see the OpenAI / Azure OpenAI documentation

create-translation clj

(create-translation params)

(create-translation params options)

Translates audio into English.

Example:

(create-translation {:file (clojure.java.io/file "path/to/file/german.m4a")
                     :model "whisper-1"})

For Azure OpenAI pass {:impl :azure} for the options argument

Also see the OpenAI / Azure OpenAI documentation

create-vector-store clj

(create-vector-store params)

(create-vector-store params options)

Create a vector store.

Example:

(create-vector-store {:name "Support FAQ" :file-ids ["file-id-123"]})

Also see the OpenAI documentation

delete-assistant clj

(delete-assistant params)

(delete-assistant params options)

Delete an assistant.

Example:

(delete-assistant {:assistant_id "----id----"})

Also see the OpenAI documentation

delete-file clj

(delete-file params)

(delete-file params options)

Delete a file.

Example:

(delete-file {:file-id "file-wefuhweof"})

Also see the OpenAI documentation

delete-model clj

(delete-model params)

(delete-model params options)

Delete a fine-tuned model. You must have the Owner role in your organization.

Example:

(delete-model {:model "fine-tune"})

Also see the OpenAI documentation

delete-thread clj

(delete-thread params)

(delete-thread params options)

Delete a thread.

Example:

(delete-thread {:thread_id "----id----"})

Also see the OpenAI documentation

delete-vector-store clj

(delete-vector-store params)

(delete-vector-store params options)

Deletes a vector store.

Example:

(delete-vector-store {:vector_store_id "vs_abc123"})

Also see the OpenAI documentation

download-file clj

(download-file params)

(download-file params options)

Returns the contents of the specified file

Example:

(download-file {:file-id "file-wefuhweof"})

Also see the OpenAI documentation

list-assistants clj

(list-assistants)

(list-assistants params)

(list-assistants params options)

Returns a list of assistants.

Example:

(list-assistants {:limit 3})

Also see the OpenAI documentation

list-files clj

(list-files)

(list-files options)

Returns a list of files that belong to the user's organization.

Example:

(list-files)

Also see the OpenAI documentation

list-fine-tuning-events clj

(list-fine-tuning-events params)

(list-fine-tuning-events params options)

Get status updates for a fine-tuning job.

Example:

(list-fine-tuning-events {:fine_tuning_job_id "ft-1wefweub"})

Also see the OpenAI documentation

list-fine-tuning-jobs clj

(list-fine-tuning-jobs)

(list-fine-tuning-jobs options)

List your organization's fine-tuning jobs

Example:

(list-fine-tuning-jobs)

Also see the OpenAI documentation

list-messages clj

(list-messages params)

(list-messages params options)

Returns a list of messages for a given thread.

Example:

(list-messages {:thread_id ",,,"
                :limit      20})

Also see the OpenAI documentation

list-models clj

(list-models)

(list-models options)

Lists the currently available models, and provides basic information about each one such as the owner and availability.

Example:

(list-models)

Also see the OpenAI documentation

list-run-steps clj

(list-run-steps params)

(list-run-steps params options)

Returns a list of run steps belonging to a run.

Example:

(list-run-steps {:thread_id    "----id----"
                 :run_id       "----id----"})

Also see the OpenAI documentation

list-runs clj

(list-runs params)

(list-runs params options)

Returns a list of runs belonging to a thread.

Example:

(list-runs {:thread_id   "----id----"})

Also see the OpenAI documentation

list-vector-stores clj

(list-vector-stores params)

(list-vector-stores params options)

Returns a list of vector stores.

Example:

(list-vector-stores {:limit 1})

Also see the OpenAI documentation

modify-assistant clj

(modify-assistant params)

(modify-assistant params options)

Modifies an assistant.

Example:

(modify-assistant {:assistant_id "id"
                   :name "assistant-name"
                   :model "gpt4.. "
                   :description " update the assistant "})

Also see the OpenAI documentation

modify-message clj

(modify-message params)

(modify-message params options)

Modify a message.

Example:

(modify-message {:thread_id   "----id----"
                 :message_id  "----id----"})

Also see the OpenAI documentation

modify-run clj

(modify-run params)

(modify-run params options)

Modifies a run.

Example:

(modify-run {:thread_id   "----id----"
             :run_id      "----id----"})

Also see the OpenAI documentation

modify-thread clj

(modify-thread params)

(modify-thread params options)

Modifies a thread.

Example:

(modify-thread {:thread_id "----id----"
                :metadata {}})

Also see the OpenAI documentation

modify-vector-store clj

(modify-vector-store params)

(modify-vector-store params options)

Modifies a vector store.

Example:

(modify-vector-store {:vector_store_id "vs_abc123" :name "Support FAQ"})

Also see the OpenAI documentation

retrieve-assistant clj

(retrieve-assistant params)

(retrieve-assistant params options)

Retrieves an assistant.

Example:

(retrieve-assistant {:assistant_id "----id----"})

:assistant_id param required :model too (but not in spec)

Also see the OpenAI documentation

retrieve-file clj

(retrieve-file params)

(retrieve-file params options)

Returns information about a specific file.

Example:

(retrieve-file {:file-id "file-wefuhweof"})

Also see the OpenAI documentation

retrieve-fine-tuning-job clj

(retrieve-fine-tuning-job params)

(retrieve-fine-tuning-job params options)

Gets info about a fine-tuning job.

Example:

(retrieve-fine-tuning-job {:fine_tuning_job_id "ft-1wefweub"})

Also see the OpenAI documentation

retrieve-message clj

(retrieve-message params)

(retrieve-message params options)

Retrieve a message.

Example:

(retrieve-message {:thread_id   "----id----"
                   :message_id  "----id----"})

Also see the OpenAI documentation

retrieve-model clj

(retrieve-model params)

(retrieve-model params options)

Retrieves a model instance, providing basic information about the model such as the owner and permissioning.

Example:

(retrieve-model {:model "text-davinci-003"})

Also see the OpenAI documentation

retrieve-run clj

(retrieve-run params)

(retrieve-run params options)

Retrieves a run.

Example:

(retrieve-run {:thread_id   "----id----"
               :run_id      "----id----"})

Also see the OpenAI documentation

retrieve-run-step clj

(retrieve-run-step params)

(retrieve-run-step params options)

Retrieves a run step.

Example:

(retrieve-run-step {:thread_id    "----id----"
                    :run_id       "----id----"
                    :step_id      "----id----"})

Also see the OpenAI documentation

retrieve-thread clj

(retrieve-thread params)

(retrieve-thread params options)

Retrieves a thread.

Example:

(retrieve-thread {:thread_id "----id----"})

Also see the OpenAI documentation

retrieve-vector-store clj

(retrieve-vector-store params)

(retrieve-vector-store params options)

Retrieves a vector store.

Example:

(retrieve-vector-store {:vector_store_id "vs_abc123"})

Also see the OpenAI documentation

submit-tool-outputs-to-run clj

(submit-tool-outputs-to-run params)

(submit-tool-outputs-to-run params options)

When a run has the status: "requires_action" and required_action.type is submit_tool_outputs, this endpoint can be used to submit the outputs from the tool calls once they're all completed. All outputs must be submitted in a single request.

Example:

(submit-tool-outputs-to-run {:thread_id    "----id----"
                             :run_id       "----id----"
                             :tool_outputs  [{:tool_call_id  "call_wwg3TXXXF0SCT7UTTvqxjZc"
                                              :output        "Budapest, Hungary"}]})

Also see the OpenAI documentation