การค้นพบโมเดล

ใช้หน้าโมเดลหรือ Models API เพื่อตรวจสอบโมเดลข้อความที่พร้อมใช้งาน ข้อมูลเมตาของโมเดล รวมถึงผู้ผลิต ผู้ให้บริการ รูปแบบ ความยาวบริบท ตระกูล API ที่รองรับ ความสามารถที่รองรับ ความพร้อมใช้งาน ขีดจำกัดระดับบัญชี และราคาเครดิต

จุดเชื่อมต่อ: GET /v1/models วัตถุประสงค์: แสดงรายการโมเดลที่พร้อมใช้งานสำหรับบัญชีปัจจุบัน

curl --request GET \
  --url https://api.ciyuan-market.com/api/v1/models \
  --header "Authorization: Bearer $CIYUAN_MARKET_API_KEY"

ตารางความสามารถ

ตารางความเข้ากันได้ของตระกูล API

การรับรองความถูกต้อง

คำขอ API ทุกรายการใช้โทเค็นผู้ถือ เก็บคีย์ในตัวแปรสภาพแวดล้อมฝั่งเซิร์ฟเวอร์ หมุนเวียนเมื่อการเข้าถึงของทีมเปลี่ยนแปลง และบันทึกรหัสคำขอเพื่อการดีบัก

ข้อแนะนำด้านความปลอดภัยของคีย์

1. เก็บคีย์ API ไว้บนเซิร์ฟเวอร์ อย่าเปิดเผยคีย์ในโค้ดเบราว์เซอร์หรือไคลเอนต์มือถือ
2. Use separate keys for development, staging, production, and third-party integrations.
3. กำหนดขอบเขตคีย์ตามสภาพแวดล้อม บริการ ลูกค้า หรือผู้เช่าเมื่อมีให้
4. Rotate keys after employee departures, vendor access changes, or suspected leakage.
5. เก็บคีย์ในตัวจัดการความลับหรือตัวแปรสภาพแวดล้อม ไม่ใช่โค้ดต้นฉบับ

ตัวแทนเขียนโค้ด

ciyuan_market ทำงานร่วมกับตัวแทนเขียนโค้ดและเครื่องมือพัฒนา AI ที่รองรับ จุดเชื่อมต่อ API ที่เข้ากันได้กับ OpenAI หรือ Anthropic ใช้นามแฝงการกำหนดเส้นทางเช่น mwf/coding-auto เพื่อให้ ciyuan_market สามารถกำหนดเส้นทางไปยังโมเดลเขียนโค้ดที่ดีที่สุดที่พร้อมใช้งาน โดยไม่ต้องให้นักพัฒนาเปลี่ยนการกำหนดค่าเครื่องมือ

การตั้งค่าที่เข้ากันได้กับ OpenAI แบบทั่วไป

ใช้การตั้งค่านี้สำหรับ Cursor, Codex, Hermes, OpenClaw, Continue, Aider, Cline, ตัวแทนที่ใช้ LangChain, ตัวแทนที่ใช้ LlamaIndex, และรันไทม์ตัวแทนที่เข้ากันได้กับ OpenAI แบบกำหนดเอง

export OPENAI_BASE_URL="https://api.ciyuan-market.com/api/v1"
export OPENAI_API_KEY="$CIYUAN_MARKET_API_KEY"
export OPENAI_MODEL="mwf/coding-auto"

การตั้งค่าที่เข้ากันได้กับ Anthropic แบบทั่วไป

ใช้การตั้งค่านี้สำหรับไคลเอนต์ที่เข้ากันได้กับ Claude และเครื่องมือที่คาดหวังรูปแบบ Anthropic Messages

export ANTHROPIC_BASE_URL="https://api.ciyuan-market.com/api/anthropic"
export ANTHROPIC_API_KEY="$CIYUAN_MARKET_API_KEY"
export ANTHROPIC_MODEL="mwf/coding-auto"

โมเดลตัวแทนที่แนะนำ

คู่มือฉับไว Cursor

ใช้จุดเชื่อมต่อที่เข้ากันได้กับ OpenAI

Base URL: https://api.ciyuan-market.com/api/v1
API Key:  CIYUAN_MARKET_API_KEY
Model:    mwf/coding-auto

ขั้นตอนที่แนะนำ:

1. เปิดการตั้งค่า Cursor
2. เพิ่มหรือเปิดใช้งานการกำหนดค่าคีย์ API ที่เข้ากันได้กับ OpenAI
3. ตั้งค่าการแทนที่ URL ฐาน OpenAI เป็น https://api.ciyuan-market.com/api/v1
4. Add a custom model such as mwf/coding-auto, mwf/coding-fast, or mwf/coding-long.
5. ใช้โมเดลที่รองรับการสตรีมและการเรียกเครื่องมือเพื่อพฤติกรรมตัวแทนที่ดีที่สุด

การแก้ไขปัญหา:

คู่มือฉับไว Claude Code

ใช้จุดเชื่อมต่อเกตเวย์ที่เข้ากันได้กับ Anthropic

export ANTHROPIC_BASE_URL="https://api.ciyuan-market.com/api/anthropic"
export ANTHROPIC_API_KEY="$CIYUAN_MARKET_API_KEY"
export ANTHROPIC_MODEL="mwf/coding-auto"

ciyuan_market รองรับเส้นทางที่เข้ากันได้กับ Anthropic นี้สำหรับ Claude Code และความเข้ากันได้ของ Anthropic SDK:

POST /api/v1/messages

ข้อกำหนดที่แนะนำ:

คู่มือฉับไว Codex

ใช้ ciyuan_market เป็นผู้ให้บริการโมเดลที่เข้ากันได้กับ OpenAI แบบกำหนดเอง

ตัวอย่างการกำหนดค่าผู้ให้บริการ:

[model_providers.ciyuanmarket]
name = "ciyuan_market"
base_url = "https://api.ciyuan-market.com/api/v1"
env_key = "CIYUAN_MARKET_API_KEY"
wire_api = "responses"

model_provider = "ciyuanmarket"
model = "mwf/coding-auto"

ตัวแปรสภาพแวดล้อม:

export CIYUAN_MARKET_API_KEY="br_xxx"

โมเดลที่แนะนำ:

การแก้ไขปัญหา:

คู่มือฉับไว Hermes

ใช้จุดเชื่อมต่อที่เข้ากันได้กับ OpenAI เว้นแต่การปรับใช้ Hermes ของคุณกำหนดค่าไว้สำหรับ พิธีสารอื่น

export OPENAI_BASE_URL="https://api.ciyuan-market.com/api/v1"
export OPENAI_API_KEY="$CIYUAN_MARKET_API_KEY"
export OPENAI_MODEL="mwf/coding-auto"

นโยบายโมเดลที่แนะนำ:

คู่มือฉับไว OpenClaw

ใช้จุดเชื่อมต่อที่เข้ากันได้กับ OpenAI สำหรับการกำหนดค่ารันไทม์ตัวแทนสไตล์ OpenAI

export OPENAI_BASE_URL="https://api.ciyuan-market.com/api/v1"
export OPENAI_API_KEY="$CIYUAN_MARKET_API_KEY"
export OPENAI_MODEL="mwf/coding-auto"

หาก OpenClaw รองรับผู้ให้บริการหลายราย ให้กำหนดค่า ciyuan_market เป็นผู้ให้บริการที่เข้ากันได้กับ OpenAI และใช้นามแฝงการกำหนดเส้นทาง ciyuan_market สำหรับการเลือกโมเดล

{
  "provider": "openai-compatible",
  "base_url": "https://api.ciyuan-market.com/api/v1",
  "api_key_env": "CIYUAN_MARKET_API_KEY",
  "model": "mwf/coding-auto"
}

รายการตรวจสอบความเข้ากันได้ของตัวแทน

การใช้งานคอนโซล

คอนโซล ciyuan_market เป็นระนาบควบคุมการดำเนินงานสำหรับการเข้าถึง API ความพร้อมของโมเดล นโยบายการกำหนดเส้นทาง การมองเห็นการใช้งาน และการบริหารการเรียกเก็บเงิน มอบ มุมมองรวมศูนย์ให้ผู้ดูแลบัญชีเกี่ยวกับคีย์ โมเดล คำขอ เครดิต และ การควบคุมระดับบัญชีสำหรับการเข้าชมโมเดลการผลิต

การจัดการคีย์ API

สร้าง หมุนเวียน เพิกถอน และติดป้ายกำกับคีย์ API จากคอนโซล ใช้คีย์แยกสำหรับ การพัฒนา การจัดเตรียม การผลิต และบริการแต่ละรายการ เพื่อให้สามารถตรวจสอบและ แยกการใช้งานตามสภาพแวดล้อมหรือแอปพลิเคชัน

รายการโมเดล

ใช้หน้าโมเดลเพื่อตรวจสอบโมเดลที่พร้อมใช้งานสำหรับบัญชี รายการโมเดลแต่ละรายการอาจ รวมถึงผู้ผลิต ผู้ให้บริการ รูปแบบ ตระกูล API ที่รองรับ ความยาวบริบท แฟล็กความสามารถ สถานะความพร้อมใช้งาน และข้อมูลราคา

สำหรับแอปพลิเคชันการผลิต ให้ตรวจสอบความสามารถของโมเดลก่อนเปิดใช้งานการเข้าชม พารามิเตอร์และคุณสมบัติบางอย่างขึ้นอยู่กับโมเดลและอาจไม่รองรับในทุก ตระกูล API

การใช้งาน & บันทึก

มุมมองการใช้งาน & บันทึก ให้การมองเห็นการดำเนินงานของการเข้าชม API ทีมสามารถ ตรวจสอบปริมาณคำขอ โมเดลที่เลือก เป้าหมายการกำหนดเส้นทางที่แก้ไขแล้ว การใช้เครดิต เวลาแฝง รหัสข้อผิดพลาด และรหัสคำขอ

• แก้ไขปัญหาคำขอที่ล้มเหลว
• ระบุงานที่มีต้นทุนสูง
• เปรียบเทียบการใช้งานโมเดลข้ามแอปพลิเคชันและสภาพแวดล้อม
• ตรวจสอบพฤติกรรมการกำหนดเส้นทางและการสำรอง
• สืบสวนปัญหาเวลาแฝงหรือความพร้อมของผู้ให้บริการ
• ระบุรหัสคำขอเมื่อติดต่อฝ่ายสนับสนุน

การตอบกลับ API แต่ละรายการรวมหรือเปิดเผยรหัสคำขอ ciyuan_market เก็บรหัสนี้ใน บันทึกแอปพลิเคชันของคุณเพื่อให้การดีบักการผลิตและการขยายการสนับสนุนมีประสิทธิภาพมากขึ้น

การสำรอง

