一个密钥，调用维尼的
真实商业模型网络
使用 OpenAI 兼容接口接入对话与图片，通过异步任务接口生成视频或运行 Agent。模型、价格和可用性由服务端实时目录决定。
先创建密钥并在服务端设置 WEINI_API_KEY，再从下方目录选择模型。此示例随当前模型与规格更新。
正在读取可调用模型…
01 / AUTH
使用 Bearer 密钥鉴权
密钥只在创建时完整显示一次。请存入服务端环境变量或密钥管理器，不要写进浏览器代码、仓库、日志或 Agent 对话。
请求头
Authorization: Bearer $WEINI_API_KEY
最小权限
按密钥限制接口范围、模型、IP、过期时间和消费额度；完整密钥不会再次返回。
02 / COMMERCE
同一账户计费，密钥独立控额
API 调用使用当前个人灵感值账户。密钥额度是独立消费上限，实际扣费仍进入统一消费记录，不存在第二个钱包。
综合最优
价格、成功率、稳定性与拥堵综合评分
价格优先
优先选择同模型中估算价格更低的路由
速度优先
优先选择响应更快的可执行路由
成功率优先
优先选择近期成功证据更好的路由
调度只发生在同一个规范模型的可执行路由之间。价格和健康数据由服务端控制，客户端不能覆盖。
03 / LIVE CATALOG
实际可调用模型
价格与执行规格来自服务端可售渠道。运行时调用 /v1/models，可同时获取密钥权限内的模型、规格、接口和计费单位；每次请求的参数须属于同一个能力组合。
04 / SYNCHRONOUS
对话生成
OpenAI Chat Completions 兼容接口，支持普通 JSON 与 SSE 流式响应。模型请从 /v1/models 中选择。
当前没有公开可调用的对话模型。
05 / SYNCHRONOUS
图片生成
OpenAI Images 风格接口。不同模型支持的比例、分辨率和参考图数量以实时模型目录为准。
当前没有可生成示例的图片模型。
06 / ASYNCHRONOUS
视频生成任务
创建任务后轮询同一个任务 ID。网络超时重试必须复用 Idempotency-Key，不能重复创建付费任务。
当前没有可生成示例的视频模型。
07 / AGENT RUN
运行完整 Agent 任务
适合需要多步骤规划与交付的任务。创建后通过 run ID 查询状态，不要把密钥、系统提示词或上游配置放进 prompt。
08 / RECOVERY
错误与安全重试
已鉴权并进入审计的请求在 X-Trace-Id 响应头中返回排查标识；curl -i 可以查看。错误体的 error.code 用于区分原因。异步任务保留 id，先查询原任务再决定重试。
09 / AGENT READY
让 Agent 正确调用 API
安装官方 weini-api Skill 后，Agent 会先发现实时模型、从环境变量读取密钥，并正确处理异步幂等与计费错误。
weini-api
RAW API · MODEL DISCOVERY · IDEMPOTENCY
不会要求你把 API 密钥粘贴到对话；不会硬编码模型；不会在超时后自动创建第二个付费任务。