常见问题及解决办法

1.HTTP状态码及其含义

HTTP状态码是用于表示网页服务器HTTP响应状态的3位数字代码。以下是一些常见的HTTP状态码及其含义：

标题	代码解释
400 Bad Request	请求格式错误或不能被服务器理解。通常意味着客户端错误。
401 Unauthorized	API密钥验证未通过。你需要验证你的API密钥是否正确，其他原因还包括令牌过期。
403 Forbidden	一般是权限不足。
404 Not Found	请求的资源未找到。你可能正在尝试访问一个不存在的端点。
413 Request Entity Too Large	请求体太大。你可能需要减小你的请求体容量。
429 Too Many Requests	由于频繁的请求超过限制，你已经超过了你的速率限制。
500 Internal Server Error	服务器内部的错误。这可能是OpenAI服务器的问题，不是你的问题。
503 Service Unavailable	服务器暂时不可用。这可能是由于OpenAI正在进行维护或者服务器过载。

请注意，以上只是HTTP状态码的一部分，并不完全。有些状态码可能会因服务器的实现和使用而有所不同。

2.API地址

不同应用的 API 地址可能存在差异，实际取值可能为以下之一：

切勿绑错API地址和KEY 以免造成请求失败而无法排查原因。

不同模型供应商原生请求协议

OpenAI / Deepseek

curl -X POST "https://lingyunapi.com/v1/chat/completions" \
  -H "Authorization: Bearer sk-XXX" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4",
    "messages": [
      {
        "role": "system",
        "content": "你是一个专业、严谨的 AI 助手，回答要结构清晰、中文输出。"
      },
      {
        "role": "user",
        "content": "你好，给我介绍一下量子力学"
      }
    ],
  }'

OpenAI 生图

生图

curl -X POST "https://lingyunapi.com/v1/images/generations/" \
  -H "Authorization: Bearer sk-XXX" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-1",
    "prompt": "A cute baby sea otter",
    "n": 1,
    "size": "1024x1024"
  }'

编辑图

curl -X POST "https://lingyunapi.com/v1/images/edits/" \
  -H "Authorization: Bearer sk-XXX" \
  -F image="cmMtdXBsb2FkLTE2ODc4MzMzNDc3NTEtMjA=/31225951_59371037e9_small.png" \
  -F prompt="A cute baby sea otter wearing a beret."

Claude

curl -X POST "https://lingyunapi.com/v1/messages" \
  -H "anthropic-version: 2023-06-01" \
  -H "Authorization: Bearer sk-XXX" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5-20250929",
    "system": [
      {
        "type": "text",
        "text": "你是一个专业、严谨的 AI 助手，回答要结构清晰、中文输出。"
      }
    ],
    "messages": [
      {
        "role": "user",
        "content": "你好"
      }
    ]
  }'

Gemini

对话

curl "https://lingyunapi.com/v1beta/models/gemini-2.5-flash:generateContent?key=sk-XXX" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "你好，给我科普一下量子力学吧"
          }
        ]
      }
    ],
    "generationConfig": {
      "temperature": 0.7,
      "maxOutputTokens": 1024
    }
  }'

生图

curl -X POST "https://lingyunapi.com/v1beta/models/模型名称:generateContent" \
  -H "Authorization: Bearer sk-XXX" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "draw a cat"
          }
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": [
        "TEXT",
        "IMAGE"
      ],
      "imageConfig": {
        "aspectRatio": "16:9",
        "imageSize": "4K"
      }
    }
  }'

常见问题及解决办法

1.HTTP状态码及其含义#

2.API地址#

不同模型供应商原生请求协议#

OpenAI / Deepseek#

OpenAI 生图#

Claude#

Gemini#

1.HTTP状态码及其含义

2.API地址

不同模型供应商原生请求协议

OpenAI / Deepseek

OpenAI 生图

Claude

Gemini