PackageTrack
Sign in Get early access

openai_dart

Dart client for the OpenAI REST APIs and realtime WebSocket/WebRTC workflows with type-safe access to GPT, image, audio, and Responses APIs.

8.0.0 32K downloads/mo #1807 most downloaded on pub.dev davidmigloz/ai_clients_dart

What this package is like to depend on

Last release 22 days ago

01 Aug 2026

Release timing varies

gaps range from 8 days to 2 months

Nearly every release is documented

notes for 65 of 65 stable releases

Nothing withdrawn

no release was ever pulled

3 years old

66 releases · first in 2023

25 releases in the last 12 months

see the full history below

Release timeline

66 releases · Oct 2023 to Aug 2026
2024 2025 2026
Release Pre-release

Releases

latest 60 of 66
  1. 8.0.0 01 Aug 2026
    Release notes

    [!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)
    Open source →
  2. 7.0.1 05 Jul 2026
    Release notes

    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)
    Open source →
  3. 7.0.0 21 Jun 2026
    Release notes

    [!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 modeReasoningConfig.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)
    Open source →
  4. 6.2.0 06 Jun 2026
    Release notes

    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)
    Open source →
  5. 6.1.0 02 Jun 2026
    Release notes

    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)
    Open source →
  6. 6.0.0 24 May 2026
    Release notes

    [!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)
    Open source →
  7. 5.0.0 02 May 2026
    Release notes

    [!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)
    Open source →
  8. 4.3.0 21 Apr 2026
    Release notes

    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)
    Open source →
  9. 4.2.0 16 Apr 2026
    Release notes

    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)
    Open source →
  10. 4.1.0 09 Apr 2026
    Release notes

    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)
    Open source →
  11. 4.0.1 02 Apr 2026
    Release notes

    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)
    Open source →
  12. 4.0.0 29 Mar 2026
    Release notes

    [!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)
    Open source →
  13. 3.0.0 27 Mar 2026
    Release notes

    [!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)
    Open source →
  14. 2.0.0 16 Mar 2026
    Release notes

    [!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)
    Open source →
  15. 1.4.0 10 Mar 2026
    Release notes

    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)
    Open source →
  16. 1.3.0 06 Mar 2026
    Release notes

    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)
    Open source →
  17. 1.2.0 06 Mar 2026
    Release notes

    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)
    Open source →
  18. 1.1.0 04 Mar 2026
    Release notes

    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)
    Open source →
  19. 1.0.1 04 Mar 2026
    Release notes

    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)
    Open source →
  20. 1.0.0 03 Mar 2026
    Release notes

    [!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:
      • CreateChatCompletionRequestChatCompletionCreateRequest
      • 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('...')
      • CreateImageRequestImageGenerationRequest
      • ImageSize.v1024x1024ImageSize.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.contentevent.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)
    Open source →
  21. 0.6.2 27 Dec 2025
    Release notes
    Open source →
  22. 0.6.1 20 Dec 2025
    Release notes
    • 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)
    Open source →
  23. 0.6.0 15 Oct 2025
    Release notes

    [!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)
    Open source →
  24. 0.6.0+1 16 Oct 2025
    Release notes
    Open source →
  25. 0.5.5 31 Aug 2025
    Release notes
    Open source →
  26. 0.5.4 10 Aug 2025
    Release notes
    Open source →
  27. 0.5.4+1 25 Aug 2025
    Release notes
    • FIX: Change CreateChatCompletionRequest.verbosity default value to null (#771). (46d22905)
    Open source →
  28. 0.5.3 30 Jul 2025
    Release notes
    • FEAT: Make CreateChatCompletionStreamResponse.choices field nullable to support Groq's OpenAI-compatible API (#742). (76fbbdc6)
    • BUILD: Update dependencies (#751). (250a3c6)
    Open source →
  29. 0.5.2 20 Jun 2025
    Release notes
    • 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)
    Open source →
  30. 0.5.1 18 Jun 2025
    Release notes
    • 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)
    Open source →
  31. 0.5.0 12 Jun 2025
    Release notes
    • 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)
    Open source →
  32. 0.4.5 16 Dec 2024
    Release notes
    • 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)
    Open source →
  33. 0.4.4 31 Oct 2024
    Release notes
    • FEAT: Add five new voice types to Chat Completions API (#594). (543f2977)
    Open source →
  34. 0.4.3 29 Oct 2024
    Release notes
    • 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)
    Open source →
  35. 0.4.2 25 Sep 2024
    Release notes
    • 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)
    Open source →
  36. 0.4.2+1 08 Oct 2024
    Release notes
    Open source →
  37. 0.4.2+2 14 Oct 2024
    Release notes
    Open source →
  38. 0.4.1 22 Aug 2024
    Release notes
    • 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)
    Open source →
  39. 0.4.0 26 Jul 2024
    Release notes
    • 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)
    Open source →
  40. 0.3.3 31 May 2024
    Release notes
    • FEAT: Support FastChat OpenAI-compatible API (#444). (ddaf1f69)
    • FIX: Make vector store name optional (#436). (29a46c7f)
    • FIX: Fix deserialization of sealed classes (#435). (7b9cf223)
    Open source →
  41. 0.3.3+1 02 Jul 2024
    Release notes
    • REFACTOR: Migrate conditional imports to js_interop (#453). (a6a78cfe)
    Open source →
  42. 0.3.2 14 May 2024
    Release notes
    • 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)
    Open source →
  43. 0.3.2+1 20 May 2024
    Release notes
    • FIX: Rename CreateRunRequestModel factories names (#429). (fd15793b)
    • FIX: Make quote nullable in MessageContentTextAnnotationsFileCitation (#428). (75b95645)
    Open source →
  44. 0.3.1 09 May 2024
    Release notes
    • FEAT: Add support for stream_options (#405). (c15714ca)
    • FIX: RunStepDetailsToolCalls deserialization in Assistants API v2 (#404). (d76c6aba)
    Open source →
  45. 0.3.0 06 May 2024
    Release notes

    [!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)
    Open source →
  46. 0.2.2 30 Apr 2024
    Release notes
    • FEAT: Add temperature, top_p and response format to Assistants API (#384). (1d18290f)
    Open source →
  47. 0.2.1 16 Apr 2024
    Release notes
    • 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)
    Open source →
  48. 0.2.0 10 Apr 2024
    Release notes
    • FEAT: Sync OpenAI API (#347). (f296eef6)
    • FIX: Have the == implementation use Object instead of dynamic (#334). (89f7b0b9)
    Open source →
  49. 0.1.7 15 Feb 2024
    Release notes
    Open source →
  50. 0.1.6 26 Jan 2024
    Release notes
    • 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)
    Open source →
  51. 0.1.6+1 31 Jan 2024
    Release notes
    Open source →
  52. 0.1.5 20 Jan 2024
    Release notes
    Open source →
  53. 0.1.4 13 Jan 2024
    Release notes
    Open source →
  54. 0.1.3 26 Dec 2023
    Release notes
    Open source →
  55. 0.1.2 05 Dec 2023
    Release notes
    • FEAT: Allow to update OpenAI key without having to recreate the wrapper (#246). (05739bd1)
    Open source →
  56. 0.1.2+1 12 Dec 2023
    Release notes
    • FIX: Make ChatCompletionNamedToolChoice fields required (#259). (4c7d0436)
    Open source →
  57. 0.1.1 17 Nov 2023
    Release notes
    Open source →
  58. 0.1.1+1 17 Nov 2023
    Release notes
    • FIX: Fetch requests with big payloads dropping connection (#226). (1e771098)
    Open source →
  59. 0.1.1+2 20 Nov 2023
    Release notes
    Open source →
  60. 0.1.0 15 Nov 2023
    Release notes

    [!CAUTION] This release has breaking changes. See the Migration Guide for upgrade instructions. Migration guides: new factories and multi-modal

    • BREAKING FEAT: Add multi-modal support (#218). (14c8e7ef)
    • BREAKING FEAT: Rename factory const to more meaningful names (#215). (7e4602fa)
    • FEAT: Add gpt-3.5-turbo-1106 chat model (#217). (73f37915)
    • REFACTOR: Improve request error handling (#214). (4a9f3d33)
    Open source →

Every package, every release, already written down.

The archive is open and free. Watching your own project is what we are building next.

Browse the archive