# 文档概览

面向开发者和企业的模型 API 接入指南。

## 从这里开始

星算API 提供模型 API 接入、调用记录、账户余额与开票等服务。平台由星算智能科技（东莞）有限公司运营。

| 你想完成的事 | 阅读指南 |
| --- | --- |
| 完成第一次调用 | [快速开始](/zh/quickstart/) |
| 创建密钥和设置访问范围 | [密钥与鉴权](/zh/keys/) |
| 接入文字对话、推理和流式输出 | [文本与流式输出](/zh/chat/) |
| 生成图片、识别参考图 | [图像与视觉](/zh/images/) |
| 创建视频任务并获取结果 | [视频任务](/zh/video/) |
| 了解参考素材怎么传给模型 | [文件与参考素材](/zh/files/) |
| 查看人民币计价和费用记录 | [价格与账单](/zh/billing/) |
| 充值、申请发票和使用推广功能 | [账户与服务](/zh/account/) |

## 先确认模型能力

打开[模型广场](https://api.xsopc.com/pricing)，复制完整模型 ID，核对支持的接口、输入类型、价格与可用分组。展示名称、API 模型 ID 和上游别名可能不同，调用时请使用平台公布的 ID。

文档介绍的是平台支持的接入方式。某个模型是否开放图片、视频、流式、缓存或工具功能，以该模型详情和账户权限为准；平台支持一个接口，不代表全部模型都支持它。

## 地址填写规则

- 平台域名：`https://api.xsopc.com`。
- 常见客户端的 API Base URL：`https://api.xsopc.com/v1`。
- 完整对话接口：`https://api.xsopc.com/v1/chat/completions`。

客户端有的会自动添加 `/v1`，有的要求你填写；按其说明配置，避免出现 `/v1/v1`。第一次接入建议先用 cURL 验证，再配置第三方客户端。

## 文档与实际配置

页面中的示例是调用格式，不是模型上架或价格承诺。可用模型、充值方式、验证方式、发票门槛及推广规则，请以控制台当前显示为准。代码中的 `YOUR_API_KEY`、`YOUR_MODEL_ID` 都需要替换。