docs
API

Messages

Markdown

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

คู่มือฉบับเต็ม
POSThttps://api.ailoot.ai/v1/messages
Messages
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": "สวัสดี! คุณทำอะไรได้บ้าง?"}]
  }' 
200 OK
{
  "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-keyheaderจำเป็น

    คีย์ sk-…. ใช้ Authorization: Bearer sk-… ได้เช่นกัน — Claude Code ใช้วิธีนี้กับ ANTHROPIC_AUTH_TOKEN.

  • anthropic-versionheaderไม่จำเป็น

    เวอร์ชัน API เช่น 2023-06-01. SDK ส่งค่านี้ให้โดยอัตโนมัติ

เนื้อหาคำขอ

  • modelstringจำเป็น

    ID ของโมเดลที่ใช้รูปแบบ Messages — 776 รหัส: Claude รวมถึง GPT, Gemini, DeepSeek, Qwen และโมเดลอื่น ๆ

  • messagesarrayจำเป็น

    ข้อความ user และ assistant; content — สตริงหรือบล็อก (text, image, tool_use, tool_result).

  • max_tokensintegerจำเป็น

    จำนวนโทเค็นสูงสุดของคำตอบ ใช้ในการสำรองเงิน หากเงินคงเหลือไม่พอสำหรับขีดจำกัดเต็ม Ailoot จะลดขีดจำกัดลง แต่ไม่ต่ำกว่า 256 (1025 เมื่อเปิดการให้เหตุผล) และแจ้งขีดจำกัดใหม่ในเฮดเดอร์ X-Ailoot-Max-Tokens-Capped.

  • systemstring | arrayไม่จำเป็น

    คำสั่งระบบ

  • streambooleanไม่จำเป็น

    สตรีมอีเวนต์ SSE (message_start, content_block_delta, …, message_stop). ข้อความที่คิดค่าบริการจะส่งมาเป็นบล็อกเดียวหลังคำนวณราคา

  • temperaturenumberไม่จำเป็น

    ระดับความสุ่มของคำตอบ ตั้งแต่ 0 ถึง 1

  • toolsarrayไม่จำเป็น

    เครื่องมือ: name, description, input_schema.

  • tool_choiceobjectไม่จำเป็น

    auto, any, tool หรือ none.

  • thinkingobjectไม่จำเป็น

    {"type": "enabled", "budget_tokens": N} — การให้เหตุผลสำหรับโมเดลที่รองรับ

  • stop_sequencesarrayไม่จำเป็น

    สตริงที่ทำให้การสร้างคำตอบหยุดลง

คำตอบ

  • contentarray

    บล็อกคำตอบ: text, thinking, tool_use.

  • stop_reasonstring

    end_turn, max_tokens, stop_sequence หรือ tool_use.

  • usageobject

    input_tokens, output_tokens, สำหรับแคช — cache_read_input_tokens และ cache_creation_input_tokens.

ยังมีคำถามอยู่ใช่ไหม ส่ง Request ID และรายละเอียดมาให้เรา เราจะช่วยตรวจ⁠สอบติดต่อฝ่ายสนับสนุน