API 调用示例

本页只保留最小、可验证的调用示例。
当前对外正式开放的是 OpenAI-compatible 调用。
主入口为 https://sub2api.mycodexhub.xyz/v1，备用入口为 https://docs.mycodexhub.xyz/v1。
API Key 需要替换为你自己的密钥；模型 ID 可从当前开放模型列表中选择。

1. 接口规则

OpenAI-compatible

• Base URL：https://sub2api.mycodexhub.xyz/v1
• Endpoint：POST /chat/completions 或 POST /responses
• 认证方式：Authorization: Bearer sk-...

当前开放模型

• gpt-5.3-codex
• gpt-5.3-codex-spark
• gpt-5.4
• gpt-5.4-mini
• gpt-5.5
• gpt-image-2

2. curl 示例

OpenAI-compatible / Chat Completions

curl --request POST "https://sub2api.mycodexhub.xyz/v1/chat/completions" \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer sk-替换为你的API密钥" \
  --data '{
    "model": "gpt-5.5",
    "messages": [
      {
        "role": "user",
        "content": "解释一下快速排序的时间复杂度"
      }
    ]
  }'

OpenAI-compatible / Responses

curl --request POST "https://sub2api.mycodexhub.xyz/v1/responses" \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer sk-替换为你的API密钥" \
  --data '{
    "model": "gpt-5.3-codex",
    "input": "输出一句：连接测试成功"
  }'

3. Python 示例

import requests

API_KEY = "sk-替换为你的API密钥"

def call_openai(prompt: str):
    url = "https://sub2api.mycodexhub.xyz/v1/chat/completions"
    headers = {
        "Content-Type": "application/json",
        "Authorization": f"Bearer {API_KEY}",
    }
    payload = {
        "model": "gpt-5.5",
        "messages": [{"role": "user", "content": prompt}],
    }
    resp = requests.post(url, headers=headers, json=payload, timeout=60)
    resp.raise_for_status()
    return resp.json()

4. JavaScript / Node.js 示例

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-替换为你的API密钥",
  baseURL: "https://sub2api.mycodexhub.xyz/v1",
});

const resp = await client.chat.completions.create({
  model: "gpt-5.5",
  messages: [{ role: "user", content: "输出一句连接测试成功" }],
});

console.log(resp.choices[0].message.content);

5. 通用错误排查

错误码	原因	处理方式
401	API Key 错误或未填写	检查认证头和密钥状态
403	权限不足	检查模型权限、分组或风控限制
404	路径错误	检查是否多写或少写 /v1
429	频率超限	降低频率，加入重试
500	服务端内部错误	重试并查看日志
529	上游过载	退避重试，必要时切备用线路

6. 调用前核对

• Authorization 头是否为 Bearer sk-...
• 主入口是否使用 https://sub2api.mycodexhub.xyz/v1
• 备用入口是否使用 https://docs.mycodexhub.xyz/v1
• 模型 ID 是否来自当前开放模型列表
• 如遇报错，优先查看 FAQ