API 参考文档

OpenAI 兼容 REST API · 19 条线路 · 100+ 个模型 · 完整 OpenAPI 3.1 规范

下载规范: openapi.json

0. 快速开始

Base URL

https://hardysapi.com/v1

认证

所有请求需要在 Authorization 头中携带 Bearer Token:

Authorization: Bearer sk-hardy-YOUR_API_KEY

API Key 在 控制台 创建,格式 sk-hardy-...。

5 分钟迁移指南(OpenAI → HardysAPI)

# Python (openai 库)
from openai import OpenAI

client = OpenAI(
    api_key="sk-hardy-YOUR_KEY",     # ← 改
    base_url="https://hardysapi.com/v1", # ← 改
)

response = client.chat.completions.create(
    model="claude-fable-5-1",
    messages=[{"role": "user", "content": "Hello"}]
)
print(response.choices[0].message.content)

1. 端点列表

GET/v1/models

列出所有可用的模型 ID。返回 OpenAI 兼容格式。

POST/v1/chat/completions

创建聊天补全请求。OpenAI 完全兼容,支持 streaming (SSE)、function calling、tools、vision、prompt caching。

POST/v1/images/generations

创建图像生成请求(DALL·E / gpt-image-2.6)。OpenAI 兼容格式。

GET/v1/usage

查询当前 API Key 的使用量统计(按天聚合)。

2. /v1/chat/completions

请求体

{
  "model": "claude-fable-5-1",       // 必填,模型 ID
  "messages": [                      // 必填,对话历史
    {"role": "system", "content": "你是助手"},
    {"role": "user", "content": "你好"},
    {"role": "assistant", "content": "你好!有什么可以帮助?"},
    {"role": "user", "content": "讲个笑话"}
  ],
  "max_tokens": 1024,                // 可选,默认 1024
  "temperature": 0.7,               // 可选,0-2,默认 1
  "top_p": 1,                       // 可选,0-1
  "stream": false,                    // 可选,默认 false,SSE
  "tools": [...],                    // 可选,function calling
  "tool_choice": "auto",            // 可选
  "user": "user-123"                 // 可选,用户追踪 ID
}

响应(非 streaming)

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1700000000,
  "model": "claude-fable-5-1",
  "choices": [{
    "index": 0,
    "message": {"role": "assistant", "content": "笑话:..."},
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 32,
    "completion_tokens": 128,
    "total_tokens": 160
  }
}

错误码

状态码错误类型说明
401invalid_api_keyAPI Key 无效或过期
402insufficient_balance余额不足,请充值
404model_not_found模型不存在或暂不可用
429rate_limit_exceeded请求速率超限(每分钟 60-500 RPM 视套餐而定)
502upstream_error上游 API 错误,已自动重试 1 次
503model_unavailable模型暂不可用(上游限流或维护中)
529overloaded所有上游账号过载,建议 1 秒后重试

3. 支持的模型

下面是各厂商的主力模型,共 43 个。完整可售清单(100+)请直接调 GET /v1/models,或在 模型广场 查看实时倍率。

Anthropic Claude

claude-fable-5-1, claude-opus-5-5, claude-sonnet-5-5, claude-haiku-5-5, claude-opus-5, claude-sonnet-5

OpenAI GPT

gpt-6.2-astra, gpt-6.2-sol, gpt-6.1-sol, gpt-6-astra, gpt-6-sol, gpt-5.6-terra, gpt-5.6-sol, gpt-5.6-luna, gpt-5-pro, gpt-5.1, gpt-4.1, gpt-image-2.6, gpt-image-2.5, o3, o4-mini

Google Gemini

gemini-4-argon, gemini-4-carbon, gemini-4-hydrogen, gemini-3.8-flash, gemini-3-flash

xAI Grok

grok-4.7, grok-4.6, grok-4.5

国产模型

DeepSeek: deepseek-v4-pro, deepseek-v4.1-flash, deepseek-v4-flash
智谱 GLM: glm-5.3, glm-5.3-flash, glm-5.2
月之暗面 Kimi: kimi-k3.1-pro, kimi-k3, kimi-k2.7-code
阿里云 Qwen: qwen3.8-max, qwen3.8-flash, qwen3.7-max
MiniMax: minimax-m3.1-flash
小米 MiMo: mimo-v2.6-pro

4. Function Calling / Tools

完全兼容 OpenAI tools 协议:

{
  "model": "claude-fable-5-1",
  "messages": [...],
  "tools": [{
    "type": "function",
    "function": {
      "name": "get_weather",
      "description": "获取城市天气",
      "parameters": {
        "type": "object",
        "properties": {
          "city": {"type": "string"}
        },
        "required": ["city"]
      }
    }
  }],
  "tool_choice": "auto"
}

5. Streaming

设置 stream: true 即可获得 SSE 流式输出:

data: {"id":"chatcmpl-abc","object":"chat.completion.chunk","created":1700000000,"model":"claude-fable-5-1","choices":[{"index":0,"delta":{"role":"assistant","content":""},"finish_reason":null}]}

data: {"id":"chatcmpl-abc","object":"chat.completion.chunk","created":1700000000,"model":"claude-fable-5-1","choices":[{"index":0,"delta":{"content":"你"},"finish_reason":null}]}

data: {"id":"chatcmpl-abc","object":"chat.completion.chunk","created":1700000000,"model":"claude-fable-5-1","choices":[{"index":0,"delta":{"content":"好"},"finish_reason":null}]}

...

data: [DONE]

6. 速率限制

套餐RPMTPM并发
免费 / 默认60100K3
付费用户300500K10
企业版5001M50
企业版 (申请)2000+5M+100+