快速开始

先用免费的测试模型发出第一个请求，再改一下模型 ID 换成真实模型。

1. 获取 Key

在 API Key 页面创建一个 Key，然后导出为环境变量：

export OHMYGPT_API_KEY="sk-..."

在账单页面完成首次充值后，Key 即可使用。

Key 只放在你的服务器上。不要提交到代码仓库，也不要打包进浏览器或移动端应用。

2. 调用免费的测试模型

ohmygpt/mock 不收费，所有端点都能应答，流式和非流式都支持。花钱之前，先用它确认 base URL、Key 和你的响应处理逻辑都没问题。

curl https://api.ohmygpt.com/v1/chat/completions \
  -H "Authorization: Bearer $OHMYGPT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "ohmygpt/mock", "messages": [{"role": "user", "content": "ping"}]}'

{
  "id": "chatcmpl-ohmygpt-mock",
  "object": "chat.completion",
  "model": "mock",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "This is a mock reply from OhMyGPT. Your integration works; switch to a real model when ready."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 15, "completion_tokens": 17, "total_tokens": 32 }
}

工具调用也可以用它免费测试。如果请求里声明了工具，它会调用第一个工具（或 tool_choice 指定的那个），所有必填参数都填对应类型的零值；收到工具结果后，再回复一段文本。

3. 换成真实模型

只改模型 ID 即可，ID 从模型列表里取。

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.ohmygpt.com/v1",
    api_key=os.environ["OHMYGPT_API_KEY"],
)

completion = client.chat.completions.create(
    model="openai/gpt-5.4-nano",
    messages=[{"role": "user", "content": "Say hello in one word."}],
)
print(completion.choices[0].message.content)

想试别的模型，把 model 改成 anthropic/claude-sonnet-5-5 或 zhipu/glm-5.3-flash 就行，其他都不用动。同一个 Key 也能用于 Anthropic 和 Gemini 的 SDK，它们的 base URL 见协议表。

调用失败时

错误信息会告诉你该怎么做。首次调用最常见的问题和解决办法：

状态码	`code`	解决办法
401	`invalid_api_key`	检查 `Authorization: Bearer` 请求头里的 Key。
402	`insufficient_credits`	到账单页面充值。
404	`model_not_found`	从 `GET /v1/models` 复制模型 ID。
404，响应体为 `404 page not found`	—	检查请求路径。用 Anthropic SDK 时，去掉 base URL 末尾的 `/v1`。