BUILD WITH ChartCourse AI / DEVELOPER GUIDE

一次接入，
連接你的 AI 工作。

對話、識圖、生成與編輯圖像。
從協議選擇到第一個請求，把每一步寫清楚。

查看調用示例 ↓取得接入方案 ↗

DOCUMENTATION / 01

依據 LM-API-DOC-V1.0（2026-08-11）整理，本站更新於 2026-09-21。網站提供接入指南；公開 API、線上充值及密鑰自助申請尚未開放。

01 / BEFORE YOU BUILD

先確認三個值。

開通時取得網關地址、專屬 API Key 和可用模型 ID。下面的環境變數用於示範，不是已開通的帳號或可直接調用的網關。

NOCA_API_HOST

網關根地址

使用開通通知中的 HTTPS 地址，不附加 /v1。不要把本網站網址當作模型網關。

NOCA_API_KEY

專屬密鑰

只配置在你的服務端環境。不要寫入網頁、公開代碼庫、截圖或諮詢表。

NOCA_MODEL

模型 ID

按開通清單精確填寫。模型名稱、權限、費率及限額需一起核對。

請求統一使用 POST，JSON 接口使用 Content-Type: application/json 和 Authorization: Bearer <API_KEY>。圖片編輯使用 multipart，由 HTTP 客戶端生成 boundary。

普通對話 60 秒 · 生圖 120 秒 · Claude 600 秒

這是接入資料給出的客戶端超時建議，不是響應時效承諾。長任務也要同步確認應用與反向代理的超時設定。

02 / CHOOSE YOUR PROTOCOL

同一個入口，保留協議差異。

按模型和任務選擇接口。不同協議的消息、圖片與流式事件結構不能直接互換。

能力 / 協議	POST 路徑	用途
OpenAI 兼容對話	`/v1/chat/completions`	文本、長文與適用模型的工具調用
Anthropic Messages	`/v1/messages`	Claude 對話、識圖
Gemini 圖像	`/models/{MODEL}:generateContent`	圖像生成
圖像生成	`/v1/images/generations`	文生圖
圖像編輯	`/v1/images/edits`	局部修改、擴圖與圖生圖

路徑依接入資料保留。Gemini 路徑不要自行添加版本前綴；以你實際開通的協議為準。

03 / YOUR FIRST REQUEST

從一個簡單請求開始。

以下是 OpenAI 兼容對話協議的服務端示例。先在服務端設定三個環境變數；Python / Node.js 版本需安裝對應的 openai 套件。

流式 SSE

Bash / cURL

curl --fail-with-body --max-time 60 "${NOCA_API_HOST%/}/v1/chat/completions" \
  -H "Authorization: Bearer ${NOCA_API_KEY}" \
  -H "Content-Type: application/json" \
  -d "{\"model\":\"${NOCA_MODEL}\",\"messages\":[{\"role\":\"user\",\"content\":\"Hello\"}],\"stream\":false}"

示例只在本頁切換，不會發送 API 請求。

先核對一個非流式請求的返回結果，再測流式。示例關閉 SDK 自動重試，避免在請求狀態不明時重複產生用量。

MORE PROTOCOLS / BASH

按協議選擇請求體。

Claude / Messages

以下鑑權方式沿用接入資料中的網關協議。請填入已開通的 Claude 模型 ID。

curl --fail-with-body --max-time 600 "${NOCA_API_HOST%/}/v1/messages" \
  -H "Authorization: Bearer ${NOCA_API_KEY}" \
  -H "Content-Type: application/json" \
  -d "{\"model\":\"${NOCA_MODEL}\",\"max_tokens\":1024,\"messages\":[{\"role\":\"user\",\"content\":\"Hello\"}]}"

Gemini / 圖像生成

使用已開通的 Gemini 圖像模型；支持的尺寸與比例按型號確認。

curl --fail-with-body --max-time 120 "${NOCA_API_HOST%/}/models/${NOCA_MODEL}:generateContent" \
  -H "Authorization: Bearer ${NOCA_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"role":"user","parts":[{"text":"A quiet mountain lake at sunset"}]}],"generationConfig":{"responseModalities":["TEXT","IMAGE"],"imageConfig":{"aspectRatio":"4:3","imageSize":"1K"}}}'

