Skip to main content
Xcompute 提供 OpenAI 兼容的文本生成接口，以及 GPT Image 2.5 图像生成接口。使用 API 前，先创建 API Key，再根据任务选择接口。

​
三步开始

  1. 在 API Key 管理页面 创建并复制 API Key。
  2. 选择适合任务的 文本接口 或 图像接口。
  3. 将示例中的 YOUR_API_KEY 替换为自己的密钥，并从模型目录选择当前可用的模型 ID。
API Key 等同于账户密码。不要提交到 GitHub、写入前端代码、发送到聊天群或粘贴到不可信的软件中。发现泄露时，请立即删除并重新创建密钥。

​
服务地址

所有接口路径都接在 Base URL 后面，例如文本接口的完整地址是 https://xcompute.us/v1/chat/completions。Base URL 必须保留末尾的 /v1。

​
认证

除特别说明外，每个请求都需要以下 Header：

​
接口目录

​
文本生成

使用 OpenAI Chat Completions 兼容格式调用文本模型： 模型可用性会随渠道变化，请以模型目录和模型广场实时显示为准。

​
图像生成

同步接口会等待图片生成完成；异步接口立即返回任务 ID，需配合任务查询接口轮询结果。

​
如何选择图像接口

​
通用请求约定

  • 请求体使用 JSON，并设置 Content-Type: application/json。
  • 图片接口的 response_format 当前仅支持 url。
  • 模型 ID 必须使用模型广场当前展示的值，不要根据旧教程猜测模型名。
  • 生产环境应检查 HTTP 状态码，并对网络错误、超时和限流进行重试或降级处理。