API 中转站 · 技术文档

1基本信息

2模型清单

模型名即路由：请求按 model 字段自动转发到对应上游，无需关心上游差异。新模型上架会在此页更新。

3对话接口 POST /chat/completions

请求参数

未列出的 OpenAI 参数会原样透传给上游，上游不支持的参数会被其忽略。

非流式响应结构

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "created": 1787000000,
  "model": "qwen-plus",
  "choices": [{
    "index": 0,
    "message": {"role": "assistant", "content": "你好！"},
    "finish_reason": "stop"
  }],
  "usage": {"prompt_tokens": 12, "completion_tokens": 61, "total_tokens": 73}
}

用量（usage）会同时记录在你的账户里，可在「我的 → API 中转站」查看今日/累计消耗。

4流式协议（SSE）

请求加 "stream": true 后，响应为 text/event-stream，逐行推送：

data: {"id":"chatcmpl-xxx","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"role":"assistant","content":""}}]}

data: {"id":"chatcmpl-xxx","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"你"}}]}

data: {"id":"chatcmpl-xxx","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"好"}}]}

data: [DONE]

5文生图 POST /images/generations

请求参数

请求示例

curl https://aigcbox.com.cn/relay/v1/images/generations \
  -H "Authorization: Bearer sk-xm-你的Key" \
  -H "Content-Type: application/json" \
  -d '{"model":"wanx2.1-t2i-turbo","prompt":"一只戴耳机的蓝色小企鹅，3D 卡通风格","size":"1024x1024","n":1}'

响应示例

{
  "created": 1787000000,
  "data": [{"url": "https://dashscope-xxx.aliyuncs.com/xxx.png", "revised_prompt": null}]
}

6错误码

错误响应统一为 {"detail": "错误描述"}（JSON）。上游错误不会泄露上游密钥等内部信息。

7客户端接入

Codex CLI

# 方式一：环境变量（推荐）
export OPENAI_BASE_URL="https://aigcbox.com.cn/relay/v1"
export OPENAI_API_KEY="sk-xm-你的Key"
codex

# 方式二：~/.codex/config.toml
model = "qwen3-coder-plus"
model_provider = "xiaoming"

[model_providers.xiaoming]
name = "xiaoming"
base_url = "https://aigcbox.com.cn/relay/v1"
env_key = "XIAOMING_API_KEY"
wire_api = "chat"

图形客户端

8代码示例

Python（openai SDK，含流式与异常处理）

from openai import OpenAI, APIError, RateLimitError

client = OpenAI(api_key="sk-xm-你的Key", base_url="https://aigcbox.com.cn/relay/v1")

# 非流式
resp = client.chat.completions.create(
    model="qwen3-coder-plus",
    messages=[{"role": "user", "content": "用 Python 写快排"}],
    temperature=0.3,
)
print(resp.choices[0].message.content)

# 流式
stream = client.chat.completions.create(
    model="qwen-plus",
    messages=[{"role": "user", "content": "写一首短诗"}],
    stream=True,
)
for chunk in stream:
    delta = chunk.choices[0].delta.content
    if delta:
        print(delta, end="", flush=True)

# 异常处理
try:
    client.chat.completions.create(model="qwen-plus", messages=[])
except RateLimitError:
    # 429：退避重试
    pass
except APIError as e:
    print("调用失败:", e)

Node.js

import OpenAI from "openai";

const client = new OpenAI({ apiKey: "sk-xm-你的Key", baseURL: "https://aigcbox.com.cn/relay/v1" });
const resp = await client.chat.completions.create({
  model: "qwen3-coder-plus",
  messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);

Java（OkHttp）

OkHttpClient client = new OkHttpClient();
String json = "{\"model\":\"qwen-plus\",\"messages\":[{\"role\":\"user\",\"content\":\"你好\"}]}";
Request req = new Request.Builder()
    .url("https://aigcbox.com.cn/relay/v1/chat/completions")
    .addHeader("Authorization", "Bearer sk-xm-你的Key")
    .post(RequestBody.create(json, MediaType.get("application/json")))
    .build();
String body = client.newCall(req).execute().body().string();

Go

payload := strings.NewReader(`{"model":"qwen-plus","messages":[{"role":"user","content":"你好"}]}`)
req, _ := http.NewRequest("POST", "https://aigcbox.com.cn/relay/v1/chat/completions", payload)
req.Header.Set("Authorization", "Bearer sk-xm-你的Key")
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)

9用量与计费

10FAQ

Key 在哪里获取？

登录小鸣TV →「我的」→ API 中转站，自动签发（累计充值满 ¥198 开通）。

401 / 429 怎么处理？

401：Key 错误、未开通或刚重置过；429：触发限流，降速或做指数退避（建议 1s/2s/4s 重试）。

支持 function calling / vision 吗？

参数会透传，但取决于上游模型能力；多模态输入暂以文本对话为主，图片请走文生图接口。

返回的图片 URL 多久有效？

文生图返回的是上游临时签名 URL，约 24 小时有效，请下载后自行存储。

可以商用吗？并发多少？

可以商用。默认 60 次/分钟，企业级并发联系微信 Aigc1668888 评估。

Key 泄露了怎么办？

「我的 → API 中转站」点「重置」秒换新 Key，旧 Key 即刻失效；也可联系微信处理。

我的请求内容会被存储吗？

仅记录调用元数据（时间、模型、token 用量、IP），不审查不存储对话内容。