API 开发文档

快速集成指南与完整 API 参考

模型选择

先拿到真实可用的模型 ID

所有请求里的 model 字段都必须填写当前平台真实可用的模型 ID。第一次接入时，建议先读取模型列表，再复制其中一个可调用模型做测试。

如果 Token 配置了模型权限，你只能调用该 Token 被授权访问的模型。模型存在但没有权限时，也可能表现为调用失败。

调用 /v1/models 可以查看当前账号或 Token 可访问的模型。复制返回结果里的 id 字段，用到后续请求的 model 字段中。

curl

bash

curl https://api.wei.run/v1/models \
  -H "Authorization: Bearer sk-your-api-key"

字段	它表示什么	接入时怎么用
id	模型的真实调用 ID。	复制到请求体的 model 字段，或填到工具的 Model ID 配置项。
capabilities	模型支持的能力类型，例如文本、图片、视频或多模态。	用来判断应该调用文本、图片还是视频接口。
billing_type	该模型的计费方式。	和价格页或模型详情一起判断调用成本。
enabled	模型当前是否可用。	优先选择当前启用且有可用渠道的模型。

优先选择文本或多模态模型，并调用 /v1/chat/completions。它最容易验证成功。

选择图片生成模型后，再调用 /v1/images/generations。第一次建议只生成 1 张。

选择视频模型后，按创建任务、查询任务、读取结果的异步流程测试。