openai_dart

[!CAUTION] This release has breaking changes. See the Migration Guide for upgrade instructions.

Requires Dart 3.12 or later; upgrade your Dart SDK or the Dart SDK bundled with Flutter before updating this package.

• BREAKING CHORE: Require Dart >=3.12.0 and align compatible development tooling (#309). (804bf19b)

ReasoningDetail now round-trips OpenRouter reasoning_details payloads exactly — explicit null values, nested unknown data, and ordered detail chunks all survive parsing and re-serialization, which OpenRouter requires when reasoning is replayed between requests. The type also exposes typed id, format, index, summary, and signature fields plus a ReasoningDetail.withAdditionalProperties factory for future non-reserved fields, stream accumulation retains explicitly empty reasoning arrays, and ChatDelta equality and hashing now account for tool calls and reasoning details.

• FIX: Preserve reasoning detail fidelity (#299). (6cc6bc03)

Fixes a LinkedHashMap failure on Dart 3.13.2 that broke streaming multipart requests. The client added a JSON content-type header and later removed it, and MultipartRequest.finalize() reinserting the same case-insensitive key then threw. Streaming multipart requests now build their headers directly and add the required SSE Accept header, leaving the generated multipart boundary owned by package:http.

• FIX: Restore Dart 3.13 compatibility (#293). (9def8ac4)

[!CAUTION] This release has breaking changes. See the Migration Guide for upgrade instructions.

Adds Fast mode (ServiceTier.fast, up to 2.5× faster processing, replacing Priority Processing) and a full modernization of the GPT-Transcribe generation — chunking strategy control, logprobs, keyword hints, multi-language input, speaker diarization, and new createStream()/createDiarized()/createRaw() methods on client.audio.transcriptions. Also adds a client.contentProvenanceChecks resource for detecting OpenAI C2PA and SynthID provenance signals, and syncs the pinned spec to GPT-5.6 with programmatic tool calling, explicit prompt caching, and a multi-agent Responses beta. Breaking: TranscriptionResponseFormat is renamed to AudioResponseFormat (a deprecated typedef keeps old code compiling), TranslationRequest.responseFormat now uses a dedicated TranslationResponseFormat enum, TranscriptionVerboseResponse.task is now String?, InputAudioTranscriptionCompletedEvent.usage is now a typed TranscriptUsage?, and multipart array fields switch to spec-correct bracket-repeated encoding. See the Migration Guide.

• BREAKING FEAT: Fast service tier, gpt-transcribe streaming/diarization, and content provenance checks (#284). (0b8d8d61)
• FEAT: GPT-5.6 spec sync with multi-agent Responses beta (#281). (e2764117)

Fixes buildUrl collapsing repeated query keys carried by the base URL (?k=a&k=b) to the last value — a proxy/gateway base URL with duplicate keys now keeps all of them on every request. Single-value behavior (including Azure api-version handling) is unchanged.

• FIX: Preserve repeated base URL query params in buildUrl (#277). (5fff6c28)

[!CAUTION] This release has breaking changes. See the Migration Guide for upgrade instructions.

Syncs openai_dart to the latest OpenAI OpenAPI spec. Adds a reasoning context mode — ReasoningConfig.context (new ReasoningContext enum: auto/currentTurn/allTurns) controls which reasoning items are rendered back to the model on later turns, and the effective mode is now surfaced on the response (which also carries reasoning + truncation, so it's no longer silently dropped). Also adds MCP Secure Tunnel and connector addressing for remote MCP tools via McpTool.tunnelId and McpTool.connectorId. The single breaking change has limited real-world impact: to express the spec's server_url/connector_id/tunnel_id one-of, McpTool.serverUrl is now nullable (String?) — existing code that always passed serverUrl continues to compile and behave the same; only callers that read McpTool.serverUrl must now handle null. See the Migration Guide.

• BREAKING FEAT: Reasoning context mode + MCP tunnel/connector (#261). (9c14d9ae)

Adds support for the new moderation scores feature on the Chat Completions and Responses APIs — pass a moderation object on a request to receive moderation results for both the model input and the generated output, surfaced as sealed input/output outcomes (ChatCompletion.moderation, ChatStreamEvent.moderation, Response.moderation) and captured by ChatStreamAccumulator for streaming. All new fields are additive and nullable. Also marks the image-model id constants OpenAI has deprecated or removed with @Deprecated (retained for compatibility), leaving ImageModels.gptImage2 as the only recommended image model, and refreshes the canonical spec.

• FEAT: Add moderation scores and deprecate sunset image models (#251). (068d5a2b)

Adds two new OpenAI Responses features from the latest spec: the additional_tools item — surfacing extra tool definitions mid-conversation — across the input, output, and conversation-item unions, and a personality style preset on the input-token-count request (responses.inputTokens.count), modeled as a sealed Personality type with friendly/pragmatic presets plus a custom(...) escape hatch for forward compatibility. Also completes the MessageRole enum with the spec's critic, discriminator, and tool values, which previously collapsed to unknown.

• FEAT: Add additional_tools item and personality preset (#245). (723b3725)

[!CAUTION] This release has breaking changes. See the Migration Guide for upgrade instructions.

Migrates the Realtime API client to the GA shape from OpenAI's Voice Intelligence drop (2026-05-07): a nested audio.{input,output} config block, sealed unions for audio formats / turn detection / truncation / tracing, new RealtimeReasoning, parallelToolCalls, transcription delay, and the realtime translation surface (gpt-realtime-translate + gpt-realtime-whisper) via connectTranslation(...) and the new client-secret methods. Adds DX helpers RealtimeConnection.sendUserMessage(text) and appendAudioBytes(...), plus a lenient event parser that returns UnknownRealtimeEvent instead of throwing. Also adds an optional serviceTier and a typed CompactionTriggerItem to the /responses/compact surface. Breaking: the impact is confined to the Realtime API (client.realtime / client.realtimeSessions) — audio fields moved under audio.{input,output}, several enums became sealed unions (RealtimeAudioFormats, RealtimeAudioInputTurnDetection), the legacy create()/createTranscription() HTTP methods are replaced by client-secret flows, and spec-dropped fields (RealtimeSession.temperature, RealtimeSessionCreateResponse.clientSecret) are removed. The Chat Completions and Responses APIs are unaffected.

• BREAKING FEAT: Migrate Realtime API to GA shape (#220). (53f3c47e)
• FEAT: Add compact service_tier & compaction_trigger item (#238). (1ded0dee)
• CHORE: Fix use_null_aware_elements lint flagged by Dart 3.12 (#232). (31ac5efc)

[!CAUTION] This release has breaking changes. See the Migration Guide for upgrade instructions.

Adds support for GPT-5.5 (gpt-5.5 and the gpt-5.5-2026-04-23 snapshot) across the ChatModel enum and all examples, and exposes the new prompt_cache_retention field on the /v1/responses/{response_id}/compact endpoint via CompactResponseRequest. Also fixes a StateError that affected non-streaming requests using abortTrigger (#209). Breaking: FunctionCallStatus is realigned to match the OpenAI spec (inProgress/completed/incomplete) — the non-spec failed value is removed (#208). The breaking surface is intentionally small: any code that referenced FunctionCallStatus.failed was already rejected by the API at runtime, so the practical impact is limited — but we follow strict semver and ship the enum change as a major bump regardless.

• BREAKING FIX: Align FunctionCallStatus values with OpenAI spec (#217). (70a02fbd)
• FEAT: Add prompt_cache_retention to compact endpoint (#215). (57d042c6)
• FEAT: Add GPT-5.5 model support (#206). (ca239826)
• FIX: Avoid StateError when non-streaming requests use abortTrigger (#216). (9228f357)

Adds support for GPT Image 2 (gpt-image-2) — surfacing the full GPT-image parameter surface on ImageGenerationRequest and ImageEditRequest (background, moderation, output format/compression, streaming, input fidelity), expanded ImageQuality and ImageSize enums, token-based usage metadata on ImageResponse, and a new ImageModels constants class. Also expands the ReasoningEffort enum with none, minimal, and xhigh to match the latest OpenAI spec and the per-model support matrix for gpt-5.1, gpt-5-pro, and models after gpt-5.1-codex-max.

• FEAT: Support GPT Image 2 (gpt-image-2) (#195). (902b1317)
• FEAT: Add none, minimal, xhigh to ReasoningEffort enum (#194). (8b8e0143)

Re-introduces the detail field on InputFileContent via a new FileInputDetail enum (high/low) for controlling how thoroughly the model processes file inputs, following the same pattern as the existing ImageDetail enum. Also refreshes the OpenAPI spec to the latest upstream version.

• FEAT: Update OpenAPI spec and add file input detail (#186). (65aa7167)
• FEAT: Annotate llms.txt with token counts and tighten agent-facing docs (#181). (a1e82aca)

Adds a phase property to ConversationMessageItem to match the latest OpenAI spec. The field labels assistant messages as either commentary (intermediate thinking) or final_answer, which prevents performance degradation when resending conversation history to models like gpt-5.3-codex.

• FEAT: Add phase field to conversation messages (#174). (2814aa89)

Aligns the README layout by moving the coding-agents TIP callout to the standard position after badges and description.

• DOCS: Align README TIP position with other packages (#172). (a6562b99)

[!CAUTION] This release has breaking changes. See the Migration Guide for upgrade instructions.

Adds FileContentPart and RefusalContentPart to the Chat Completions API — completing the content part union with support for sending PDFs/documents and representing model refusals. The InputFileContent.data() and InputContent.fileData() factories now require a mediaType parameter and construct proper data URL format (raw base64 was rejected by the API). Also adds ToolChoiceAllowedTools and ToolChoiceCustom variants for constraining tool selection, and narrows InputTokensResource.count toolChoice from Object? to ResponseToolChoice?.

• BREAKING FEAT: Add FileContentPart and RefusalContentPart (#152). (821eea60)
• FEAT: Add ToolChoiceAllowedTools and ToolChoiceCustom variants (#161). (f0940801)
• DOCS: Improve toolkit and skills from PR #152 lessons (#153). (f55de1ec)
• DOCS: Overhaul root README and add semver bullet to all packages (#151). (e6af33dd)

[!CAUTION] This release has breaking changes. See the Migration Guide for upgrade instructions.

Replaces the ServiceTier enum with an extensible class to preserve provider-specific tier values on round-trip serialization. Adds missing type and param fields to ResponseError and makes code nullable. Adds custom tool call support to the Responses API, modifier keys for computer use actions, and expands the Video API with edit, extend, and character endpoints. Removes FileInputDetail enum and detail parameter from InputFileContent. Also fixes toolkit verification warnings, adds docs coverage for 14 resources with new example files, standardizes equality helper locations, and adds llms.txt ecosystem files.

• BREAKING FEAT: Improve spec compliance for ServiceTier and ResponseError (#133). (487231d2)
• BREAKING FEAT: Update OpenAPI spec with custom tools, video expansion, and computer action keys (#143). (b08ba7b9)
• FIX: Resolve toolkit verification warnings across packages (#122). (634bdda2)
• REFACTOR: Standardize equality helpers location across packages (#123). (34086102)
• DOCS: Un-exclude 14 resources from docs verification (#121). (2a2966ad)
• DOCS: Overhaul READMEs and add llms.txt ecosystem (#149). (98f11483)
• TEST: Add OpenRouter integration test (#114). (46a75724)

[!CAUTION] This release has breaking changes. See the Migration Guide for upgrade instructions.

Made non-streaming response parsing robust for third-party OpenAI-compatible providers (AWS Bedrock proxies, Ollama, vLLM, TogetherAI, OpenRouter, etc.) by relaxing strict casts in fromJson while keeping constructor invariants strict. Added ResponseStreamExtensions for convenient stream event filtering/mapping, copyWith methods to all ResponseStreamEvent subtypes and ChatMessage/ContentPart, and updated RunStep, Message, Tool, and EmbeddingRequest models with additional fields from the latest API spec.

• BREAKING FEAT: Make parsing robust for third-party OpenAI-compatible APIs (#110). (3c3b2853)
• FEAT: Add copyWith, streaming extensions, and model improvements (#108). (b12109b2)

This release improves streaming error handling by detecting and surfacing errors embedded in chat and other streaming responses. It also updates model references to the latest gpt-realtime-1.5 and gpt-audio-1.5 models, and documents WebRTC support for the Realtime API.

• FEAT: Detect inline streaming errors (#91). (9f0eaf37)
• FEAT: Update model references to gpt-realtime-1.5 and gpt-audio-1.5 (#83). (30d27274)
• FIX: Detect and throw errors embedded in chat streaming data (#87). (7bdeaaa5)
• DOCS: Improve READMEs with badges, sponsor section, and vertex_ai deprecation (#90). (5741f2f3)
• DOCS: Document WebRTC support in Realtime API (#84). (2f385378)

Added missing containerId field to CodeInterpreterCallOutputItem and made ContainerFile.bytes nullable to match the API response.

• FIX: Add missing containerId and fix ContainerFile.bytes crash (#81). (1dde0468)

Added support for GPT-5.4 and the new Responses API agent capabilities released alongside it — tool search (deferred tool loading at runtime), built-in computer use, and 1M-token context with message phases. Also added multi-modal moderation, fine-tune management methods, and missing ChatCompletionCreateRequest fields. Fixed handling of unknown streaming event types.

• FEAT: GPT-5.4, tool search, computer use & message phase support (#69). (3dab848f)
• FEAT: Add missing ChatCompletionCreateRequest fields (#73). (0b06b159)
• FEAT: Add multi-modal moderation, fine-tune methods & missing fields (#76). (8b54049c)
• FIX: Handle unknown streaming event types gracefully (#72). (28a49804)
• REFACTOR: Migrate API skills to the shared api-toolkit CLI (#74). (923cc83e)
• DOCS: Update README with SOTA models and Responses API (#68). (ff6d2774)
• CHORE: Add .pubignore to exclude .agents/ and specs/ from publishing (#78). (0ff199bf)

Added baseUrl and defaultHeaders parameters to withApiKey constructors, aligned Responses API models with the latest OpenAI spec, fixed null index handling in ToolCallDelta.fromJson, and improved hashCode for list fields.

• FEAT: Add baseUrl and defaultHeaders to withApiKey constructors (#57). (f0dd0caa)
• FIX: Align Responses API models with current OpenAI spec (#59). (a55a67b7)
• FIX: Handle null index in ToolCallDelta.fromJson (#64). (9b3df8a4)
• FIX: Use Object.hashAll() for list fields in hashCode (#65). (4b19abd9)
• REFACTOR: Unify equality_helpers.dart across packages (#67). (ec2897f8)

Fixed Responses API model types to align with the latest OpenAI spec.

• FIX: Align Responses API model types with OpenAI spec (#54). (c200a489)
• CHORE: Bump googleapis from 15.0.0 to 16.0.0 and Dart SDK to 3.9.0 (#52). (eae130b7)

[!CAUTION] This release has breaking changes. See the Migration Guide for upgrade instructions.

TL;DR: Complete reimplementation with a new architecture, minimal dependencies, resource-based API, and improved developer experience. Hand-crafted models (no code generation), interceptor-driven architecture, comprehensive error handling, full OpenAI API coverage, and alignment with the latest OpenAI OpenAPI (2026-02-19).

What's new

• Resource-based API organization:
  • client.chat.completions — Chat completion creation, streaming
  • client.responses — Responses API (recommended unified API)
  • client.conversations — Conversation management
  • client.embeddings — Text embeddings
  • client.audio.speech / audio.transcriptions / audio.translations — Audio APIs
  • client.images — Image generation, editing, variations
  • client.files / client.uploads — File and large upload management
  • client.batches — Batch processing
  • client.models — Model listing and retrieval
  • client.moderations — Content moderation
  • client.fineTuning.jobs — Fine-tuning job management
  • client.beta.assistants / beta.threads / beta.vectorStores — Assistants API (Beta)
  • client.videos — Sora video generation
  • client.containers — Code execution containers
  • client.chatkit — ChatKit sessions and threads (Beta)
  • client.evals — Model evaluation
  • client.realtime — WebSocket-based Realtime API
  • client.completions — Legacy text completions
• Architecture:
  • Interceptor chain (Auth → Logging → Error → Transport with Retry wrapper).
  • Authentication: API key, organization+key, or Azure via AuthProvider interface (ApiKeyProvider, OrganizationApiKeyProvider, AzureApiKeyProvider).
  • Retry with exponential backoff + jitter (only for idempotent methods on 429, 5xx, timeouts).
  • Abortable requests via abortTrigger parameter.
  • SSE streaming parser for real-time responses.
  • WebSocket support for Realtime API.
  • Central OpenAIConfig (timeouts, retry policy, log level, baseUrl, auth).
• Hand-crafted models:
  • No code generation dependencies (no freezed, json_serializable).
  • Minimal runtime dependencies (http, logging, meta, web_socket only).
  • Immutable models with copyWith using sentinel pattern.
  • Full type safety with sealed exception hierarchy.
• Improved DX:
  • Simplified message creation (e.g., ChatMessage.user(), ChatMessage.system()).
  • Explicit streaming methods (createStream() vs create()).
  • Response helpers (.text, .hasToolCalls, .allToolCalls).
  • ChatStreamAccumulator and extension methods (collectText(), textDeltas(), accumulate()).
  • Rich logging with field redaction for sensitive data.
• Full API coverage:
  • Chat completions with tool calling, vision, structured outputs, audio, and predicted outputs.
  • Responses API with built-in tool output types (web search, file search, code interpreter, image generation, MCP).
  • Videos API (Sora) for video generation and remixing.
  • Conversations API for multi-turn conversation management.
  • Containers API for isolated code execution environments.
  • ChatKit API for session and thread management (Beta).
  • Evals API with multiple grader types and data source configurations.
  • Realtime API for WebSocket-based audio conversations.
  • Full Assistants, Threads, Messages, Runs, and Vector Stores API (Beta, separate import).

Breaking Changes

• Resource-based API: Methods reorganized under strongly-typed resources:
  • client.createChatCompletion() → client.chat.completions.create()
  • client.createChatCompletionStream() → client.chat.completions.createStream()
  • client.createEmbedding() → client.embeddings.create()
  • client.createImage() → client.images.generate()
  • client.createSpeech() → client.audio.speech.create()
  • client.createTranscription() → client.audio.transcriptions.create()
  • client.createFineTuningJob() → client.fineTuning.jobs.create()
  • client.uploadFile() → client.files.upload()
  • client.createBatch() → client.batches.create()
• Model class renames:
  • CreateChatCompletionRequest → ChatCompletionCreateRequest
  • ChatCompletionMessage.user(content: ChatCompletionUserMessageContent.string('...')) → ChatMessage.user('...')
  • ChatCompletionMessage.system(content: '...') → ChatMessage.system('...')
  • ChatCompletionTool(type: ..., function: FunctionObject(...)) → Tool.function(...)
  • ChatCompletionModel.modelId('gpt-4o') → 'gpt-4o' (plain string)
  • EmbeddingInput.string('...') → EmbeddingInput.text('...')
  • CreateImageRequest → ImageGenerationRequest
  • ImageSize.v1024x1024 → ImageSize.size1024x1024
• Import structure: Assistants and Realtime APIs moved to separate entry points:
  • import 'package:openai_dart/openai_dart_assistants.dart' for Assistants, Threads, Messages, Runs, Vector Stores
  • import 'package:openai_dart/openai_dart_realtime.dart' for Realtime API
• Configuration: New OpenAIConfig with AuthProvider pattern:
  • OpenAIClient(apiKey: 'KEY') → OpenAIClient(config: OpenAIConfig(authProvider: ApiKeyProvider('KEY')))
  • Or use OpenAIClient.fromEnvironment() to read OPENAI_API_KEY.
  • Or use OpenAIClient.withApiKey('KEY') for quick setup.
• Exceptions: Replaced OpenAIClientException with typed hierarchy:
  • ApiException, AuthenticationException, RateLimitException, NotFoundException, RequestTimeoutException, AbortedException, ConnectionException, ParseException, StreamException.
• Streaming: Use convenience getters and extension methods:
  • event.choices.first.delta.content → event.textDelta
  • .map() callbacks → Dart 3 switch expressions or is type checks.
• Nullable fields: Model.created, Model.ownedBy, ChatCompletion.created are now nullable for OpenAI-compatible provider support.
• Session cleanup: endSession() → close().
• Dependencies: Removed freezed, json_serializable; now minimal (http, logging, meta, web_socket).

See MIGRATION.md for step-by-step examples and mapping tables.

Commits

• BREAKING FEAT: Complete v1.0.0 reimplementation (#24). (ed68e31b)
• BREAKING FEAT: Add type-safe ResponseInput and convenience factories (#29). (015307ea)
• BREAKING FIX: Make created and ownedBy nullable for provider compatibility (#30). (5c56f005)
• FEAT: Add Skills API, response compaction, JSON image editing, and batch endpoints (#34). (98128ade)
• FIX: Pre-release documentation and code fixes (#41). (5616f8f3)
• REFACTOR: Align client package architecture across SDK packages (#37). (cf741ee1)
• REFACTOR: Align API surface across all SDK packages (#36). (ed969cc7)
• DOCS: Refactors repository URLs to new location. (76835268)

• FEAT: Fix formatting issues (#922). (62bca9da)

• FEAT: Add image streaming and new GPT image models (#827). (1218d8c3)
• FEAT: Add ImageGenStreamEvent schema for streaming (#834). (eb640052)
• FEAT: Add ImageGenUsage schema for image generation (#833). (aecf79a9)
• FEAT: Add metadata fields to ImagesResponse (#831). (bd94b4c6)
• FEAT: Add prompt_tokens_details to CompletionUsage (#830). (ede649d1)
• FEAT: Add fine-tuning method parameter and schemas (#828). (99d77425)
• FEAT: Add Batch model and usage fields (#826). (b2933f50)
• FEAT: Add OpenRouter-specific sampling parameters (#825). (3dd9075c)
• FIX: Remove default value from image stream parameter (#829). (d94c7063)
• FIX: Fix OpenRouter reasoning type enum parsing (#810) (#824). (44ab2841)

• REFACTOR: Fix pub format warnings (#809). (640cdefb)

[!CAUTION] This release has breaking changes. See the Migration Guide for upgrade instructions.

• FIX: Correct text content serialization in CreateMessageRequest (#805). (e4569c96)
• FIX: Handle optional space after colon in SSE parser (#779). (9defa827)
• FEAT: Add OpenRouter provider routing support (#794). (6d306bc1)
• FEAT: Add OpenAI-compatible vendor reasoning content support (#793). (e0712c38)
• FEAT: Upgrade to http v1.5.0 (#785). (f7c87790)
• BREAKING BUILD: Require Dart >=3.8.0 (#792). (b887f5c6)

• FEAT: Migrate to Freezed v3 (#773). (f87c8c03)

• FIX: Change CreateChatCompletionRequest.verbosity default value to null (#771). (46d22905)

• FEAT: Add gpt-5 to model catalog (#758). (f92c94ed)
• FEAT: Add support for minimal reasoning effort (#760). (2ebc5506)
• FEAT: Add Verbosity support (#759). (3894da76)

• FEAT: Make CreateChatCompletionStreamResponse.choices field nullable to support Groq's OpenAI-compatible API (#742). (76fbbdc6)
• BUILD: Update dependencies (#751). (250a3c6)

• FEAT: Make Model.object/owned_by fields nullable to support OpenRouter's OpenAI-compatible API (#736). (afa98b8c)
• FEAT: Make Model.created field nullable to support Google's OpenAI-compatible API (#735). (d617e49f)

• FEAT: Make ToolCallChunk.index field nullable to support Gemini OpenAI-compatible API (#733). (19cb49c0)
• FEAT: Make Embedding.index field nullable to support Gemini OpenAI-compatible API (#729). (9d22f197)

• BREAKING FEAT: Align OpenAI API changes (#706). (b8b04ca6)
• FEAT: Add support for web search, gpt-image-1 and list chat completions (#716). (269dea03)
• FEAT: Update OpenAI model catalog (#714). (68df4558)
• FEAT: Change the default value of 'reasoning_effort' from medium to null (#713). (f224572e)
• FEAT: Update dependencies (requires Dart 3.6.0) (#709). (9e3467f7)
• REFACTOR: Remove fetch_client dependency in favor of http v1.3.0 (#659). (0e0a685c)
• REFACTOR: Fix linter issues (#708). (652e7c64)
• DOCS: Fix TruncationObject docs typo. (ee5ed4fd)
• DOCS: Document Azure Assistants API base url (#626). (c3459eea)

• FEAT: Support Predicted Outputs (#613). (315fe0fd)
• FEAT: Support streaming audio responses in chat completions (#615). (6da756a8)
• FEAT: Add gpt-4o-2024-11-20 to model catalog (#614). (bf333081)
• FIX: Default store field to null to support Azure and Groq APIs (#608). (21332960)
• FIX: Make first_id and last_id nullable in list endpoints (#607). (7cfc4ddf)
• DOCS: Update OpenAI endpoints descriptions (#612). (10c66888)
• REFACTOR: Add new lint rules and fix issues (#621). (60b10e00)
• REFACTOR: Upgrade api clients generator version (#610). (0c8750e8)

• FEAT: Add five new voice types to Chat Completions API (#594). (543f2977)

• FEAT: Add support for audio in chat completions (#577). (0fb058cd)
• FEAT: Add support for storing outputs for model distillation and metadata (#578). (c9b8bdf4)
• FEAT: Support multi-modal moderations (#576). (45b9f423)
• FIX: submitThreadToolOutputsToRunStream not returning any events (#574). (00803ac7)
• DOCS: Add xAI to list of OpenAI-compatible APIs (#582). (017cb74f)
• DOCS: Fix assistants API outdated documentation (#579). (624c4128)

• DOCS: Add note about the new openai_realtime_dart client. (44672f0a)

• DOCS: Fix typo. (e7ddd558)

• FEAT: Add OpenAI o1-preview and o1-mini to model catalog (#555). (9ceb5ff9)
• FEAT: Add support for maxCompletionTokens and reasoningTokens (#556). (37d75b61)
• FEAT: Option to include file search results in assistants API (#543). (e916ad3c)

• FEAT: Add support for Structured Outputs (#525). (c7574077)
• FEAT: Add log probabilities for refusal tokens (#534). (8470a24c)
• FEAT: Add gpt-4o-2024-08-06 to model catalog (#522). (563200e0)
• FEAT: Add chatgpt-4o-latest to model catalog (#527). (ec82c760)

• FEAT: Add support for disabling parallel tool calls (#492). (a91e0719)
• FEAT: Add GPT-4o-mini to model catalog (#497). (faa23aee)
• FEAT: Support chunking strategy in file_search tool (#496). (cfa974a9)
• FEAT: Add support for overrides in the file search tool (#491). (89605638)
• FEAT: Allow to customize OpenAI-Beta header (#502). (5fed8dbb)
• FEAT: Add support for service tier (#494). (0838e4b9)

• REFACTOR: Migrate conditional imports to js_interop (#453). (a6a78cfe)

• FEAT: Support FastChat OpenAI-compatible API (#444). (ddaf1f69)
• FIX: Make vector store name optional (#436). (29a46c7f)
• FIX: Fix deserialization of sealed classes (#435). (7b9cf223)

• FIX: Rename CreateRunRequestModel factories names (#429). (fd15793b)
• FIX: Make quote nullable in MessageContentTextAnnotationsFileCitation (#428). (75b95645)

• FEAT: Add GPT-4o to model catalog (#420). (96214307)
• FEAT: Add support for different content types in Assistants API and other fixes (#412). (97acab45)
• FEAT: Add support for completions and embeddings in batch API (#425). (16fe4c68)
• FEAT: Add incomplete status to RunObject (#424). (71b116e6)

• FEAT: Add support for stream_options (#405). (c15714ca)
• FIX: RunStepDetailsToolCalls deserialization in Assistants API v2 (#404). (d76c6aba)

[!CAUTION] This release has breaking changes. See the Migration Guide for upgrade instructions. If you are using the Assistants API v1, please refer to the OpenAI docs to see how to migrate to v2.

• BREAKING FEAT: Migrate OpenAI Assistants API to v2 and add support for vector stores (#402). (45de29a1)
• FEAT: Add support for ChatCompletionToolChoiceMode.required (#402). (45de29a1)

• FEAT: Add temperature, top_p and response format to Assistants API (#384). (1d18290f)

• FEAT: Support for Batch API (#383). (6b89f4a2)
• FEAT: Streaming support for Assistant API (#379). (6ef68196)
• FEAT: Option to specify tool choice in Assistant API (#382). (97d7977a)
• FEAT: JSON mode in Assistant API (#381). (a864dae3)
• FEAT: Max tokens and truncation strategy in Assistant API (#380). (7153167b)
• FEAT: Updated models catalog with GPT-4 Turbo with Vision (#378). (88537540)
• FEAT: Weights & Biases integration for fine-tuning and seed options (#377). (a5fff1bf)
• FEAT: Support for checkpoints in fine-tuning jobs (#376). (69f8e2f9)

• FEAT: Sync OpenAI API (#347). (f296eef6)
• FIX: Have the == implementation use Object instead of dynamic (#334). (89f7b0b9)

• FEAT: Allow to specify OpenAI custom instance (#327). (4744648c)
• FEAT: Update meta and test dependencies (#331). (912370ee)
• DOCS: Update pubspecs. (d23ed89a)

• DOCS: Update CHANGELOG.md. (d0d46534)

• FEAT: Add gpt-4-0125-preview and gpt-4-turbo-preview in model catalog (#309). (f5a78867)
• FEAT: Add text-embedding-3-small and text-embedding-3-large in model catalog (#310). (fda16024)
• FEAT: Add support for shortening embeddings (#311). (c725db0b)

• FEAT: Support Anyscale API client (#303). (e0a3651c)
• FEAT: Support Together AI API (#296). (ca6f23d5)
• FEAT: Support Together AI Embeddings API client (#301). (4a6e1045)
• FEAT: Add usage to Run/RunStep client (#302). (cc6538b5)

• FEAT: Support OpenRouter API (#292). (57699b32)
• FEAT: Remove OpenAI deprecated models (#290). (893b1c51)

• FEAT: Add support for Assistants API (#278). (06de2d5e)

• FIX: Make ChatCompletionNamedToolChoice fields required (#259). (4c7d0436)