การสำรองเป็นกลไกความยืดหยุ่นของ ciyuan_market เมื่อโมเดลหลักหรือนโยบายการกำหนดเส้นทาง ล้มเหลว ระบบจะสลับไปยังโมเดลสำรองโดยอัตโนมัติเพื่อดำเนินการ คำขอต่อ นี่ทำให้แอปพลิเคชันของคุณตอบสนองและลดความเสี่ยงของการ หยุดชะงักของบริการ

ทำไมการสำรองจึงสำคัญ

ในการผลิต บริการโมเดลอาจประสบปัญหาที่คาดเดาไม่ได้หลายประการ:

• ความล้มเหลวของบริการโมเดล: API ต้นน้ำกลายเป็น ไม่พร้อมใช้งานชั่วคราวหรือหมดเวลา
• การผันผวนของประสิทธิภาพ: โหลดโมเดลสูงนำไปสู่การตอบกลับ ช้าหรือล้มเหลว
• ความล้มเหลวของการกำหนดเส้นทาง: โมเดลผู้สมัครทั้งหมดที่เลือกโดยการกำหนดเส้นทางอัจฉริยะ กลายเป็นไม่พร้อมใช้งาน

การสำรองทำให้แอปพลิเคชันของคุณพร้อมใช้งานโดยให้เส้นทางสำรองที่เชื่อถือได้

ข้อได้เปรียบหลัก

การกำหนดค่าโมเดลสำรองทั่วไป

ciyuan_market รองรับการตั้งค่าโมเดลสำรองทั่วไปจากแบ็กเอนด์คอนโซล คำขอทั้งหมดใช้โมเดลนี้เป็นการสำรองโดยอัตโนมัติเมื่อล้มเหลว

วิธีการกำหนดค่า:

1. Go to the หน้าการตั้งค่ากลยุทธ์ ciyuan_market.
2. ค้นหาการตั้งค่า โมเดลสำรองเริ่มต้น
3. เลือกโมเดลสำรองทั่วไปจากรายการแบบเลื่อนลง
4. บันทึกการตั้งค่าเพื่อใช้ทันที

ข้อได้เปรียบของการกำหนดค่าทั่วไป:

• ไม่ต้องเปลี่ยนแปลงโค้ด: กำหนดค่าครั้งเดียวและใช้ทั่วโลก โดยไม่ต้องทำซ้ำการตั้งค่าในทุกคำขอ
• การจัดการแบบรวมศูนย์: จัดการนโยบายสำรองในที่เดียวเพื่อ การปรับเปลี่ยนและการติดตามที่ง่ายขึ้น
• การบำรุงรักษาที่ง่ายขึ้น: ลดความซับซ้อนของโค้ดและโอกาส เกิดข้อผิดพลาดในการกำหนดค่า
• การแทนที่ที่ยืดหยุ่น: การกำหนดค่าสำรองระดับคำขอมี ลำดับความสำคัญสูงกว่าและสามารถแทนที่การตั้งค่าทั่วไปสำหรับสถานการณ์เฉพาะ

การกำหนดค่าสำรองระดับคำขอ

สำหรับสถานการณ์ทางธุรกิจเฉพาะ คุณสามารถระบุโมเดลสำรองใน คำขอแต่ละรายการเพื่อแทนที่การกำหนดค่าทั่วไป

ระบุโมเดลสำรองด้วยพารามิเตอร์ router.fallBackModels:

{
  "model": "claude-sonnet-4",
  "messages": [
    {
      "role": "user",
      "content": "Explain what quantum computing is"
    }
  ],
  "router": {
    "fallBackModels": ["glm-5.2"]
  }
}

กฎลำดับความสำคัญ

เมื่อมีการกำหนดค่าสำรองหลายรายการ ลำดับความสำคัญจะทำงานจากสูงสุดไปยัง ต่ำสุด:

1. ระดับคำขอ router.fallBackModels: โมเดลสำรองที่ระบุในคำขอแต่ละรายการ
2. โมเดลสำรองเริ่มต้นทั่วไป: โมเดลสำรองทั่วไปที่กำหนดค่า ในคอนโซล
3. ไม่มีการสำรอง: หากไม่ได้กำหนดค่าทั้งสองอย่าง คำขอจะส่งกลับข้อผิดพลาด เมื่อล้มเหลว

การบริหารบัญชี

ขึ้นอยู่กับประเภทบัญชี คอนโซลอาจรวมถึงการเปิดใช้งานโมเดลระดับบัญชี การควบคุมผู้ค้าต่อหรือผู้แจกจ่าย การกำหนดค่าการเรียกเก็บเงิน และการตั้งค่าการเข้าถึง ผู้ดูแลสามารถใช้การควบคุมเหล่านี้เพื่อจัดการการเข้าถึงโมเดล การมองเห็นการใช้งาน และ ความรับผิดชอบการเรียกเก็บเงินให้สอดคล้องกับแอปพลิเคชัน บัญชีลูกค้า หรือหน่วยธุรกิจ

รายการตรวจสอบการดำเนินงานการผลิต

การเรียกเก็บเงิน & เครดิต

ciyuan_market ใช้โมเดลการเรียกเก็บเงินแบบเครดิตสำหรับงานโมเดลข้อความ ภาพ วิดีโอ และ งานอื่นๆ ที่รองรับ เครดิตเป็นหน่วยรวมสำหรับการใช้งานหลายโมเดลและ หลายผู้ให้บริการ เพื่อให้ทีมสามารถจัดการการใช้งานได้อย่างสม่ำเสมอข้ามรูปแบบและ ตระกูล API

ราคาโมเดลโดยละเอียดมีให้ในหน้าโมเดลหรือผ่าน API ข้อมูลเมตาของโมเดล ราคาอาจแตกต่างกันตามโมเดล ผู้ให้บริการ รูปแบบ ความละเอียด ประเภทโทเค็น ความยาวเอาต์พุต ระยะเวลางาน ประเภทบัญชี และข้อตกลงเชิงพาณิชย์

เติมเงิน & กระเป๋าเงิน

บัญชีสามารถเพิ่มเครดิตกระเป๋าเงินจ่ายตามการใช้งานสำหรับการใช้งานที่ยืดหยุ่น เครดิตกระเป๋าเงิน ใช้หลังจากเครดิตแผนรายเดือนและแพ็กเกจทรัพยากรถูกใช้หมด ยกเว้นกฎการเรียกเก็บเงิน แบบกำหนดเองที่ใช้กับบัญชี

เครดิตกระเป๋าเงินไม่หมดอายุ เว้นแต่ระบุไว้เป็นอย่างอื่นในเงื่อนไขทางพาณิชย์ที่บังคับใช้ มีค่าธรรมเนียมบริการเมื่อเติมเงินกระเป๋าเงินจ่ายตามการใช้งาน

แผนรายเดือนและแพ็กเกจทรัพยากร

ผู้ใช้หรือบัญชีแต่ละรายสามารถเลือกแผนรายเดือนที่ใช้งานอยู่หนึ่งแผน แผนรายเดือนให้ ปริมาณความจุการใช้งานที่กำหนด เงื่อนไขทางพาณิชย์ และการกำหนดค่าการเข้าถึง ระดับบัญชีสำหรับรอบการเรียกเก็บเงิน

ผู้ใช้ยังสามารถซื้อแพ็กเกจทรัพยากรหลายแพ็กเกจเพื่อเพิ่มความจุการใช้งาน แพ็กเกจ ทรัพยากรสามารถแยกการใช้งานที่ผูกมัดจากยอดคงเหลือกระเป๋าเงินจ่ายตามการใช้งานและมีประโยชน์สำหรับ การใช้งานข้อความ ภาพ วิดีโอ ปริมาณมาก หรืองานเฉพาะ

ลำดับการหักเงิน

เว้นแต่จะกำหนดค่ากฎการเรียกเก็บเงินแบบกำหนดเอง เครดิตจะถูกหักใน ลำดับต่อไปนี้:

สำหรับบัญชีที่มีเงื่อนไขทางพาณิชย์แบบกำหนดเอง ลำดับการหักเงิน กฎการหมดอายุ การใช้งาน ที่รวม และราคาอาจแตกต่างกัน กฎเฉพาะบัญชีจะแสดงในคอนโซลหรือ ระบุผ่านข้อตกลงทางพาณิชย์

ราคาที่กำหนดเอง

ราคาสามารถกำหนดเองสำหรับผู้ใช้หรือบัญชีแต่ละราย ลูกค้าองค์กร บัญชีผู้ค้าต่อ บัญชีผู้แจกจ่าย และลูกค้าที่ใช้ปริมาณมากอาจมีสิทธิ์ได้รับราคา กำหนดเอง ติดต่อฝ่ายขายเพื่อขอราคา

ราคากำหนดเองสามารถกำหนดค่าตามบัญชี โมเดล ผู้ให้บริการ รูปแบบ ภูมิภาค ปริมาณ การใช้งาน หรือข้อตกลงทางพาณิชย์ เมื่อเปิดใช้งานราคากำหนดเอง คอนโซลและ API การเรียกเก็บเงินจะแสดงราคาและกฎการหักเงินเฉพาะบัญชีเมื่อมี

หน่วยราคา

โมดอลิตี้โมเดลที่แตกต่างกันใช้หน่วยวัดที่แตกต่างกัน ciyuan_market แปลง หน่วยเหล่านี้เป็นเครดิตตามกฎการกำหนดราคาของโมเดล

หน่วยราคาอาจแตกต่างกันตามโมเดล โปรดดูหน้ารายละเอียดโมเดลหรือข้อมูลเมตา ราคาก่อนเปิดใช้งานโมเดลในการผลิตเสมอ

การระบุแหล่งที่มาการใช้งาน

การใช้งาน ciyuan_market สามารถตรวจสอบได้ตามบัญชี คีย์ API โมเดล รูปแบบ หรือช่วงเวลา ซึ่งช่วยให้ทีมสามารถระบุต้นทุนให้กับแอปพลิเคชัน สภาพแวดล้อม ลูกค้า หรือ หน่วยธุรกิจภายใน

ยอดเครดิตคงเหลือ

ตรวจสอบจำนวนเครดิตที่พร้อมใช้งานในบัญชีของคุณ ยอดคงเหลือถูกแบ่งเป็น กระเป๋าเงินสามใบที่หักตามลำดับ: เงินช่วยเหลือแผนรายเดือน แพ็กเกจทรัพยากรที่ซื้อ และกระเป๋าเงินจ่ายตามการใช้งาน ยอดรวมทรัพยากรรวม (แผนรายเดือน + แพ็กเกจ ทรัพยากร ไม่รวมจ่ายตามการใช้งาน) ยังมีให้สำหรับติดตามการใช้งานที่รวมแยกจาก การใช้จ่ายเติมเงิน

เพื่อดึงข้อมูลนี้โดยใช้โปรแกรม ดู GET /v1/billing/balance ใน การอ้างอิง API

รายละเอียดการใช้งาน

