0x1c Wiki
API Reference

API 概览

0x1c 提供 OpenAI 兼容接口,并尽量兼容常见 SDK 和本地 AI 工具。

0x1c 的目标是让你用统一账号访问 Claude、Gemini、OpenAI、DeepSeek 等模型。大多数客户端只需要把官方接口地址替换为 0x1c 的 Base URL。

Base URL

OpenAI 兼容客户端:

https://0x1c.io/v1

Claude Code 或 Anthropic 兼容客户端:

https://0x1c.io

Gemini 原生协议客户端如果支持自定义 endpoint,通常会要求填写 Gemini 兼容地址。实际路径以控制台或客户端说明为准;如果客户端支持 OpenAI-compatible,优先使用 https://0x1c.io/v1

鉴权

OpenAI 兼容接口:

Authorization: Bearer YOUR_API_KEY

常见 JSON 请求头:

Content-Type: application/json

常见接口

接口用途
GET /v1/models获取可用模型列表
POST /v1/chat/completionsOpenAI Chat Completions 兼容接口
POST /v1/responsesOpenAI Responses 兼容接口,适合新版工具和 Codex
POST /v1/messagesAnthropic Messages 兼容接口

最小 curl 示例

curl https://0x1c.io/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "messages": [
      {
        "role": "user",
        "content": "你好,介绍一下你自己。"
      }
    ]
  }'

响应格式

OpenAI 兼容接口会尽量返回 OpenAI 风格的 JSON。常见字段包括:

  • id
  • object
  • created
  • model
  • choices
  • usage

不同模型提供商的字段可能略有差异。业务代码不要强依赖某个非标准字段。

错误格式

常见错误会包含状态码和错误信息,例如:

{
  "error": {
    "message": "Invalid API key",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}

排查时优先看 HTTP 状态码,再看 messagecode

On this page