openai/openai-java

View on GitHub

The official Java library for the OpenAI API

Stars: 1.5k
Forks: 264
Open beginner issues: 0
Indexed issues: 64
Avg merge: 9h 46m
Merged PRs (30d): 96

Dominant language: Kotlin
License: Apache-2.0
Last GitHub push: Sep 19, 2026
Latest indexed: Sep 19, 2026
Contributing guide: Contributing guide
Code of conduct: No code of conduct
Beginner labels: No beginner labels indexed

Beginner friendly Everything

Open All

64 open issues indexed

AsyncStreamResponse can hang when the subscriber executor rejects work Open

Difficulty 3/5 1-2 days Newbie friendliness 74/100

openai/openai-java#973 · Opened Sep 4, 2026
Regression of #371 — `ResponsesModel.toString()` leaks into Azure deployment URL path via `PrepareRequest.modelNameOrNull()` Open

Difficulty 3/5 1-2 days Newbie friendliness 68/100

openai/openai-java#967 · 2 comments · Opened Sep 3, 2026
Feature proposal: official scripted HTTP test client for offline SDK tests Open

Difficulty 5/5 Over a week Newbie friendliness 35/100

openai/openai-java#956 · Opened Aug 31, 2026
Async internal plumbing bypasses both `dispatcherExecutorService` and `streamHandlerExecutor`, forcing a hop through `ForkJoinPool.commonPool()` Open

Difficulty 5/5 Over a week Newbie friendliness 35/100

openai/openai-java#952 · Opened Aug 28, 2026
RetryingHttpClient.close skips sleeper cleanup when delegate close fails Open

Difficulty 2/5 1-3 hours Newbie friendliness 78/100

openai/openai-java#890 · Opened Aug 18, 2026
DefaultSleeper.close can strand pending sleepAsync futures Open

Difficulty 3/5 1-2 days Newbie friendliness 72/100

openai/openai-java#889 · Opened Aug 18, 2026
RetryingHttpClient.executeAsync skips retry handling when delegate throws synchronously Open

Difficulty 3/5 1-2 days Newbie friendliness 78/100

openai/openai-java#888 · Opened Aug 18, 2026
HttpRequest.url() logs spaces in path segments as literal plus signs Open

Difficulty 2/5 1-3 hours Newbie friendliness 78/100

openai/openai-java#886 · 2 comments · Opened Aug 18, 2026
Phantom-reachable wrappers can close resources twice after explicit cleanup Open

Difficulty 4/5 3-5 days Newbie friendliness 66/100

openai/openai-java#884 · Opened Aug 18, 2026
WorkloadIdentityHttpClient can leak its delegate when auth cleanup throws Open

Difficulty 3/5 1-2 days Newbie friendliness 76/100

openai/openai-java#882 · Opened Aug 18, 2026
fix: clear WorkloadIdentityAuth refresh state after synchronous provider failures Open

Difficulty 3/5 1-2 days Newbie friendliness 74/100

openai/openai-java#852 · Opened Aug 10, 2026
fix: closing a withOptions client closes shared resources Open

Difficulty 4/5 3-5 days Newbie friendliness 48/100

openai/openai-java#850 · Opened Aug 10, 2026
Upgrade from Jackson 2 to Jackson 3 Open

Difficulty 4/5 3-5 days Newbie friendliness 48/100

openai/openai-java#847 · 1 reaction · Opened Aug 7, 2026
openai-java-core the size of more than 40m, hope to optimize, split the dependency Open

Difficulty 5/5 Over a week Newbie friendliness 25/100

openai/openai-java#821 · Opened Jul 30, 2026
Make diarized transcription duration and task optional Open

Difficulty 2/5 1-3 hours Newbie friendliness 68/100

openai/openai-java#802 · 2 comments · 3 reactions · Opened Jul 19, 2026
swagger-annotations api dependency conflicts with swagger-annotations-jakarta Open

Difficulty 3/5 1-2 days Newbie friendliness 58/100