ตรวจสอบรายการการใช้งานแต่ละรายการแบบแบ่งหน้าตามลำดับเวลาสำหรับการรายงาน การติดตาม และการจัดสรรต้นทุนภายใน แต่ละรายการแสดงโมเดล ประเภทโมเดล (ข้อความ ภาพ หรือวิดีโอ) เครดิตที่หัก และรายละเอียดว่าการหักแต่ละรายการถูกหักจากกระเป๋าเงินใด ผลลัพธ์สามารถกรองตามช่วงเวลาเฉพาะ

เพื่อดึงข้อมูลนี้โดยใช้โปรแกรม ดู GET /v1/usage ใน การอ้างอิง API

ประวัติธุรกรรม

ใช้ประวัติธุรกรรมเพื่อตรวจสอบการเคลื่อนไหวของเครดิต รวมถึงการเติมเงิน การจัดสรร แผน การให้แพ็กเกจทรัพยากร การหักการใช้งาน การปรับ และการแก้ไข ทางการบริหาร

เพื่อดึงข้อมูลนี้โดยใช้โปรแกรม ดู GET /v1/billing/transactions ใน การอ้างอิง API

คำขอที่ล้มเหลวและการคืนเงิน

ข้อผิดพลาดในการตรวจสอบ ข้อผิดพลาดการรับรองความถูกต้อง และข้อผิดพลาดการอนุญาต มักไม่ถูกเรียกเก็บเงินเพราะไม่มีการดำเนินการโมเดล คำขอที่ถึงโมเดลต้นน้ำหรือ สร้างเอาต์พุตบางส่วนอาจใช้เครดิตขึ้นอยู่กับโมเดล ผู้ให้บริการ และ สถานะการตอบกลับ

สำหรับงานภาพและวิดีโออะซิงโครนัส พฤติกรรมการเรียกเก็บเงินขึ้นอยู่กับว่างานถูก ยอมรับ เริ่ม เสร็จสิ้น ล้มเหลว หรือยกเลิก การตอบกลับรายละเอียดงานรวม ข้อมูลการใช้งานเมื่อเครดิตถูกใช้

การเติมเงิน แผนรายเดือน แพ็กเกจทรัพยากร และเครดิตที่ใช้แล้วไม่สามารถคืนได้ เว้นแต่ ระบุไว้เป็นอย่างอื่นในข้อตกลงทางพาณิชย์ที่บังคับใช้หรือตามที่กฎหมายกำหนด

การอ้างอิง API

ข้อตกลงทั่วไป

URL ฐาน

จุดเชื่อมต่อทั้งหมดให้บริการภายใต้คำนำหน้า /v1

การรับรองความถูกต้อง

