Qwen 3.8 27B 文本 API 使用说明

提供标准 OpenAI 兼容对话接口（支持普通 JSON 与 SSE 流式响应）及云端 A100 GPU 启停与租约控制接口。

1. 鉴权方式

向管理员获取 API Key，所有接口请求统一携带 Authorization: Bearer <API_KEY> 请求头：

export TEXT_API_KEY='你的_API_KEY'

2. 对话生成接口（OpenAI 兼容）

2.1 普通 JSON 请求（POST /v1/chat/completions）

curl https://text-api.chatpig.space/v1/chat/completions \
  -H "Authorization: Bearer $TEXT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen3.8-27b-uncensored",
    "messages": [
      {"role": "system", "content": "你是一个简洁直接的助手。"},
      {"role": "user", "content": "计算 37 × 19，并用一句中文回答。"}
    ],
    "max_tokens": 512,
    "temperature": 0.7,
    "stream": false
  }'

2.2 SSE 流式输出（stream: true）

curl -N https://text-api.chatpig.space/v1/chat/completions \
  -H "Authorization: Bearer $TEXT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen3.8-27b-uncensored",
    "messages": [
      {"role": "user", "content": "用中文介绍一下你自己。"}
    ],
    "max_tokens": 512,
    "temperature": 0.7,
    "stream": true
  }'

2.3 使用官方 OpenAI Python SDK

from openai import OpenAI

client = OpenAI(
    base_url="https://text-api.chatpig.space/v1",
    api_key="你的_API_KEY",
)

stream = client.chat.completions.create(
    model="qwen3.8-27b-uncensored",
    messages=[{"role": "user", "content": "用中文介绍一下你自己。"}],
    max_tokens=512,
    temperature=0.7,
    stream=True,
)
for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

2.4 查询模型列表（GET /v1/models）

curl https://text-api.chatpig.space/v1/models \
  -H "Authorization: Bearer $TEXT_API_KEY"

3. GPU 启停与租约控制接口

推理服务运行在云端 A100 GPU 上。使用前可通过以下接口查看状态或启动 GPU；每次调用 /v1/chat/completions 都会自动刷新活跃时间，避免在正常使用期间触发闲置关机。

3.1 查看 GPU 状态（GET /gpu/status）

curl https://text-api.chatpig.space/gpu/status \
  -H "Authorization: Bearer $TEXT_API_KEY"

• state：offline（已关闭）、starting（分配 A100 中）、warming（加载模型与预热中）、ready（已就绪）、busy（推理中）、recovering（恢复中）、stopping（释放中）
• ready：为 true 时可直接调用对话生成接口
• lease_remaining_minutes / idle_remaining_minutes：剩余租约分钟数与闲置自动关机倒计时（常驻模式为 null）

3.2 启动 A100（POST /gpu/start）

# 1) 租约 + 闲置保护模式（保持 120 分钟，若连续 30 分钟无请求则提前自动释放）
curl -X POST https://text-api.chatpig.space/gpu/start \
  -H "Authorization: Bearer $TEXT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keep_online_minutes": 120, "idle_timeout_minutes": 30, "keep_forever": false, "confirm_gpu_charge": true}'

# 2) 常驻不自动关机模式（直到手动调用 /gpu/stop）
curl -X POST https://text-api.chatpig.space/gpu/start \
  -H "Authorization: Bearer $TEXT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keep_forever": true, "confirm_gpu_charge": true}'

3.3 延长 GPU 租约（POST /gpu/extend）

curl -X POST https://text-api.chatpig.space/gpu/extend \
  -H "Authorization: Bearer $TEXT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"extra_minutes": 60}'

3.4 立即释放 GPU（POST /gpu/stop）

curl -X POST https://text-api.chatpig.space/gpu/stop \
  -H "Authorization: Bearer $TEXT_API_KEY"