OpenAI Compatible 快速入门

使用 OpenAI Compatible 接口快速接入，支持文本对话、多模态输入和工具调用。

最通用的接入方式。学习成本低、迁移成本低，大多数客户端和 SDK 都能直接套用。

适用场景：文本对话、多模态输入、工具调用。

基础配置

• Base URL：https://ergouzi.life/v1
• 鉴权：Authorization: Bearer <API_KEY>

OpenAI SDK 和通用 OpenAI Compatible 工具使用 https://ergouzi.life/v1，由它们自动拼接 /chat/completions。手写 curl 时直接请求完整 endpoint。

最小示例

curl --request POST \
  --url https://ergouzi.life/v1/chat/completions \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer $DOGZEE_API_KEY" \
  --data '{
    "model": "gpt-5.4",
    "messages": [
      {"role": "user", "content": "用两句话介绍 Dogzee API。"}
    ]
  }'

验证三件事：地址是否正确、Bearer 鉴权是否通过、分组是否支持该模型。

两种请求格式

Chat Completions（传统格式）

适合已有 messages 结构代码的场景，迁移成本最低。

curl --request POST \
  --url https://ergouzi.life/v1/chat/completions \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer $DOGZEE_API_KEY" \
  --data '{
    "model": "gpt-5.4",
    "messages": [
      {"role": "user", "content": "写一句简短的欢迎语。"}
    ]
  }'

多模态输入：

curl --request POST \
  --url https://ergouzi.life/v1/chat/completions \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer $DOGZEE_API_KEY" \
  --data '{
    "model": "gpt-5.4",
    "messages": [
      {
        "role": "user",
        "content": [
          {"type": "text", "text": "请描述这张图片。"},
          {
            "type": "image_url",
            "image_url": {
              "url": "https://images.unsplash.com/photo-1518717758536-85ae29035b6d"
            }
          }
        ]
      }
    ]
  }'

Responses（新格式）

用统一的 input 结构，适合新项目和需要混合文本、图片等多模态输入的场景。

curl --request POST \
  --url https://ergouzi.life/v1/responses \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer $DOGZEE_API_KEY" \
  --data '{
    "model": "gpt-5.4",
    "input": "请用三句话概括 Dogzee API 的定位。"
  }'

图像输入：

curl --request POST \
  --url https://ergouzi.life/v1/responses \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer $DOGZEE_API_KEY" \
  --data '{
    "model": "gpt-5.4",
    "input": [
      {
        "role": "user",
        "content": [
          { "type": "input_text", "text": "请描述图中的主要内容。" },
          {
            "type": "input_image",
            "image_url": "https://images.unsplash.com/photo-1518717758536-85ae29035b6d"
          }
        ]
      }
    ]
  }'

排错

• 请求失败 → 先检查分组是否支持该模型，不是先怀疑 curl 写法
• 和 Claude/Gemini 原生格式混用 → 这条线只走 OpenAI 格式
• 建议顺序：先用 curl 验证 → 再接客户端或 SDK → 最后做复杂配置