常见问题
| 我想… | 去这里 |
|---|---|
| 建密钥并调通 | 快速入门 |
| 企业级配置 | 控制台概览 |
| 打开控制台 | 控制台 ↗ |
如何获取 API 密钥？
在控制台 API 密钥 中创建（完整明文只展示一次，前缀多为 xh-...）。
控制台 · API 密钥 ↗ · 管理 API 密钥
目前支持哪些接入方式？
HTTP API，使用 API Key 鉴权。见 快速入门。IDE / Agent 配置见 应用场景。
目前支持哪些能力？
| 能力 | 路径 |
|---|---|
| 生文（默认） | POST /v1/chat/completions |
| 生文（Responses） | POST /v1/responses |
| 生文（Messages） | POST /v1/messages |
| 生图（Images） | POST /v1/images/generations · POST /v1/images/edits |
| 生图（统一契约） | POST /v1/chat/completions + modalities / image_config |
| 生视频 | POST /v1/video/generations，查询 GET /v1/video/tasks/{taskId} |
同一模型不一定支持全部生文路径，请以 GET /models 或 模型广场 ↗ 为准。
折扣与专属价目？
公开价目见模型列表与广场。企业折扣请联系我们（控制台工单或客户成功）。
模型名称格式是什么？
请求体 model 填模型 ID（非展示名），须与 获取模型 或 模型广场 ↗ 一致，例如 gpt-5.5、Hunyuan-3.0、kling-2.6。详见 API 概述。
API Key 是什么格式？
控制台创建，前缀一般为 xh-...。请求头：Authorization: Bearer xh-...。密钥属于工作区；换区请换 Key。见 工作区。
流式、错误、限额在哪里查？
文档与线上行为不一致怎么办？
以实际网关响应为准。若与文档不符，请通过控制台工单或客户成功反馈，并附上 X-Request-Id 与（如有）X-Settlement-Key。
INFO
更多 FAQ 将随产品能力更新补充。产品对外公告见 产品动态。