快速开始

完成接入只需要三个动作：准备 API Key、配置 Base URL、按统一协议发起请求。

1. 准备 API Key

在商户控制台创建 API Key。创建成功后的完整 Key 只建议展示一次，请妥善保存；如需限制可用模型，可在创建后再设置模型范围。

2. 配置 Base URL

把业务系统中的供应商 Base URL 替换为平台统一网关地址：

https://api.harnmodel.com/

实际接口路径由 API 参考页给出，例如：

POST /v1/chat/completions
POST /v1/messages
GET  /v1/models
POST /v1/videos/generations

3. 发起第一条请求

import requests

response = requests.post(
    "https://api.harnmodel.com/v1/chat/completions",
    headers={
        "Authorization": "Bearer sk-xxx",
        "Content-Type": "application/json",
    },
    json={
        "model": "gpt-4o",
        "messages": [
            {"role": "user", "content": "请用一句话介绍千云开发者中心。"}
        ],
        "stream": False,
    },
    timeout=120,
)

print(response.status_code)
print(response.text)

4. 使用在线调试

进入任一 API 参考页即可看到 Playground。第一版 Playground 是浏览器直连网关模式，需要你填写：

• Base URL：你的 API 网关地址。
• Token / API Key：模型调用 Key 或管理开放 API token。

CORS 要求

如果浏览器提示跨域错误，需要在 API 网关允许文档站域名的跨域请求。Nginx / Gateway / 后端 CORS 配置需要同时允许 Authorization、Content-Type、x-api-key、anthropic-version 等请求头。