openai/openai-java#796 · Opened Jul 17, 2026
OpenAI Java lib 4.41.0 throws OpenAIInvalidDataException in OrganizationCostsResult when parsing amount values Open

Difficulty 3/5 1-2 days Newbie friendliness 55/100

openai/openai-java#769 · 2 comments · Opened Jul 6, 2026
Bug: Turkish Locale - Potential Header/Key resolution failure due to case-insensitive TreeMap serialization Open

Difficulty 2/5 1-3 hours Newbie friendliness 72/100

openai/openai-java#755 · 1 comment · Opened Jun 6, 2026
Allow custom executor/thread pool for async HTTP calls in CompletionServiceAsyncImpl Open

Difficulty 4/5 3-5 days Newbie friendliness 65/100

openai/openai-java#754 · 1 comment · Opened Jun 5, 2026
Support Jackson 3 / Spring Boot 4 compatibility path Open

Difficulty 5/5 Over a week Newbie friendliness 30/100

openai/openai-java#748 · 4 comments · 2 reactions · Opened May 20, 2026
Non-2xx responses are not closed when error handling throws Open

Difficulty 3/5 1-2 days Newbie friendliness 65/100

openai/openai-java#745 · Opened May 19, 2026
OpenAI Java SDK issues with Azure OpenAI Open

bug sdk upstream

Difficulty 3/5 1-2 days Newbie friendliness 55/100

openai/openai-java#715 · 1 reaction · Opened Apr 7, 2026
Responses API: undocumented reasoning+message pairing constraint breaks multi-turn conversations Open

bug spec

Difficulty 5/5 Over a week Newbie friendliness 35/100

openai/openai-java#710 · Opened Mar 25, 2026
how to upload Video Input with openai-java Open

question sdk

Difficulty 5/5 Over a week Newbie friendliness 15/100

openai/openai-java#700 · Opened Mar 13, 2026
Make request/response info available in `OpenAIException` when available Open

enhancement sdk

Difficulty 3/5 1-2 days Newbie friendliness 42/100

openai/openai-java#690 · 3 comments · Opened Feb 19, 2026
Missing `name` field in Realtime function-call event in OpenAPI spec breaks generated SDK models Open

bug spec

Difficulty 4/5 3-5 days Newbie friendliness 45/100

openai/openai-java#683 · 2 comments · Opened Jan 27, 2026
Error streaming back the ResponseFunctionCallArgumentsDoneEvent Open

bug spec

Difficulty 2/5 1-3 hours Newbie friendliness 45/100

openai/openai-java#682 · 1 comment · Opened Jan 26, 2026
Support making raw requests Open

enhancement sdk

Difficulty 3/5 1-2 days Newbie friendliness 45/100

openai/openai-java#678 · Opened Jan 14, 2026
How to use Speech.stream_format=sse Open

bug sdk

Difficulty 3/5 1-2 days Newbie friendliness 25/100

openai/openai-java#672 · Opened Dec 31, 2025
Feat. Request: HttpRequest/HttpResponse convenience methods. Open

enhancement sdk

Difficulty 4/5 3-5 days Newbie friendliness 35/100

openai/openai-java#664 · 2 comments · Opened Dec 10, 2025
com.openai.errors.BadRequestException: 400: Prediction is enabled only for api versions 2025-01-01-preview and later Open

question sdk

Difficulty 4/5 3-5 days Newbie friendliness 25/100

openai/openai-java#662 · 2 comments · Opened Dec 5, 2025
How to set the responseFormat as JsonSchema without a dedicated record/class Open

question sdk

Difficulty 2/5 1-3 hours Newbie friendliness 35/100

openai/openai-java#655 · 1 comment · 2 reactions · Opened Nov 20, 2025
Cancelling the completable future of an OpenAI call doesn't cancel the underlying OkHttp request Open

bug sdk

Difficulty 3/5 1-2 days Newbie friendliness 55/100

