大模型 API 使用指南

{
  "object": "list",
  "data": [
    {"id": "gpt-4o", "object": "model", "owned_by": "openai"},
    {"id": "claude-sonnet-4-20250514", "object": "model", "owned_by": "anthropic"}
  ]
}

{"role": "system", "content": "You are a helpful assistant."}
{"role": "user", "content": "Hello!"}
{"role": "assistant", "content": "Hi there!"}

{
  "role": "user",
  "content": [
    {"type": "text", "text": "描述这张图片"},
    {"type": "image_url", "image_url": {"url": "https://...", "detail": "high"}}
  ]
}

{
  "model": "gpt-4o",
  "messages": [{"role": "user", "content": "北京天气如何？"}],
  "tools": [{
    "type": "function",
    "function": {
      "name": "get_weather",
      "description": "获取天气信息",
      "parameters": {
        "type": "object",
        "properties": {
          "location": {"type": "string", "description": "城市名"}
        },
        "required": ["location"]
      }
    }
  }]
}

{
  "choices": [{
    "message": {
      "role": "assistant",
      "tool_calls": [{
        "id": "call_xxx",
        "type": "function",
        "function": {"name": "get_weather", "arguments": "{\"location\":\"北京\"}"}
      }]
    },
    "finish_reason": "tool_calls"
  }]
}

{
  "model": "gpt-4o",
  "messages": [
    {"role": "user", "content": "北京天气如何？"},
    {"role": "assistant", "content": null, "tool_calls": [
      {"id": "call_xxx", "type": "function", "function": {"name": "get_weather", "arguments": "{\"location\":\"北京\"}"}}
    ]},
    {"role": "tool", "tool_call_id": "call_xxx", "content": "北京今天晴，25°C"}
  ]
}

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "created": 1734567890,
  "model": "gpt-4o",
  "choices": [{
    "index": 0,
    "message": {"role": "assistant", "content": "你好！"},
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 5,
    "total_tokens": 15
  }
}

{
  "model": "gpt-5.2",
  "messages": [{"role": "user", "content": "证明根号2是无理数"}],
  "reasoning_effort": "high"
}

{
  "choices": [{
    "message": {
      "role": "assistant",
      "content": "我来证明根号2是无理数...(最终答案)",
      "reasoning_content": "让我思考这个问题...(推理过程)"
    },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 500,
    "completion_tokens_details": {"reasoning_tokens": 400}
  }
}

{"role": "user", "content": "Hello!"}
{"role": "assistant", "content": "Hi!"}

{
  "role": "user",
  "content": [
    {"type": "text", "text": "描述这张图片"},
    {
      "type": "image",
      "source": {
        "type": "base64",
        "media_type": "image/jpeg",
        "data": "/9j/4AAQ..."
      }
    }
  ]
}

{
  "type": "image",
  "source": {
    "type": "url",
    "url": "https://example.com/image.jpg"
  }
}

{
  "role": "user",
  "content": [
    {
      "type": "text",
      "text": "这是一段很长的参考文档...",
      "cache_control": {"type": "ephemeral", "ttl": "1h"}
    },
    {
      "type": "text",
      "text": "请根据上述文档回答：xxx"
    }
  ]
}

{
  "usage": {
    "input_tokens": 100,
    "output_tokens": 50,
    "cache_creation_input_tokens": 2048,
    "cache_read_input_tokens": 0
  }
}

{
  "model": "claude-sonnet-4-20250514",
  "max_tokens": 16000,
  "thinking": {
    "type": "enabled",
    "budget_tokens": 10000
  },
  "messages": [{"role": "user", "content": "分析这段代码的时间复杂度并优化"}]
}

{
  "content": [
    {
      "type": "thinking",
      "thinking": "让我分析这段代码...时间复杂度是O(n²)..."
    },
    {
      "type": "text",
      "text": "这段代码的时间复杂度是 O(n²)，建议使用哈希表优化..."
    }
  ],
  "stop_reason": "end_turn"
}

{
  "model": "claude-sonnet-4-20250514",
  "max_tokens": 1024,
  "tools": [{
    "name": "get_weather",
    "description": "获取天气信息",
    "input_schema": {
      "type": "object",
      "properties": {
        "location": {"type": "string", "description": "城市名称"}
      },
      "required": ["location"]
    }
  }],
  "messages": [{"role": "user", "content": "北京天气如何？"}]
}

{
  "content": [{
    "type": "tool_use",
    "id": "toolu_xxx",
    "name": "get_weather",
    "input": {"location": "北京"}
  }],
  "stop_reason": "tool_use"
}

{
  "messages": [
    {"role": "user", "content": "北京天气如何？"},
    {"role": "assistant", "content": [
      {"type": "tool_use", "id": "toolu_xxx", "name": "get_weather", "input": {"location": "北京"}}
    ]},
    {"role": "user", "content": [
      {"type": "tool_result", "tool_use_id": "toolu_xxx", "content": "北京今天晴，25°C"}
    ]}
  ]
}

{
  "id": "msg_xxx",
  "type": "message",
  "role": "assistant",
  "content": [{"type": "text", "text": "你好！"}],
  "model": "claude-sonnet-4-20250514",
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 10,
    "output_tokens": 5
  }
}

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxx",
    base_url="https://www.nextai-code.com/v1"
)

# 基础对话
response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "你好"}]
)
print(response.choices[0].message.content)

# 流式输出
stream = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "讲个故事"}],
    stream=True
)
for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

import anthropic

client = anthropic.Anthropic(
    api_key="sk-xxxxx",
    base_url="https://www.nextai-code.com"
)

# 基础对话
message = client.messages.create(
    model="claude-sonnet-4-20250514",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好"}]
)
print(message.content[0].text)

# 带缓存的对话
message = client.messages.create(
    model="claude-sonnet-4-20250514",
    max_tokens=1024,
    system=[{
        "type": "text",
        "text": "你是专业助手...",
        "cache_control": {"type": "ephemeral"}
    }],
    messages=[{"role": "user", "content": "问题"}]
)
print(f"缓存创建: {message.usage.cache_creation_input_tokens}")
print(f"缓存命中: {message.usage.cache_read_input_tokens}")

curl https://www.nextai-code.com/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxxx" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-4o","messages":[{"role":"user","content":"你好"}]}'

curl https://www.nextai-code.com/v1/messages \
  -H "x-api-key: sk-xxxxx" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-4-20250514","max_tokens":1024,"messages":[{"role":"user","content":"你好"}]}'

const response = await fetch('https://www.nextai-code.com/v1/chat/completions', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer sk-xxxxx',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'gpt-4o',
    messages: [{role: 'user', content: '你好'}]
  })
});
const data = await response.json();
console.log(data.choices[0].message.content);

{
  "error": {
    "message": "错误描述",
    "type": "invalid_request_error",
    "param": "model",
    "code": "model_not_found"
  }
}

{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "错误描述"
  }
}