无界模型云概览
无界模型云的产品定位、统一 API 能力面（LLM / 图像 / 语音 / OCR / 视觉分割）与控制面 / 数据面分工。
无界模型云（Wujie Model Cloud）是一套统一的模型 API 产品：一个账户、一套网关 API Key、一个计费体系，同时覆盖对话大模型、图像生成与编辑、语音识别与合成、文字识别（OCR）以及图像 / 视频分割。已有 OpenAI / Anthropic 兼容客户端的应用可以几乎零改造接入。
私有化部署 API 完全一致，仅需替换 Base 域名 → 企业私有化部署。
第一个调用
在控制台 https://ai.tos.run 创建一个以 gk_ 开头的网关 API Key，用 Authorization: Bearer 头发起调用即可：
curl "https://api.tos.run/v1/chat/completions?provider=dashscope" \
-H "Authorization: Bearer $TOS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "qwen-plus", "messages": [{"role": "user", "content": "你好"}]}'完整步骤见快速开始。
控制面与数据面
无界模型云在网络入口上区分控制面（管控台 / 浏览器）和数据面（API 调用），两者使用不同的 host：
| 面 | 公网 host | 用途 |
|---|---|---|
| 控制面 / 管控台 | https://ai.tos.run | 管理控制台、号源配置、API Key 创建与管理、计费、用量查看（浏览器入口）。也对外提供 OCR / 视觉分割 / 公开模型与定价查询等公共端点 |
| 数据面 | https://api.tos.run | 公有云的 /v1/* 数据面入口（follower）：对话、图像、语音等。私有化部署则替换为你自己的数据面域名 |
所有 /v1/* 调用走数据面域名（公有云为 api.tos.run，私有化部署为你自己的域名）；控制台 host 只用于浏览器管理，不要把它当成对话 / 图像等数据面接口的 API base。
少数端点只在 master host https://ai.tos.run 上提供（数据面 api.tos.run 不代理）：OCR /v1/recognize、视觉分割 /v1/vision-segment/*、公开模型查询 /v1/public/models/lookup、组织定价查询 /v1/pricing/lookup，以及 ASR/TTS 的 master 别名 /v1/transcribe / /v1/synthesize。对话 / 图像 / 语音（/v1/audio/*）等高频数据面接口走 api.tos.run。各能力页会标注其 host。
统一能力面
无界模型云对外暴露一组统一的能力（capability），每个能力对应一类模型与一组 /v1/* 端点：
| 能力 ID | 中文 | 说明 |
|---|---|---|
llm | 对话大模型 | 文本对话 / 推理 / 工具调用，OpenAI 兼容与 Anthropic 原生两种形态 |
image | 图像生成与编辑 | 文生图、图生图、多图融合编辑 |
asr | 语音识别 | 语音转文字 |
tts | 语音合成 | 文字转语音 |
ocr | 文字识别 | 图片 / 文档文字识别 |
vision-segment | 视觉分割（SAM3） | 图像 / 视频分割 |
具体可用的模型族、模型 ID 与价格以控制台展示为准。建议在代码里把模型 ID 作为配置项管理，便于跟随控制台更新平滑切换版本。可用模型与定价可通过模型发现与目录接口查询。
鉴权
所有 API 调用使用网关 API Key 鉴权，Key 以 gk_ 为前缀，在控制台 https://ai.tos.run 创建。请求时通过 HTTP header 传入：
Authorization: Bearer gk_xxxxxxxxxxxxxxAPI Key 按能力 scope 授权（对话用 ai:chat，另有 ai:image / ai:asr / ai:tts / ai:ocr / ai:vision-segment，或 ai:* 通配）。详见鉴权与 API Key。
兼容形态与 Base
无界模型云对 LLM 提供两套兼容接口，共享同一账户、同一 Key 和同一计费：
| 形态 | Base | 主要端点 |
|---|---|---|
| OpenAI 兼容 | https://api.tos.run/v1 | POST /v1/chat/completions、POST /v1/responses |
| Anthropic 兼容 | https://api.tos.run | POST /v1/messages |
| 图像 | https://api.tos.run | POST /v1/images/generations、POST /v1/images/edits |
OpenAI 兼容请求需要显式声明 provider（号源 / 供应商），否则会返回 400。这是无界模型云路由多号源的设计，详见快速开始。
下一步
- 快速开始：用一条 curl 调通第一个请求。
- 鉴权与 API Key：API Key、Bearer 头、能力 scope 与鉴权错误码。
- 模型发现与目录：查询可用模型与实时价格。
- Claude 对话 API、GPT-Image 2 图像生成与编辑：分能力的接口细节。