- chat: add stream options (#363)
- chat: add
instanceId
field toChatCompletionRequest
(#359) (thanks @harishv-collab) - messages: add assistant tools to attachments (#370)
- assistants: add
attachments.fileId
field toMessageRequest
(#367) (thanks @0chil) - runs: feat(runs): add new fields into assistant run (#366) (thanks @ahmedmirza994)
- messages: update
quote
to optional field for openai compatibility assistant on FileCitation (#361) (thanks @AntoDev) - messages: serialization exception while retrieving thread messages (#369) (thanks @meroving)
Published 28 Jun 2024
- runs: set beta header to v2 (#357) (thanks @kdman98)
- chat: default
ChatChunk.finishReason
to null (#358) (thanks @Him188)
Published 27 Jun 2024
- assistant: added feature for assistant beta-v2, and option for version selection (thanks @kdman98)
- vector-stores: add vector stores APIs (#324)
- batch: add batch APIs (#334)
- models: make created and ownedBy nullable (#332) (thanks @thiswillbeyourgithub)
- chat: enhance flow cancel capability (#333)
- assistants: Assistant.name is nullable (#337) (thanks @Gama11)
- chat: add Azure OpenAI Content Filter Support (#340) (thanks @asharab)
- config: request options headers override previous values (#353)
- runs: get runs order param serialization (#355)
Published 28 Apr 2024
- embeddings: add embedding
dimensions
request field (#317) (thanks @EliasJorgensen) - chat: add
logprob
andtopLogprobs
(#328) (thanks @jkohls-indeed)
- chat:
image_url
content type (#321) - images: remove
Quality
typealias (#318) (thanks @florentine-doemges)
Published 01 Apr 2024
- Audio: add
timestampGranularities
(thanks @mxwell)
- Core: nullable
OpenAIErrorDetails
fields (#315) - Messages: content as image file (#313)
Published 11 Feb 2024
- add
RequestOptions
(#296)
- chat: add
systemFingerprint
toChatCompletionChunk
(#303) - chat: move
description
toFunctionTool
(#304) - chat: make
FunctionTool#Parameters
nullable (#304) - finetuning: nullable
ErrorInfo#message
andErrorInfo#code
(#304) - image: correct
Quality
package name (#302) (thanks @voqaldev) - assistants: files endpoint (#298) (thanks @rjeeb)
- runs:
RunRequest
builder
Published 13 Jan 2024
- Images: add
quality
andstyle
fields (#292) - Runs: add
additionalInstructions
property toRunRequest
(#293) (thanks @ahmedmirza994)
- Messages:
MessageFile
optional fields (#290) - proguard: Add
EnclosingMethod
proguard rule (thanks @rafsanjani)
Published 15 Dec 2023
- Completion:
Choice.finishReason
as nullable (#285) - Chat:
ChatCompletion.created
field change type fromInt
toLong
(#282) (thanks @VarenytsiaMykhailo) - Runs: incorrect property name
Run.cancelledAt
(#279) (thanks @Gama11) - Proguard: add
EnclosingMethod
rule (#283) (thanks @rafsanjani)
Published 26 Nov 2023
- Runs:
ToolCalls
,ToolCallStep
andRunSteps
serialization (#266, #269, #271, #273) (thanks @voqaldev) - Messages:
MessageContent
serialization (#275)
Published 24 Nov 2023
- Images: Support for model selection for
ImageCreation
,ImageEdit
andImageVariations
(#257) (thanks @FilipObornik) - Chat: add tool calls (#256)
- Chat: add vision feature (#258)
- Config: adding ktor engine config to support Kotlin Scripting (#261) (thanks @DevSrSouza)
- Audio: add speech-to-text (#263)
- Assistants: api implementation (#259)
- Threads: api implementation (#262)
- Messages: api implementation (#262)
- Runs: api implementation (#262)
Published 05 Nov 2023
- Models: permission field nullable (#251)
- Chat: add
mergeToChatMessage
extension (#250)
Published 04 Oct 2023
- Fine-tuning: API implementation (#242)
- Fine-tunes is deprecated
Published 28 Sep 2023
- Config: Allow custom ktor http client configuration (#239) (Thanks @rasharab)
Published 31 Aug 2023
- Chat: fix(chat):
FunctionCall
nullable name/arguments (#232)
Published 23 Aug 2023
- Introduced
Parameters.Empty
for functions without parameters. - Added
File.statusDetails
for retrieving file status details. HyperParams
new fields:computeClassificationMetrics
,classificationNClasses
andclassificationPositiveClass
.- Moderation: update categories and scores.
- Removed beta status from the chat and audio features.
completions
is deprecated.edits
as legacy.
- Audio: Updated
TranscriptionRequest
'sresponseFormat
type toAudioResponseFormat
. - Fine Tune: set
HyperParams.learningRateMultiplier
to be non-nullable. - Edit:
Choice.finishReason
type toFinishReason
. - Chat: Multiple changes have been implemented:
- Set
index
,message
, andfinishReason
fields inChatChoice
to be non-nullable. - Set
index
,delta
, andfinishReason
fields inChatChunk
to be non-nullable. - Set
ChatCompletionFunction.parameters
to be non-nullable. - In
FunctionCall
, setname
,arguments
, andargumentsAsJson()
to be non-nullable. - Modified
ChatChoice.finishReason
andChatChunk.finishReason
types toFinishReason
.
- Set
Published 21 Jul 2023
- Audio:
Segment#transient
property nullable (thanks @charlee-dev)
- Kotlin to
1.9.0
- Kotlin coroutines to
1.7.2
- Kotlin serialization to
1.5.1
- ktor to
2.3.2
- okio to
3.4.0
Published 24 Jun 2023
- Chat: function mode serializer (#203) (thanks @emeasure-github-private)
Published 19 Jun 2023
- Chat: Function Call (#200 #202) (thanks @JochenGuckSnk)
Published 03 Jun 2023
- Add
OpenAIHost
builder for Azure (#196) - Support of
OpenAIHost
with a base path (#196)
Published 21 May 2023
- Logging configuration using
LoggingConfig
sanitize
flag to sanitize authorization header in the logs- Enhance
OpenAI()
factory function parameters
- Updated
OpenAIConfig
to replace logging fields withLoggingConfig
- Authorization token is now hidden by default in the logs
Published 01 May 2023
OpenAIIOException
andGenericIOException
(#178)
Published 29 Apr 2023
- Completion: add suffix request param (#174)
- Exceptions: Add more detailed api errors (#163)
- Replace
Autocloseable
until stable (#173)
Published 9 Apr 2023
- Proguard / R8 rules for jvm (#149)
OpenAI
implementsAutoCloseable
(#151)
- Kotlin to
1.8.20
(#146) - Kotlin serialization to
1.5.0
(#146) - Ktor to
2.2.4
(#146)
Published 23 Mar 2023
- Audio: add other formats support (#127)
- Chat: add user param to chat request (#128)
- Simplify and add more exceptions (#123)
Published 17 Mar 2023
- Add error details to
OpenAIAPIException
(#120) (thanks @rosuH)
- Audio: switch mixed-up translation and transcription paths (#119) (thanks @matusekma)
Published 10 Mar 2023
- Audio: api implementation (#105)
- Config: proxy config (#111)
- Config: retry strategy config (#112)
Published 02 Mar 2023
Important changes since 2.1.3
- Requests: DSL builder functions to create requests (#80)
- Completions and
Edit
: addusage
to the responses (#82) - Files: add
download
anddelete
functions (#86) - OpenAIConfig:
headers
andorganization
(#96) - Embeddings:
similarity
anddistance
(#88) (experimental) - Chat implementation (#99) (beta)
- OpenAIConfig: custom host config (#102)
- FileSource and okio for I/O operations (e.g. files, images) (#75)
- FineTunes: remove experimental (#90)
- Images: mark as experimental (#91)
- Embeddings: response changed to
EmbeddingResponse
to includeusage
. (#82)
- Non-blocking SSE
Flow
events (#95)
- Update Kotlin to
1.8.10
Published 19 Feb 2023
OpenAIConfig
:headers
andorganization
(#96)
FineTunes
: remove experimental (#90)Images
: mark as experimental (#91)
- Non-blocking SSE
Flow
events (#95)
Published 06 Feb 2023
This release contains changes from 3.0.0-alpha01, plus the following:
- Embeddings: similarity and distance (#88) (Experimental)
- Update Kotlin to
1.8.10
Published 29 Jan 2023
- Add darwin simulators and x86 targets (#85)
Published 20 Jan 2023
- DSL builder functions to create requests
Completions
andEdit
: addusage
to the responsesFiles
: adddownload
anddelete
functions
FileSource
and okio for I/O operations (e.g. files, images).Embeddings
: response changed toEmbeddingResponse
to includeusage
.
Published 11 Jan 2023
- FineTunes: events streaming using
GET
(#76) (thanks @PatrickLaflamme)
Published 02 Jan 2023
- Targets
ios
,watchos
andtvos
(x64/arm64)
- Update Kotlin to
1.8.0
Published 14 Dec 2022
- Images implementation (#68)
- Http timeout configuration (#71)
- Update Kotlin to
1.7.20
- Update Kotlin serialization to
1.4.1
- Update Ktor
2.1.3
Published 20 Aug 2022
- Models implementation
- Moderations implementation
- Fine-Tunes implementation
- Update Kotlin to
1.7.10
- Update Kotlin serialization to
1.4.0
- Update
Completions
,Edits
andEmbeddings
to useModels
Engines
,Answers
,Search
andClassification
Published 11 Jun 2022
openai-client-bom
artifact for jvm projects
- Update Kotlin to
1.7.0
(#31) - Update Coroutines to
1.6.2
(#26)
- Answers, Classification and Search Endpoints (#29)
Published 08 May 2022
- Field
user
toCompletionRequest
(#9) (thanks @Stuie) - Native targets:
linuxX64
,macosX64
,macosArm64
andmingwX64
(w/ new memory manager)
- Kotlin
1.6.21
- Kotlin coroutines
1.6.1
- The client throws
OpenAIException
on errors
Published 19 Jun 2021
- Kotlin 1.5.10
- Value classes:
EngineID
,FileStatus
,FileId
andPurpose
Published 03 Apr 2021
- Kotlin
1.4.32
Published 20 Mar 2021
- Deprecate
stream
parameter inCompletionRequest
.
Published 13 Mar 2021
- Remove Ktor's logging classes from public API
Published 11 Mar 2021
OpenAI.completions
: text completions as stream of events
OpenAI.completion
whenstream
is set
OpenAI.createCompletion
renamed toOpenAI.completion
Published 10 Mar 2021
- Ktor as an implementation dependency of
openai-client
Published 09 Mar 2021