模型列表与目录

在代码里读取模型有两种方式。下面两个示例都是真实的文件，发布前我们都会实际运行一遍。

你的 API Key 能调用的模型

# The models your key can call, in the standard list format.
curl -sS "${OCEANTOKEN_BASE_URL:-https://api.oceantoken.ai/v1}/models" \
  -H "Authorization: Bearer $OCEANTOKEN_API_KEY"

GET /v1/models 采用 OpenAI 的列表格式：data[] 里每个模型一个 id，就是要发送的 model 值。它只列出你的 API Key 能调用的模型：如果你的账户只开放了部分模型，列表里只会出现这些，调用其他模型会以 403 model_not_allowed 被拒绝（限制 → 模型访问）。OpenAI SDK 的 client.models.list() 读取的就是它。

带类型和能力的模型目录

# The public catalog: every model with its type, context window, capabilities
# and prices, as JSON. No key needed. This prints the IDs of the video models.
curl -sS --fail https://api.oceantoken.ai/public/model_hub |
  python3 -c 'import json, sys; print("\n".join(m["model_group"] for m in json.load(sys.stdin) if m.get("mode") == "video_generation"))'

https://api.oceantoken.ai/public/model_hub 以 JSON 数组的形式提供完整目录，模型页和控制台用的就是这份数据。不需要 API Key。每一项包含以下字段（不止这些）：

字段	含义
model_group	模型 ID，即要发送的 model 值
mode	类型，决定调用哪个端点：chat、image_generation、video_generation、audio_speech、audio_transcription、embedding、rerank
max_input_tokens、max_output_tokens	文本模型的上下文窗口和最长回答
supports_vision、supports_function_calling、supports_reasoning、supports_web_search	图片输入、工具调用、推理、联网搜索
input_cost_per_token、output_cost_per_token 等	价格，单位是美元每 token，或该类型模型的每个计费单位

当你的应用要让用户自选模型，或者调用前要先确认某项能力时，就读这份目录。模型会不断上新和下线，所以请定期重新读取，而不是复制一份留着用。给人看的价格请见 oceantoken.ai。

各类型用哪个端点

mode	端点	指南
chat	/v1/chat/completions、/v1/responses、/v1/messages	文本生成
image_generation	/v1/images/generations、/v1/images/edits	图像
video_generation	/v1/videos	视频
audio_speech	/v1/audio/speech	语音合成
audio_transcription	/v1/audio/transcriptions	语音转写
embedding	/v1/embeddings	向量
rerank	/v1/rerank	重排序

模型 ID

ID 由发布方和模型名组成，比如 openai/gpt-5-mini 或 bytedance/seedance-2.0。以 :free 结尾的是免费、限速的版本。smart-router 会替你挑选文本模型（文本生成）。