Images / 文生圖

使用已開通的圖像模型 ID。返回格式及支援尺寸按型號確認。

curl --fail-with-body --max-time 120 "${NOCA_API_HOST%/}/v1/images/generations" \
  -H "Authorization: Bearer ${NOCA_API_KEY}" \
  -H "Content-Type: application/json" \
  -d "{\"model\":\"${NOCA_MODEL}\",\"prompt\":\"A white cat waving hello, realistic photography\",\"n\":1,\"size\":\"1024x1024\"}"

圖片編輯資料只說明 multipart 與本地圖片，未給出完整表單字段；開通時先取得字段定義，不直接套用文本示例。

04 / REQUEST SHAPE

把內容、控制參數分開。

參數	作用	注意
`model`	選擇模型	必須是帳號已開通的模型 ID
`messages`	對話內容	文本和圖片的 content 結構不同
`stream`	是否分段輸出	關閉時返回完整 JSON
`stream_options.include_usage`	取得流式用量	兼容對話協議設為 true
`max_tokens`	最大輸出長度	依模型上限設定，不把單一上限套用全部模型
`temperature / top_p`	採樣控制	通常選一個調整，先確認模型是否支援
`tools / stop`	工具定義與停止條件	按任務使用，核對具體模型相容性
`thinking / web_search / safe`	模型擴展能力	僅按具體模型的支援範圍配置

多模態識圖怎樣準備？

使用支援視覺的型號，並按協議構建圖片內容。兼容對話中的 content 可包含文字與 image_url；Claude 請使用 Messages 的圖片消息結構。尺寸、格式及上下文限制在開通時確認。

Claude 與 Gemini 可以直接替換示例路徑嗎？

不能只改 URL。Claude 使用獨立 Messages 請求體；Gemini 使用 generateContent 的 contents / parts 結構。圖像返回也要按對應協議解碼。需要這些能力時，請附上工具與模型需求，取得對應的完整配置。

05 / READ THE RESPONSE

輸出與用量，分別核對。

JSON / 非流式

一次取得完整結果

choices[0].message.content 是回答正文，finish_reason 表示結束原因。

usage.prompt_tokens、completion_tokens 和 total_tokens 用於核對模型用量。

SSE / 流式

逐段讀取，直到結束

逐個處理 data: {JSON} 事件，拼接 delta.content，遇到 data: [DONE] 結束。

開啟 include_usage，保留最後的用量塊；該塊可能沒有 choices，不應直接下標取值。

Token 數量不等於付款金額。

模型費率、快取及圖像計費規則需另行確認。用量字段不是實際扣費憑證；收款、可用額度與消耗記錄分開核對。連接中斷後應先確認請求狀態。

06 / TROUBLESHOOTING

從錯誤碼定位問題。

狀態 / 業務碼	先檢查	處理方向
`400`	JSON 與 content 類型	核對協議、字段及圖文消息結構
`401`	密鑰、權限、帳號餘額	檢查開通狀態，勿公開完整密鑰
`422`	上下文、長度、參數衝突	精簡歷史消息，調整輸出上限
`429`	頻率或並發限制	降低並發，按限流資訊延後再試
`500 / 103503`	內部異常或服務繁忙	保留錯誤資訊，核對後再決定是否重試
`103501 / 104201`	請求超時	核對超時設定與已有消耗記錄
`100118 / 100119`	模型訪問限制	聯絡支援核對帳號與模型權限

尋求支援時提供時間、協議、模型 ID、HTTP 狀態與請求 ID（如有）。先移除 Authorization、個人資料及敏感的輸入輸出。

07 / MODELS & ACCESS

模型以開通清單為準。

接入資料涉及 GPT / DeepSeek 文本、Claude 視覺、Gemini 圖像與 GPT Image 系列。不同模型的上下文、工具調用、搜索及圖像能力有差異。

資料列出的型號與能力尚未全部由新航線實測，不構成可售清單、價格或可用性承諾。正式方案會確認具體型號、調用權限、費率及支援範圍。

把你的工具接進來。

告訴我們要做什麼、使用哪個工具、預計用量。

整理接入需求 ↗