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 系列。不同模型的上下文、工具调用、搜索及图像能力有差异。

资料列出的型号与能力尚未全部由新航线实测，不构成可售清单、价格或可用性承诺。正式方案会确认具体型号、调用权限、费率及支援范围。

把你的工具接进来。

告诉我们要做什么、使用哪个工具、预计用量。

整理接入需求 ↗