Alphawrite SDK

Alphawrite 千问 API 官方 SDK。同一份代码覆盖微信小程序、浏览器与 Node 18+，零运行时依赖。

版本 1.0.0 发布日期 2026-09-23 许可证 内部使用体积 43.5 KB（tgz）

运行环境

环境	传输实现	流式
Node.js 18+	`fetch`	ReadableStream
浏览器	`fetch`	ReadableStream
微信小程序	`wx.request`	enableChunked + onChunkReceived

环境自动检测：存在 wx.request 时走小程序适配器，否则走 fetch。

下载文件与校验值

文件	用途	SHA-256
alphawrite-sdk-1.0.0.tgz	npm 安装包（含 dist、类型定义、README）	1a337441abb6395ad7aa4d02c17eb0b20c8b389aa54a91d83a27fe47f4518c9a
alphawrite-sdk-1.0.0.global.js	UMD 单文件，`<script>` 直接引入或小程序 require	94ee1bfa834a23ff23ee26d5da8dcad76efb1900d5cc9c78a9f1ce074d6c8d13
alphawrite-sdk-1.0.0.mjs	ESM 模块	5b620dce9802b53cf66c4f21c26abb95dd4cddcd6c7bb6a00dbcf39592fec56f
alphawrite-sdk-1.0.0.d.ts	TypeScript 类型定义	见 tgz 内文件

安装

npm install ./alphawrite-sdk-1.0.0.tgz

快速开始

import { Alphawrite } from 'alphawrite-sdk'

const client = new Alphawrite({
  apiKey: process.env.ALPHAWRITE_KEY,
  baseURL: 'https://model.alphawrite.cn/v1',
  mode: 'server'
})

const r = await client.chat({
  model: 'qwen3.8-flash',
  messages: [{ role: 'user', content: '你好' }]
})
console.log(r.content)

示例

场景	文件
Node / 服务端	examples/node.mjs
浏览器	examples/browser.html
微信小程序	examples/miniprogram.js

安全提醒：微信小程序和浏览器里的代码、请求头、运行时参数都可以被提取， 长期 API Key 绝不能写在前端。正确做法是小程序 / 页面先调你们自己的业务后端换取 短期 Token，再由后端持有长期密钥去调用 model.alphawrite.cn。 SDK 的 mode: 'client' 会在初始化时给出提醒。

接口对应关系

SDK 方法	接口
`models()`	`GET /v1/models`
`chat(opts)`	`POST /v1/chat/completions`
`responses(opts)`	`POST /v1/responses`
`messages(opts)`	`POST /v1/messages`