Skip to main content
POST
/
v1
/
messages
curl -X POST https://www.qingbo.dev/v1/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4.5",
    "max_tokens": 1024,
    "system": "你是一个专业的AI助手。",
    "messages": [
      {
        "role": "user",
        "content": "解释一下冒泡排序算法。"
      }
    ]
  }'

{
  "id": "msg_013Zva2CMHLNnXjNJJKqJ2EF",
"type": "message",
"role": "assistant",
"content": [
  {
    "type": "text",
      "text": "你好！我是Claude。很高兴见到你。"
  }
],
  "model": "claude-sonnet-4.5",
"stop_reason": "end_turn",
  "stop_sequence": null,
"usage": {
    "input_tokens": 12,
    "output_tokens": 18
}
}

Documentation Index

Fetch the complete documentation index at: https://docs.qingbo.dev/llms.txt

Use this file to discover all available pages before exploring further.

  • Fully compatible with the Claude Messages API format
  • Supports multi-turn conversations and one-shot queries
  • Supports multimodal content including text and images
curl -X POST https://www.qingbo.dev/v1/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4.5",
    "max_tokens": 1024,
    "system": "你是一个专业的AI助手。",
    "messages": [
      {
        "role": "user",
        "content": "解释一下冒泡排序算法。"
      }
    ]
  }'

{
  "id": "msg_013Zva2CMHLNnXjNJJKqJ2EF",
"type": "message",
"role": "assistant",
"content": [
  {
    "type": "text",
      "text": "你好！我是Claude。很高兴见到你。"
  }
],
  "model": "claude-sonnet-4.5",
"stop_reason": "end_turn",
  "stop_sequence": null,
"usage": {
    "input_tokens": 12,
    "output_tokens": 18
}
}

​
Authorizations

​
x-api-key
string
required
API key used for authentication.Visit the API Key management page to obtain your API Key.Add it to the request header:
x-api-key: YOUR_API_KEY
​
anthropic-version
string
required
API version.Specifies which Claude API version to use.Example: 2023-06-01

​
Body

​
model
string
required
Model name.
  • claude-opus-4.6 — Claude 4.6 Opus, latest flagship
  • claude-sonnet-4.6 — Claude 4.6 Sonnet, latest version
  • claude-opus-4.5 — Claude 4.5 Opus flagship
  • claude-sonnet-4.5 — Claude 4.5 Sonnet, balanced
  • claude-haiku-4.5 — Claude 4.5 Haiku, fast response
​
messages
array
required
Message list with alternating user and assistant roles.
​
max_tokens
integer
required
Maximum tokens to generate.Maximum number of tokens before generation stops. The model may stop earlier.Maximum value varies by model — refer to the model documentation.Minimum: 1
​
system
string | array
System prompt.The system prompt defines Claude’s role, personality, goals, and instructions.String format:
{
  "system": "你是一位专业的Python编程导师"
}
Structured format:
{
  "system": 
  [
    {
      "type": "text",
      "text": "你是一位专业的Python编程导师"
    }
  ]
}
​
temperature
number
Temperature, range 0–1.Controls output randomness:
  • Low values (e.g., 0.2): more deterministic, more conservative
  • High values (e.g., 0.8): more random, more creative
Default: 1.0
​
top_p
number
Nucleus sampling parameter, range 0–1.Uses nucleus sampling. We recommend using either temperature or top_p, not both.Default: 1.0
​
top_k
integer
Top-K sampling.Sample only from the top K highest-probability options to remove “long-tail” low-probability responses.Recommended only for advanced use cases.
​
stream
boolean
Whether to enable streaming output.
  • true: Stream the response progressively via Server-Sent Events (SSE).
  • false: Return the full response in one go.
Default: false
​
stop_sequences
array
Stop sequences.Custom text sequences that stop generation when encountered. Up to 4 sequences, each up to 32 tokens long.
​
metadata
object
Metadata.An object used to track or identify the request.

​
Response

​
id
string
Unique identifier of the message.
​
type
string
Object type, always message.
​
role
string
Role, always assistant.
​
content
array
Array of message content.
​
model
string
Name of the model that actually served the request.
​
stop_reason
string
Reason generation stopped.Possible values:
  • end_turn — Natural completion
  • max_tokens — Reached max token limit
  • stop_sequence — Stop sequence encountered
  • tool_use — Tool use
​
stop_sequence
string
The triggering stop sequence (if any).
​
usage
object
Token usage statistics.

​
Examples

​
Single turn

{
  "model": "claude-sonnet-4.5",
  "max_tokens": 1024,
  "messages": [
    {"role": "user", "content": "解释一下量子计算"}
  ]
}

​
Multi-turn conversation

{
  "model": "claude-sonnet-4.5",
  "max_tokens": 1024,
  "messages": [
    {"role": "user", "content": "你好"},
    {"role": "assistant", "content": "你好！我是Claude。"},
    {"role": "user", "content": "能解释一下AI吗？"}
  ]
}

​
Using a system prompt

{
  "model": "claude-sonnet-4.5",
  "max_tokens": 1024,
  "system": "你是一位经验丰富的数据科学家，专长包括统计分析和机器学习。",
  "messages": [
    {"role": "user", "content": "如何选择合适的机器学习算法？"}
  ]
}

​
Prefilling the response

{
  "model": "claude-sonnet-4.5",
  "max_tokens": 1024,
  "messages": [
    {"role": "user", "content": "列出5个Python最佳实践"},
    {"role": "assistant", "content": "以下是5个Python最佳实践：\n\n1."}
  ]
}