# Xiaoya Open Platform

> OAuth 2.0, Personal/Team contexts, model catalog, model gateway, and open-agent integration documentation.

Use the downloadable Skill when the coding agent supports Skills. Otherwise read the documents below before implementing an integration.

## Documentation

- [文档目录](https://claw.zhenhuiai.com/developers/): 小雅开放平台开发文档入口与公开接口边界。
- [快速开始](https://claw.zhenhuiai.com/developers/quickstart.html): 完成首个 OAuth 授权与模型调用。
- [OAuth 2.0](https://claw.zhenhuiai.com/developers/oauth.html): 授权码、Scope、Token 生命周期和安全边界。
- [积分与计费](https://claw.zhenhuiai.com/developers/billing.html): Personal/Team 查询余额、扣积分、退积分、用量、响应字段与幂等重试。
- [模型目录与调用](https://claw.zhenhuiai.com/developers/models.html): 读取当前用户可用模型并调用统一模型网关。
- [XiaoyaHub 实时接口](https://claw.zhenhuiai.com/developers/xiaoyahub.html): 运行时读取仅包含后台已启用接口的 OpenAPI、调用示例和积分费用。
- [Studio 画布工具](https://claw.zhenhuiai.com/developers/studio-tools.html): 通过 CLI/MCP 使用 Studio 生成、素材、模板、音色、主体、TikHub 内容查询和网页交接工具。
- [Team 上下文](https://claw.zhenhuiai.com/developers/team.html): Team 精确绑定、工作流 Header、结算与限制。
- [开发 Skill](https://claw.zhenhuiai.com/developers/skill.html): 下载并安装小雅开放平台开发 Skill。
- [智能体开发规范](https://claw.zhenhuiai.com/developers/agent-development.html): MCP 与网页型智能体的接口、安全、计费、幂等、Artifact 和发布要求。
- [完整 API 参考](https://claw.zhenhuiai.com/developers/api-reference.html): 全部外部开发者可调用接口的请求参数、Scope、请求体与响应 Schema。
- [AI 接入文档](https://claw.zhenhuiai.com/developers/ai-access.html): llms.txt、完整上下文、OpenAPI 和 Skill 的选择。
- [文档维护与部署](https://claw.zhenhuiai.com/developers/maintenance.html): 从 Markdown 更新同域静态官网文档，不增加运行服务。
- [公开 OpenAPI](https://claw.zhenhuiai.com/developers/reference/openapi.html): 机器可读的公开接口契约。
- [Documentation index](https://claw.zhenhuiai.com/developers/en/): Xiaoya Open Platform documentation entry point and public API boundary.
- [Quickstart](https://claw.zhenhuiai.com/developers/en/quickstart.html): Complete the first OAuth authorization and model call.
- [OAuth 2.0](https://claw.zhenhuiai.com/developers/en/oauth.html): Authorization code, scopes, token lifecycle, and security boundaries.
- [Points and billing](https://claw.zhenhuiai.com/developers/en/billing.html): Personal/Team balance, charge, refund, usage, response fields, idempotency, and retries.
- [Models](https://claw.zhenhuiai.com/developers/en/models.html): List models available to the current subject and call the model gateway.
- [XiaoyaHub live APIs](https://claw.zhenhuiai.com/developers/en/xiaoyahub.html): Load the current enabled-only OpenAPI catalog, request examples, and point costs at runtime.
- [Studio Canvas tools](https://claw.zhenhuiai.com/developers/en/studio-tools.html): Use Studio generation, asset, template, voice, subject, TikHub content queries, and browser-handoff tools through CLI/MCP.
- [Team context](https://claw.zhenhuiai.com/developers/en/team.html): Exact Team binding, workflow headers, settlement, and limits.
- [Developer Skill](https://claw.zhenhuiai.com/developers/en/skill.html): Download and install the Xiaoya Open Platform developer Skill.
- [Agent development rules](https://claw.zhenhuiai.com/developers/en/agent-development.html): MCP and web-agent interface, security, billing, idempotency, Artifact, and review requirements.
- [Complete API reference](https://claw.zhenhuiai.com/developers/en/api-reference.html): Every external developer operation with parameters, scopes, request bodies, and response schemas.
- [AI-readable docs](https://claw.zhenhuiai.com/developers/en/ai-access.html): Choose between llms.txt, full context, OpenAPI, and the Skill.
- [Documentation maintenance](https://claw.zhenhuiai.com/developers/en/maintenance.html): Update the same-origin static website from Markdown without adding a runtime service.
- [Public OpenAPI](https://claw.zhenhuiai.com/developers/en/reference/openapi.html): Machine-readable public API contract.

## Machine-readable contracts

- [Full documentation context](https://claw.zhenhuiai.com/developers/llms-full.txt)
- [Public OpenAPI](https://claw.zhenhuiai.com/developers/openapi.json)
- [Developer Skill ZIP](https://claw.zhenhuiai.com/developers/downloads/xiaoya-open-agent-developer-skill.zip)

Do not place OAuth access tokens, authorization codes, client secrets, or provider credentials in browser code, AI prompts, logs, or URLs.