Source: https://ailoot.ai/docs/th/api/messages/
Canonical: https://ailoot.ai/docs/th/api/messages/
Language: th

[API](https://ailoot.ai/docs/th/) 

# Messages

[Markdown](https://ailoot.ai/docs/th/api/messages/index.md)

รูปแบบ Anthropic Messages ซึ่ง Claude Code, Anthropic SDK และเอเจนต์จำนวนมากใช้งาน

POST`https://api.ailoot.ai/v1/messages`

Messages

```bash
curl https://api.ailoot.ai/v1/messages \
  -H "x-api-key: $AILOOT_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "สวัสดี! คุณทำอะไรได้บ้าง?"}]
  }' 
```

```python
import anthropic
import os

client = anthropic.Anthropic(max_retries=0, 
    base_url="https://api.ailoot.ai",   # ไม่ต้องใส่ /v1: SDK จะเติม /v1/messages เอง
    api_key=os.environ["AILOOT_API_KEY"],
)

msg = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "อธิบายในสองประโยคว่า API คืออะไร"}],
)
print(msg.content[0].text)
```

```js
import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({ maxRetries: 0,
  baseURL: "https://api.ailoot.ai", // ไม่ต้องใส่ /v1
  apiKey: process.env.AILOOT_API_KEY,
});

const msg = await client.messages.create({
  model: "claude-sonnet-5-5",
  max_tokens: 1024,
  messages: [{ role: "user", content: "อธิบายในสองประโยคว่า API คืออะไร" }],
});
console.log(msg.content[0].type === "text" ? msg.content[0].text : msg.content);
```

200 OK

```json
{
  "id": "msg_01H…",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-5-5",
  "content": [
    { "type": "text", "text": "สวัสดี! ฉันเขียนและอธิบายโค้ด ตอบคำถามได้…" }
  ],
  "stop_reason": "end_turn",
  "usage": { "input_tokens": 14, "output_tokens": 52 }
}
```

## การยืนยันสิทธิ์

| พารามิเตอร์ | ชนิด | จำเป็น | คำอธิบาย |
| --- | --- | --- | --- |
| `x-api-key` | header | จำเป็น | คีย์ `sk-…`. ใช้ `Authorization: Bearer sk-…` ได้เช่นกัน — Claude Code ใช้วิธีนี้กับ `ANTHROPIC_AUTH_TOKEN`. |
| `anthropic-version` | header | ไม่จำเป็น | เวอร์ชัน API เช่น `2023-06-01`. SDK ส่งค่านี้ให้โดยอัตโนมัติ |

## เนื้อหาคำขอ

| พารามิเตอร์ | ชนิด | จำเป็น | คำอธิบาย |
| --- | --- | --- | --- |
| `model` | string | จำเป็น | ID ของโมเดลที่ใช้รูปแบบ Messages — 776 รหัส: Claude รวมถึง GPT, Gemini, DeepSeek, Qwen และโมเดลอื่น ๆ |
| `messages` | array | จำเป็น | ข้อความ `user` และ `assistant`; `content` — สตริงหรือบล็อก (`text`, `image`, `tool_use`, `tool_result`). |
| `max_tokens` | integer | จำเป็น | จำนวนโทเค็นสูงสุดของคำตอบ ใช้ในการสำรองเงิน หากเงินคงเหลือไม่พอสำหรับขีดจำกัดเต็ม Ailoot จะลดขีดจำกัดลง แต่ไม่ต่ำกว่า 256 (1025 เมื่อเปิดการให้เหตุผล) และแจ้งขีดจำกัดใหม่ในเฮดเดอร์ `X-Ailoot-Max-Tokens-Capped`. |
| `system` | string \| array | ไม่จำเป็น | คำสั่งระบบ |
| `stream` | boolean | ไม่จำเป็น | สตรีมอีเวนต์ SSE (`message_start`, `content_block_delta`, …, `message_stop`). ข้อความที่คิดค่าบริการจะส่งมาเป็นบล็อกเดียวหลังคำนวณราคา |
| `temperature` | number | ไม่จำเป็น | ระดับความสุ่มของคำตอบ ตั้งแต่ 0 ถึง 1 |
| `tools` | array | ไม่จำเป็น | เครื่องมือ: `name`, `description`, `input_schema`. |
| `tool_choice` | object | ไม่จำเป็น | `auto`, `any`, `tool` หรือ `none`. |
| `thinking` | object | ไม่จำเป็น | `{"type": "enabled", "budget_tokens": N}` — การให้เหตุผลสำหรับโมเดลที่รองรับ |
| `stop_sequences` | array | ไม่จำเป็น | สตริงที่ทำให้การสร้างคำตอบหยุดลง |

## คำตอบ

| พารามิเตอร์ | ชนิด | จำเป็น | คำอธิบาย |
| --- | --- | --- | --- |
| `content` | array |  | บล็อกคำตอบ: `text`, `thinking`, `tool_use`. |
| `stop_reason` | string |  | `end_turn`, `max_tokens`, `stop_sequence` หรือ `tool_use`. |
| `usage` | object |  | `input_tokens`, `output_tokens`, สำหรับแคช — `cache_read_input_tokens` และ `cache_creation_input_tokens`. |

การนับโทเค็น (`POST /v1/messages/count_tokens`) สำหรับโมเดลในแค็ตตาล็อกยังไม่พร้อมใช้งาน

ยังมีคำถามอยู่ใช่ไหม ส่ง Request ID และรายละเอียดมาให้เรา เราจะช่วยตรวจ⁠สอบ[ติดต่อฝ่ายสนับสนุน](mailto:support@ailoot.ai)

## Ailoot · บริษัทและพอร์ตโฟลิโอโครงการของบริษัท





Ailoot อาศัยประสบการณ์การดำเนินงานที่สั่งสม ฐานลูกค้าขนาดใหญ่ บริการที่เสถียร และการติดตาม KPI อย่างต่อเนื่อง





บริษัทและพอร์ตโฟลิโอโครงการของบริษัท: ลูกค้าหลายล้านราย; ยอดขายระดับหลายพันล้านต่อเดือน.





Ailoot นำประสบการณ์การดำเนินงานนี้มาใช้เพื่อให้เข้าถึงฟังก์ชัน AI ผ่าน API ในผลิตภัณฑ์ของลูกค้า เอเจนต์ แอปพลิเคชัน และระบบอัตโนมัติ