Langsung ke konten
Kemampuan

Kemampuan

Apa yang dapat dilakukan setiap model melalui API, model demi model: tools, input gambar, reasoning, output JSON, prompt caching, pencarian web, dan streaming.

Setiap model diakses lewat tiga endpoint yang sama dengan kunci yang sama. Kedua tabel menunjukkan perbedaan antarmodel. Tanda strip berarti model menjawab tanpa kemampuan itu.

Model Shannon

Model ToolsGambarReasoningEffortObjek JSONJSON schemaCachingPencarianStreaming
shannon-1.6-lite YaYa——YaYa—YaYa
shannon-1.6-pro YaYaYa—YaYa—YaYa
shannon-2-lite Ya—Ya—YaYa—YaYa
shannon-2-pro Ya—Ya—YaYa—YaYa
shannon-3 YaYaYa—YaYa—YaYa
shannon-3-pro YaYaYa—YaYa—YaYa
shannon-3.1 YaYaYa—YaYa—YaYa
shannon-3.1-pro YaYaYa—YaYa—YaYa
shannon-3.5 Ya———YaYa——Ya
shannon-coder-1 Ya—Ya—YaYa——Ya

Model open-weight hosted

Id model hosted adalah nama dan variannya yang digabung dengan tanda hubung, misalnya DeepSeek-V4-Pro-0813-3BIT-REAP.

Model ToolsGambarReasoningEffortObjek JSONJSON schemaCachingPencarianStreaming
DeepSeek-V4-Pro-0813 3BIT-REAP Ya—YaYaYaYaYa—Ya
GLM-5.2 3BIT-REAP Ya—YaYaYaYaYa—Ya
Kimi-K3 3BIT-REAP YaYaYaYaYaYaYa—Ya
Nemotron3Ultra 3BIT-REAP Ya—YaYaYaYaYa—Ya
MiniMax-M3 3BIT-REAP YaYaYaYaYaYaYa—Ya
DeepSeek-V4-Flash-0731 W4A16-AUTOROUND-REAP Ya—YaYaYaYaYa—Ya
Kimi-K2.6 W4A16-AUTOROUND-REAP YaYaYaYaYaYaYa—Ya
Laguna-S-2.1 W4A16-AUTOROUND-REAP Ya—YaYa——Ya—Ya
inkling W4A16-AUTOROUND-REAP YaYaYaYaYa—Ya—Ya
MiMo-V2.5-Pro W8A16 Ya—YaYaYaYaYa—Ya
MiMo-V2.5 W8A16 YaYaYaYaYaYaYa—Ya
Hy3 W8A16 Ya—YaYaYaYaYa—Ya

Arti setiap kolom

  • Tools. Anda mendeskripsikan fungsi di tools, model membalas dengan panggilan yang diinginkannya, dan kode Anda menjalankannya. Setiap model menerima tools. tool_choice yang dipaksakan diterapkan oleh model open-weight hosted. Pemanggilan fungsi
  • Input gambar. Model membaca gambar yang dikirim di dalam pesan user, sebagai data URL atau sebagai alamat. shannon-2-lite dan shannon-2-pro membaca gambar pada permintaan yang juga mengirim tools atau response_format. Keluarga Shannon 3 juga membaca dokumen. Gambar dan file
  • Reasoning. Balasan dapat membawa teks penalaran model di samping jawaban, dalam field tersendiri. Reasoning effort
  • Reasoning effort. Field permintaan mengatur seberapa dalam model bernalar: off, low, medium, atau high. Model Shannon menentukan kedalamannya sendiri. Reasoning effort
  • Objek JSON. Dengan response_format: {"type": "json_object"}, jawaban berupa JSON tanpa bentuk yang ditentukan. Pada /v1/chat/completions dan /v1/responses. Output Terstruktur
  • JSON schema. Dengan response_format bertipe json_schema, jawaban mengikuti schema yang Anda kirim. Pada /v1/chat/completions dan /v1/responses. Output Terstruktur
  • Prompt caching. Prompt yang diawali sama seperti prompt terbaru pada model yang sama dibaca dari cache, dan bagian yang ter-cache ditagih 25% dari harga input. Tidak memerlukan field permintaan. Prompt caching
  • Pencarian web. Dengan web_search: true, API mencari di web dan memberikan hasilnya ke model sebelum menjawab. Pada /v1/chat/completions dan /v1/messages. Ini adalah field permintaan dan tidak memiliki flag di GET /v1/models. Pencarian Web Terintegrasi
  • Streaming. Dengan stream: true, balasan tiba sebagai server-sent events selagi model menulis. Setiap model mendukung streaming di ketiga endpoint. Streaming

Fakta yang sama dari GET /v1/models

GET https://api.shannon-ai.com/v1/models

GET /v1/models mencantumkan setiap model beserta objek capabilities, sehingga program dapat membaca fakta ini alih-alih halaman ini. Endpoint ini tidak memerlukan kunci.

from openai import OpenAI

client = OpenAI(api_key="YOUR_API_KEY", base_url="https://api.shannon-ai.com/v1")

for model in client.models.list():
    print(model.id, getattr(model, "capabilities", None))

id dan capabilities dari dua entri data:

200 JSON
[
  {
    "id": "shannon-3",
    "capabilities": {
      "tools": true,
      "vision": true,
      "reasoning": true,
      "reasoning_effort": false,
      "streaming": true,
      "json_schema": true
    }
  },
  {
    "id": "Kimi-K3-3BIT-REAP",
    "capabilities": {
      "tools": true,
      "vision": true,
      "reasoning": true,
      "reasoning_effort": true,
      "streaming": true,
      "response_format": true,
      "json_schema": true,
      "prompt_caching": true
    }
  }
]
Kolom Flag di capabilities
Tools tools
Input gambar vision
Reasoning reasoning
Reasoning effort reasoning_effort
Objek JSON response_format
JSON schema json_schema
Prompt caching prompt_caching
Pencarian web Bukan flag: field permintaan web_search.
Streaming streaming
  • response_format dan prompt_caching adalah flag pada entri open-weight hosted. Entri Shannon melaporkan output JSON hanya dengan json_schema, yang mewakili kedua mode JSON.
  • vision bernilai true untuk shannon-2-lite dan shannon-2-pro: keduanya membaca gambar pada permintaan yang juga mengirim tools atau response_format.

Di luar baris sebuah model

Model open-weight hosted menolak gambar atau mode JSON yang berada di luar barisnya. Penolakan terjadi sebelum apa pun dipotong dari saldo Anda:

Status Tipe Pesan Kapan
400 invalid_request_error <id> does not accept image input Gambar dikirim ke model open-weight hosted yang tidak mendukung input gambar.
400 invalid_request_error <id> does not accept response_format Output JSON diminta dari model open-weight hosted yang tidak memiliki mode JSON apa pun.
400 invalid_request_error <id> does not accept response_format json_schema; use json_object Schema dikirim ke model open-weight hosted yang hanya memiliki mode objek JSON.

Model Shannon menjawab permintaan semacam itu dengan status 200: kemampuan di luar barisnya tidak berperan dalam jawaban. Penanganan kesalahan