Refactor for AIMLAPI repo and update version to 2.8.1-beta.1

Updated repository references from 'api-sdk-python' to 'aimlapi-sdk-python' throughout the codebase and workflows. Changed version to 2.8.1-beta.1 in pyproject.toml, .release-please-manifest.json, and _version.py. Added a manual version bump workflow, removed OpenAI-specific release workflows, and adjusted CI and PyPI publishing logic for AIMLAPI. Cleaned up imports and ordering in several modules, improved README with example capabilities, and removed deprecated uploads example and test files.

Author: D1m7asis

.github/workflows/ci.yml

@@ -16,7 +16,7 @@ jobs:
   lint:
     timeout-minutes: 10
     name: lint
-    runs-on: ${{ github.repository == 'stainless-sdks/openai-python' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
+    runs-on: ubuntu-latest
     if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
     steps:
       - uses: actions/checkout@v4
@@ -42,7 +42,7 @@ jobs:
     permissions:
       contents: read
       id-token: write
-    runs-on: ${{ github.repository == 'stainless-sdks/openai-python' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
+    runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
 
@@ -60,25 +60,10 @@ jobs:
       - name: Run build
         run: rye build
 
-      - name: Get GitHub OIDC Token
-        if: github.repository == 'stainless-sdks/openai-python'
-        id: github-oidc
-        uses: actions/github-script@v6
-        with:
-          script: core.setOutput('github_token', await core.getIDToken());
-
-      - name: Upload tarball
-        if: github.repository == 'stainless-sdks/openai-python'
-        env:
-          URL: https://pkg.stainless.com/s
-          AUTH: ${{ steps.github-oidc.outputs.github_token }}
-          SHA: ${{ github.sha }}
-        run: ./scripts/utils/upload-artifact.sh
-
   test:
     timeout-minutes: 10
     name: test
-    runs-on: ${{ github.repository == 'stainless-sdks/openai-python' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
+    runs-on: ubuntu-latest
     if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
     steps:
       - uses: actions/checkout@v4
@@ -100,8 +85,8 @@ jobs:
   examples:
     timeout-minutes: 10
     name: examples
-    runs-on: ${{ github.repository == 'stainless-sdks/openai-python' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
-    if: github.repository == 'openai/openai-python' && (github.event_name == 'push' || github.event.pull_request.head.repo.fork)
+    runs-on: ubuntu-latest
+    if: github.repository == 'aimlapi/aimlapi-sdk-python' && (github.event_name == 'push' || github.event.pull_request.head.repo.full_name == github.repository)
 
     steps:
       - uses: actions/checkout@v4
@@ -118,10 +103,10 @@ jobs:
           rye sync --all-features
 
       - env:
-          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+          AIML_API_KEY: ${{ secrets.AIML_API_KEY || secrets.AIMLAPI_API_KEY }}
         run: |
             rye run python examples/demo.py
       - env:
-          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+          AIML_API_KEY: ${{ secrets.AIML_API_KEY || secrets.AIMLAPI_API_KEY }}
         run: |
             rye run python examples/async_demo.py

.github/workflows/create-releases.yml

@@ -9,7 +9,7 @@ jobs:
   detect_breaking_changes:
     runs-on: 'ubuntu-latest'
     name: detect-breaking-changes
-    if: github.repository == 'openai/openai-python'
+    if: github.repository == 'aimlapi/aimlapi-sdk-python'
     steps:
       - name: Calculate fetch-depth
         run: |
@@ -39,4 +39,4 @@ jobs:
           # Try to check out previous versions of the breaking change detection script. This ensures that
           # we still detect breaking changes when entire files and their tests are removed.
           git checkout "${{ github.event.pull_request.base.sha }}" -- ./scripts/detect-breaking-changes 2>/dev/null || true
-          ./scripts/detect-breaking-changes ${{ github.event.pull_request.base.sha }}
+          ./scripts/detect-breaking-changes ${{ github.event.pull_request.base.sha }}

.github/workflows/detect-breaking-changes.yml

@@ -0,0 +1,102 @@
+name: Manual bump version
+
+on:
+  workflow_dispatch:
+    inputs:
+      new_version:
+        description: "New version (e.g. 0.5.3)"
+        required: true
+        type: string
+
+permissions:
+  contents: write
+
+jobs:
+  bump-version:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Update version in files
+        run: |
+          python - << 'PY'
+          import re
+          import json
+          import pathlib
+          import sys
+
+          new_version = "${{ github.event.inputs.new_version }}".strip()
+          if not new_version:
+              print("No version provided", file=sys.stderr)
+              sys.exit(1)
+
+          root = pathlib.Path(".")
+
+          # 1) Update pyproject.toml
+          pyproject = root / "pyproject.toml"
+          text = pyproject.read_text(encoding="utf-8")
+          text, count = re.subn(
+              r'(?m)^(version\s*=\s*")[^"]+(")',
+              rf'\1{new_version}\2',
+              text,
+          )
+          if count == 0:
+              print('Could not find version = "..." in pyproject.toml', file=sys.stderr)
+              sys.exit(1)
+          pyproject.write_text(text, encoding="utf-8")
+          print("Updated pyproject.toml")
+
+          # 2) Update src/aimlapi/_version.py
+          version_py = root / "src" / "aimlapi" / "_version.py"
+          if version_py.exists():
+              text = version_py.read_text(encoding="utf-8")
+              text, _ = re.subn(
+                  r'(?m)^__version__\s*=\s*"[^\"]+"',
+                  f'__version__ = "{new_version}"',
+                  text,
+              )
+              version_py.write_text(text, encoding="utf-8")
+              print("Updated src/aimlapi/_version.py")
+          else:
+              print("src/aimlapi/_version.py not found, skipping")
+
+          # 3) Update .release-please-manifest.json (if present)
+          manifest = root / ".release-please-manifest.json"
+          if manifest.exists():
+              data = json.loads(manifest.read_text(encoding="utf-8"))
+
+              if isinstance(data, dict):
+                  for key in list(data.keys()):
+                      data[key] = new_version
+              else:
+                  print("Unexpected manifest format, skipping")
+                  sys.exit(1)
+
+              manifest.write_text(json.dumps(data, indent=2) + "\n", encoding="utf-8")
+              print("Updated .release-please-manifest.json")
+          else:
+              print(".release-please-manifest.json not found, skipping")
+
+          PY
+
+      - name: Commit and push
+        env:
+          NEW_VERSION: ${{ github.event.inputs.new_version }}
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+
+          git add pyproject.toml src/aimlapi/_version.py .release-please-manifest.json 2> /dev/null || true
+
+          if git diff --cached --quiet; then
+            echo "No changes to commit"
+            exit 0
+
+          fi
+
+          git commit -m "chore: bump version to ${NEW_VERSION}"
+          git push

.github/workflows/manual-bump-version.yml

@@ -1,5 +1,5 @@
-# workflow for re-running publishing to PyPI in case it fails for some reason
-# you can run this workflow by navigating to https://www.github.com/openai/openai-python/actions/workflows/publish-pypi.yml
+# Workflow for re-running publishing to PyPI in case it fails for some reason
+# You can run this workflow by navigating to https://www.github.com/aimlapi/aimlapi-sdk-python/actions/workflows/publish-pypi.yml
 name: Publish PyPI
 on:
   workflow_dispatch:
@@ -25,4 +25,4 @@ jobs:
         run: |
           bash ./bin/publish-pypi
         env:
-          PYPI_TOKEN: ${{ secrets.OPENAI_PYPI_TOKEN || secrets.PYPI_TOKEN }}
+          PYPI_TOKEN: ${{ secrets.AIMLAPI_PYPI_TOKEN || secrets.PYPI_TOKEN }}

.github/workflows/publish-pypi.yml

@@ -1,3 +1,3 @@
 {
-  ".": "2.8.1"
+  ".": "2.8.1-beta.1"
 }

.github/workflows/release-doctor.yml

@@ -2,6 +2,18 @@
 
 AI/ML API provides access to 300+ AI models (including DeepSeek, Gemini, and ChatGPT) with enterprise-grade rate limits and uptime. This package is an OpenAI-compatible fork of the official OpenAI Python client and defaults to the AI/ML API endpoints so you can reuse familiar APIs while targeting [api.aimlapi.com](https://api.aimlapi.com/v1/).
 
+**Overview of example capabilities:**
+
+* **Chat completions** — sync, async, and streaming
+* **Responses API streaming** — incremental response events
+* **Vision and image generation** — creating and processing visual content
+* **Speech generation and transcription** — TTS and STT capabilities
+* **Video generation** — multi-step video creation and retrieval
+* **Structured outputs** — schema-validated responses
+* **Tool calling** — function and tool execution via the model
+* **Azure / Entra authentication flows** — enterprise identity support
+* **Modular client usage** — flexible, component-based API design
+
 - Models: https://aimlapi.com/models
 - REST API reference: https://docs.aimlapi.com/
 - Example endpoints: https://api.aimlapi.com/v1/ and https://api.aimlapi.com/v1/chat/completions

.release-please-manifest.json

@@ -1,8 +1,9 @@
 #!/usr/bin/env python
 
-from aimlapi import AIMLAPI
 import base64
 
+from aimlapi import AIMLAPI
+
 # gets AIML_API_KEY from your environment variables
 aimlapi = AIMLAPI()