快速集成 Codex API

基础 URL 和认证标头

每个请求都以将您的客户端指向专用基础 URL 开始。此端点接受标准头，并替换默认 OpenAI 代理，大多数 SDK 无需代码更改即可使用。

• 基础 URL： https://api.apicodex.cc/v1
• Auth 标头： Authorization: Bearer YOUR_API_KEY

API 密钥在注册时即时生成。如果需要，您可以轮换密钥，但每个账户一次只能保留一个活动密钥。

Copycurl https://api.apicodex.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fix syntax error in python loop"}]
  }'

POST /v1/chat/completions 参数

使用标准聊天格式发送文本补全请求。模型 ID 始终为 uncensored 并接受如 temperature 和 top_p 等参数以控制创意。

• 上下文窗口：总共 100,000 个 token。
• 最大输出：每次请求 16,000 个 token。
• 如果未指定，默认 max_tokens：2,048。

输入和输出 token 分别计费。错误不会消耗信用额度。

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apicodex.cc/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

GET /v1/models 端点详情

查询可用模型以确认连接。此端点返回托管在我们服务器上的 uncensored 模型的元数据。

• 模型 ID： uncensored
• 类型：chat-completion

使用此端点验证您的 API 密钥在发送大量负载之前是否有效。它立即返回，延迟低。

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.apicodex.cc/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

流式响应和令牌使用

通过将 stream: true服务器为每个生成的 token 发送服务器发送事件（SSE）。Token 使用统计信息出现在流的最后一个块中。

• 通过 SSE 实时交付令牌。
• 最终块包含使用数据。

流式传输降低了大输出的感知延迟。监控最后一个块以计算确切成本。

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

JSON 模式与函数调用

通过设置请求结构化输出 response_format 到 {"type": "json_object"}. 这强制模型返回不带 Markdown 包装器的 JSON。

• 函数调用：通过标准工具格式支持。
• 工具选择：可配置。

JSON 模式非常适合将数据解析到应用程序中。函数调用支持使用外部工具的代理工作流。

错误处理和速率限制

通过检查标准 HTTP 状态码来处理错误。401 错误表示您的 API 密钥无效或缺失。402 错误表示预付费余额不足。429 错误表示您已超过速率限制。

• 限流：每个密钥每分钟 300 次请求。
• 并发请求：每个密钥最多 8 个。
• 最大请求体：8 MB。

信用额度不提供退款，但错误免费。账单问题请联系支持部门。