> ## Documentation Index
> Fetch the complete documentation index at: https://api.xcompute.us/llms.txt
> Use this file to discover all available pages before exploring further.

# 新手指南

> 先理解 Dualseason / Xcompute 的使用方式，再完成 API Key 创建与首次调用。

跟着这份指南，你可以先理解 Dualseason / Xcompute 的工作方式，再完成首次接入。

## 先理解 Xcompute 在做什么

Xcompute 的核心能力，是把多种 AI 模型统一到一套调用方式里。你不需要分别对接不同厂商，也不需要为每个工具维护不同配置。

## 先分清三个站点

| 站点     | 域名                        | 说明               |
| ------ | ------------------------- | ---------------- |
| 国际站    | `xcompute.us`             | 香港服务器，适合国际网络直连。  |
| 国际加速入口 | `intl.dualseason.com`     | 国内访问国际站的加速转发入口。  |
| 国内站    | `xcompute.dualseason.com` | 国内独立站点，与国际站完全隔离。 |

<Tip>
  `intl.dualseason.com` 只负责加速国际站，不会混用国内站的账号、数据或计费。
</Tip>

<Info>
  如果你的应用已经兼容 OpenAI 接口协议，通常只需要替换 `Base URL` 和 `API Key`，就可以开始迁移。
</Info>

## 三步完成上手

<Steps>
  <Step title="创建 API Key">
    登录控制台，进入 API Key 页面创建密钥。建议按业务或团队拆分不同密钥，方便后续监控与管理。
  </Step>

  <Step title="选择模型与渠道">
    根据任务目标选择模型，并结合渠道分组与计费方式控制成本和稳定性。
  </Step>

  <Step title="在工具或代码中完成配置">
    将目标工具中的接口地址切换到 Xcompute，然后填入你的 API Key。
  </Step>
</Steps>

## 你需要关注的两个概念

### 渠道分组

* `官方渠道`：更适合稳定性要求高的生产任务。
* `特惠渠道`：更适合对价格敏感的测试、实验或批量任务。
* `default`：系统自动优选，适合新手直接开始使用。

### 计费模式

* `按量计费`：适合短对话、轻量调用和高频问答。
* `按次计费`：适合长文生成、复杂分析和长上下文任务。

<Tip>
  如果单次请求和回复的总长度很长，按次计费通常更容易控制预算。
</Tip>

## 常见使用方式

<Columns cols={2}>
  <Card title="站内聊天" icon="message-circle">
    最简单的体验方式。登录后直接在网页中与模型对话。
  </Card>

  <Card title="第三方客户端" icon="monitor">
    适合已有工作流的用户，把支持自定义接口的客户端接入 Xcompute。
  </Card>

  <Card title="应用内 API 调用" icon="code">
    在你自己的服务、插件或自动化流程里直接发起接口请求。
  </Card>

  <Card title="新版接口总览" icon="square-terminal" href="/new-api-reference">
    先查看新版接口总览，再核对接口参数和示例代码。
  </Card>
</Columns>

## 常见问题

<AccordionGroup>
  <Accordion title="我应该先从哪种方式开始？">
    如果你是第一次接触平台，先创建 API Key，再用站内聊天或新版接口总览验证调用方式，最后再接入自己的应用。
  </Accordion>

  <Accordion title="如何查看使用量和费用？">
    你可以在控制台查看调用记录、用量和费用明细。
  </Accordion>

  <Accordion title="可以给不同业务分开密钥吗？">
    可以。建议按应用、团队或环境拆分 API Key，便于限额管理和问题排查。
  </Accordion>
</AccordionGroup>