メインコンテンツへスキップ
POST
/
v1
/
messages
curl -X POST https://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-20250929",
    "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-20250929",
"stop_reason": "end_turn",
  "stop_sequence": null,
"usage": {
    "input_tokens": 12,
    "output_tokens": 18
}
}
  • Claude Messages API フォーマットと完全互換
  • マルチターン対話および単発クエリに対応
  • テキスト、画像などのマルチモーダルコンテンツに対応
curl -X POST https://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-20250929",
    "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-20250929",
"stop_reason": "end_turn",
  "stop_sequence": null,
"usage": {
    "input_tokens": 12,
    "output_tokens": 18
}
}

​
Authorizations

​
x-api-key
string
必須
API キーは認証に使用されますAPI Key 管理ページ にアクセスして API Key を取得してくださいリクエストヘッダーに以下を追加してください：
x-api-key: YOUR_API_KEY
​
anthropic-version
string
必須
API バージョン番号使用する Claude API バージョンを指定してください例：2023-06-01

​
Body

​
model
string
必須
モデル名
  • claude-haiku-4-5-20251001 - Claude 4.5 高速レスポンスバージョン
  • claude-sonnet-4-5-20250929 - Claude 4.5 バランスバージョン
  • claude-opus-4-1-20250805 - 最も強力な Claude 4.1 フラッグシップモデル
  • claude-opus-4-1-20250805-thinking - Claude 4.1 Opus 深層思考版
  • claude-sonnet-4-5-20250929-thinking - Claude 4.5 Sonnet 深層思考版
​
messages
array
必須
メッセージリスト、user と assistant ロールを交互に使用
​
max_tokens
integer
必須
最大生成 Token 数生成が停止するまでの最大 Token 数。モデルはこの制限に達する前に停止する場合があります。モデルごとに最大値が異なります。モデルのドキュメントを参照してください。最小値：1
​
system
string | array
システムプロンプトシステムプロンプトは Claude のロール、パーソナリティ、目標、指示を設定するために使用されます。文字列形式：
{
  "system": "你是一位专业的Python编程导师"
}
構造化形式：
{
  "system": 
  [
    {
      "type": "text",
      "text": "你是一位专业的Python编程导师"
    }
  ]
}
​
temperature
number
温度パラメータ、範囲 0-1出力のランダム性を制御します：
  • 低い値（例：0.2）：より確定的、より保守的
  • 高い値（例：0.8）：よりランダム、より創造的
デフォルト値：1.0
​
top_p
number
核サンプリングパラメータ、範囲 0-1nucleus sampling を使用します。temperature または top_p のどちらか一方のみを使用し、同時に使用しないことを推奨します。デフォルト値：1.0
​
top_k
integer
Top-K サンプリング確率が最も高い K 個の選択肢からのみサンプリングし、「ロングテール」の低確率レスポンスを除去するために使用します。高度なユースケースでのみ使用することを推奨します。
​
stream
boolean
ストリーミング出力を有効にするかどうか
  • true: Server-Sent Events (SSE) で段階的にレスポンスを返します
  • false: 完全なレスポンスを一括で返します
デフォルト値：false
​
stop_sequences
array
停止シーケンスカスタムテキストシーケンスで、遭遇時に生成が停止します。最大4つのシーケンス、各最大32 Token。
​
metadata
object
メタデータリクエストの追跡や識別に使用されるオブジェクトです。

​
Response

​
id
string
メッセージの一意識別子
​
type
string
オブジェクトタイプ、固定値 message
​
role
string
ロールタイプ、固定値 assistant
​
content
array
メッセージコンテンツ配列
​
model
string
実際に使用されたモデル名
​
stop_reason
string
停止理由可能な値：
  • end_turn - 自然終了
  • max_tokens - 最大 Token 制限に到達
  • stop_sequence - 停止シーケンスに遭遇
  • tool_use - ツール使用
​
stop_sequence
string
停止をトリガーしたシーケンス（該当する場合）
​
usage
object
Token 使用統計

​
使用例

​
単発対話

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

​
マルチターン対話

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

​
システムプロンプトの使用

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

​
レスポンスのプレフィル

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