openai/openai-java#654 · 6 comments · 2 reactions · Opened Nov 19, 2025
Transcription API response is missing diarized data for response_format=diarized_json Open

bug sdk

Difficulty 2/5 1-3 hours Newbie friendliness 72/100

openai/openai-java#652 · 2 comments · Opened Nov 17, 2025
Cannot retrieve the full file content Open

bug sdk

Difficulty 4/5 3-5 days Newbie friendliness 30/100

openai/openai-java#650 · Opened Nov 13, 2025
Cannot use MultiGrader object inside FineTune service API Open

bug spec

Difficulty 3/5 1-2 days Newbie friendliness 45/100

openai/openai-java#647 · Opened Nov 10, 2025
Why is ChatCompletionService#createStreaming blocking the thread for a significant amount of time Open

bug sdk

Difficulty 4/5 3-5 days Newbie friendliness 32/100

openai/openai-java#646 · Opened Nov 9, 2025
Potential misleading documentation on OpenAiClientAsync Open

documentation question sdk

Difficulty 3/5 1-2 days Newbie friendliness 45/100

openai/openai-java#644 · Opened Nov 3, 2025
ChatKit usecase without frontend Open

documentation question sdk

Difficulty 4/5 3-5 days Newbie friendliness 35/100

openai/openai-java#643 · Opened Oct 31, 2025
`SpeechCreateParams.Voice` constants do not match the voices lists in the speech synthesis OpenAI API docs Open

bug spec

Difficulty 2/5 1-3 hours Newbie friendliness 45/100

openai/openai-java#642 · 1 reaction · Opened Oct 29, 2025
IDEA seems to be unable to recognize additional-spring-configuration-metadata.json Open

question sdk

Difficulty 4/5 3-5 days Newbie friendliness 25/100

openai/openai-java#631 · 4 comments · Opened Oct 15, 2025
Response object does not contain all elements Open

question sdk

Difficulty 3/5 1-2 days Newbie friendliness 35/100

openai/openai-java#625 · 1 comment · Opened Oct 4, 2025
Update `openai.com` with Java examples Open

api documentation

Difficulty 4/5 3-5 days Newbie friendliness 30/100

openai/openai-java#624 · 1 comment · 2 reactions · Opened Oct 4, 2025
SDK Size Open

question sdk

Difficulty 5/5 Over a week Newbie friendliness 35/100

openai/openai-java#602 · 7 comments · 7 reactions · Opened Aug 30, 2025
DeepResearch returns empty ResponseFunctionWebSearch.action after exceeding maxToolCalls Open

api bug

Difficulty 4/5 3-5 days Newbie friendliness 35/100

openai/openai-java#600 · Opened Aug 28, 2025
Expose x-request-id in SSE streaming responses for Java SDK Open

enhancement sdk

Difficulty 4/5 3-5 days Newbie friendliness 35/100

openai/openai-java#593 · 2 comments · Opened Aug 21, 2025
Unexpected WebSearchTool loop for some prompts when using additional tools Open

api bug

Difficulty 4/5 3-5 days Newbie friendliness 35/100

openai/openai-java#591 · 3 comments · 2 reactions · Opened Aug 20, 2025
ResponseOutputMessage requires id and status as mandatory even for non-stored responses Open

bug spec

Difficulty 3/5 1-2 days Newbie friendliness 45/100

openai/openai-java#585 · Opened Aug 15, 2025
Deserializing ResponseInputItem results in unknown state Open

bug spec

Difficulty 3/5 1-2 days Newbie friendliness 35/100

openai/openai-java#584 · 2 comments · Opened Aug 15, 2025
Request for Java-friendly support when customizing OkHttp (current implementation in Kotlin causes difficulties) Open

enhancement sdk

Difficulty 5/5 Over a week Newbie friendliness 30/100

openai/openai-java#574 · 2 comments · 9 reactions · Opened Aug 9, 2025

openai/openai-java

Get new issues in your inbox