统一中转调用文档

快速开始

https://us-1.nianhua.store/v1

https://newapi.makelove.cloud/v1

https://us-1.nianhua.store/v1
https://us-2.nianhua.store/v1
https://us-3.nianhua.store/v1

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

最小可用测试

curl https://us-1.nianhua.store/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

节点线路说明

常见接口矩阵

OpenAI 兼容调用

OpenAI 官方 Chat Completions 使用消息数组生成回复；Responses API 可同时处理文本、图像输入和工具调用等任务。本站兼容这些常见调用形态，实际可用模型以 /v1/models 返回为准。

Chat Completions

curl https://newapi.makelove.cloud/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4-mini",
    "messages": [
      {"role": "system", "content": "你是一个简洁可靠的助手。"},
      {"role": "user", "content": "用一句话介绍 Nianhua API。"}
    ],
    "stream": false
  }'

Responses

curl https://newapi.makelove.cloud/v1/responses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4-mini",
    "input": "请用三点说明如何安全保管 API Key。"
  }'

OpenAI 图像生成

curl https://newapi.makelove.cloud/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一张干净的科技风 API 控制台插画",
    "n": 1,
    "size": "1024x1024",
    "response_format": "url"
  }'

Grok 调用

Grok 文本模型可按 OpenAI Chat Completions 调用。Grok Imagine 图像模型支持文生图、图像编辑等能力；官方说明中 Grok Imagine 图像生成支持配置数量、宽高比、分辨率和返回格式，且 grok-imagine-image-quality 支持 1K 与 2K。

Grok 文本

curl https://newapi.makelove.cloud/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.3",
    "messages": [
      {"role": "user", "content": "请用中文回答：Grok 适合什么场景？"}
    ]
  }'

Grok 1K 生图

curl https://newapi.makelove.cloud/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image-quality",
    "prompt": "一张蓝银色科技风 API 状态卡片，细节清晰",
    "n": 1,
    "response_format": "url"
  }'

Grok 2K 高分辨率生图

Grok 高分辨率不要只写 size: "2048x2048"。推荐使用 xAI 风格参数 resolution: "2k"，并按需要设置 aspect_ratio。

curl https://newapi.makelove.cloud/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image-quality",
    "prompt": "2K 分辨率测试图，精细几何网格和清晰文字",
    "n": 1,
    "resolution": "2k",
    "aspect_ratio": "1:1",
    "response_format": "url"
  }'

如果客户端只支持 OpenAI 的 size 字段，可能会被上游按默认 1K 处理。

Gemini 调用

Google 官方 Gemini API 提供 OpenAI compatibility，用 OpenAI SDK 时可通过自定义 base_url 调用。本站也推荐使用 OpenAI 兼容路径调用 Gemini 模型。

Gemini Chat

curl https://newapi.makelove.cloud/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-flash",
    "messages": [
      {"role": "user", "content": "请总结一下中转 API 接入步骤。"}
    ],
    "stream": false
  }'

Gemini 推理强度

部分 Gemini 模型支持 reasoning_effort 或供应商扩展参数。不同模型支持度不同，生产环境建议先用小请求验证。

{
  "model": "gemini-3-flash",
  "messages": [{"role": "user", "content": "给出一个简短方案。"}],
  "reasoning_effort": "low"
}

Claude 调用

Claude 模型通常可以通过 OpenAI 兼容 Chat Completions 调用；部分 Claude 原生客户端会使用 Anthropic Messages 协议。请优先以当前令牌的模型列表和客户端支持为准。

OpenAI 兼容方式

curl https://newapi.makelove.cloud/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4.8-thinking",
    "messages": [
      {"role": "user", "content": "请用中文写一个接口接入检查清单。"}
    ],
    "max_tokens": 800
  }'

Anthropic Messages 兼容方式

curl https://newapi.makelove.cloud/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4.8-thinking",
    "max_tokens": 800,
    "messages": [
      {"role": "user", "content": "请输出一个 JSON 格式的部署步骤。"}
    ]
  }'

如果客户端只支持 Bearer Token，可以尝试把 x-api-key 换成 Authorization: Bearer YOUR_API_KEY。

多模态、流式输出与工具调用

图片输入

curl https://newapi.makelove.cloud/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4-mini",
    "messages": [{
      "role": "user",
      "content": [
        {"type": "text", "text": "这张图里有什么？"},
        {"type": "image_url", "image_url": {"url": "https://example.com/image.jpg"}}
      ]
    }]
  }'

流式输出

{
  "model": "gpt-5.4-mini",
  "messages": [{"role": "user", "content": "写一个短段落。"}],
  "stream": true
}

工具调用

{
  "model": "gpt-5.4-mini",
  "messages": [{"role": "user", "content": "查询北京天气。"}],
  "tools": [{
    "type": "function",
    "function": {
      "name": "get_weather",
      "description": "查询城市天气",
      "parameters": {
        "type": "object",
        "properties": {"city": {"type": "string"}},
        "required": ["city"]
      }
    }
  }]
}

SDK 与常见客户端

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://us-1.nianhua.store/v1",
)

resp = client.chat.completions.create(
    model="gpt-5.4-mini",
    messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "YOUR_API_KEY",
  baseURL: "https://us-1.nianhua.store/v1",
});

const resp = await client.chat.completions.create({
  model: "gpt-5.4-mini",
  messages: [{ role: "user", content: "Hello" }],
});
console.log(resp.choices[0].message.content);

客户端配置

常见错误处理

安全规范

• 所有 API 请求必须走 HTTPS。
• 生产服务建议设置超时、重试和速率限制，避免异常重试造成高额消耗。
• 前端应用不要直连本站 API；应由你的后端代理请求并做用户鉴权。
• 图片、文件和日志中可能包含隐私信息，上传前请确认合规授权。
• 遇到异常扣费、未知 IP 调用或令牌泄露迹象，请立即禁用旧令牌并创建新令牌。

本页面是纯静态文档，不读取数据库、不接收用户输入、不展示任何管理密钥或内部服务地址。

参考来源

• OpenAI Chat Completions API Reference
• OpenAI Responses API Reference
• xAI Grok Imagine Documentation
• Google Gemini OpenAI Compatibility
• Claude Messages API Reference