AI Gridเอกสาร
สมัครใช้งาน

โมเดล

แสดงสิ่งที่คีย์ของคุณเรียกใช้ได้จริง — ชุดของโปรเจกต์คุณ ไม่ใช่แค็ตตาล็อกทั้งหมด

อัปเดต 9 ก.ย. 2026
GET/v1/models
bash
curl https://api.aigridapp.com/v1/models \
  -H "Authorization: Bearer $AIGRID_API_KEY"

สิ่งที่ส่งกลับ#

json
{
  "object": "list",
  "data": [
    {
      "id": "openai/gpt-oss-20b",
      "object": "model",
      "created": 1754870400,
      "name": "GPT OSS 20B",
      "description": "…",
      "owned_by": "AI Grid",
      "modality": "text->text",
      "context_length": 128000,
      "max_output_tokens": 8192,
      "architecture": { "modality": "text->text", "input_modalities": ["text"], "output_modalities": ["text"] },
      "top_provider": { "context_length": 128000, "max_completion_tokens": 8192, "is_moderated": false },
      "supported_parameters": ["max_tokens", "temperature", "top_p", "stop", "seed", "tools", "tool_choice", "response_format", "stream"],
      "pricing": {
        "unit": "tokens",
        "prompt": "0.00000005",
        "completion": "0.00000025",
        "input_usd_per_1m": 0.05,
        "output_usd_per_1m": 0.25
      }
    }
  ]
}

แต่ละรายการมี id, object, created, name, description, owned_by, modality, context_length, max_output_tokens, architecture, top_provider, supported_parameters และ pricing

Pricing มีสองรูปแบบ แยกด้วย unit:

  • tokens — prompt และ completion เป็น USD ต่อ token พร้อม input_usd_per_1m / output_usd_per_1m ที่อ่านง่ายกว่า
  • request — request เป็น USD ต่อการเรียกที่สำเร็จ พร้อม usd_per_request

ไม่แสดงอัตราขายส่งฝั่งผู้ให้บริการ

ขอบเขตคือโปรเจกต์ของคุณ#

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

  • ผลิตภัณฑ์ที่เผยแพร่แล้วและกำหนดให้โปรเจกต์ของคีย์ (เฉพาะ chat product — media product มี interface ของตนเอง) และถูกจำกัดต่อด้วย access policy ของคีย์
  • sandbox product ของโปรเจกต์ที่ active มี revision ที่เปิดใช้ และ contract เป็นข้อความเข้าหนึ่งรายการ/ข้อความออกหนึ่งรายการ

ไม่ใช่แค็ตตาล็อกทั้งองค์กรหรือทั้งระบบ และ data ที่ว่างเป็นคำตอบที่ถูกต้อง หมายความว่าโปรเจกต์ยังไม่มีสิ่งที่กำหนดให้เรียกได้ ไม่ใช่ API เสีย วิธีแก้คือให้ผู้ดูแลกำหนด assignment ไม่ใช่ retry ดู Catalogue and assignments

รายการแซนด์บ็อกซ์มีเครื่องหมายให้แยกได้:

json
{
  "id": "sbx-…",
  "owned_by": "<project name>",
  "pricing": { "unit": "execution", "prompt": "0", "completion": "0", "request": "0" },
  "aigrid": { "kind": "sandbox", "revision": 3, "invoke": "/v1/sandbox/sbx-…/invoke" }
}

แซนด์บ็อกซ์คิดราคาเป็นราย execution: การเรียก dependency ที่อยู่ภายใต้การกำกับภายในจะคิดกับโปรเจกต์ขณะเกิดขึ้น ดู Sandbox products

Model id#

ใช้ id ตามเดิมเป็นฟิลด์ model ใน การเติมข้อความในแชต id มีความเสถียร

Grid รายงานโมเดล ไม่รายงาน provider key หรือ origin ที่อยู่เบื้องหลัง นี่เป็นเจตนาเพื่อให้เปลี่ยนผู้ให้บริการได้โดย integration ของคุณไม่ต้องเปลี่ยน

ขั้นตอนถัดไป#