การเรียกจุดเชื่อมต่อ /v1/* ใช้การรับรองความถูกต้อง คีย์ API (ไม่ใช่ JWT) คีย์ API ส่งผ่านส่วนหัวต่อไปนี้:

คีย์ที่ขาดหายไปหรือไม่ถูกต้องจะส่งกลับ 401

การตรวจสอบยอดคงเหลือล่วงหน้า

จุดเชื่อมต่อเรียกโมเดลทั้งหมดจะตรวจสอบยอดคงเหลือก่อนการดำเนินการ:

• Insufficient balance returns Insufficient credit, mapped to:
  • พิธีสาร OpenAI: HTTP 400, code = insufficient_quota
  • พิธีสาร Anthropic: HTTP 402, type = billing_error
• จุดเชื่อมต่อบางรายการยังประเมินต้นทุนขั้นต่ำต่อโมเดลสำหรับการตรวจสอบล่วงหน้าครั้งที่สอง

POST https://api.ciyuan-market.com/api/v1/chat/completions

จุดเชื่อมต่อที่เข้ากันได้กับ OpenAI Chat Completions รองรับการสตรีมและไม่สตรีม การเรียก เครื่องมือ โหมด JSON และอินพุตหลายรูปแบบ

Message fields:

curl --request POST \
  --url https://api.ciyuan-market.com/api/v1/chat/completions \
  --header "Authorization: Bearer $CIYUAN_MARKET_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "glm-5.2",
    "messages": [{"role": "user", "content": "Describe Hangzhou in one sentence."}],
    "stream": false,
    "temperature": 0.7
  }'

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "created": 1721380000,
  "model": "glm-5.2",
  "choices": [
    {
      "index": 0,
      "message": {"role": "assistant", "content": "Hangzhou is ..."},
      "finish_reason": "stop"
    }
  ],
  "usage": {"prompt_tokens": 12, "completion_tokens": 18, "total_tokens": 30}
}

ฟิลด์การตอบกลับ (ไม่สตรีม):

ตัวอย่างการตอบกลับแบบสตรีม:

data: {"object":"chat.completion.chunk","choices":[{"delta":{"role":"assistant","content":"..."}}]}

data: {"object":"chat.completion.chunk","choices":[{"delta":{"content":"..."}}]}

data: [DONE]

POST https://api.ciyuan-market.com/api/v1/responses

จุดเชื่อมต่อที่เข้ากันได้กับ OpenAI Responses ใช้ input แทน messages instructions แทนข้อความระบบ และ บล็อก text แทน response_format

curl --request POST \
  --url https://api.ciyuan-market.com/api/v1/responses \
  --header "Authorization: Bearer $CIYUAN_MARKET_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "glm-5.2",
    "input": "Describe Hangzhou in one sentence.",
    "instructions": "Be concise.",
    "stream": false
  }'

{
  "id": "resp_xxx",
  "object": "response",
  "model": "glm-5.2",
  "status": "completed",
  "created_at": 1721380000,
  "output": [
    {
      "id": "msg_xxx",
      "type": "message",
      "role": "assistant",
      "content": [{"type": "output_text", "text": "Hangzhou is ..."}],
      "status": "completed"
    }
  ],
  "usage": {"input_tokens": 12, "output_tokens": 18, "total_tokens": 30}
}

ฟิลด์การตอบกลับ (ไม่สตรีม):

การสตรีมตามเหตุการณ์ API Responses:

POST https://api.ciyuan-market.com/api/v1/messages

จุดเชื่อมต่อที่เข้ากันได้กับ Anthropic Messages ยอมรับส่วนหัว x-api-key และ anthropic-version: 2023-06-01 บล็อกเนื้อหารองรับ text, image, tool_use, tool_result, thinking และ redacted_thinking

ตัวอย่างบล็อกภาพ:

{ "type": "image", "source": { "type": "base64", "media_type": "...", "data": "..." } }
{ "type": "image", "source": { "type": "url", "url": "..." } }

curl --request POST \
  --url https://api.ciyuan-market.com/api/v1/messages \
  --header "Authorization: Bearer $CIYUAN_MARKET_API_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "claude-sonnet-4.6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Describe Hangzhou in one sentence."}]
  }'

{
  "id": "msg_xxx",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4.6",
  "content": [{"type": "text", "text": "Hangzhou is ..."}],
  "stop_reason": "end_turn",
  "usage": {"input_tokens": 12, "output_tokens": 18}
}

ฟิลด์การตอบกลับ (ไม่สตรีม):

GET https://api.ciyuan-market.com/api/v1/models

ส่งคืนโมเดล API ที่ออนไลน์และเปิดใช้งานทั้งหมด

curl --request GET \
  --url https://api.ciyuan-market.com/api/v1/models \
  --header "Authorization: Bearer $CIYUAN_MARKET_API_KEY"

{
  "object": "list",
  "data": [
    {
      "id": "glm-5.2",
      "object": "model",
      "display_name": "glm-5.2",
      "created": 1721380000,
      "owned_by": "Zai",
      "input_modalities": ["text", "image"],
      "output_modalities": ["text"],
      "context_length": 128000,
      "description": "..."
    }
  ]
}

ฟิลด์ของแต่ละรายการโมเดล (data[]):

GET https://api.ciyuan-market.com/api/v1/models/{model}

ส่งคืนโมเดลเดียวที่มีรูปร่างเดียวกับรายการในรายการ ส่งกลับ HTTP 404 เมื่อ โมเดลไม่มีอยู่

curl --request GET \
  --url https://api.ciyuan-market.com/api/v1/models/gpt-5.5 \
  --header "Authorization: Bearer $CIYUAN_MARKET_API_KEY"

การตอบกลับสำเร็จ: ออบเจ็กต์โมเดลเดียวที่มีฟิลด์เดียวกันกับ รายการใน /v1/models

เมื่อโมเดลไม่มีอยู่ จะส่งกลับ HTTP 404:

{"error": {"message": "The model 'xxx' does not exist", "type": "invalid_request_error", "code": "invalid_model_error"}}

GET https://api.ciyuan-market.com/api/v1/image-models

สอบถามความละเอียด อัตราส่วน และจำนวนสูงสุดที่รองรับโดยโมเดลภาพก่อน เรียก /v1/image-generations ไม่ต้องรับรองความถูกต้อง

curl --request GET \
  --url https://api.ciyuan-market.com/api/v1/image-models \
  --header "Authorization: Bearer $CIYUAN_MARKET_API_KEY"

{
  "object": "list",
  "data": [
    {
      "id": "gpt-image-2",
      "object": "image_model",
      "displayName": "GPT Image 1",
      "description": "...",
      "icon": "...",
      "created": 1721380000,
      "maxCount": 4,
      "fileMax": 10,
      "resolutions": ["720p", "1080p"],
      "ratios": ["1:1", "3:2"]
    }
  ]
}

GET https://api.ciyuan-market.com/api/v1/video-models

สอบถามค่า videoType ที่รองรับ ช่วงระยะเวลา ความละเอียด และ อัตราส่วนสำหรับโมเดลวิดีโอก่อนเรียก /v1/video-generations ไม่ ต้องรับรองความถูกต้อง

VideoTypeOption fields:

curl --request GET \
  --url https://api.ciyuan-market.com/api/v1/video-models \
  --header "Authorization: Bearer $CIYUAN_MARKET_API_KEY"

{
  "object": "list",
  "data": [
    {
      "id": "sora-2",
      "object": "video_model",
      "displayName": "Sora 2",
      "description": "...",
      "icon": "...",
      "created": 1721380000,
      "allowedVideoTypes": [
        {"code": 1, "name": "text-to-video"},
        {"code": 2, "name": "image-to-video"},
        {"code": 3, "name": "image-to-video (first/last frame)"}
      ],
      "videoDurationMin": 5,
      "videoDurationMax": 10,
      "videoDurationSuggest": [5, 8, 10],
      "resolutions": ["1080p", "720p"],
      "ratios": ["16:9", "9:16"],
      "fileMax": 5
    }
  ]
}

คำอธิบายฟิลด์ระดับราคา

4 endpoint สำหรับการคิวรีโมเดล /v1/models, /v1/models/{model}, /v1/image-models และ /v1/video-models จะคืนค่าราคาที่เรียกเก็บจริงสำหรับผู้เรียก (ผู้ใช้ API Key) ซึ่งตรงกับค่าใช้จ่ายจริง และคืนค่าระดับราคาทั้งหมดของโมเดลนั้น

ความแตกต่างของชื่อฟิลด์:/v1/models / /v1/models/{model} ใช้สไตล์ OpenAI snake_case (price_tiers); /v1/image-models / /v1/video-models ใช้ camelCase (priceTiers)โครงสร้างเหมือนกัน

price_tiers / priceTiers เป็น array โดยแต่ละ element คือระดับราคา:

โมเดลทั้งสามประเภทใช้โครงสร้างเดียวกัน ต่างกันที่การเติมฟิลด์คำอธิบายเท่านั้น ฟิลด์ที่ไม่เกี่ยวข้องเป็น null:

ความหมายของราคา:ค่า inputPrice / outputPrice / cacheReadPrice / cacheWritePrice ที่คืนมา เป็นหน่วยราคาเรียกเก็บสุดท้ายสำหรับผู้ใช้ API Key ปัจจุบัน หลังจากแก้ไขผ่าน price chain (chain)→ guidance → ราคาฐาน ตรงกับค่าใช้จ่ายจริง หน่วยราคาที่ผู้เรียกเห็นจะแตกต่างกันตามกลุ่ม pricing chain (reseller / distributor / องค์กร / การตั้งค่าระดับผู้ใช้)

ยอดหักจริง = ปริมาณการใช้ ÷ quantity × ราคาต่อหน่วยที่เกี่ยวข้อง × ratio สำหรับวิดีโอที่คิดตามวินาที: ยอดหักจริง = duration × outputPrice × ratio

การจัดการขอบเขตและข้อยกเว้น (endpoint แบบอ่านอย่างเดียวจะไม่คืน 500 เนื่องจากปัญหาการตั้งค่าราคา)

ตัวอย่างการตอบกลับ (/v1/models, โมเดลข้อความ):

{
  "object": "list",
  "data": [
    {
      "id": "gpt-4o",
      "object": "model",
      "display_name": "gpt-4o",
      "context_length": 128000,
      "price_tiers": [
        {
          "region": "GLOBAL",
          "bandMin": null,
          "bandMax": null,
          "resolution": null,
          "clarity": null,
          "unit": "token",
          "quantity": 1000,
          "description": "ต่อ 1,000 token",
          "inputPrice": 0.0025,
          "outputPrice": 0.01,
          "cachePrice": 0.00125,
          "cacheReadPrice": 0,
          "cacheWritePrice": 0,
          "ratio": 1,
          "mode": "RATIO",
          "planId": null
        }
      ]
    }
  ]
}

ตัวอย่างการตอบกลับ (/v1/image-models, โมเดลรูปภาพ, โครงสร้าง priceTiers เหมือนข้างต้น, unit คือ image):

{
  "object": "list",
  "data": [
    {
      "id": "dall-e-3",
      "object": "image_model",
      "displayName": "dall-e-3",
      "resolutions": ["1024x1024", "1792x1024", "1024x1792"],
      "priceTiers": [
        {
          "region": null,
          "bandMin": null,
          "bandMax": null,
          "resolution": "1024x1024",
          "clarity": "standard",
          "unit": "image",
          "quantity": 1,
          "description": "ต่อรูป",
          "inputPrice": 0,
          "outputPrice": 0.04,
          "cachePrice": 0,
          "cacheReadPrice": 0,
          "cacheWritePrice": 0,
          "ratio": 1,
          "mode": "RATIO",
          "planId": null
        }
      ]
    }
  ]
}

POST https://api.ciyuan-market.com/api/v1/image-generations

ส่งงานสร้างภาพแบบอะซิงโครนัส ส่งคืน taskId ทันที ดึงผลลัพธ์โดยโพล GET /v1/image-generations/{taskId} หรือผ่าน เว็บฮุก callbackUrl

model ค่า resolution / ratio ที่รองรับ ขีดจำกัดบน count และขีดจำกัดการอัปโหลดภาพอ้างอิง (fileMax) ต้องได้รับจาก GET /v1/image-models ก่อน ยอมรับเฉพาะค่า ที่ระบุในสเปกของโมเดลนั้นเท่านั้น

curl --request POST \
  --url https://api.ciyuan-market.com/api/v1/image-generations \
  --header "Authorization: Bearer $CIYUAN_MARKET_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "seedream-4.5",
    "text": "A cat drinking water by the river",
    "count": 1,
    "resolution": "2k",
    "ratio": "1:1",
    "imageUrls": []
  }'

{
  "code": 200,
  "message": "image task is commit",
  "data": {"taskId": "img_xxx"}
}

การตอบกลับข้อผิดพลาด:

// Insufficient credit
{ "code": 500, "message": "Insufficient credit" }

// Model not found
{ "code": 404, "message": "Model not found: xxx" }

GET https://api.ciyuan-market.com/api/v1/image-generations/{taskId}

โพลงานสร้างภาพ status คือ pending / success / failed images เป็นอาร์เรย์ URL ของภาพที่แปลงเป็นสตริง JSON text มีคำอธิบายข้อความที่โมเดลแนบมา (เช่น เอาต์พุตหลายรูปแบบของ Gemini) หากไม่มีจะเป็น null

curl --request GET \
  --url https://api.ciyuan-market.com/api/v1/image-generations/img_xxx \
  --header "Authorization: Bearer $CIYUAN_MARKET_API_KEY"

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "img_xxx",
    "status": "success",
    "errorMessage": null,
    "images": "[\"https://.../1.png\"]",
    "text": null
  }
}

ฟิลด์ data การตอบกลับ:

ไม่พบงาน:

{ "code": 500, "message": "task not found" }

หากระบุ callbackUrl ไว้ตอนส่ง เซิร์ฟเวอร์จะส่งผลลัพธ์ success / failed ขั้นสุดท้ายผ่านเว็บฮุกด้วยรูปแบบ data เดียวกัน

ตัวอย่างแบบเต็ม (ส่ง + โพล)

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;

public class ImageGenerationExample {
  private static final String BASE = "https://api.ciyuan-market.com/api/v1";
  private static final String API_KEY = System.getenv("CIYUAN_MARKET_API_KEY");

  public static void main(String[] args) throws Exception {
    HttpClient http = HttpClient.newBuilder()
        .connectTimeout(Duration.ofSeconds(10)).build();

    // 1. Submit the task.
    String body = "{"
        + "\"model\":\"seedream-4.5\","
        + "\"text\":\"A cat drinking water by the river\","
        + "\"count\":1,"
        + "\"resolution\":\"2k\","
        + "\"ratio\":\"1:1\","
        + "\"imageUrls\":[]"
        + "}";
    HttpResponse<String> submit = http.send(
        HttpRequest.newBuilder(URI.create(BASE + "/image-generations"))
            .header("Authorization", "Bearer " + API_KEY)
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(body)).build(),
        HttpResponse.BodyHandlers.ofString());

    String taskId = extract(submit.body(), "taskId");
    System.out.println("taskId = " + taskId);

    // 2. Poll until terminal status.
    String status = "pending";
    while ("pending".equals(status)) {
      Thread.sleep(15_000L);
      HttpResponse<String> poll = http.send(
          HttpRequest.newBuilder(URI.create(BASE + "/image-generations/" + taskId))
              .header("Authorization", "Bearer " + API_KEY).GET().build(),
          HttpResponse.BodyHandlers.ofString());
      status = extract(poll.body(), "status");
      System.out.println("status = " + status);
    }

    if (!"success".equals(status)) {
      throw new RuntimeException("image generation failed: " + status);
    }
    // images is a JSON-stringified array of URLs.
    String images = extract(pollResult(http, taskId), "images");
    System.out.println("images = " + images);
  }

  // Minimal JSON field extractor — use Jackson/Gson in production.
  private static String extract(String json, String field) {
    int i = json.indexOf("\"" + field + "\":");
    if (i < 0) return null;
    i += field.length() + 3;
    if (json.charAt(i) == '\"') {
      int end = json.indexOf('\"', i + 1);
      return json.substring(i + 1, end);
    }
    int end = i;
    while (end < json.length() && "0123456789.".indexOf(json.charAt(end)) >= 0) end++;
    return json.substring(i, end);
  }

  private static String pollResult(HttpClient http, String taskId) throws Exception {
    return http.send(HttpRequest.newBuilder(URI.create(BASE + "/image-generations/" + taskId))
        .header("Authorization", "Bearer " + API_KEY).GET().build(),
        HttpResponse.BodyHandlers.ofString()).body();
  }
}

import os
import time
import requests

BASE = "https://api.ciyuan-market.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['CIYUAN_MARKET_API_KEY']}"}

# 1. Submit the task.
resp = requests.post(
    f"{BASE}/image-generations",
    headers={**HEADERS, "Content-Type": "application/json"},
    json={
        "model": "seedream-4.5",
        "text": "A cat drinking water by the river",
        "count": 1,
        "resolution": "2k",
        "ratio": "1:1",
        "imageUrls": [],
    },
)
resp.raise_for_status()
task_id = resp.json()["data"]["taskId"]
print(f"taskId = {task_id}")

# 2. Poll until terminal status.
while True:
    time.sleep(15)
    poll = requests.get(f"{BASE}/image-generations/{task_id}", headers=HEADERS)
    poll.raise_for_status()
    data = poll.json()["data"]
    status = data["status"]
    print(f"status = {status}")
    if status != "pending":
        break

if status != "success":
    raise RuntimeError(f"image generation failed: {data.get('errorMessage')}")

# images is a JSON-stringified array of URLs.
import json
images = json.loads(data["images"])
print(f"images = {images}")

POST https://api.ciyuan-market.com/api/v1/video-generations

ส่งงานสร้างวิดีโอแบบอะซิงโครนัส ส่งคืน taskId ทันที ดึงผลลัพธ์โดยโพล GET /v1/video-generations/{taskId} หรือผ่าน เว็บฮุก callbackUrl

model ค่า videoType ที่อนุญาต ช่วงระยะเวลา (videoDurationMin/Max) resolution / ratio ที่รองรับ และขีดจำกัดการอัปโหลดเนื้อหาอ้างอิง (fileMax) ต้อง ได้รับจาก GET /v1/video-models ก่อน ยอมรับเฉพาะ รหัส videoType ที่ระบุใน allowedVideoTypes ของโมเดลนั้นเท่านั้น

ตัวอย่างสำหรับแต่ละ videoType:

1. ข้อความเป็นวิดีโอ (videoType=1)

สร้างวิดีโอจากพร้อมต์ข้อความเท่านั้น ไม่ต้องมีเนื้อหาอ้างอิง

curl --request POST \
  --url https://api.ciyuan-market.com/api/v1/video-generations \
  --header "Authorization: Bearer $CIYUAN_MARKET_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "videoType": 1,
    "text": "A cat jumping on a bed",
    "resolution": "480p",
    "ratio": "16:9",
    "duration": 4,
    "model": "seedance-2.0"
  }'

2. ภาพเป็นวิดีโอ - เฟรมแรก (videoType=2)

ระบุเฟรมเริ่มต้นเดียวใน imageUrls โมเดลจะสร้างวิดีโอ เริ่มจากเฟรมนั้น

curl --request POST \
  --url https://api.ciyuan-market.com/api/v1/video-generations \
  --header "Authorization: Bearer $CIYUAN_MARKET_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "videoType": 2,
    "text": "Happily shaking head",
    "resolution": "480p",
    "ratio": "16:9",
    "duration": 4,
    "model": "seedance-2.0",
    "imageUrls": ["https://ciyuanmarket-flie.oss-accelerate.aliyuncs.com/test/first-frame.png"]
  }'

3. ภาพเป็นวิดีโอ - เฟรมแรกและสุดท้าย (videoType=3)

ระบุทั้งเฟรมแรกและสุดท้ายใน imageUrls (ลำดับ: [first, last]) โมเดลจะสร้างวิดีโอเปลี่ยนผ่านระหว่างสอง เฟรม

curl --request POST \
  --url https://api.ciyuan-market.com/api/v1/video-generations \
  --header "Authorization: Bearer $CIYUAN_MARKET_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "videoType": 3,
    "text": "Put on the hat",
    "resolution": "480p",
    "ratio": "16:9",
    "duration": 4,
    "model": "seedance-2.0",
    "imageUrls": [
      "https://ciyuanmarket-flie.oss-accelerate.aliyuncs.com/test/first-frame.png",
      "https://ciyuanmarket-flie.oss-accelerate.aliyuncs.com/test/last-frame.png"
    ]
  }'

4. ภาพเป็นวิดีโอ - อ้างอิง (videoType=4)

ระบุภาพอ้างอิงหนึ่งภาพขึ้นไปใน imageUrls โมเดลจะใช้ สไตล์/เนื้อหาเป็นอ้างอิง (ไม่ใช่เฟรมแรก/สุดท้ายที่บังคับ) เพื่อสร้างวิดีโอ

curl --request POST \
  --url https://api.ciyuan-market.com/api/v1/video-generations \
  --header "Authorization: Bearer $CIYUAN_MARKET_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "videoType": 4,
    "text": "Two cats playing together",
    "resolution": "480p",
    "ratio": "16:9",
    "duration": 4,
    "model": "kling-v3-omni-video",
    "imageUrls": [
      "https://ciyuanmarket-flie.oss-accelerate.aliyuncs.com/test/ref-1.png",
      "https://ciyuanmarket-flie.oss-accelerate.aliyuncs.com/test/ref-2.png"
    ]
  }'

5. อ้างอิงทั้งหมด (videoType=5)

อ้างอิงภาพ / วิดีโอ / เสียงแบบผสม อ้างอิงเนื้อหาตามตำแหน่งในพร้อมต์: รายการ ที่ 1 ใน imageUrls คือ @图片 1 รายการที่ 1 ใน videoUrls คือ @视频 1 รายการที่ 1 ใน audioUrls คือ @音频 1 videoUrls ยังยอมรับสตริง URL แบบธรรมดา

curl --request POST \
  --url https://api.ciyuan-market.com/api/v1/video-generations \
  --header "Authorization: Bearer $CIYUAN_MARKET_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "videoType": 5,
    "text": "Use the first-person framing of @视频 1 and @音频 1 as background music. First-person tea ad; start frame is @图片 1 ... end frame is @图片 2.",
    "model": "seedance-2.0",
    "imageUrls": [
      "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic1.jpg",
      "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic2.jpg"
    ],
    "videoUrls": ["https://ark-project.tos-cn-beijing.volces.com/doc_video/r2v_tea_video1.mp4"],
    "audioUrls": ["https://ark-project.tos-cn-beijing.volces.com/doc_audio/r2v_tea_audio1.mp3"],
    "resolution": "1080p",
    "ratio": "16:9",
    "duration": 11
  }'

การตอบกลับการส่ง (ทั้งห้าประเภท):

{
  "code": 200,
  "message": "success",
  "data": {"taskId": "vid_xxx"}
}

GET https://api.ciyuan-market.com/api/v1/video-generations/{taskId}

โพลงานสร้างวิดีโอ status คือ pending / success / failed videoUrl คือ URL ของวิดีโอที่สร้างขึ้น และ lastFrameUrl คือ URL ของเฟรมสุดท้าย (สถานการณ์ภาพเป็นวิดีโอ)

curl --request GET \
  --url https://api.ciyuan-market.com/api/v1/video-generations/vid_xxx \
  --header "Authorization: Bearer $CIYUAN_MARKET_API_KEY"

{
  "code": 200,
  "message": "success",
  "data": {
    "status": "success",
    "videoUrl": "https://.../out.mp4",
    "lastFrameUrl": null,
    "message": null
  }
}

ฟิลด์ data การตอบกลับ:

หากระบุ callbackUrl ไว้ตอนส่ง เซิร์ฟเวอร์จะส่งผลลัพธ์ขั้นสุดท้าย ผ่านเว็บฮุกด้วยรูปแบบ data เดียวกัน

ตัวอย่างแบบเต็ม (ส่ง + โพล)

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;

public class VideoGenerationExample {
  private static final String BASE = "https://api.ciyuan-market.com/api/v1";
  private static final String API_KEY = System.getenv("CIYUAN_MARKET_API_KEY");

  public static void main(String[] args) throws Exception {
    HttpClient http = HttpClient.newBuilder()
        .connectTimeout(Duration.ofSeconds(10)).build();

    // 1. Submit the task (videoType=1: text-to-video).
    String body = "{"
        + "\"videoType\":1,"
        + "\"text\":\"A cat jumping on a bed\","
        + "\"resolution\":\"480p\","
        + "\"ratio\":\"16:9\","
        + "\"duration\":4,"
        + "\"model\":\"seedance-2.0\""
        + "}";
    HttpResponse<String> submit = http.send(
        HttpRequest.newBuilder(URI.create(BASE + "/video-generations"))
            .header("Authorization", "Bearer " + API_KEY)
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(body)).build(),
        HttpResponse.BodyHandlers.ofString());

    String taskId = extract(submit.body(), "taskId");
    System.out.println("taskId = " + taskId);

    // 2. Poll until terminal status. Video tasks take longer — poll every 20s.
    String status = "pending";
    String lastBody = null;
    while ("pending".equals(status)) {
      Thread.sleep(20_000L);
      HttpResponse<String> poll = http.send(
          HttpRequest.newBuilder(URI.create(BASE + "/video-generations/" + taskId))
              .header("Authorization", "Bearer " + API_KEY).GET().build(),
          HttpResponse.BodyHandlers.ofString());
      lastBody = poll.body();
      status = extract(lastBody, "status");
      System.out.println("status = " + status);
    }

    if (!"success".equals(status)) {
      throw new RuntimeException("video generation failed: " + status);
    }
    String videoUrl = extract(lastBody, "videoUrl");
    System.out.println("videoUrl = " + videoUrl);
  }

  // Minimal JSON field extractor — use Jackson/Gson in production.
  private static String extract(String json, String field) {
    int i = json.indexOf("\"" + field + "\":");
    if (i < 0) return null;
    i += field.length() + 3;
    if (json.charAt(i) == '\"') {
      int end = json.indexOf('\"', i + 1);
      return json.substring(i + 1, end);
    }
    int end = i;
    while (end < json.length() && "0123456789.".indexOf(json.charAt(end)) >= 0) end++;
    return json.substring(i, end);
  }
}

import os
import time
import requests

BASE = "https://api.ciyuan-market.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['CIYUAN_MARKET_API_KEY']}"}

# 1. Submit the task (videoType=1: text-to-video).
resp = requests.post(
    f"{BASE}/video-generations",
    headers={**HEADERS, "Content-Type": "application/json"},
    json={
        "videoType": 1,
        "text": "A cat jumping on a bed",
        "resolution": "480p",
        "ratio": "16:9",
        "duration": 4,
        "model": "seedance-2.0",
    },
)
resp.raise_for_status()
task_id = resp.json()["data"]["taskId"]
print(f"taskId = {task_id}")

# 2. Poll until terminal status. Video tasks take longer — poll every 20s.
while True:
    time.sleep(20)
    poll = requests.get(f"{BASE}/video-generations/{task_id}", headers=HEADERS)
    poll.raise_for_status()
    data = poll.json()["data"]
    status = data["status"]
    print(f"status = {status}")
    if status != "pending":
        break

if status != "success":
    raise RuntimeError(f"video generation failed: {data.get('message')}")

print(f"videoUrl = {data['videoUrl']}")
if data.get("lastFrameUrl"):
    print(f"lastFrameUrl = {data['lastFrameUrl']}")

GET https://api.ciyuan-market.com/api/v1/billing/balance

ส่งคืนยอดคงเหลือบัญชีแบ่งเป็นกระเป๋าเงินสามใบ: แผนรายเดือน แพ็กเกจทรัพยากร และ เครดิตจ่ายตามการใช้งาน

curl --request GET \
  --url https://api.ciyuan-market.com/api/v1/billing/balance \
  --header "Authorization: Bearer $CIYUAN_MARKET_API_KEY"

{
  "totalCredit": 128.50,
  "totalResourceCredit": 30.00,
  "wallets": {
    "monthlyPlan": {"id": "pkg_xxx", "credit": 50.00, "name": "Monthly plan"},
    "resourcePacks": [
      {"id": "rp_xxx", "credit": 30.00, "name": "Video resource pack"}
    ],
    "payAsYouGo": 48.50
  }
}

ฟิลด์การตอบกลับ:

WalletDetailVO fields::

GET https://api.ciyuan-market.com/api/v1/usage

รายละเอียดการเรียกเก็บเงินการเรียกโมเดลแบบแบ่งหน้า สแนปชอตตามราคา (priceSnapshotId) เรียงตามเวลาสร้างคำสั่งซื้อจากมากไปน้อย ส่งคืนเฉพาะ ระเบียนค่าใช้จ่ายปกติ (reason = model usage) เท่านั้น

พารามิเตอร์การค้นหา:

curl --request GET \
  --url "https://api.ciyuan-market.com/api/v1/usage?page=1&size=20&startTime=2026-07-01T00:00:00&endTime=2026-07-31T23:59:59" \
  --header "Authorization: Bearer $CIYUAN_MARKET_API_KEY"

ตัวห่อหุ้มการตอบกลับ:

{
  "code": 0,
  "message": "success",
  "data": { ... }
}

UsageDetailVO fields:

CreditDetailItem fields:

อนุสัญญาค่าว่าง: เฉพาะฟิลด์ที่เกี่ยวข้องกับแต่ละ modelType เท่านั้นที่ ถูกเติม ส่วนที่เหลือเป็น null text เติมฟิลด์โทเค็น image เติม imageCount/imageResolution/imageRatio video เติม videoResolution/videoRatio/videoDurationSec

ตัวอย่างการตอบกลับ:

{
  "code": 200,
  "message": "success",
  "data": {
    "records": [
      {
        "priceSnapshotId": "snap_9f3c1a2b",
        "taskId": "task_5e8a1c33",
        "credit": 0.0342,
        "model": "glm-5.2",
        "modelType": "text",
        "inputTokens": 1280,
        "outputTokens": 642,
        "totalTokens": 1922,
        "cacheReadTokens": 0,
        "cacheWriteTokens": 0,
        "imageCount": null,
        "imageResolution": null,
        "imageRatio": null,
        "videoResolution": null,
        "videoRatio": null,
        "videoDurationSec": null,
        "orderCreatedAt": "2026-07-18T14:23:11",
        "creditDetails": [
          {
            "credit": 0.0342,
            "deductionSource": "balance",
            "packageName": ""
          }
        ]
      },
      {
        "priceSnapshotId": "snap_a12f77c0",
        "taskId": "task_c71e44a2",
        "credit": 1.8000,
        "model": "seedance-2.0",
        "modelType": "video",
        "inputTokens": null,
        "outputTokens": null,
        "totalTokens": null,
        "cacheReadTokens": null,
        "cacheWriteTokens": null,
        "imageCount": null,
        "imageResolution": null,
        "imageRatio": null,
        "videoResolution": "1080p",
        "videoRatio": "16:9",
        "videoDurationSec": 8,
        "orderCreatedAt": "2026-07-17T22:41:09",
        "creditDetails": [
          {
            "credit": 1.5000,
            "deductionSource": "Monthly Package",
            "packageName": "基础月度套餐"
          },
          {
            "credit": 0.3000,
            "deductionSource": "Resource Package",
            "packageName": "byteplus视频资源包"
          }
        ]
      }
    ],
    "total": 128,
    "current": 1,
    "size": 20,
    "pages": 7
  }
}

GET https://api.ciyuan-market.com/api/v1/billing/transactions

รายการแบบแบ่งหน้าของธุรกรรมการเติมเงินที่ชำระแล้ว (status=2) ของผู้ใช้ปัจจุบัน เรียงตาม created_at จากมากไปน้อย

curl --request GET \
  --url "https://api.ciyuan-market.com/api/v1/billing/transactions?page=1&size=20&startTime=2026-07-01%2000:00:00&endTime=2026-07-31%2023:59:59" \
  --header "Authorization: Bearer $CIYUAN_MARKET_API_KEY"

ตัวห่อหุ้มการตอบกลับ:

{
  "code": 0,
  "message": "success",
  "data": { ... }
}

TransactionVO fields:

TransactionVO fields:

{
  "code": 200,
  "message": "success",
  "data": {
    "records": [
      {
        "orderNo": "R20260718abc123",
        "thirdPartyOrderNo": "wx_pay_xxx",
        "amount": 50.00,
        "actualAmount": 48.50,
        "discount": 1.50,
        "paymentMethod": "wechat",
        "serviceFeeAmount": 0.00,
        "paymentChannel": "wechat",
        "source": "recharge",
        "packageName": null,
        "createdAt": "2026-07-18T14:23:11"
      }
    ],
    "total": 28,
    "current": 1,
    "size": 20,
    "pages": 2
  }
}

การดำเนินงาน

ข้อผิดพลาด

ciyuan_market ส่งคืนรหัสข้อผิดพลาดที่เสถียรเพื่อให้แอปพลิเคชันสามารถจัดการการลองใหม่ การสำรอง ปัญหาการเรียกเก็บเงิน และการดีบักได้อย่างสม่ำเสมอ

จุดเชื่อมต่อที่เข้ากันได้กับผู้ให้บริการจะพยายามรักษารูปร่างข้อผิดพลาด ของตระกูล API ต้นฉบับเมื่อเป็นไปได้ จุดเชื่อมต่อ ciyuan_market-native ใช้ออบเจ็กต์ข้อผิดพลาด ciyuan_market

HTTP status and error code mapping

รหัสข้อผิดพลาดทั่วไป

ฟีเจอร์

• 🤖 แชทหลาย API: รองรับเอนด์พอยต์ที่เข้ากันได้กับ OpenAI Chat Completions, Anthropic Messages และ OpenAI Responses
• 🖼️ การสร้างมัลติมีเดีย: นอกจากแชทข้อความแล้ว ยังรองรับงานแบบอะซิงโครนัสสำหรับสร้างภาพและวิดีโอ (ข้อความเป็นภาพ, ภาพเป็นภาพ, เฟรมแรก/สุดท้าย, สินทรัพย์อ้างอิง)
• 🔍 การค้นหาโมเดลและบัญชี: แสดงรายการโมเดลที่พร้อมใช้งาน รายละเอียดโมเดล ยอดคงเหลือในบัญชี รายละเอียดการใช้งาน/การเรียกเก็บเงิน และธุรกรรมการเติมเงิน
• 🔑 ส่งคีย์ผ่านส่วนหัว: การเรียกทุกครั้งจะอ่านคีย์ API จากส่วนหัวของคำขอ ดังนั้นการติดตั้งใช้งานเพียงครั้งเดียวสามารถใช้ร่วมกันได้หลายบัญชี — เซิร์ฟเวอร์จะไม่จัดเก็บหรือแคชคีย์ใด ๆ ไว้เลย

เริ่มต้นอย่างรวดเร็ว

ใช้งานผ่าน Claude Code (แนะนำ) เพิ่ม -s user เพื่อลงทะเบียนในระดับผู้ใช้ (ใช้ได้กับทุกโปรเจกต์ของคุณ)

ขั้นตอนที่ 1: เพิ่มการเชื่อมต่อ

claude mcp add --transport http ciyuanmarket https://api.ciyuan-market.com/mcp \
  --header "X-Ciyuanmarket-Api-Key: <your ciyuan_market API key>" \
  -s user

ขั้นตอนที่ 2: ตรวจสอบการเชื่อมต่อ

claude mcp list          # should show ✓ Connected
claude mcp get ciyuanmarket  # should show Scope: User config (available in all your projects)

ขั้นตอนที่ 3: เริ่มใช้งาน

คุณสามารถขอให้ Claude ทำสิ่งต่าง ๆ ได้ เช่น

• "ใช้ ciyuan_market เรียก claude-sonnet-5 แล้วเขียนบทกวีเกี่ยวกับฤดูใบไม้ร่วง"
• "แสดงรายการโมเดลที่พร้อมใช้งานในบัญชี ciyuan_market ของฉัน"
• "ตรวจสอบยอดคงเหลือและการใช้งานล่าสุดของ ciyuan_market ของฉัน"
• "ใช้ ciyuan_market สร้างภาพเมืองยามค่ำคืนสไตล์ไซเบอร์พังก์"

Claude จะเรียกใช้เครื่องมือ MCP ที่ตรงกันโดยอัตโนมัติและส่งคืนผลลัพธ์

การใช้งานกับ Claude Desktop

เพิ่มสิ่งนี้ลงในส่วน mcpServers

{
  "mcpServers": {
    "ciyuanmarket": {
      "type": "http",
      "url": "https://api.ciyuan-market.com/mcp",
      "headers": {
        "X-Ciyuanmarket-Api-Key": "<your ciyuan_market API key>"
      }
    }
  }
}

การใช้งานกับ Codex CLI

แนะนำ: ใช้ env_http_headers เพื่ออ่านคีย์จากตัวแปรสภาพแวดล้อม

ตั้งค่าตัวแปรสภาพแวดล้อมในเชลล์ของคุณก่อน

export CIYUAN_MARKET_API_KEY=<your ciyuan_market API key>

จากนั้นใน ~/.codex/config.toml

[mcp_servers.ciyuanmarket]
url = "https://api.ciyuan-market.com/mcp"
env_http_headers = { "X-Ciyuanmarket-Api-Key" = "CIYUAN_MARKET_API_KEY" }

อีกวิธี: ใช้ http_headers เพื่อเขียนคีย์ลงในไฟล์ตั้งค่าโดยตรง (สะดวกหากคุณไม่ต้องการจัดการตัวแปรสภาพแวดล้อมแยก แต่โปรดทราบว่าคีย์จะถูกจัดเก็บเป็นข้อความล้วนในไฟล์ตั้งค่า)

[mcp_servers.ciyuanmarket]
url = "https://api.ciyuan-market.com/mcp"
http_headers = { "X-Ciyuanmarket-Api-Key" = "<your ciyuan_market API key>" }

หากเพิ่มผ่านหน้าตั้งค่าของ Codex

• ประเภท: HTTP / Streamable HTTP
• ชื่อ: ciyuanmarket
• URL: https://api.ciyuan-market.com/mcp
• ชื่อส่วนหัว: X-Ciyuanmarket-Api-Key
• ค่าส่วนหัว: คีย์ API ciyuan_market ของคุณ

ตรวจสอบการเชื่อมต่อ

หลังจากเปิด Codex CLI คำสั่ง /mcp จะแสดงรายการเซิร์ฟเวอร์ MCP ที่ตั้งค่าไว้และสถานะการเชื่อมต่อ — เพียงยืนยันว่าโหลด สำเร็จ รูปแบบการใช้งานเหมือนกับ Claude คือ Codex จะเลือกเครื่องมือที่ถูกต้อง โดยอัตโนมัติ

หากไฟล์ตั้งค่าของคุณมีเซิร์ฟเวอร์ MCP อื่นอยู่แล้ว ให้เพิ่มรายการนี้ในระดับเดียวกัน ปิด Claude Desktop ให้สนิทแล้วเปิดใหม่หลังแก้ไข

เครื่องมือ

เซิร์ฟเวอร์ MCP นี้มีเครื่องมือ 14 รายการ แบ่งเป็นห้าหมวดหมู่

1. แชท

1. chat_completion — Chat Completions

ส่งคำขอสนทนาหนึ่งครั้งและส่งกลับคำตอบเต็มของโมเดล (ไม่สตรีม) นอกจากข้อความแล้ว ยังรับภาพเพื่อการเข้าใจภาพได้ (โมเดลต้องรองรับ vision) — เปลี่ยน content ของข้อความจาก string เป็นarray ของบล็อกเนื้อหา ผสม text กับ image_url

อินพุตหลายโมดัล (text / image / video)

อินพุตภาพ (URL):

{"role": "user", "content": [
  {"type": "text", "text": "ในภาพนี้มีอะไร?"},
  {"type": "image_url", "image_url": {"url": "https://example.com/image.jpg"}}
]}

อินพุตภาพ (Base64):

{"type": "image_url", "image_url": {"url": "data:image/jpeg;base64,<BASE64_STRING>"}}

รูปแบบที่รองรับ: PNG, JPEG, GIF (เฉพาะเฟรมแรก), WebP. ขนาดรูปภาพเดียวจำกัด 20MB.

หมายเหตุ: รูปภาพขนาดใหญ่ที่เข้ารหัส Base64 จะได้สตริงที่ยาวมาก อาจล้มเหลวเนื่องจากเนื้อความคำขอใหญ่เกินไป แนะนำให้ส่งภาพผ่าน URL

พารามิเตอร์ detail (ไม่บังคับ ตั้งใน object image_url) ควบคุมความละเอียดการประมวลผลภาพ: "auto" (ค่าเริ่มต้น — โมเดลตัดสินตามขนาด) / "low" (ภาพย่อ 512x512 เร็วและประหยัด เหมาะกับการจำแนกง่าย ๆ) / "high" (ความละเอียดเต็ม เหมาะกับอ่านอักษรเล็ก/รายละเอียด) ใน array content ของข้อความหนึ่งสามารถใส่บล็อก image_url หลายบล็อกเพื่อส่งภาพหลายภาพได้

Video input (URL):

{"role": "user", "content": [
  {"type": "text", "text": "อธิบายสิ่งที่เกิดขึ้นในวิดีโอนี้"},
  {"type": "video_url", "video_url": {"url": "https://example.com/video.mp4"}}
]}

Video input (Base64):

{"type": "video_url", "video_url": {"url": "data:video/mp4;base64,<BASE64_STRING>"}}

โมเดลที่รองรับการป้อนข้อมูลวิดีโอบน ciyuan_market ได้แก่ โมเดลบางรุ่นจากซีรีส์ Qwen, Doubao (dola-seed), Kimi, MiniMax — ตรวจสอบ input_modalities ที่ส่งกลับโดย list_models มาตรฐาน Chat Completions อย่างเป็นทางการของ OpenAI ไม่รองรับวิดีโอแบบ native แต่ ciyuan_market gateway รองรับผ่าน

{"type": "video_url", "video_url": {"url": "..."}}

รูปแบบส่วนขยาย รูปแบบนี้สอดคล้องกับรูปแบบ video_url ที่ใช้โดย OpenRouter, NVIDIA NIM, vLLM และแพลตฟอร์มอื่น ๆ

2. create_message — เข้ากันได้กับ Anthropic Messages

เรียก endpoint ที่รองรับ Anthropic Messages (ไม่สตรีม) บล็อกเนื้อหารองรับ text, image, tool_use, tool_result, thinking, redacted_thinking ส่งภาพผ่านบล็อกเนื้อหา

{"type": "image", "source": {...}}

อินพุตหลายโมดัล (text / image / video)

อินพุตภาพรองรับ source สามแบบ:

1. เข้ารหัส Base64 (หมายเหตุ: ฟิลด์ data เป็น string Base64 ล้วน ไม่มีคำนำหน้า data:); media_type รองรับ image/jpeg, image/png, image/gif, image/webp:

{"type": "image", "source": {
  "type": "base64",
  "media_type": "image/jpeg",
  "data": "<BASE64_STRING>"
}}

2. อ้างอิง URL:

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

3. File ID (อัปโหลดภาพผ่าน Files API ด้วย purpose="vision" ก่อนเพื่อรับ file_id):

{"type": "image", "source": {
  "type": "file",
  "file_id": "<file_id>"
}}

ใน array content ของข้อความหนึ่งสามารถใส่บล็อก image หลายบล็อกเพื่อส่งภาพหลายภาพ

หมายเหตุ: รูปภาพขนาดใหญ่ที่เข้ารหัส Base64 จะได้สตริงที่ยาวมาก อาจล้มเหลวเนื่องจากเนื้อความคำขอใหญ่เกินไป แนะนำให้ส่งภาพผ่าน URL

อินพุตวิดีโอ: API Anthropic Messages ไม่รองรับไฟล์วิดีโอโดยกำเนิด สำหรับเข้าใจวิดีโอ ให้สกัดคีย์เฟรมด้วย ffmpeg หรือเครื่องมือทำนองเดียวกันก่อน แล้วส่งแต่ละเฟรมเป็นบล็อกเนื้อหา image บาง gateway ที่รองรับอาจขยายรองรับ

{"type": "video", "source": {...}}

และรูปแบบทำนองเดียวกัน — ดูเอกสาร gateway ของคุณ For models supporting video input on ciyuan_market (check input_modalities via list_models), use chat_completion or create_response for native video support.

3. create_response — เข้ากันได้กับ OpenAI Responses

ใช้ input แทน messages, instructions แทนข้อความระบบ และ text.format แทน response_format นอกจากข้อความแล้ว ยังรับภาพเพื่อการเข้าใจภาพได้ (โมเดลต้องรองรับ vision) — ตั้ง input เป็น array ของ object ข้อความ โดย content เป็น array ของบล็อกเนื้อหาผสมข้อความกับภาพ

อินพุตหลายโมดัล (text / image / video)

หมายเหตุ: Responses API ใช้ประเภทบล็อกเนื้อหา input_text / input_image / input_video (ไม่ใช่ text / image_url / video_url ของ Chat Completions) และ image_url / video_url เป็น string ตรง ๆ ไม่ใช่ object ซ้อน

อินพุตภาพ (URL):

[{"role": "user", "content": [
  {"type": "input_text", "text": "ในภาพนี้มีอะไร?"},
  {"type": "input_image", "image_url": "https://example.com/image.jpg"}
]}]

อินพุตภาพ (Base64):

{"type": "input_image", "image_url": "data:image/jpeg;base64,<BASE64_STRING>"}

รูปแบบที่รองรับ: PNG, JPEG, GIF (เฉพาะเฟรมแรก), WebP. ขนาดรูปภาพเดียวจำกัด 20MB.

หมายเหตุ: รูปภาพขนาดใหญ่ที่เข้ารหัส Base64 จะได้สตริงที่ยาวมาก อาจล้มเหลวเนื่องจากเนื้อความคำขอใหญ่เกินไป แนะนำให้ส่งภาพผ่าน URL

อินพุตภาพ (File ID):

{"type": "input_image", "file_id": "<file_id>"}

file_id ได้จากการอัปโหลดภาพผ่าน Files API ด้วย purpose="vision"

พารามิเตอร์ detail (ไม่บังคับ ใน object input_image) ควบคุมความละเอียดการประมวลผล: "auto" (ค่าเริ่มต้น) / "low" (ภาพย่อ 512x512 เร็วและประหยัด) / "high" (ความละเอียดเต็ม อ่านอักษรเล็ก/รายละเอียด) / "original" (ความละเอียดดั้งเดิม) ใน array content ของข้อความหนึ่งสามารถใส่บล็อก input_image หลายบล็อกเพื่อส่งภาพหลายภาพได้

Video input (URL):

[{"role": "user", "content": [
  {"type": "input_text", "text": "อธิบายสิ่งที่เกิดขึ้นในวิดีโอนี้"},
  {"type": "input_video", "video_url": "https://example.com/video.mp4"}
]}]

Video input (Base64):

{"type": "input_video", "video_url": "data:video/mp4;base64,<BASE64_STRING>"}

Video input (File ID):

{"type": "input_video", "file_id": "<file_id>"}

โมเดลที่รองรับการป้อนข้อมูลวิดีโอบน ciyuan_market ได้แก่ โมเดลบางรุ่นจากซีรีส์ Qwen, Doubao (dola-seed), Kimi, MiniMax — ตรวจสอบ input_modalities ที่ส่งกลับโดย list_models มาตรฐาน Responses API อย่างเป็นทางการของ OpenAI ไม่รองรับวิดีโอแบบ native แต่ ciyuan_market gateway รองรับผ่าน

{"type": "input_video", "video_url": "..."}

รูปแบบส่วนขยาย รูปแบบนี้สอดคล้องกับรูปแบบ input_video ที่ใช้โดย BytePlus/Volcengine และแพลตฟอร์มอื่น ๆ

2. โมเดลและบัญชี

4. list_models — แสดงรายการโมเดลที่พร้อมใช้งาน

ส่งคืนโมเดลที่พร้อมใช้งานสำหรับบัญชีปัจจุบัน พร้อมเมทาดาต้าผู้ให้บริการ โมดัลลิตี้ ความสามารถ และราคา ไม่มีพารามิเตอร์ แต่ละรายการในลิสต์มีช่วงราคา price_tiers ซึ่งเป็นราคาเรียกเก็บที่มีผลของผู้เรียก ตรงกับการหักเงินจริง (ดู คู่มือฟิลด์ช่วงราคา)

5. get_model — ดูรายละเอียดโมเดลเดียว

ผลลัพธ์มีช่วงราคา price_tiers (ดู คู่มือฟิลด์ช่วงราคา) เมื่อโมเดลไม่มีอยู่จะส่ง 404 โดยไม่มีฟิลด์ราคา

6. get_balance — ตรวจสอบยอดคงเหลือในบัญชี

ส่งคืนการใช้งานและยอดคงเหลือของบัญชีปัจจุบัน ไม่มีพารามิเตอร์

3. การเรียกเก็บเงิน

7. list_usage — รายละเอียดการใช้งาน/การเรียกเก็บเงินของโมเดล

รายละเอียดการเรียกเก็บเงินจากการใช้งานโมเดลแบบแบ่งหน้า เรียงตามเวลาที่สร้างคำสั่งจากใหม่ไปเก่า มีเฉพาะค่าใช้จ่ายจากการใช้งานปกติเท่านั้น — ไม่รวมการเติมเงินหรือการปรับปรุง

8. list_transactions — ธุรกรรมการเติมเงิน/แพ็กเกจ

ธุรกรรมการเติมเงิน / การซื้อแพ็กเกจที่ชำระเงินแล้วแบบแบ่งหน้า เรียงตามเวลาที่สร้างจากใหม่ไปเก่า

4. การสร้างภาพ

9. list_image_models — แสดงรายการโมเดลสร้างภาพ

ส่งคืนโมเดลสร้างภาพที่รองรับ พร้อมความละเอียด สัดส่วนภาพ จำนวนภาพสูงสุด (maxCount) และจำนวนภาพอ้างอิงสูงสุด (fileMax) ไม่มีพารามิเตอร์ ตรวจสอบสิ่งนี้ก่อนสร้างภาพ — คุณสามารถส่งค่าที่ระบุไว้เท่านั้น แต่ละรายการในลิสต์มีช่วงราคา priceTiers (ดู คู่มือฟิลด์ช่วงราคา)

10. create_image_generation — ส่งงานสร้างภาพ

ส่งแบบอะซิงโครนัสและส่งคืน taskId ทันที; จะหักเครดิตของบัญชี

11. get_image_generation — โพลงานสร้างภาพ

ผลลัพธ์: status คือ pending / success / failed; images คืออาร์เรย์สตริง JSON ของ URL ภาพ; text ให้ข้อความเพิ่มเติมจากโมเดล (เช่น เอาต์พุตมัลติโมดัลของ Gemini)

5. การสร้างวิดีโอ

12. list_video_models — แสดงรายการโมเดลสร้างวิดีโอ

ส่งคืนโมเดลสร้างวิดีโอที่รองรับ พร้อม allowedVideoTypes ช่วงระยะเวลา (videoDurationMin/Max) ความละเอียด สัดส่วนภาพ และขีดจำกัดสินทรัพย์อ้างอิง (fileMax) ไม่มีพารามิเตอร์ ตรวจสอบสิ่งนี้ก่อนสร้างวิดีโอ แต่ละรายการในลิสต์มีช่วงราคา priceTiers (ดู คู่มือฟิลด์ช่วงราคา)

13. create_video_generation — ส่งงานสร้างวิดีโอ

ส่งแบบอะซิงโครนัสและส่งคืน taskId ทันที; จะหักเครดิตของบัญชี

ความหมายของ video_type:

14. get_video_generation — โพลงานสร้างวิดีโอ

คู่มือฟิลด์ช่วงราคา

ผลลัพธ์ของเครื่องมือค้นหาโมเดล 4 ตัวนี้ — list_models, get_model, list_image_models, list_video_models — ส่ง ราคาเรียกเก็บที่มีผล ของผู้เรียก (ผู้ใช้ API Key) ซึ่งตรงกับการหักเงินจริงทุกประการ และรวม ช่วงราคาทั้งหมด ของโมเดล

ความแตกต่างของชื่อ: list_models / get_model ใช้ snake_case ของ OpenAI (price_tiers); list_image_models / list_video_models ใช้ camelCase (priceTiers) โครงสร้างเหมือนกัน

price_tiers / priceTiers เป็น array แต่ละอิลิเมนต์คือหนึ่งช่วงราคา:

โมเดล 3 ประเภทใช้โครงสร้างเดียวกัน ต่างเพียงฟิลด์คำอธิบาย และฟิลด์ที่ไม่ใช้จะเป็น null:

ความหมายของราคา: inputPrice / outputPrice / cacheReadPrice / cacheWritePrice ฯลฯ ที่ส่งกลับ คือราคาหน่วยเรียกเก็บสุดท้าย สำหรับผู้ใช้ API Key ปัจจุบัน ที่คำนวณผ่าน chain → guidance → ราคาพื้นฐาน และตรงกับการหักเงินจริง ราคาหน่วยที่ผู้เรียกเห็นจะต่างกันตาม chain ราคาของตน (reseller / distributor / องค์กร / การตั้งค่าระดับผู้ใช้)

การหักเงินจริง = ปริมาณ ÷ quantity × ราคาหน่วย × ratio สำหรับเรียกเก็บวิดีโอต่อวินาที: การหักเงินจริง = duration × outputPrice × ratio

กรณีขอบและการจัดการข้อผิดพลาด (endpoint แบบอ่านอย่างเดียวจะไม่ส่ง 500 เพราะปัญหาคอนฟิกราคา):

ตัวอย่างการตอบ (list_models, โมเดลข้อความ):

{
  "object": "list",
  "data": [
    {
      "id": "gpt-4o",
      "object": "model",
      "display_name": "gpt-4o",
      "context_length": 128000,
      "description": "...",
      "price_tiers": [
        {
          "region": "GLOBAL",
          "bandMin": null,
          "bandMax": null,
          "resolution": null,
          "clarity": null,
          "unit": "token",
          "quantity": 1000,
          "description": "ต่อ 1K token",
          "inputPrice": 0.0025,
          "outputPrice": 0.01,
          "cachePrice": 0.00125,
          "cacheReadPrice": 0,
          "cacheWritePrice": 0,
          "ratio": 1,
          "mode": "RATIO",
          "planId": null
        }
      ]
    }
  ]
}

ตัวอย่างการตอบ (list_image_models, โมเดลภาพ; priceTiers โครงสร้างเหมือนกัน unit เป็น image):

{
  "object": "list",
  "data": [
    {
      "id": "dall-e-3",
      "object": "image_model",
      "displayName": "dall-e-3",
      "resolutions": ["1024x1024", "1792x1024", "1024x1792"],
      "priceTiers": [
        {
          "region": null,
          "bandMin": null,
          "bandMax": null,
          "resolution": "1024x1024",
          "clarity": "standard",
          "unit": "image",
          "quantity": 1,
          "description": "ต่อภาพ",
          "inputPrice": 0,
          "outputPrice": 0.04,
          "cachePrice": 0,
          "cacheReadPrice": 0,
          "cacheWritePrice": 0,
          "ratio": 1,
          "mode": "RATIO",
          "planId": null
        }
      ]
    }
  ]
}

ตัวอย่าง

ตัวอย่างที่ 1: คำขอแชทแบบพื้นฐาน

ถาม: "ใช้ ciyuan_market เรียก claude-sonnet-5 แล้วถามว่า GIL ของ Python คืออะไร"

AI จะเรียก chat_completion ด้วย

{
  "model": "claude-sonnet-5",
  "messages": [{"role": "user", "content": "What is Python's GIL?"}]
}

ตัวอย่างที่ 2: การใช้เครื่องมือผ่านเอนด์พอยต์ Anthropic Messages

ถาม: "ใช้เอนด์พอยต์ Messages ของ ciyuan_market แล้วให้โมเดลตัดสินใจว่าจะตรวจสอบสภาพอากาศหรือไม่"

AI จะเรียก create_message โดยส่งคำนิยามเครื่องมือและ tool_choice; การตอบกลับจะมีบล็อกเนื้อหา tool_use รวมอยู่ด้วย

ตัวอย่างที่ 3: แสดงรายการโมเดลที่พร้อมใช้งาน

ถาม: "แสดงรายการโมเดลในบัญชี ciyuan_market ของฉัน"

AI จะเรียก list_models ซึ่งส่งคืนรหัส ผู้ให้บริการ โมดัลลิตี้ ราคา และข้อมูลอื่น ๆ ของโมเดลที่พร้อมใช้งานทั้งหมด

ตัวอย่างที่ 4: ตรวจสอบยอดคงเหลือและการใช้งาน

ถาม: "ตรวจสอบการใช้งาน ciyuan_market ของฉันในเดือนนี้"

AI จะเรียก get_balance เพื่อดูยอดคงเหลือ จากนั้นเรียก list_usage (กำหนด start_time ให้อยู่ในเดือนนี้) เพื่อดูรายละเอียดการใช้งาน

ตัวอย่างที่ 5: สร้างภาพ

ถาม: "ใช้ ciyuan_market สร้างภาพเมืองยามค่ำคืนสไตล์ไซเบอร์พังก์"

AI จะเรียก list_image_models ก่อนเพื่อตรวจสอบข้อกำหนด จากนั้นเรียก create_image_generation เพื่อรับ taskId แล้วโพล get_image_generation เพื่อดู URL ของภาพ

ตัวอย่างที่ 6: ข้อความเป็นวิดีโอ

ถาม: "ใช้ ciyuan_market สร้างวิดีโอ 5 วินาทีของเนบิวลาในอวกาศ"

AI จะเรียก list_video_models ก่อนเพื่อตรวจสอบข้อกำหนด จากนั้นเรียก create_video_generation (video_type=1, duration=5) และหลังจาก ได้ taskId แล้ว จะโพล get_video_generation

คำถามที่พบบ่อย

การเรียกเครื่องมือล้มเหลวด้วย "missing ciyuan_market API Key"

• คุณรัน claude mcp add โดยไม่ใส่ --header หรือคีย์ไม่ถูกต้อง
• หากแก้ไขไฟล์ตั้งค่า JSON โดยตรง ชื่อฟิลด์ headers ไม่ถูกต้อง (ควรเป็น X-Ciyuanmarket-Api-Key)
• รันในเครื่องโดยไม่ได้ตั้งค่าตัวแปรสภาพแวดล้อม CIYUAN_MARKET_API_KEY

การเรียกเครื่องมือล้มเหลวด้วย "ciyuan_market returned 401 unauthorized"

คีย์ API เองไม่ถูกต้องหรือหมดอายุ — สร้างใหม่ในคอนโซล ciyuan_market

Claude ไม่เรียกเครื่องมือของ ciyuan_market — ต้องทำอย่างไร

• ยืนยันว่าการเชื่อมต่อแสดง ✓ Connected ผ่าน claude mcp list
• ตรวจสอบสถานะการเชื่อมต่อ: claude mcp get ciyuanmarket
• ลองระบุให้ชัดเจน: "ใช้เครื่องมือ chat_completion ของ ciyuan_market เรียก claude-sonnet-5 …"

การสร้างภาพ/วิดีโอค้างสถานะ pending ตลอดไป

• โพลงานภาพด้วย get_image_generation และงานวิดีโอด้วย get_video_generation — โปรดทราบว่าสถานะของงานวิดีโอที่กำลังทำงานคือ "running" ไม่ใช่ "pending"
• การสร้างใช้เวลา ปกติไม่กี่ถึงหลายสิบวินาที นานกว่านั้นสำหรับวิดีโอ
• หากคุณส่ง callback_url ไว้ งานจะเรียกกลับเมื่อเสร็จสิ้น — ไม่ต้องโพล

list_image_models / list_video_models เกิดข้อผิดพลาด

ทั้งสองเครื่องมือนี้ไม่หักเครดิตเอง — ข้อผิดพลาดมักชี้ไปที่ปัญหาคีย์หรือเครือข่าย ให้ยืนยันก่อนว่า list_models ทำงานได้ตามปกติ

ข้อควรทราบ

• ชื่อส่วนหัว:MCP ส่งคีย์ผ่าน X-Ciyuanmarket-Api-Key
• การหักเครดิต:chat_completion / create_message / create_response / create_image_generation / create_video_generation ทั้งหมดหักเครดิตของบัญชี — ตรวจสอบ get_balance ก่อนหากต้องการรู้ยอดคงเหลือล่วงหน้า
• ตรวจสอบข้อกำหนดก่อนสร้าง:พารามิเตอร์การสร้างภาพ/วิดีโอ เช่น model, resolution, ratio, count, duration และ video_type ต้องใช้เฉพาะค่าที่ระบุโดย list_image_models / list_video_models เท่านั้น ไม่เช่นนั้นการเรียกจะเกิดข้อผิดพลาด
• ไม่มีการสตรีม:เอนด์พอยต์แชททั้งสามไม่รองรับการสตรีม — แต่ละเอนด์พอยต์จะส่งคืนผลลัพธ์ทั้งหมดในครั้งเดียว
• การออกแบบแบบไม่มีสถานะ:คำขอทุกครั้งเป็นอิสระจากกันและไม่มีการจัดเก็บเซสชัน สำหรับการสนทนาแบบหลายรอบ ให้ใช้ create_response กับ previous_response_id หรือดูแลประวัติด้วยตัวเองใน messages