@aihubmix/ai-sdk-provider 2.1.0 → 2.2.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @aihubmix/ai-sdk-provider
 
+## 2.2.0
+
+### Minor Changes
+
+- 新增 `baseURL` 配置项:`createAihubmix({ baseURL })` 可覆盖请求 host（默认 `https://aihubmix.com`，末尾斜杠会自动去除）。`/v1`、`/gemini/v1beta` 等路径自动拼接，适用于自建网关 / 代理场景。
+- 修复 `fetch` 透传:为 Claude、Gemini、Responses 三类模型补上 `fetch` 选项,使自定义 `fetch` 对所有 sub-model 生效（此前仅 OpenAI-compatible / completion / transcription / speech 生效）。
+
 ## 2.1.0
 
 ### Minor Changes

package/README.ja.md

@@ -66,6 +66,43 @@ const aihubmix = createAihubmix({
 });
 ```
 
+### `appCode`（任意）
+
+すべてのリクエストには `APP-Code` ヘッダーが付与されます。デフォルトでは本パッケージに組み込まれた値が使われるため、**通常は設定不要です**。独自の app code がある場合は、`appCode` を渡してデフォルト値を上書きできます：
+
+```ts
+import { createAihubmix } from '@aihubmix/ai-sdk-provider';
+
+const aihubmix = createAihubmix({
+  apiKey: 'your-api-key-here',
+  appCode: 'YOUR-APP-CODE', // 任意；省略時は組み込みのデフォルト値にフォールバック
+});
+```
+
+### `baseURL`（任意）
+
+デフォルトではすべてのリクエストは `https://aihubmix.com` に送信されます。独自のゲートウェイやプロキシ経由にする場合は `baseURL` を渡します（末尾のスラッシュは自動的に除去されます）。`/v1` や `/gemini/v1beta` などのパスは自動的に付与されます：
+
+```ts
+import { createAihubmix } from '@aihubmix/ai-sdk-provider';
+
+const aihubmix = createAihubmix({
+  apiKey: 'your-api-key-here',
+  baseURL: 'https://your-gateway.example.com', // 任意；デフォルトは https://aihubmix.com
+});
+```
+
+### カスタム `fetch`
+
+カスタム `fetch` 実装（プロキシ、ロギング、テスト用）を渡せます。OpenAI互換、Claude、Gemini、Responses、文字起こし、音声のすべてのモデルに転送されます：
+
+```ts
+const aihubmix = createAihubmix({
+  apiKey: 'your-api-key-here',
+  fetch: myCustomFetch,
+});
+```
+
 ## 使用
 
 まず、必要な関数をインポートします：

package/README.md

@@ -67,6 +67,50 @@ const aihubmix = createAihubmix({
 });
 ```
 
+### `appCode` (optional)
+
+Every request carries an `APP-Code` header. By default it uses the value
+built into this package, so **you do not need to set it**. If you have your
+own app code, pass `appCode` to override the default:
+
+```ts
+import { createAihubmix } from '@aihubmix/ai-sdk-provider';
+
+const aihubmix = createAihubmix({
+  apiKey: 'your-api-key-here',
+  appCode: 'YOUR-APP-CODE', // optional; falls back to the built-in default when omitted
+});
+```
+
+### `baseURL` (optional)
+
+By default all requests go to `https://aihubmix.com`. To route through your
+own gateway or proxy, pass `baseURL` (a trailing slash is allowed and
+stripped). Paths such as `/v1` and `/gemini/v1beta` are appended
+automatically:
+
+```ts
+import { createAihubmix } from '@aihubmix/ai-sdk-provider';
+
+const aihubmix = createAihubmix({
+  apiKey: 'your-api-key-here',
+  baseURL: 'https://your-gateway.example.com', // optional; defaults to https://aihubmix.com
+});
+```
+
+### Custom `fetch`
+
+You may pass a custom `fetch` implementation (for proxies, logging, or
+testing). It is forwarded to every model — OpenAI-compatible, Claude,
+Gemini, Responses, transcription, and speech:
+
+```ts
+const aihubmix = createAihubmix({
+  apiKey: 'your-api-key-here',
+  fetch: myCustomFetch,
+});
+```
+
 ## Usage
 
 First, import the necessary functions:

package/README.zh.md

@@ -66,6 +66,43 @@ const aihubmix = createAihubmix({
 });
 ```
 
+### `appCode`（可选）
+
+每个请求都会携带 `APP-Code` 请求头。默认使用本包内置的值，因此**通常无需设置**。如果你有自己的 app code，可传入 `appCode` 覆盖默认值：
+
+```ts
+import { createAihubmix } from '@aihubmix/ai-sdk-provider';
+
+const aihubmix = createAihubmix({
+  apiKey: 'your-api-key-here',
+  appCode: 'YOUR-APP-CODE', // 可选；不传时回退到内置默认值
+});
+```
+
+### `baseURL`（可选）
+
+默认所有请求发往 `https://aihubmix.com`。若要走自建网关或代理，可传入 `baseURL`（末尾斜杠会自动去除）。`/v1`、`/gemini/v1beta` 等路径会自动拼接：
+
+```ts
+import { createAihubmix } from '@aihubmix/ai-sdk-provider';
+
+const aihubmix = createAihubmix({
+  apiKey: 'your-api-key-here',
+  baseURL: 'https://your-gateway.example.com', // 可选；默认 https://aihubmix.com
+});
+```
+
+### 自定义 `fetch`
+
+可传入自定义 `fetch` 实现（用于代理、日志或测试）。它会透传给所有模型 —— OpenAI 兼容、Claude、Gemini、Responses、转录与语音：
+
+```ts
+const aihubmix = createAihubmix({
+  apiKey: 'your-api-key-here',
+  fetch: myCustomFetch,
+});
+```
+
 ## 使用
 
 首先，导入必要的函数：

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aihubmix/ai-sdk-provider",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "license": "Apache-2.0",
   "packageManager": "pnpm@10.28.0",
   "sideEffects": false,